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

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

• En el nivel de proceso: en la pestaña Parámetros de la ventana Ver proceso, como se explica aquí.
• En el nivel de trabajo: en la pestaña Parámetros de la ventana Iniciar trabajo, como se explica aquí.

• A nivel de programación: en la pestaña Parámetros de la ventana Añadir programación, tal y 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.

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 de entrada, pero hay que tener en cuenta que Orchestrator solo valida los primitivos.

API de Orchestrator

• En nivel de paquete: a punto final /odata/Processes/UiPath.Server.Configuration.OData.SetArguments(key='key');
• En nivel de proceso: como una solicitud PATCH al punto final /odata/Releases(Id);
• En nivel de trabajo: como una solicitud POST al punto final /odata/Jobs/UiPath.Server.Configuration.OData.StartJobs;

• En nivel de programación: como una solicitud POST al /odata/ProcessSchedulespunto final.

  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.

Visualización de valores de parámetros

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

• Sin valor: no se proporcionó ningún valor para el parámetro en el nivel de proceso, trabajo, programación o 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 existen valores de los parámetros de entrada o salida, se muestran en la ventana Detalles del trabajo. Los valores de entrada se mostrarán en la ventana mencionada en los siguientes casos:

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

También puedes ver los parámetros de entrada y salida en el 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.

Permisos

Se necesitan los siguientes permisos en relación a los parámetros 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 el nivel de programación: crear y/o editar en programaciones.