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, especialmente al crear el conector para un público más amplio. 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 Generador 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

En la configuración de autenticación, los detalles se localizan dentro de la tabla que enumera todos los parámetros, sin tener en cuenta el tipo de autenticación. La tabla proporciona una rápida edición en línea o una pantalla más avanzada utilizando el menú Más opciones .

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}.

Cuando añades 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.

Para definir una variable para un parámetro, selecciona el menú Más opciones .

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 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}.