Alcance del proceso de Excel

UiPath.Excel.Activities.ExcelProcessScopeX

Abre o reutiliza procesos de Excel, carga la configuración del proyecto de Excel y los aplica al archivo Excel asociado. Esta actividad simplifica la administración de procesos de Excel al permitirte configurar cómo se inicia un proceso de Excel y cómo se administran los procesos existentes.

Algunos de los casos de uso son:

• Activa o desactiva macros.
• Maneja la resolución de conflictos entre archivos de Excel.
• Permite la finalización de procesos de Excel existentes para evitar conflictos.
• Gestiona los modos de los procesos (ya sea para abrir un nuevo proceso, reutilizar uno existente o avisar al usuario).

Recomendamos colocar una actividad Usar archivo de Excel dentro de una actividad Ámbito del proceso de Excel para abrir documentos de Excel con ciertas configuraciones ya aplicadas.

Propiedades

Común

• Nombre para mostrar: el nombre para mostrar de la actividad.

Otros

• Privado : si se selecciona, los valores de variables y argumentos ya no se registran en el nivel Detallado.

Opciones

• Mostrar alertas : si se selecciona, Excel puede mostrar alertas y mensajes. El valor predeterminado es Igual que el proyecto. El menú desplegable contiene las siguientes opciones: Igual que el proyecto, Falso y Verdadero.
• Acción de procesos existentes : la acción que se ejecutará si se están ejecutando otros procesos de Excel. El valor predeterminado es Igual que el proyecto. El menú desplegable contiene las siguientes opciones:
  • Igual que el proyecto: aplica la misma configuración que en la Configuración del proyecto.
  • Ninguno : no se realiza ninguna acción en relación con los procesos existentes en la máquina.
  • Forzar cancelación: cierra cualquier proceso de Excel abierto sin ningún intento de guardar el archivo.
• Resolución de conflictos de archivos : la acción que se ejecutará si se detectan conflictos de archivos de Excel entre procesos de Excel. Por ejemplo, un archivo de Excel ya está abierto en otro proceso de Excel. El valor predeterminado es Igual que el proyecto. El menú desplegable contiene las siguientes opciones:
  • Igual que el proyecto: aplica la misma configuración que en la Configuración del proyecto.
  • Ninguno: no se ha realizado ninguna acción.
  • Cerrar sin guardar: cierra los archivos de Excel que estén en conflicto y no guarda los cambios pendientes.
  • Preguntar al usuario: muestra al usuario un aviso que solicita que se cierren los archivos.
  • Lanzar excepción: lanza una excepción que se puede manejar en una actividad Intentar capturar o hacer que finalice el flujo de trabajo.
• Launch method - Determines whether an Excel process is launched via COM APIs or as full process. The default value is Same as project. The drop-down contains three options, as follows:
  • Igual que el proyecto: aplica la misma configuración que en la Configuración del proyecto.
  • Automatización : las API de automatización inician Excel. Esto es más rápido, pero no todos los complementos se cargan, por lo que puede causar problemas si el libro depende de un complemento para funcionar correctamente.
  • Aplicación: Excel se inicia como si un usuario lo abriera manualmente, lo que garantiza que todos los aspectos de Excel, como los complementos, se carguen.
• Launch timeout - The time to wait for Excel to start in seconds, if launched as a full process. The default value is 20 seconds.
• Configuración de macros : especifica el nivel de macros para el archivo de Excel actual. El valor predeterminado es Igual que el proyecto. El menú desplegable contiene las siguientes opciones:
  • Igual que el proyecto: aplica la misma configuración que en la Configuración del proyecto.
  • HabilitarTodo : todas las macros están habilitadas y se pueden ejecutar.
  • DeshabilitarTodo : se deshabilitan todas las macros en el archivo de Excel especificado. No se pueden ejecutar macros.
  • Utilizar la configuración de Excel: lee la Configuración de macros actual de Excel.
• Modo de proceso: determina cómo la actividad Alcance del proceso de Excel administra los procesos de Excel:
  • Igual que el proyecto : aplica la misma configuración que en la Configuración del proyecto. Este es el valor predeterminado.
  • Crear siempre nuevo: crea siempre un nuevo proceso de Excel para cargar todos los archivos asociados.
  • Usuario atendido : impone que solo haya un proceso de Excel en la máquina. Si encuentra más de un proceso de Excel, pregunta al usuario.
  • Reutilizar si existe : da prioridad a la reutilización de un proceso de Excel existente sobre la creación de uno nuevo. Busca cualquier proceso de Excel abierto, cuando se ejecuta la primera actividad Usar archivo de Excel , para verificar si el archivo de entrada ya está abierto, y toma una de las siguientes decisiones, en este orden:
    • Si encuentra un proceso con el archivo de entrada abierto, ese proceso se asocia con la actividad Ámbito del proceso de Excel .
    • Si encuentra un proceso con otro archivo abierto, se utilizará la configuración de Resolución de conflictos de archivos para determinar el comportamiento.
    • De lo contrario, se crea un nuevo proceso de Excel.
  • Solo si existe : obliga a reutilizar una instancia de proceso de Excel específica. Busca cualquier proceso de Excel abierto, cuando se ejecuta la primera actividad Usar archivo de Excel , para verificar si el archivo de entrada ya está abierto:
    • Si encuentra un proceso con el archivo de entrada abierto, asocia ese proceso con la actividad Ámbito del proceso de Excel .
    • De lo contrario, se lanza una excepción.
• Mostrar ventana de Excel : si se selecciona, las ventanas de Excel aparecen durante la automatización. El valor predeterminado es Igual que el proyecto. El menú desplegable contiene las siguientes opciones:
  • Igual que el proyecto: aplica la misma configuración que en la Configuración del proyecto.
  • Falso: el proyecto en segundo plano abre archivos de Excel con sus ventanas ocultas.
  • Verdadero: el proyecto abre archivos de Excel con sus ventanas visibles para el usuario.

Importante:

Para evitar errores, no utilices simultáneamente las siguientes propiedades con las opciones especificadas: Acción de procesos existentes con Forzar eliminación y Modo de proceso con Solo si existe.