Herramientas de UIP

Sintaxis y opciones para `herramientas de uip`, que instala, actualiza y elimina las herramientas basadas en npm que amplían UiPath CLI.

uip tools las herramientas instalables que amplían la CLI. Consulta Herramientas (complementos) para conocer el concepto.

Para saber cómo controlar la instalación automática en los ejecutores CI, consulta Control de la instalación automática de la herramienta.

Sinopsis

uip tools list
uip tools search [<query>]
uip tools install <package-spec>
uip tools update [--name <package>]
uip tools uninstall [<package>] [--all]

Todos los subcomandos uip tools respetan las opciones globales (--output, --output-filter, --log-level, --log-file). Los códigos de salida siguen el contrato estándar.

lista de herramientas de uip

Enumera las herramientas instaladas actualmente junto con la CLI.

Argumentos

Nada.

Opciones

Nada.

Ejemplo

uip tools list --output table

Forma de datos (--output json)

{
  "Code": "ToolList",
  "Data": [
    {
      "name": "@uipath/orchestrator-tool",
      "version": "1.0.2",
      "commandPrefix": "or"
    },
    {
      "name": "@uipath/solution-tool",
      "version": "1.0.1",
      "commandPrefix": "solution"
    }
  ]
}

commandPrefix es el alias de nivel superior que escribes, por ejemplo, or para Orchestrator. Úsalo para confirmar qué se ejecutará realmente uip <prefix> … .

Búsqueda de herramientas UIP

Busca en el catálogo de herramientas de UiPath las herramientas que puedes instalar. Los resultados se filtran a las herramientas @uipath/ de la lista de permitidas (incluida rpa-legacy, que requiere una instalación explícita). Los paquetes de terceros no se devuelven.

Argumentos

• <query> (opcional) : coincidencia de subcadena con el nombre y la descripción del paquete. Sin ella, se enumeran todas las herramientas de la lista de permitidas.

Opciones

Nada.

Ejemplo

uip tools search orchestrator

Forma de datos (--output json)

{
  "Code": "SearchResult",
  "Data": [
    {
      "name": "@uipath/orchestrator-tool",
      "latestVersion": "1.0.2",
      "description": "Orchestrator jobs, folders, processes, packages, and resources",
      "availableVersions": ["1.0.0", "1.0.1", "1.0.2"]
    }
  ]
}

Buscar lecturas desde el registro npm configurado para el ámbito @uipath (normalmente https://registry.npmjs.org/ a través de la configuración predeterminada de npm o un registro anulado establecido en tu .npmrc). Los resultados se filtran del lado del cliente en función de la lista de permisos, por lo que se omite cualquier paquete @uipath/ que no esté en la lista de permisos.

Instalación de herramientas de UIP

Instala una herramienta de la lista de permisos desde npm.

Argumentos

• <package-spec> (obligatorio) : la herramienta a instalar. Cualquiera de:
  • Alias de comando: or, solution, tm, is, vss, df, …
  • Nombre corto: orchestrator-tool, solution-tool, …
  • Nombre completo de npm: @uipath/orchestrator-tool, @uipath/solution-tool, …
  • Con versión explícita: orchestrator-tool@1.0.2, @uipath/orchestrator-tool@1.0.2. El valor después de @ debe ser una cadena de servidor válida (por ejemplo 1.0.2 o 1.0.0-preview.1): un nombre de canal simple como @beta se rechaza con un ValidationError.

Opciones

Nada.

Ejemplos

# by alias — simplest
uip tools install or

# by short name
uip tools install orchestrator-tool

# by full npm name
uip tools install @uipath/orchestrator-tool

# specific version
uip tools install orchestrator-tool@1.0.2

# exact preview build
uip tools install orchestrator-tool@1.0.0-preview.1

# preview channel — switch the channel, then install normally
uip config set updateChannel preview
uip tools install orchestrator-tool

Resolución de la versión

• Con una versión explícita del servidor (p. ej. @1.0.2 o @1.0.0-preview.1), esa versión se utiliza tal cual. No existe una abreviatura npm-dist-tag como @beta: el valor después de @ debe analizarse como semver, o el comando falla con un ValidationError.
• Sin una versión, el host se resuelve contra el canal de actualización de CLI (stable de forma predeterminada, o preview/dev a través de uip config set updateChannel <channel>) y su línea MAYOR.MINOR actual, por lo que se instala stable CLI 1.0.x la última herramienta estable coincidente 1.0.*. Esto mantiene el host y la herramienta compatibles con el protocolo. Consulta Control de versiones y estabilidad y uip config.

Destino de instalación: la herramienta se instala junto al paquete npm de CLI: globalmente si CLI es una instalación global, localmente si CLI es una instalación de ámbito de proyecto. No pasas un marcador de ámbito. Ejecuta npm root -g para encontrar la ruta de instalación global en tu máquina.

Aplicación de la lista de permitidos: <package-spec> debe resolverse en uno de los paquetes @uipath/ de la lista de permitidos (o rpa-legacy). Cualquier otro valor falla con ValidationError y el código de salida 3: las herramientas de terceros no son compatibles con 1.x.

Forma de datos (--output json)

{
  "Code": "Message",
  "Data": { "Message": "Successfully installed @uipath/orchestrator-tool@1.0.2" }
}

actualización de herramientas de UIP

Actualiza una o más herramientas instaladas a la última versión compatible.

Argumentos

Nada.

Opciones

• --name <package> : actualiza una sola herramienta. Acepta alias, nombre corto o nombre completo de npm. Sin --name, se actualizan todas las herramientas instaladas.

Importante:

No hay ningún marcador --version en uip tools update: solo --name está registrado. Cada herramienta se actualiza a la última versión permitida por la política de versión activa (normalmente anclada a la línea MAYOR.MINOR de CLI); para anclar una versión específica en su lugar, utiliza uip config set version <line> o reinstala con una versión explícita a través de uip tools install <package>@<version>.

Ejemplos

# update every installed tool to the latest version within the CLI's major.minor line
uip tools update

# update just the Orchestrator tool
uip tools update --name or

Forma de datos (--output json)

{
  "Code": "UpdateResult",
  "Data": [
    {
      "name": "orchestrator-tool",
      "status": "updated",
      "from": "1.2.2",
      "to": "1.2.3"
    },
    {
      "name": "agent-tool",
      "status": "up-to-date",
      "from": "1.2.3",
      "to": "1.2.3"
    }
  ]
}

Los resultados por herramienta siempre se emiten, incluso en caso de fallo parcial. Si alguna herramienta no se actualiza, el comando sale con un código de salida distinto de cero y las entradas que fallan llevan un campo error .

Si core.version está anclado a una versión exacta (no a una línea MAJOR.MINOR), la actualización se omite por completo: el comando sigue saliendo de 0 con una matriz Data vacía y una nota Instructions que explica el anclaje, ya que una instalación anclada intencionadamente nunca se mueve.

Desinstalación de herramientas UIP

Elimina una herramienta instalada o todas las herramientas instaladas a la vez.

Argumentos

• [package-name] opcional) : alias, nombre corto o nombre completo de npm. Mutuamente exclusivo con --all. Proporciona exactamente uno de los argumentos o --all: omitir ambos, o pasar ambos, es un ValidationError.

Opciones

• --all: desinstala todas las herramientas instaladas. Mutuamente exclusivo con [package-name].

Ejemplos

# uninstall a single tool
uip tools uninstall orchestrator
uip tools uninstall @uipath/solution-tool

# uninstall every installed tool
uip tools uninstall --all

Forma de datos (--output json)

Desinstalar una sola herramienta emite Code: "Message":

{
  "Code": "Message",
  "Data": { "Message": "Successfully uninstalled @uipath/orchestrator-tool" }
}

--all emite Code: "UninstallResult" con una fila por herramienta:

{
  "Code": "UninstallResult",
  "Data": [
    { "name": "orchestrator-tool", "status": "uninstalled" },
    { "name": "agent-tool", "status": "uninstalled" }
  ]
}

Si alguna herramienta no se desinstala en la ruta --all, su fila lleva un campo error y el comando sale con un código de salida distinto de cero: se sigue emitiendo el desglose completo por herramienta.

Después de la desinstalación, al invocar uip or … se instalará automáticamente la herramienta Orchestrator de nuevo en el próximo uso, a menos que la instalación automática esté bloqueada (por ejemplo, en un ejecutor sin acceso a la red). Instala explícitamente para evitar eso.

Códigos de salida

• 0 : correcto.
• 1 — fallo (instalación, actualización, desinstalación o un error en el nivel de herramienta). Para update con varias herramientas, al menos una falló.
• 3 — error de validación (alias desconocido, paquete no incluido en la lista de permitidos, cadena de versión no válida) en install y update.

Los propios errores de validación de argumentos de uninstall (falta el nombre del paquete o --all combinado con un nombre de paquete) dan salida a 1 en lugar de 3, aunque el cuerpo de la respuesta sigue informando Result: "ValidationError" — rama en Result/ErrorCode en el cuerpo JSON en lugar del código de salida si necesitas distinguir este caso de otros fallos.

Consulta Códigos de salida para ver la tabla completa.

Ver también

• Herramientas (complementos) : el modelo de complemento, la fijación de la versión, la ubicación de la instalación y el soporte de terceros.
• Instalar UiPath CLI : instala el host y luego incorpora las herramientas.
• Control de la instalación automática de la herramienta : por qué no hay opción de exclusión y cómo mantener los tiempos de compilación de CI deterministas.
• Control de versiones y estabilidad : contrato de servidor en host y herramientas.