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 ahora cualquier proceso que crees puede recibir parámetros de entrada a través de la API o interfaz de Orchestrator, así como devolver una 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 extensión 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.

En el momento del diseño, en Studio, la forma en que configuras tu proyecto para aceptar argumentos de entrada o salida, con o sin valores predeterminados, te permite usarlos en otras aplicaciones de terceros u Orchestrator. Solo puedes hacer uso de parámetros de entrada y salida en Orchestrator y otras aplicaciones de terceros si has agregado los argumentos correspondientes en tu proyecto de Studio de antemano. Si no se han agregado argumentos en Studio, se muestra el siguiente mensaje: "Los parámetros de entrada no están definidos para esta versión".

Los argumentos de entrada, salida o entrada/salida de un proyecto se convierten en parámetros de entrada y salida cuando se publican 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 parámetros

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

Studio

As default values, when creating the arguments. A short example can be found here. A default value provided for an argument in Studio can be overwritten in Orchestrator, both at process or job level.

Nota:

Los valores por defecto previstos para los argumentos In en Studio no se muestran en Orchestrator, en ningún nivel.

Orchestrator

• At process level - in the Parameters tab of the View Process window, as explained here.

• At job level - in the Parameters tab of the Start Job window, as explained here.

• At trigger level - in the Parameters tab of the Add trigger window, as explained here.

  Nota:

  A value provided for an input parameter at process level in Orchestrator is kept when you update the package, as long as the new package version does not concern arguments' definition.

Si proporcionas valores para los parámetros 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.

API de Orchestrator

• At package level - to the /odata/Processes/UiPath.Server.Configuration.OData.SetArguments(key='key') endpoint;

• At process level - as a PATCH request to the /odata/Releases(Id) endpoint;

• At job level - as a POST request to the /odata/Jobs/UiPath.Server.Configuration.OData.StartJobs endpoint;

• At schedule level - as a POST request to the /odata/ProcessSchedules endpoint.

  Nota:

  For API calls, a maximum of 10,000 characters is accepted for the entire length of the JSON representation of input parameters, including argument names, all the escaped characters, spaces, brackets, and arguments values.

Visualización de valores de parámetros

El valor de un parámetro de entrada se marca de la siguiente manera:

• No value - No value was provided for the parameter at process, job, schedule, or package level (in 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.

  

If input or output parameters values exist, they are displayed in the Job Details window. The input values are displayed in the aforementioned window in the following cases:

• se añadieron al nivel de proceso;
• se añadieron al nivel de trabajo.

You can also view input and output parameters at package level, in the Package Versions window. For more information, see the Managing Packages.

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

The following permissions are required in relation to input and output parameters in Orchestrator:

• a nivel de paquete: Ver en Paquetes;
• a nivel de proceso: Ver y Editar en Procesos;
• a nivel de trabajo - Crear en Trabajos;
• at schedule level - Create and/or Edit on Schedules.