Utilizar variables en el Creador de conectores

Muchas aplicaciones de terceros con las que UiPath® puede conectarse requieren algún tipo de configuración dinámica, específicamente al crear el conector para una audiencia más amplia. La URL base puede requerir un parámetro de organización, cada llamada a la API puede requerir una entrada que se devolvió en la autenticación, etc.

Como hay varias formas de resolver este problema, la más fácil es utilizar variables como {organizationId} o responseKey para este tipo de procesos.

En esta página se describen las áreas dentro del Creador de conectores donde puedes añadir estas variables y cómo hacerlo.

Nota:

La notación de variables utilizada en el Creador de conectores son solo cadenas que utilizan llaves, es decir, {myVariable}.

URL base

La URL base es la URL utilizada de forma predeterminada para cualquier solicitud HTTP. En muchos casos, esta URL es estática para la aplicación de terceros y, como tal, el uso de variables está fuera del alcance. Algunos proveedores requieren dirigir todas las llamadas a la API a tu instancia específica de su aplicación o añadir algún tipo de identificador en la ruta base que identifique tu identidad.

Usemos el ejemplo de la conexión a tu instancia de UiPath Orchestrator, que requiere los detalles de la organización y el tenant en la URL base. Se utiliza más adelante como ruta base para cualquier solicitud futura. Cuando los usuarios importan este conector en su tenant y crean una conexión, puedes pedirles esa información añadiendo estos parámetros como variables y solicitándolos en la pantalla de autenticación.

Para ello, empieza añadiendo las variables en la URL base con notación {organization} y {tenant} .

Autenticación

In the authentication setup, the details are localized within the table that lists all parameters, disregarding the Authentication type. The table provides a quick inline Edit option or a more advanced screen by using the More options menu .

En el ejemplo de la API de Orchestrator, queremos añadir dos parámetros adicionales a la tabla, porque necesitamos que el usuario que crea una conexión proporcione entrada para {organization} y {tenant}.

Al añadir un nuevo parámetro de autenticación, debes establecer el Nombre (cómo quieres que se muestre un campo específico en la pantalla de conexión), su Valor (que puedes dejar vacío) y el campo Preguntar al usuario , si quieres que se requerirá durante la autenticación.

To define a variable for a parameter, select the More options menu .

En este ejemplo, el parámetro Nombre de la organización , que se solicita al usuario (Preguntar al usuario está establecido en Sí), se envía al proveedor como organización (nombre) y ruta (tipo).

Se hace lo mismo para el tenant. A continuación, en la pantalla de autenticación, Nombre de la organización y Nombre del tenant son campos obligatorios, y la organización y el tenant forman parte de la URL base.

Enviar solicitudes

El uso de variables en tus recursos funciona de forma muy similar. Y después de importar archivos swagger, es posible que esto ya sea visible en los recursos que son GETBYID que toman un {id} que luego también se representa en la sección de parámetros.

Para Orchestrator, el siguiente ejemplo utiliza esa variable para {key}.