Invocar proceso

Actividad Invocar proceso que ejecuta un proceso de UiPath que está disponible para la máquina local.

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.

Al utilizar la actividad Invocar proceso , aunque el proyecto contenga varios procesos, se crea un único trabajo para ejecutarlos, a diferencia 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 como está 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/ Nombre del 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 en la parte 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 la variable Argumentos. Para recuperar la última lista de argumentos de proceso, selecciona Actualizar argumentos a la derecha del campo. Para abrir la lista de argumentos y editar sus atributos, selecciona la casilla Argumentos .
• Variable de 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 para 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 el lado derecho 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 booleanos (verdadero, falso). El valor predeterminado es Falso. Como resultado, si el campo está vacío y se produce un error, la ejecución del proyecto se detiene. Si el valor se establece en 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.

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.
• Elevado (compatible con proyectos Windows y Windows: heredado): selecciona Verdadero para ejecutar el proceso secundario con integridad de MediumPlus, sin elevar el proceso principal. Requiere que el robot habilite la variable de entorno UIPATH_MEDIUMPLUS_INVOKE; de lo contrario, la configuración se ignora. Falso de forma predeterminada.

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

• Nombre del paquete : el nombre del paquete utilizado para crear el proceso que quieres invocar. En los proyectos de Windows: heredado, el robot identifica el proceso que se va 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 el archivo 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:

  If this activity is included in Try Catch and the value of the ContinueOnError property is True, no error is caught when the project is executed.

• Nombre para mostrar: el nombre para mostrar de la actividad.
• 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.
• Elevado : si se selecciona esta casilla, el proceso secundario se ejecuta con integridad de MediumPlus, sin elevar el proceso principal. Requiere que el robot habilite la variable de entorno UIPATH_MEDIUMPLUS_INVOKE; de lo contrario, la configuración se ignora.

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 el archivo 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.

Mensajes de argumento

La actividad informa del estado de su diccionario de Argumentos en el cuadro de información. Ninguno de estos mensajes elimina un argumento que configuraste: Actualizar argumentos importa los argumentos que declara el proceso invocado o deja el diccionario como está y dice por qué.

• "Los argumentos no se han podido leer desde el destino invocado, por lo que se han dejado sin cambios" se muestra cuando seleccionas Actualizar argumentos y el nombre del proceso está vacío, el punto de entrada no se resuelve, la llamada a Orchestrator falla o sus metadatos no se pueden analizar. Mientras editas la actividad, este caso no informa de nada.
• "El destino invocado declara argumentos que no se pueden importar (por ejemplo, falta un nombre o tipo, o un nombre duplicado), por lo que los argumentos no se modificaron. Corrige los argumentos del destino y actualiza de nuevo." se muestra al seleccionar Actualizar argumentos. La importación se rechaza en su conjunto en lugar de escribir solo los argumentos que podrían construirse.
• "Los argumentos no se pudieron actualizar en el flujo de trabajo, por lo que se dejaron sin cambios. Consulta los registros para obtener más detalles.": se muestra al seleccionar Actualizar argumentos si se leyó el proceso invocado pero no se pudo volver a escribir el diccionario. Nada se pierde.
• "El destino invocado no declara argumentos. Por seguridad, los siguientes elementos no se eliminan automáticamente:" seguido de los nombres de los argumentos. se muestra tanto al actualizar como al editar. Los argumentos enumerados se mantienen deliberadamente y puedes eliminarlos manualmente si el proceso invocado ya no los utiliza.
• "Faltan los siguientes argumentos o están mal configurados:" seguido de los nombres de los argumentos. se muestra mientras editas, cuando el proceso invocado declara argumentos que la actividad no tiene, o los tiene con un tipo o dirección diferente. Seleccionar Actualizar argumentos lo resuelve.
• "Los siguientes argumentos son adicionales:" seguido de los nombres de los argumentos. se muestra mientras editas, cuando todo lo que declara el proceso invocado ya está configurado y la actividad lleva más argumentos encima.
• "Faltan los siguientes argumentos o están mal configurados:" seguido de los nombres de los argumentos y, a continuación, "N argumentos son adicionales" se muestra mientras editas, cuando los dos casos anteriores se aplican a la vez, que es lo que produce apuntar la actividad a un proceso diferente. Los argumentos que faltan se nombran, los adicionales solo se cuentan.

Los mensajes que enumeran los nombres de los argumentos muestran como máximo tres, luego añaden "y N otro(s)".