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.

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. Ignorar este aviso desencadena una notificación de error "Las expresiones no son compatibles actualmente".
• 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

Windows, 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 cadena no son compatibles con los proyectos Windows y multiplataforma. Todas las cadenas deben colocarse entre comillas. Para abrir el flujo de trabajo en una pestaña diferente del mismo proyecto, selecciona Abrir flujo de trabajo en el lado derecho del campo.

• Argumentos: opción predeterminada. Abre el diccionario de argumentos, donde puedes ver los argumentos del flujo de trabajo 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 flujo de trabajo, selecciona Actualizar argumentos en el lado derecho del campo.

• 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 mantener 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. Para abrir la lista de argumentos y editar sus atributos, selecciona el campo Argumentos.

Nota:

• Si el valor de la variable Argumentos es nulo en tiempo de ejecución, la actividad recurre a la propiedad Argumentos.

• Cambiar entre las propiedades de la variable Argumentos y Argumentos revela el valor anterior.

• El valor de la variable Argumentos se pierde al cerrar el Editor de expresiones.

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.

Opciones

• Sesión de destino (exclusivamente para proyectos de Windows): 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 diferente de la principal, así que asegúrate de establecer la propiedad Aislado en Verdadero. 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.

• Aislado : selecciona Verdadero para ejecutar el flujo de trabajo invocado en un proceso de Windows independiente. Esto ayuda a aislar un flujo de trabajo defectuoso del flujo de trabajo principal. 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

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

• Nombre del archivo de flujo de trabajo : la ruta del archivo del archivo .xaml archivo que se va a invocar. La ruta del archivo es relativa a la carpeta del proyecto actual. Este campo solo acepta cadenas o variables de cadena. Se admiten variables de cadena. Todas las cadenas deben ir entre comillas.

• Importar argumentos: abre un panel Argumentos que presenta todos los argumentos del flujo de trabajo al que se hace referencia en la propiedad Nombre del archivo de flujo de trabajo .

  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: te permite abrir el flujo de trabajo invocado en una pestaña diferente del mismo proyecto.

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

• NombreParaMostrar: el nombre de la actividad para ser mostrado.

• 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.

• Nombre del archivo de flujo de trabajo : la ruta del archivo del archivo .xaml archivo que se va a invocar. La ruta del archivo es relativa a la carpeta del proyecto actual. Este campo solo acepta cadenas o variables de cadena. Se admiten variables de cadena. Todas las cadenas deben ir entre comillas.

  Nota: Cuando se utilizan robots 2021.10 y anteriores, las excepciones empresariales no son compatibles en un flujo de trabajo aislado, todas las excepciones se devuelven como excepciones del sistema.

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

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

• Sesión de destino (exclusivamente para proyectos de Windows): 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 diferente de la principal, así que asegúrate de establecer la propiedad Aislado en Verdadero. 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.