Invocar proceso

UiPath.Core.Activities.InvokeProcess

Descripción

Ejecuta un proceso de UiPath que está disponible para la máquina local. Se puede utilizar para ejecutar paquetes locales, así como procesos en Orchestrator, si hay una conexión disponible.

Para obtener más información sobre cómo encontrar la lista de procesos disponibles en una máquina, vaya aquí

La actividad Invocar proceso se ejecuta en modo síncrono, lo que significa que el proceso principal espera a que el proceso secundario se complete antes de reanudar su ejecución.

Los registros generados por los procesos secundarios solo contienen el resultado de la ejecución y errores, y se escriben en el mismo lugar que los del principal y pueden diferenciarse por el campo ProcessName en registros locales y por la columna Process en Orchestrator.

Cuando se utiliza la actividad Invocar proceso , aunque el proyecto contiene varios procesos, se crea un solo trabajo para ejecutarlos en lugar de la actividad Ejecutar proceso paralelo , que crea trabajos independientes para cada proceso del proyecto.

Si se han añadido múltiples procesos, la versión activa en la carpeta actual es la que se utilizará.

Nota:

• No se pueden enviar tipos de datos no serializables entre flujos de trabajo (p. ej.: NavegadorDeIU, ElementoDeIU, etc.).

Si se invoca un proceso secundario pero no se encuentra, se registra un error que contiene el nombre del proceso secundario, la ruta donde el robot lo buscó y detalles adicionales como WindowsIdentity y machineName.

Nota: al usar una versión de UiPath.System.Activities superior a la versión 20.4, Invocar proceso admite múltiples puntos de entrada. Si se crea un flujo de trabajo con esta versión y luego se desactualiza el paquete UiPath.System.Activities a una versión anterior que solo admite un único punto de entrada, las actividades Invocar Proceso del flujo de trabajo sufren errores de validación y deben reemplazarse manualmente para que funcionen.

Compatibilidad de proyectos

Windows - Heredado | Windows | Multiplataforma

Windows, configuración multiplataforma

• Ruta de la carpeta de Orchestrator : la ruta de la carpeta de Orchestrator donde se encuentra el proceso especificado, si es diferente de la carpeta donde se ejecuta el proceso. Este campo solo admite valores de cadena, con / como separador para indicar subcarpetas. Por ejemplo, "Finanzas/Cuentas por pagar".
• Invocar por : especifica si invocar el proceso por el Nombre del proceso configurado en Orchestrator, o por el Nombre del paquete. Ten en cuenta que se admite el uso del nombre del paquete, pero está obsoleto.

• Nombre del proceso/Nombredel paquete : el nombre del proceso o paquete que quieres invocar. El menú desplegable muestra los procesos o paquetes disponibles en la carpeta de Orchestrator conectada. Este campo solo admite variables String o String. Para gestionar la lista de procesos disponibles, selecciona Gestionar procesos a la derecha del campo.

  Nota:

  Cambiar entre las opciones Nombre del proceso y Nombre del paquete no actualiza automáticamente el nombre. Si el nombre de tu proceso difiere del nombre del paquete, asegúrate de actualizarlo en consecuencia.

• Punto de entrada : si tu proceso tiene varios puntos de entrada, especifica la ruta del archivo de flujo de trabajo que se ejecutará una vez que se inicie el proceso. Esta ruta debe ser relativa al paquete raíz. De forma predeterminada, este campo se deja vacío y utiliza el punto de entrada configurado en Orchestrator.

• Argumentos: opción predeterminada. Abre el diccionario de argumentos, donde puedes ver los argumentos del proceso invocado. También puedes definir una variable para contener un diccionario de argumentos seleccionando Usar una expresión en el lado derecho del campo. Esto convierte el campo Argumentos en variable Argumentos. Para recuperar la última lista de argumentos de proceso, selecciona Actualizar argumentos en el lado derecho del campo. Para abrir la lista de argumentos y editar sus atributos, selecciona el campo Argumentos.

• Variable Argumentos : activada por la opción Usar una expresión del campo Argumentos . Puedes utilizar una variable predefinida, o puedes crear una nueva utilizando expresiones VB o solicitando al Autopilot que genere una por ti. Utiliza esta variable para contener el diccionario de argumentos para el flujo de trabajo invocado. Vuelve a la opción Argumentos seleccionando Usar nombres estáticos en la parte derecha del campo.

Propiedades adicionales

Común

• Tiempo de espera: especifica la cantidad de tiempo que se debe esperar para que se ejecute el flujo de trabajo invocado antes de que se produzca un error y se cancele el flujo de trabajo. Este campo solo admite variables TimeSpan . De forma predeterminada, este campo está vacío.

• ContinuarEnCasoDeError: especifica si la automatización debe continuar incluso cuando la actividad arroja un error. Este campo solo admite valores Boolean (Verdadero, Falso). El valor predeterminado es Falso. Por lo tanto, si el campo está vacío y se produce un error, se detiene la ejecución del proyecto. Si el valor es Verdadero, la ejecución del proyecto continúa independientemente de cualquier error.

  Nota: Si esta actividad se incluye en Intentar capturar y el valor de la propiedad ContinuarEnCasoDeError es Verdadero, no se detecta ningún error cuando se ejecuta el proyecto.

Ejecución

• Sesión de destino: especifica la sesión en la que se inicia el proceso secundario.

  • Actual: el proceso secundario se abre en la misma sesión que el proceso principal.
  • Predeterminado del proceso: el proceso secundario usa los ajustes del proceso.
  • Principal: el proceso secundario se inicia en la sesión principal independientemente de dónde se ejecuta el proceso principal.
  • Imagen en imagen: el proceso secundario se inicia en la sesión Imagen en imagen independientemente de dónde se ejecuta el proceso principal.

Acceso

• Entrada de registro : especifica el tipo de información que se registrará automáticamente al introducir el recurso invocado.

• Salida de registro : especifica el tipo de información que se registrará automáticamente al salir del recurso invocado.

• NivelDeRegistro : especifica el nivel de registro aplicado a los mensajes generados por Entrada de registro y Salida de registro.

Windows - Configuración heredada

Panel del Diseñador

Puedes encontrar las siguientes propiedades en el cuerpo de la actividad:

• Nombre del paquete : el nombre del paquete utilizado para crear el proceso que quieres invocar. En proyectos Windows (heredado), el robot identifica el proceso a invocar por su nombre de paquete.

• Punto de entrada : si tu proceso tiene varios puntos de entrada, especifica la ruta del archivo de flujo de trabajo que se ejecutará una vez que se inicie el proceso. Esta ruta debe ser relativa al paquete raíz. De forma predeterminada, este campo se deja vacío y utiliza Main.xaml como punto de entrada.

• Editar argumentos : abre la lista de argumentos, donde puedes ver y gestionar los argumentos del proceso invocado.

Panel de propiedades

Común

• ContinuarEnCasoDeError: especifica si la automatización debe continuar incluso cuando la actividad arroja un error. Este campo solo admite valores Boolean (Verdadero, Falso). El valor predeterminado es Falso. Por lo tanto, si el campo está vacío y se produce un error, se detiene la ejecución del proyecto. Si el valor es Verdadero, la ejecución del proyecto continúa independientemente de cualquier error.

  Nota: si se incluye esta actividad en Intentar capturar y el valor de la propiedad ContinuarEnCasoDeError es Verdadero, no se detectará error cuando el proyecto se ejecute.
• NombreParaMostrar: el nombre de la actividad para ser mostrado.
• Tiempo de espera: especifica la cantidad de tiempo que se debe esperar para que se ejecute el flujo de trabajo invocado antes de que se produzca un error y se cancele el flujo de trabajo. Este campo solo admite variables TimeSpan . De forma predeterminada, este campo está vacío.

Entrada

• Argumentos : una colección de argumentos IN que puedes pasar al proceso que quieres ejecutar desde Orchestrator. Si un argumento tiene un tipo desconocido, se convierte a JSON.
• Variable de argumentos: las variables de argumento pasadas al proceso invocado.

• Nombre del proceso : el nombre del proceso que quieres invocar. Este campo acepta valores de cadena.

Acceso

• Entrada de registro : especifica el tipo de información que se registrará automáticamente al introducir el recurso invocado.

• Salida de registro : especifica el tipo de información que se registrará automáticamente al salir del recurso invocado.

• NivelDeRegistro : especifica el nivel de registro aplicado a los mensajes generados por Entrada de registro y Salida de registro.

Otros

• Punto de entrada : si tu proceso tiene varios puntos de entrada, especifica la ruta del archivo de flujo de trabajo que se ejecutará una vez que se inicie el proceso. Esta ruta debe ser relativa al paquete raíz. De forma predeterminada, este campo se deja vacío y utiliza Main.xaml como punto de entrada.

• Ruta de carpeta: la ruta de la carpeta de Orchestrator donde se encuentra el proceso especificado, si es diferente de la carpeta donde se ejecuta el proceso. Este campo solo admite valores de cadena con / como separador para indicar subcarpetas. Por ejemplo, "Finanzas/CuentasAPagar".
• Privado : si se selecciona, los valores de variables y argumentos ya no se registran en el nivel Detallado.

• Sesión de destino: especifica la sesión en la que se inicia el proceso secundario.

  • Actual: el proceso secundario se abre en la misma sesión que el proceso principal.
  • Predeterminado del proceso: el proceso secundario usa los ajustes del proceso.
  • Principal: el proceso secundario se inicia en la sesión principal independientemente de dónde se ejecuta el proceso principal.
  • Imagen en imagen: el proceso secundario se inicia en la sesión Imagen en imagen independientemente de dónde se ejecuta el proceso principal.
• Usar paquete: indica si el proceso debe identificarse por su nombre de paquete (seleccionado) o por su nombre de proceso (no seleccionado). De forma predeterminada, esta opción no está seleccionada.