Guía del usuario de Orchestrator

ENTREGA:

Automation Cloud Automation Cloud Public Sector Automation Suite Standalone

Última actualización 4 de dic. de 2024

Acerca de los argumentos de entrada y salida

Hemos expuesto los argumentos de entrada y salida, a los que ya está acostumbrado en Studio, como una forma de integrar sin problemas las herramientas que utiliza, como varios DCM o BPM. Esto significa que cualquier proceso que crees puede ahora recibir argumentos de entrada a través de la API o la interfaz de Orchestrator, así como devolver la salida a todo lo anterior. Por último, pero no por ello menos importante, se trata de un peldaño en la vinculación de procesos. Esta extensibilidad te ayuda a integrar mejor UiPath® en el ecosistema de tu empresa.

Nota:

Solo los argumentos de entrada, salida y entrada/salida de .xaml marcado/a como Principal en Studio están expuestos a otras aplicaciones.

Los argumentos se guardan en project.json de un proyecto.

Al diseñar, en Studio, la forma de configurar el proyecto para que acepte argumentos de entrada o salida, con o sin valores predeterminados, permite utilizarlos en otras aplicaciones de terceros o en Orchestrator. Solo puedes utilizar los argumentos de entrada y salida en Orchestrator y otras aplicaciones de terceros si has añadido los argumentos correspondientes en tu proyecto de Studio. Si no se han añadido argumentos en Studio, se muestra el siguiente mensaje: "Los argumentos de entrada no están definidos para esta versión".

Los argumentos de entrada, salida o entrada/salida de un proyecto se vuelven argumentos de entrada y salida al publicarlos en Orchestrator. Ten en cuenta que para los argumentos de entrada o salida, se crean dos argumentos diferentes y se muestran en Orchestrator, uno de entrada y uno de salida, con el mismo nombre.

Proporcionar valores de argumentos

Los valores pueden proporcionarse solo a argumentos de entrada, ya sea mediante Studio, Orchestrator o la API de Orchestrator de la siguiente manera:

Studio

Como valores por defecto, al crear los argumentos. Aquí puedes encontrar un breve ejemplo. Los valores por defecto proporcionados para un argumento en Studio pueden sobreescribirse en Orchestrator, tanto a nivel de proceso como de trabajo.

Nota: Los valores predeterminados proporcionados para los argumentos de entrada en Studio no se muestran en Orchestrator, en ningún nivel.

Orchestrator

A nivel de proceso: en la pestaña Argumentos de la ventana Ver proceso, tal y como se explica aquí.
A nivel de trabajo: en la pestaña Argumentos de la ventana Iniciar tarea, tal y como se explica aquí.
En el nivel de desencadenador: en la pestaña Argumentos de la ventana Añadir desencadenador, como se explica aquí.

Nota: Un valor proporcionado para un argumento de entrada en el proceso de Orchestrator se mantiene cuando se actualiza el paquete, siempre que la nueva versión del paquete no afecte a la definición de los argumentos.
El límite de almacenamiento para los argumentos de entrada/salida es de 1 MB.

Si proporcionas valores para los argumentos de entrada en Orchestrator, ten en cuenta que deben proporcionarse en formato JSON. Algunos ejemplos de cómo puedes hacerlo:

Cadena: el valor tiene que ser provisto sin comillas, como string;
Int32: proporciona el valor como lo haría con cualquier número entero 11;
Booleano: se muestran dos botones de radio para ayudarte a seleccionar verdadero o falso;
Doble: proporciona el valor como un valor de punto flotante, como 3.5;
DateTime: proporciona el valor como JSON, como "2012-04-23T18:25:43.511Z";
Array: proporciona los valores como JSON válido, como [1, 1, 2, 3, 5, 8] o ["firstString", "secondString"];

Nota: Se puede utilizar cualquier tipo de argumento de entrada, pero hay que tener en cuenta que Orchestrator solo valida los primitivos.
Cuando los tipos enumerados (enums) se convierten a JSON, cada miembro de la enumeración está representado por un valor entero, en lugar de por su nombre. Esto significa que la representación JSON de un número es el valor numérico de cada miembro incluido en la enumeración original.

API de Orchestrator

A nivel de paquete: al punto final /odata/Processes/UiPath.Server.Configuration.OData.SetArguments(key='key ');
A nivel de proceso, como una solicitud de PATCH para el punto final / odata / Releases (Id);
A nivel de trabajo: como una solicitud POST para el punto final /odata/Jobs/UiPath.Server.Configuration.OData.StartJobs;
A nivel de programación: como una solicitud POST para el punto final / odata / ProcessSchedules.

Nota: Para las llamadas a la API, se acepta un máximo de 10 000 caracteres para toda la longitud de la representación JSON de los argumentos de entrada, incluidos los nombres de los argumentos, todos los caracteres escapados, los espacios, los paréntesis y los valores de los argumentos.

Muestra valores de argumento

El valor de un argumento de entrada se marca de la siguiente manera:

Sin valor: no se proporciona valor para el argumento en el proceso, la tarea, la programación o el paquete (en Studio).
Heredado del paquete: valor proporcionado de manera predeterminada en Studio. Este mensaje se muestra en la ventana de Argumentos de un paquete específico, así como en las ventanas Ver proceso, Iniciar trabajo y Añadir horario.
Heredado del proceso: valor proporcionado a nivel de proceso (en la ventana Ver proceso). Este mensaje se muestra en la ventana Iniciar trabajo y Añadir horario. En la ventana Ver proceso, se muestra el propio valor.

Si los valores de argumento de entrada o de salida existen, se mostrarán en la ventana Detalles de la tarea. Los valores de entrada se mostrarán en la ventana mencionada en los siguientes casos:

se añadieron a nivel de proceso;
se añadieron a nivel de tarea.

También puedes ver los argumentos de entrada y salida a nivel de paquete, en la ventana Versiones de paquete.Para obtener más información, consulta Administrar paquetes.

Nota: Los flujos de trabajo que se crearon y publicaron en Orchestrator antes de la versión 2018.3 deben volver a cargarse con una versión 2018.3 (o posterior) para que se puedan mostrar los argumentos de entrada y salida del archivo Main.xaml.