Invocar archivo de flujo de trabajo

UiPath.Core.Activities.InvokeWorkflowFile

Descripción

Invoca sincrónicamente un flujo de trabajo especificado y envía de forma opcional una lista de argumentos de entrada. Los argumentos se pueden importar de un flujo de trabajo especificado con esta actividad usando el botón Importar argumentos del cuerpo de la actividad.

Nota:

• La importación de argumentos desde un flujo de trabajo los hace coincidir automáticamente con las variables existentes si comparten el mismo nombre y tipo de datos.
• No se pueden enviar tipos de datos no serializables entre flujos de trabajo aislados (p. ej.: NavegadorDeIU, ElementoDeIU, etc.).
• Las políticas de antivirus que restringen el acceso a PowerShell pueden impedir el uso de actividades relacionadas con PowerShell. Por ejemplo, no se puede usar Invocar archivo de flujo de trabajo e Invocar Power Shell cuando la regla con ID 6151 está habilitada en McAfee Endpoint Security.
• Después de ejecutar un flujo de trabajo invocado que añade campos de registro personalizados, los campos de registro se restauran a la configuración del flujo de trabajo principal.

Importante:

• El envío de argumentos IN a una actividad Invocar archivo de flujo de trabajo que no está aislada actúa como si se enviara una referencia, lo que significa que cualquier cambio hecho al objeto dentro del flujo de trabajo invocado cambiará el objeto en el flujo de trabajo principal.
• Las variables y los argumentos no son compatibles con los nombres de archivos de flujo de trabajo en proyectos Windows y multiplataforma. Esto desencadenará una notificación de error Actualmente no se admiten las expresiones.
• Al invocar un flujo de trabajo, comprueba que no contiene actividades de persistencia. Estas solo deben usarse en el flujo de trabajo principal.

El flujo de trabajo al que se hace referencia en la propiedad NombreDeArchivoDeFlujoDeTrabajo se puede abrir en el proyecto actual usando el botón Abrir flujo de trabajo del cuerpo de la actividad.

Nota: en cada archivo .xaml invocado cuyo título contenga un punto (.) se sustituirá todo el texto que está antes del punto (incluyendo el propio punto) por un guion bajo (_).

Compatibilidad de proyectos

Windows - Heredado | Windows | Multiplataforma

Configuración multiplataforma

• Nombre del archivo de flujo de trabajo: la ruta del archivo .xaml que se va a invocar. La ruta del archivo es relativa a la carpeta de proyecto actual. Este campo solo acepta strings o variables de string. Las variables de string no están soportadas en proyectos Windows y multiplataforma, Todas las strings deben ir entre comillas.
• Abrir flujo de trabajo: abre el flujo de trabajo invocado en una pestaña diferente del mismo proyecto.

Opciones avanzadas

Opciones

• Aislado: si se selecciona esta casilla de verificación, el flujo de trabajo invocado se ejecuta en un proceso de Windows independiente. Esto ayuda a aislar un flujo de trabajo defectuoso del flujo de trabajo principal.

Acceso

• Entrada de registro: qué tipo de información se debe registrar automáticamente al introducir el recurso invocado.
• Salida de registro: qué tipo de información se debe registrar automáticamente al salir del recurso invocado.
• NivelDeAcceso: el nivel de registro aplicado a los mensajes generados por la Entrada de registro y la Salida de registro.

Windows (heredado), configuración de Windows

Panel del Diseñador

Puedes encontrar las siguientes opciones en el cuerpo de la Actividad.

Importación de argumentos

Al hacer clic en el botón Importar argumentos del cuerpo de la actividad se abre un panel Argumentos que presenta todos los argumentos del flujo de trabajo referenciado en la propiedad RutaDelArchivoDelFlujoDeTrabajo.

Este panel te permite elegir qué argumentos deseas importar desde el flujo de trabajo invocado usando los controles direccionales del botón Eliminar para reorganizar los argumentos. Al hacer clic en Aceptar se guardan los cambios.

Nota:

• Crear argumentos en el panel hace que se descarten, ya que no coinciden con los datos del flujo de trabajo invocado.
• Los nombres de los argumentos en el panel distinguen entre mayúsculas y minúsculas.

Una vez que se cierra el panel, un contador al lado del botón muestra cuántos argumentos se han seleccionado para importarlos. El contador tiene código de color de la forma siguiente:

• naranja: si hay una coincidencia errónea entre los argumentos seleccionados y los que existen en el flujo de trabajo invocado.
• gris: si los argumentos seleccionados se han encontrado en el flujo de trabajo invocado.

Abrir flujo de trabajo

El botón Abrir flujo de trabajo del cuerpo de la actividad te permite abrir el flujo de trabajo invocado en una pestaña diferente del mismo proyecto.

Panel de propiedades

Común

• NombreParaMostrar: el nombre de la actividad para ser mostrado.
• ContinuarEnCasoDeError: especifica si la automatización debe continuar incluso cuando la actividad arroja un error. Este campo solo admite valores booleans (true, false). El valor predeterminado es false. 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.
• Tiempo de espera: especifica el período de tiempo que hay que esperar a que se ejecute la actividad antes de lanzar un error. Este campo solo admite variables TimeSpan. Este campo está vacío de forma predeterminada.

Entrada

• Argumentos: los parámetros que se pueden enviar a la aplicación en el momento de la invocación.
• VariableDeArgumentos: los parámetros que se pueden enviar de forma dinámica al flujo de trabajo usando un diccionario.
• Aislado: si se selecciona esta casilla de verificación, el flujo de trabajo invocado se ejecuta en un proceso de Windows independiente. Esto ayuda a aislar un flujo de trabajo defectuoso del flujo de trabajo principal.

• NombreDeArchivoDeFlujoDeTrabajo: la ruta de archivo del archivo .xaml que se va a invocar. La ruta del archivo es relativa a la carpeta de proyecto actual. Este campo solo acepta strings o variables de string. Las variables de string no están soportadas en proyectos Windows y multiplataforma, Todas las strings deben ir entre comillas.

  Nota: Cuando se usan robots 2021.10 y anteriores, las excepciones empresariales no se admiten en un flujo de trabajo aislado; todas las excepciones se devuelven como Excepciones del sistema.

Acceso

• Entrada de registro: qué tipo de información se debe registrar automáticamente al introducir el recurso invocado.
• Salida de registro: qué tipo de información se debe registrar automáticamente al salir del recurso invocado.
• NivelDeAcceso: el nivel de registro aplicado a los mensajes generados por la Entrada de registro y la Salida de registro.

Otros

• 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 flujo de trabajo. Solo los flujos de trabajo aislados pueden iniciarse en una sesión distinta del principal. Puedes elegir una de las siguientes opciones:

  • Actual: el proceso secundario se abre en la misma sesión que el proceso principal.
  • 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.

    Nota: al configurar Target Session para la actividad Invocar flujo, se debe activar el parámetro Isolated.