- Primeros pasos
- La definición de Swagger
- Ejemplos de uso de la API de Orchestrator
- Solicitudes de alertas
- Solicitudes de activos
- Solicitudes de calendario
- Solicitudes de entornos
- Solicitudes de carpetas
- Solicitudes de tareas genéricas
- Solicitudes de trabajos
- Solicitudes de bibliotecas
- Solicitudes de licencia
- Solicitudes de paquetes
- Solicitudes de permisos
- Solicitudes de espacios de trabajo personales
- Solicitudes de procesos
- Solicitudes de elementos en cola
- Solicitudes de política de retención de cola
- Solicitudes de robots
- Solicitudes de roles
- Solicitudes de horarios
- Solicitudes de configuración
- Solicitudes de cubos de almacenamiento
- Solicitudes de tareas
- Solicitudes de catálogos de tareas
- Solicitudes de formularios de tareas
- Solicitudes de tenants
- Solicitudes de transacciones
- Solicitudes de usuario
- Solicitudes de Webhooks
- API de gestión de plataformas
Crear solicitudes de API
FolderId, FolderPatho FolderKey en un encabezado HTTP. Este encabezado puede estar codificado (usando la codificación Base64 UTF-16LE) o como texto sin formato.
Por ejemplo:
X-UIPATH-OrganizationUnitId "FolderId":X-UIPATH-FolderPath-Encoded "{Encoded FolderPath value}":X-UIPATH-FolderPath "PlainText FolderPath value"oX-UIPATH-FolderKey "FolderKey".
FolderId se puede obtener realizando una solicitud GET al punto final /odata/Folders y copiando el valor "Id", o desde la URL de Orchestrator: https://your-domain-server.com/?fid=2032&tid=8. FolderId es de tipo Int 64.
FolderKey se puede obtener realizando una solicitud GET al punto final /odata/Folders y copiando el valor de la "Clave". FolderKey es de tipo ID / cadena únicos.
FolderId también cambia, mientras que el valor FolderKey permanece igual.
Si actualizó y tenía unidades de organización habilitadas en la instancia anterior de Orchestrator, cada unidad organizativa se migra como una nueva carpeta clásica.
X-UIPATH-FolderPath-Encoded se admiten rutas de carpeta relativas, de la siguiente manera:
/rootRuta a partir de : se inicia desde la carpeta de arbol de la que forma parte la carpeta de entorno..La ruta con : se inicia desde la carpeta de entorno.- La ruta a partir de
..: inicia en un nivel superior de la jerarquía de la carpeta de entorno para cada..en la ruta (p. ej.../para un nivel superior,../../para dos niveles superiores en la jerarquía).
Ten en cuenta que no se admiten las barras diagonales finales.
Las solicitudes GET suelen ser las más simples de realizar. Le ayudan a recuperar datos y a usar cláusulas OData genéricas:
- $ top
- $filter
- $ expandir
- $ seleccionar
- $ pedido por
- $skip
Esta cláusula le ayuda a limitar la cantidad de datos que recupera. Tiene un límite superior que está determinado por el punto final al que está realizando llamadas y el número de recursos de este tipo que existen en sus instancias de Orchestrator.
https://{yourDomain}/odata/Environments?$top=10 devuelve los primeros 10 entornos disponibles en Community Edition de Orchestrator. Sin embargo, si solo existen 5 entornos, solo se recuperan.
Esta cláusula OData se utiliza para filtrar un recurso específico según sus propiedades.
Por ejemplo, se puede filtrar según:
-
propiedades numéricas:
https://{yourDomain}/odata/Environments?$filter=Id%20eq%2015: solicita un entorno específico en función de su ID
-
propiedades del texto:
https://{yourDomain}/odata/Environments?$filter=contains(Name,'N')&$top=10: devuelve los 10 primeros entornos cuyo nombre contiene la letra "N"
-
propiedades Boolean:
https://{yourDomain}/odata/Processes?$filter=Title%20eq%20'test'%20%26%20IsLatestVersion%20eq%20true: devuelve todos los procesos que contienen la palabra "prueba" y representan la última versión
-
propiedades enumerables:
https://{yourDomain}/odata/QueueItems?$filter=Priority%20eq%20'High': devuelve todos los artículos en cola con prioridad alta
-
la propiedad de una propiedad:
https://{yourDomain}/odata/Jobs?$top=10$filter=Robot/MachineName%20eq%20'Documentation': devuelve los primeros 10 trabajos ejecutados por cualquier robot que exista en la máquina de "Documentación"
Los parámetros de filtro se pueden combinar usando los operadores lógicos "y", "o" y / o "no" y se pueden agrupar con paréntesis "()", como la siguiente solicitud:
https://{yourDomain}/odata/Jobs?$top=10&$filter=Robot/MachineName eq 'LAVINIA-PC' and (not(Source eq 'Manual') or StartTime gt 2017-10-28T12:13:00.07Z): muestra los 10 principales trabajos que se están ejecutando manualmente o después del "2017-10-28T12: 13: 00.07Z", por un Robot implementado en la máquina "LAVINIA-PC".
Esta cláusula se utiliza para cargar completamente las propiedades de navegación del recurso solicitado.
Esta cláusula OData te permite especificar un subconjunto de propiedades del recurso que deseas que se devuelvan. Si quieres extraer varios recursos, puedes separarlos con una coma.
$orderby te permite ordenar los recursos recuperados. Al igual que con la cláusula $select , los recursos que deseas ordenar están separados por comas y se pueden ordenar en orden ascendente (asc) o descendente (desc). Si no se especifica ninguno de estos operadores, los recursos se ordenan automáticamente de manera ascendente.
El verbo POST HTTP le ayuda a crear nuevos elementos subordinados a otros recursos. Al crear un nuevo recurso, PUBLICAR en el elemento principal y Orchestrator se encargará de asociar el nuevo recurso con el elemento principal, asignar una ID y otra información necesaria. Los datos se agregan a través del cuerpo de la solicitud y la respuesta es el objeto creado completo.
Puede agregar nuevos elementos a una cola, crear nuevos activos, entornos o procesos, asignar un revisor a una o varias transacciones fallidas y la lista continúa.
"Parameter@odata.type": "#String". Para entender mejor, consulte cómo se rellenó el parámetro Specific Content en el siguiente ejemplo.
Id en la URL. Ten en cuenta que una llamada PUT reemplaza la entidad existente con el contenido de la solicitud o, si no existe en la ubicación designada, intenta crearla.
Es posible actualizar colas, entornos, unidades de organización, comentarios sobre transacciones, procesos y detalles de otros recursos.
Id en la URL. El cuerpo de la solicitud contiene solo los contenidos que quieres cambiar. Esto se distingue de una llamada PUT que reemplaza la entidad actual con el contenido de la solicitud posterior.
Es posible utilizar una solicitud de PATCH para actualizar Máquinas, Procesos, Robots, Tenants, Usuarios (excepto la Unidad de Organización y los Roles) y las entidades de Webhooks.
El uso de este verbo HTTP te permite marcar un elemento especificado como eliminado en la base de datos. El recurso generalmente se indica con la ayuda de su ID en la URL a la que realiza la llamada. Una respuesta 209 debe informarle que su solicitud se ha realizado correctamente.
Es posible eliminar activos, entornos, comentarios de elementos de la cola, procesos, roles, tenants, usuarios y muchos otros.
