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 predeterminados, al crear los argumentos. Puedes encontrar un breve ejemplo aquí. Un valor predeterminado proporcionado para un argumento en Studio puede sobrescribirse en Orchestrator, tanto a nivel de proceso como de trabajo.

Nota:

Los valores por defecto previstos para los argumentos In 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 a nivel de proceso en 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 In, 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

• En el nivel de paquete: al punto final /odata/Processes/UiPath.Server.Configuration.OData.SetArguments(key='key');
• A nivel de proceso: como una solicitud PATCH al punto final /odata/Releases(Id);
• En el nivel de trabajo: como una solicitud POST al punto final /odata/Jobs/UiPath.Server.Configuration.OData.StartJobs;
• En el nivel de programación: como una solicitud POST al 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 : si el valor se proporcionó de forma predeterminada en Studio. Este mensaje se muestra en la ventana Argumentos de un paquete específico, así como en las ventanas Ver proceso,Iniciar trabajo y Añadir programación .
• 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.

Figura 1. Valores de argumento

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 creados y publicados en Orchestrator antes de la v2018.3 deben volver a cargarse con un Robot de la v2018.3 (o posterior) para que se puedan mostrar los argumentos de entrada y salida del archivo Main.xaml.

Permisos de argumento

Se necesitan los siguientes permisos en relación a los argumentos de entrada y salida en Orchestrator:

• a nivel de paquete: Ver en Paquetes;
• a nivel de proceso: Ver y Editar en Procesos;
• a nivel de trabajo - Crear en Trabajos;
• en nivel de desencadenador: Crear o Editar en programación.