Invocar archivo de flujo de trabajo

Actividad Invocar archivo de flujo de trabajo que invoca de forma síncrona un flujo de trabajo especificado, pasándole opcionalmente una lista de argumentos de entrada.

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.
• Al invocar un flujo de trabajo, comprueba que no contiene actividades de persistencia. Estas solo deben usarse en el flujo de trabajo principal.
• La invocación de flujos de trabajo de desencadenador, es decir, flujos de trabajo que comienzan con una actividad de desencadenador, puede provocar una importación automática inesperada de argumentos.

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 del archivo .xaml 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. 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 la variable Argumentos. Para recuperar la última lista de argumentos de flujo de trabajo, selecciona Actualizar argumentos en el lado derecho del campo.
  Importante:

  Un argumento de entrada que se deja vacío en el diccionario de Argumentos se pasa de forma diferente dependiendo de su tipo de datos:

  • Los tipos de referencia (por ejemplo, String, DataTable o cualquier clase) se pasan como null, por lo que el flujo de trabajo invocado utiliza el valor predeterminado declarado para ese argumento.
  • Los tipos de valor (por ejemplo, Boolean, Int32, DateTime) no pueden ser null, por lo que se pasa uno vacío como tipo predeterminado (False, 0, 01/01/0001 00:00:00, etc. ) en lugar del valor predeterminado declarado en el flujo de trabajo invocado.
  Consejo:

  Para garantizar que un argumento de tipo de valor vuelva al valor predeterminado del flujo de trabajo invocado cuando se deja vacío, puede declararse como tipo anulable (por ejemplo, Nullable(Of Boolean)) en el flujo de trabajo invocado.

• 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. Para abrir la lista de argumentos y editar sus atributos, selecciona la casilla Argumentos .
  Nota:

  • Si el valor de la variable Argumentos es nulo en tiempo de ejecución, la actividad vuelve a la propiedad Argumentos.
  • Al cambiar entre las propiedades de la variable Argumentos y Argumentos se muestra 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 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.

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.
• Elevado (compatible con proyectos Windows y Windows: heredado): selecciona Verdadero para ejecutar el proceso secundario aislado con integridad de MediumPlus, sin elevar el proceso principal. Solo tiene efecto cuando Aislado se establece en Verdadero y 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.
  Importante:

  Para establecer los valores predeterminados de Entrada de registro y Salida de registro , ve a UiPath Studio > Configuración del proyecto > Sistema > Invocar archivo de flujo de trabajo. Los valores proporcionados aquí se aplican a todo tu proyecto.

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 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 colocarse 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 quieres importar del flujo de trabajo invocado utilizando los controles direccionales o el 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:

  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 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.
• Elevado : si se selecciona esta casilla, el proceso secundario aislado se ejecuta con integridad de MediumPlus, sin elevar el proceso principal. Solo tiene efecto cuando se selecciona Aislado y requiere que el robot habilite la variable de entorno UIPATH_MEDIUMPLUS_INVOKE ; de lo contrario, la configuración se ignora.
• Nombre del archivo de flujo de trabajo : la ruta del archivo del archivo .xaml 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 colocarse entre comillas.
  Nota:

  Al utilizar robots 2021.10 y anteriores, las excepciones de negocio 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.

Importante:

Para establecer los valores predeterminados de Entrada de registro y Salida de registro , ve a UiPath Studio > Configuración del proyecto > Sistema > Invocar archivo de flujo de trabajo. Los valores proporcionados aquí se aplican a todo tu proyecto.

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.

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 flujo de trabajo invocado o deja el diccionario como está y dice por qué.

El único caso en el que aún puede escribir un conjunto incompleto es el comportamiento en Studio 25.10 o anterior, descrito en la nota al final de esta sección.

• "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 falta el archivo de flujo de trabajo, su ruta se resuelve fuera del proyecto, su extensión .xaml no se puede analizar o la lectura falla por otro motivo. 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 flujo de trabajo 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 flujo de trabajo 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 flujo de trabajo 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 flujo de trabajo 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 flujo de trabajo 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)".

Nota:

En Studio 25.10 o anterior, un flujo de trabajo cuyo archivo.xaml no se puede analizar no siempre se informa como un error de lectura: Studio descarta solo las declaraciones cuyos tipos no pudo resolver y devuelve el resto.

Si todas las declaraciones se vieron afectadas, la lectura vuelve vacía, el mensaje dice que el flujo de trabajo no declara argumentos y se mantienen los argumentos configurados. Si solo algunos se vieron afectados, la lectura parece completa, Actualizar argumentos importa el conjunto acortado y los argumentos afectados no se conservan.