UiPath Documentation
uipath-cli
latest
false
Importante :
Este contenido se ha traducido mediante traducción automática. La localización de contenidos recién publicados puede tardar entre una y dos semanas en estar disponible.

Guía del usuario de UiPath CLI

UIP son recursos

uip is resources con los objetos de runtime que direcciona un conector: tickets, contactos, registros, archivos. list enumera los objetos del conector, describe devuelve el esquema de campo y las operaciones para un objeto, y execute llama al plano de datos del conector (Crear/Enumerar/Obtener/Actualizar/Reemplazar/Eliminar) contra una conexión. Cada verbo execute requiere --connection-id; las lecturas de metadatos en caché (list, describe) lo aceptan opcionalmente para mostrar objetos/campos personalizados.

Sinopsis

uip is resources <verb> [options]
uip is resources <verb> [options]

Verbos

VerboPropósito
listEnumerar objetos disponibles en un conector; filtrar opcionalmente por operación.
describeDescribir las operaciones y el esquema de campo de un objeto.
executeLlama al plano de datos del conector (Crear/Enumerar/Obtener/Actualizar/Reemplazar/Eliminar).

uip es una lista de recursos

Enumera los objetos disponibles en un conector. Los resultados dependen de si se proporciona --connection-id : los listados de ámbito de conexión incluyen objetos personalizados; los listados sin ámbito no (la CLI muestra un Warning en ese caso).

Argumentos

NombreObligatorioPropósito
<connector-key>Clave del conector, por ejemplo uipath-zoho-desk.

Opciones

CortoLargoValorPredeterminadoDescripción
--operationENUMFiltrar por operación: List, Retrieve, Create, Update, Delete, Replace.
--connection-ididÁmbito a una conexión específica (habilita objetos personalizados).
-t--tenantnamesesión predeterminadaAnula el tenant.
--refreshMarcaDesactivadoFuerza la nueva recuperación desde la API, ignorando la caché.

Ejemplos

uip is resources list uipath-zoho-desk

# Only objects that support a Create operation
uip is resources list uipath-zoho-desk --operation Create

# Connection-scoped listing — includes custom objects
uip is resources list uipath-zoho-desk \
    --connection-id a1b2c3d4-0000-0000-0000-000000000001
uip is resources list uipath-zoho-desk

# Only objects that support a Create operation
uip is resources list uipath-zoho-desk --operation Create

# Connection-scoped listing — includes custom objects
uip is resources list uipath-zoho-desk \
    --connection-id a1b2c3d4-0000-0000-0000-000000000001

Forma de datos (--json de salida)

{
  "Code": "ResourceList",
  "Data": [
    {
      "Name": "tickets",
      "DisplayName": "Tickets",
      "Path": "/tickets",
      "Type": "standard",
      "SubType": "standard",
      "Custom": "no",
      "ElementKey": "uipath-zoho-desk"
    }
  ]
}
{
  "Code": "ResourceList",
  "Data": [
    {
      "Name": "tickets",
      "DisplayName": "Tickets",
      "Path": "/tickets",
      "Type": "standard",
      "SubType": "standard",
      "Custom": "no",
      "ElementKey": "uipath-zoho-desk"
    }
  ]
}

UIP es descripción de recursos

Describir los campos y operaciones de un objeto. --operation, devuelve la lista de operaciones disponibles y una sugerencia. Con --operation, se limita a una operación y devuelve sus parámetros, campos de solicitud y campos de respuesta.

Argumentos

NombreObligatorioPropósito
<connector-key>Clave del conector.
<object-name>Nombre del objeto (por ejemplo, tickets). Buscar nombres con resources list.

Opciones

CortoLargoValorPredeterminadoDescripción
--connection-ididÁmbito a una conexión (habilita campos personalizados).
-t--tenantnamesesión predeterminadaAnula el tenant.
--operationENUMList, Retrieve, Create, Update, Delete o Replace.
--refreshMarcaDesactivadoFuerza la nueva recuperación desde la API, ignorando la caché.

Ejemplos

# List operations available on this object
uip is resources describe uipath-zoho-desk tickets

# Field schema for the Create operation
uip is resources describe uipath-zoho-desk tickets --operation Create

# Required request fields, scripting-friendly
uip is resources describe uipath-zoho-desk tickets --operation Create \
    --output-filter 'Data.requestFields[?required].name'
# List operations available on this object
uip is resources describe uipath-zoho-desk tickets

# Field schema for the Create operation
uip is resources describe uipath-zoho-desk tickets --operation Create

# Required request fields, scripting-friendly
uip is resources describe uipath-zoho-desk tickets --operation Create \
    --output-filter 'Data.requestFields[?required].name'

Forma de datos (--json de salida)

Sin --operation:

{
  "Code": "ResourceMetadata",
  "Data": {
    "name": "tickets",
    "displayName": "Tickets",
    "elementKey": "uipath-zoho-desk",
    "availableOperations": [
      { "method": "GET", "name": "List", "description": "Search for Tickets", "path": "/tickets" },
      { "method": "POST", "name": "Create", "description": "Create a Tickets", "path": "/tickets" }
    ],
    "hint": "Use --operation <Create|List|Retrieve|Update|Delete|Replace> to see fields for a specific operation."
  }
}
{
  "Code": "ResourceMetadata",
  "Data": {
    "name": "tickets",
    "displayName": "Tickets",
    "elementKey": "uipath-zoho-desk",
    "availableOperations": [
      { "method": "GET", "name": "List", "description": "Search for Tickets", "path": "/tickets" },
      { "method": "POST", "name": "Create", "description": "Create a Tickets", "path": "/tickets" }
    ],
    "hint": "Use --operation <Create|List|Retrieve|Update|Delete|Replace> to see fields for a specific operation."
  }
}

Con --operation Create, se devuelve el mismo Code: "ResourceMetadata" , pero en lugar de availableOperations la carga útil lleva operation, parameters, requestFields y responseFields.

UIP es ejecución de recursos

Llama al plano de datos del conector. execute en sí mismo es un grupo; los verbos reales son create, list, get, update, replace y delete. Cada verbo requiere --connection-id; create, update y replace requieren además --body con un cuerpo de solicitud JSON.

uip is resources execute create   <connector-key> <object-name> --connection-id <id> --body <json>
uip is resources execute list     <connector-key> <object-name> --connection-id <id>
uip is resources execute get      <connector-key> <object-name> --connection-id <id> [--query <params>]
uip is resources execute update   <connector-key> <object-name> --connection-id <id> --body <json>
uip is resources execute replace  <connector-key> <object-name> --connection-id <id> --body <json>
uip is resources execute delete   <connector-key> <object-name> --connection-id <id> [--query <params>]
uip is resources execute create   <connector-key> <object-name> --connection-id <id> --body <json>
uip is resources execute list     <connector-key> <object-name> --connection-id <id>
uip is resources execute get      <connector-key> <object-name> --connection-id <id> [--query <params>]
uip is resources execute update   <connector-key> <object-name> --connection-id <id> --body <json>
uip is resources execute replace  <connector-key> <object-name> --connection-id <id> --body <json>
uip is resources execute delete   <connector-key> <object-name> --connection-id <id> [--query <params>]

Asignación de métodos HTTP: create → POST, list → GET (colección), get → GET-by-id, update → PATCH, replace → PUT, delete → DELETE.

Argumentos

NombreObligatorioPropósito
<connector-key>Clave del conector.
<object-name>Nombre del objeto (por ejemplo, tickets).

Opciones compartidas

CortoLargoValorPredeterminadoDescripción
--connection-ididobligatorioConexión utilizada para autorizar la llamada del plano de datos.
-t--tenantnamesesión predeterminadaAnula el tenant.
--queryParámetrosParámetros de consulta. Acepta key=value&key=value o un objeto JSON.
--bodyJSONCuerpo de la solicitud. Obligatorio para create, update, replace.

Ejemplos

# Create a ticket
uip is resources execute create uipath-zoho-desk tickets \
    --connection-id a1b2c3d4-0000-0000-0000-000000000001 \
    --body '{"subject":"New issue","departmentId":"DEP-1"}'

# List tickets — first page
uip is resources execute list uipath-zoho-desk tickets \
    --connection-id a1b2c3d4-0000-0000-0000-000000000001

# Delete a ticket by ID
uip is resources execute delete uipath-zoho-desk tickets \
    --connection-id a1b2c3d4-0000-0000-0000-000000000001 \
    --query 'id=TK-1001'
# Create a ticket
uip is resources execute create uipath-zoho-desk tickets \
    --connection-id a1b2c3d4-0000-0000-0000-000000000001 \
    --body '{"subject":"New issue","departmentId":"DEP-1"}'

# List tickets — first page
uip is resources execute list uipath-zoho-desk tickets \
    --connection-id a1b2c3d4-0000-0000-0000-000000000001

# Delete a ticket by ID
uip is resources execute delete uipath-zoho-desk tickets \
    --connection-id a1b2c3d4-0000-0000-0000-000000000001 \
    --query 'id=TK-1001'

Forma de datos (--json de salida)

{
  "Code": "ExecuteOperation",
  "Data": { "id": "TK-1001", "subject": "New issue", "status": "Open" }
}
{
  "Code": "ExecuteOperation",
  "Data": { "id": "TK-1001", "subject": "New issue", "status": "Open" }
}

Las operaciones list devuelven { "items": [...] } y, cuando el backend señala más páginas a través de encabezados Elements-Has-More / Elements-Next-Page-Token , incluye un objeto Pagination con HasMore y NextPageToken.

Las llamadas fallidas emergen con Failure, el estado HTTP como Message y el cuerpo del servidor como Instructions.

  • uip is connections — Los valores --connection-id provienen de connections list / connections create.
  • uip is connectors : descubre primero la clave del conector.
  • uip is activities : consulta las operaciones con nombre que expone un conector.
  • uip is triggers : contrapartes impulsadas por eventos de los verbos del plano de datos aquí.

Ver también

¿Te ha resultado útil esta página?

Conectar

¿Necesita ayuda? Soporte

¿Quiere aprender? UiPath Academy

¿Tiene alguna pregunta? Foro de UiPath

Manténgase actualizado