- Información general
- Comience ya
- Conceptos
- Uso de UiPath CLI
- Guías prácticas
- Recetas de CI/CD
- Referencia de los comandos
- Información general
- Códigos de salida
- Opciones globales
- agente de código UIP
- codificador UIP
- Contextualización de UIP
- UIP Docsai
- Función uip
- barreras de seguridad de UIP
- Configuración de UIP llm
- puerta de enlace llm de uip
- Creación de UIP Maestro
- Registro maestro de UIP
- UIP model-hub
- Actividades Buscar
- actividades get-default-xaml
- Analizar
- lista de reglas del analizador
- Crear
- Limpieza
- instalación de data-fabric-entities
- lista de entidades de data-fabric
- diferencia de archivos
- obtener-repositorio-de-objetos-de-biblioteca
- obtener-objeto-repositorio
- Init
- lista de instancias
- Paquete
- inspeccionar paquetes
- instalación de paquetes
- versiones de paquetes
- Publicar
- Remoto
- restore
- ejecutar, depurar & Ejecución
- Configuración
- Inicio de Studio
- Búsqueda de plantillas
- entidad de adición de datos de prueba
- añadir-cola de datos de prueba
- añadir-variación de los datos de prueba
- TM
- UIA
- Validar
- ejemplos-de-flujo-de-flujo-obtener
- lista de ejemplos de flujo de trabajo
- Tareas de UIP
- Archivo adjunto
- Campo personalizado
- Defects
- Ejecuciones
- exportar-trabajos
- Migración
- EtiquetaDeObjeto
- Paquete
- escenario de rendimiento
- grupos de carga de escenarios de rendimiento
- datos de ejecución de perf-scenario
- informe de escenario de rendimiento
- Proyecto
- permisos del proyecto
- Solicitudes
- Informar
- Requisitos
- Resultado
- Iniciar
- Programaciones
- scopes
- Registro de casos de prueba
- Casos de prueba
- Conjuntos de prueba
- registro de pasos de prueba
- Usuario
- Esperar
- Seguimientos de UIP
- Comentarios de seguimientos de UIP
- Migración
- Referencia y soporte
uip o procesos
Sintaxis y opciones para `uip o procesos`, que gestiona las vinculaciones de carpetas de paquetes a procesos ejecutables en Orchestrator.
uip or processes las vinculaciones ejecutables de paquetes a carpetas, lo que Orchestrator llama internamente Versiones. Un proceso es lo que uip or jobs start apunta; un paquete es el artefacto .nupkg subyacente (consulta uip or packages).
Sinopsis
uip or processes <verb> [options]
uip or processes <verb> [options]
Verbos
| Verbo | Propósito |
|---|---|
list | Enumera los procesos en una carpeta o en cada carpeta del tenant. |
get | Obtener un proceso por clave, incluidos los esquemas de argumentos y la retención. |
resources | Enumera los recursos del paquete (colas, activos, depósitos, conexiones) requeridos por un proceso. |
version-history | Enumera el historial cronológico de versiones de paquetes para un proceso. |
create | Vincula un paquete a una carpeta como un nuevo proceso. |
update-version | Actualiza uno o más procesos a la última versión del paquete (o a una específica). |
update (alias edit) | Actualizar la configuración del proceso (semántica PATCH en los campos seleccionados). |
delete | Eliminar un proceso vinculado por clave (no elimina el paquete). |
rollback | Revierte un proceso a su versión anterior del paquete. |
uip o lista de procesos
Enumera los procesos en una carpeta (--folder-path o --folder-key), o en cada carpeta del tenant con --all-folders. Devuelve la clave del proceso (GUID), el nombre, la versión, la carpeta y la configuración de retención.
Opciones
| Corto | Largo | Valor | Predeterminado | Descripción |
|---|---|---|---|---|
| — | --folder-path | Ruta | — | Carpeta de destino por ruta. |
| — | --folder-key | GUID | — | Carpeta de destino por clave. |
| — | --all-folders | Marca | Desactivado | Listado de todo el tenant. Mutuamente exclusivo con --folder-path/--folder-key. |
-n | --name | text | — | Contiene coincidencia en el nombre del proceso. |
| — | --process-type | ENUM | — | Process, Agent, Flow, TestAutomationProcess, WebApp, Api, MCPServer, BusinessRules, CaseManagement, Function. |
| — | --all-fields | Marca | Desactivado | Devuelve la carga útil de la API completa. |
-l | --limit | Número | 50 | Tamaño de la página. |
| — | --offset | Número | 0 | Omitir recuento. |
| — | --sort-by | Campo | Id desc | Ordenación de OData. |
Ejemplos
uip or processes list --folder-path "Shared"
uip or processes list --folder-path "Shared" --process-type Agent
uip or processes list --limit 50 --folder-path "Shared" \
--output-filter '[].{key:Key, name:Name, v:ProcessVersion}'
# Tenant-wide audit across every folder
uip or processes list --all-folders --name "Invoice"
uip or processes list --folder-path "Shared"
uip or processes list --folder-path "Shared" --process-type Agent
uip or processes list --limit 50 --folder-path "Shared" \
--output-filter '[].{key:Key, name:Name, v:ProcessVersion}'
# Tenant-wide audit across every folder
uip or processes list --all-folders --name "Invoice"
Forma de datos (--json de salida)
{
"Code": "ProcessList",
"Data": [
{
"Key": "c3d4e5f6-0000-0000-0000-000000000001",
"Name": "InvoiceProcessing",
"ProcessKey": "InvoiceProcessing",
"ProcessVersion": "1.0.2",
"Description": "",
"IsLatestVersion": true,
"FolderKey": "f0f0f0f0-0000-0000-0000-000000000001",
"FolderPath": "Shared",
"RetentionPeriod": 30,
"RetentionAction": "Delete"
}
],
"Pagination": { "Returned": 1, "Limit": 50, "Offset": 0, "HasMore": false }
}
{
"Code": "ProcessList",
"Data": [
{
"Key": "c3d4e5f6-0000-0000-0000-000000000001",
"Name": "InvoiceProcessing",
"ProcessKey": "InvoiceProcessing",
"ProcessVersion": "1.0.2",
"Description": "",
"IsLatestVersion": true,
"FolderKey": "f0f0f0f0-0000-0000-0000-000000000001",
"FolderPath": "Shared",
"RetentionPeriod": 30,
"RetentionAction": "Delete"
}
],
"Pagination": { "Returned": 1, "Limit": 50, "Offset": 0, "HasMore": false }
}
FolderId se añade a cada fila solo cuando se utiliza --all-folders.
uip o procesos get
Obtener un proceso por clave GUID. Devuelve la versión, el punto de entrada, los esquemas de argumentos de entrada/salida, el tipo de proceso y la configuración. La clave se resuelve en todo el tenant de forma predeterminada. Pasa --folder-path o --folder-key para establecer el ámbito de la búsqueda en una carpeta, lo que requiere una identidad con acceso a una sola carpeta (como una aplicación externa).
Argumentos
| Nombre | Obligatorio | Propósito |
|---|---|---|
<process-key> | Sí | Clave de proceso (GUID). Encuéntralo con processes list. |
Opciones
| Corto | Largo | Valor | Predeterminado | Descripción |
|---|---|---|---|---|
| — | --folder-path | Ruta | — | Ámbito de la búsqueda a esta carpeta en lugar de resolver la clave en todo el tenant. |
| — | --folder-key | GUID | — | Ámbito de la búsqueda a esta carpeta en lugar de resolver la clave en todo el tenant. |
| — | --all-fields | Marca | Desactivado | Devuelve la carga útil de la API completa. |
Ejemplos
uip or processes get c3d4e5f6-0000-0000-0000-000000000001
uip or processes get c3d4e5f6-0000-0000-0000-000000000001 --all-fields
uip or processes get c3d4e5f6-0000-0000-0000-000000000001 \
--output-filter 'InputArguments'
uip or processes get c3d4e5f6-0000-0000-0000-000000000001
uip or processes get c3d4e5f6-0000-0000-0000-000000000001 --all-fields
uip or processes get c3d4e5f6-0000-0000-0000-000000000001 \
--output-filter 'InputArguments'
Forma de datos (--json de salida)
{
"Code": "ProcessGet",
"Data": {
"Key": "c3d4e5f6-0000-0000-0000-000000000001",
"Name": "InvoiceProcessing",
"ProcessKey": "InvoiceProcessing",
"ProcessVersion": "1.0.2",
"Description": "Processes vendor invoices",
"IsLatestVersion": true,
"ProcessType": "Process",
"EntryPointPath": "Main.xaml",
"InputArguments": "{\"invoicePath\":\"String\"}",
"FolderKey": "a1b2c3d4-0000-0000-0000-000000000001",
"FolderPath": "Shared",
"AutoUpdate": false,
"TargetFramework": "Windows",
"JobPriority": "Normal",
"SpecificPriorityValue": 50,
"RetentionPeriod": 30,
"RetentionAction": "Delete",
"StaleRetentionPeriod": 0,
"StaleRetentionAction": "None",
"HiddenForAttendedUser": false,
"AutoCreateConnectedTriggers": false
}
}
{
"Code": "ProcessGet",
"Data": {
"Key": "c3d4e5f6-0000-0000-0000-000000000001",
"Name": "InvoiceProcessing",
"ProcessKey": "InvoiceProcessing",
"ProcessVersion": "1.0.2",
"Description": "Processes vendor invoices",
"IsLatestVersion": true,
"ProcessType": "Process",
"EntryPointPath": "Main.xaml",
"InputArguments": "{\"invoicePath\":\"String\"}",
"FolderKey": "a1b2c3d4-0000-0000-0000-000000000001",
"FolderPath": "Shared",
"AutoUpdate": false,
"TargetFramework": "Windows",
"JobPriority": "Normal",
"SpecificPriorityValue": 50,
"RetentionPeriod": 30,
"RetentionAction": "Delete",
"StaleRetentionPeriod": 0,
"StaleRetentionAction": "None",
"HiddenForAttendedUser": false,
"AutoCreateConnectedTriggers": false
}
}
recursos uip o de procesos
Enumera los recursos del paquete (colas, activos, depósitos, conexiones y otros requisitos del paquete) a los que hace referencia un proceso. Resuelve la carpeta del proceso automáticamente; no se necesita ningún marcador de carpeta.
ResourceName, FolderPath y ResourceId informan de lo que declara el paquete. Cuando el proceso vuelve a vincular un recurso a un destino diferente, IsOverwritten es true y los campos Overwrite* describen el destino al que se vincula el proceso:
| Campo | Descripción |
|---|---|
IsOverwritten | true cuando el proceso vuelve a vincular el recurso; false de lo contrario. |
OverwriteName | Nombre para mostrar del recurso de destino. Vacío cuando el recurso no es de rebote. |
OverwriteEntityId | ID de Orchestrator del recurso de destino. Vacío cuando el recurso no es de rebote. |
OverwriteFolderId | ID de la carpeta que contiene el recurso de destino. null cuando el recurso no es de rebote. |
OverwriteProperties | Pares de nombre/valor de propiedad que definen el destino, por ejemplo name y folderPath. Las claves se devuelven exactamente como las almacena Orchestrator. {} cuando el recurso no es de rebote. |
Con --all-fields, cada fila lleva el recurso API sin procesar más un objeto Overwrite (null cuando el recurso no es de rebote).
Argumentos
| Nombre | Obligatorio | Propósito |
|---|---|---|
<process-key> | Sí | Clave de proceso (GUID). Encuéntralo con processes list. |
Opciones
| Corto | Largo | Valor | Predeterminado | Descripción |
|---|---|---|---|---|
| — | --all-fields | Marca | Desactivado | Devuelve la carga útil de la API completa en lugar del resumen seleccionado. |
Ejemplos
uip or processes resources c3d4e5f6-0000-0000-0000-000000000001
uip or processes resources c3d4e5f6-0000-0000-0000-000000000001 --all-fields
uip or processes resources c3d4e5f6-0000-0000-0000-000000000001
uip or processes resources c3d4e5f6-0000-0000-0000-000000000001 --all-fields
Forma de datos (--json de salida)
{
"Code": "ProcessResources",
"Data": [
{
"ResourceType": "Queue",
"ResourceName": "InvoiceQueue",
"FolderPath": "Shared",
"ValidationResult": "Success",
"ValidationError": "",
"IsOverwritable": true,
"ResourceKey": "InvoiceQueue",
"ResourceId": "123456",
"Id": 0,
"IsOverwritten": false,
"OverwriteName": "",
"OverwriteEntityId": "",
"OverwriteFolderId": null,
"OverwriteProperties": {}
}
]
}
{
"Code": "ProcessResources",
"Data": [
{
"ResourceType": "Queue",
"ResourceName": "InvoiceQueue",
"FolderPath": "Shared",
"ValidationResult": "Success",
"ValidationError": "",
"IsOverwritable": true,
"ResourceKey": "InvoiceQueue",
"ResourceId": "123456",
"Id": 0,
"IsOverwritten": false,
"OverwriteName": "",
"OverwriteEntityId": "",
"OverwriteFolderId": null,
"OverwriteProperties": {}
}
]
}
Un recurso que el proceso vuelve a vincular a una carpeta diferente:
{
"Code": "ProcessResources",
"Data": [
{
"ResourceType": "App",
"ResourceName": "ApprovalApp",
"FolderPath": "Dev/Apps",
"ValidationResult": "Success",
"ValidationError": "",
"IsOverwritable": true,
"ResourceKey": "Dev/Apps.ApprovalApp",
"ResourceId": "555001",
"Id": 0,
"IsOverwritten": true,
"OverwriteName": "ApprovalApp",
"OverwriteEntityId": "777002",
"OverwriteFolderId": 4412,
"OverwriteProperties": {
"name": "ApprovalApp",
"folderPath": "Prod/Apps"
}
}
]
}
{
"Code": "ProcessResources",
"Data": [
{
"ResourceType": "App",
"ResourceName": "ApprovalApp",
"FolderPath": "Dev/Apps",
"ValidationResult": "Success",
"ValidationError": "",
"IsOverwritable": true,
"ResourceKey": "Dev/Apps.ApprovalApp",
"ResourceId": "555001",
"Id": 0,
"IsOverwritten": true,
"OverwriteName": "ApprovalApp",
"OverwriteEntityId": "777002",
"OverwriteFolderId": 4412,
"OverwriteProperties": {
"name": "ApprovalApp",
"folderPath": "Prod/Apps"
}
}
]
}
UIP o el historial de versiones de los procesos
Enumera el historial cronológico de versiones de paquetes asociado a un proceso. La carpeta es opcional: si no se proporciona, se infiere de la clave del proceso.
Argumentos
| Nombre | Obligatorio | Propósito |
|---|---|---|
<process-key> | Sí | Clave de proceso (GUID). |
Opciones
| Corto | Largo | Valor | Predeterminado | Descripción |
|---|---|---|---|---|
| — | --folder-path | Ruta | inferido | Omita la detección automática y utilice esta carpeta. |
| — | --folder-key | GUID | inferido | Omita la detección automática y utilice esta carpeta. |
| — | --all-fields | Marca | Desactivado | Devuelve la carga útil de la API completa en lugar del resumen seleccionado. |
Ejemplos
uip or processes version-history c3d4e5f6-0000-0000-0000-000000000001
uip or processes version-history c3d4e5f6-0000-0000-0000-000000000001
Forma de datos (--json de salida)
{
"Code": "ProcessVersionHistory",
"Data": [
{
"Version": "1.0.0",
"CreatedAt": "2024-01-10T08:30:00.000Z",
"ReleaseName": "InvoiceProcessing",
"ReleaseId": 101,
"Id": 1001
},
{
"Version": "1.0.2",
"CreatedAt": "2024-01-15T09:45:00.000Z",
"ReleaseName": "InvoiceProcessing",
"ReleaseId": 101,
"Id": 1002
}
]
}
{
"Code": "ProcessVersionHistory",
"Data": [
{
"Version": "1.0.0",
"CreatedAt": "2024-01-10T08:30:00.000Z",
"ReleaseName": "InvoiceProcessing",
"ReleaseId": 101,
"Id": 1001
},
{
"Version": "1.0.2",
"CreatedAt": "2024-01-15T09:45:00.000Z",
"ReleaseName": "InvoiceProcessing",
"ReleaseId": 101,
"Id": 1002
}
]
}
creación de uip o procesos
Vincula un paquete a una carpeta como proceso. Requiere --folder-path o --folder-key y tres opciones de paquete necesarias. Utiliza uip or packages list para la clave del paquete y uip or packages versions para las versiones disponibles.
La retención de trabajos se establece de forma predeterminada en Delete después de 30 días. Para archivar trabajos, pasa --retention-action Archive con --retention-bucket <bucket-key>. Para archivar trabajos obsoletos, pasa --stale-retention-action Archive con --stale-retention-period <days> y --stale-retention-bucket <bucket-key>.
Opciones
Obligatorio
| Corto | Largo | Valor | Predeterminado | Descripción |
|---|---|---|---|---|
| — | --name | text | — | Nombre del proceso dentro de la carpeta. |
| — | --package-key | text | — | Clave de paquete (la PackageId de packages list). |
| — | --package-version | 2020.x | — | Versión del paquete (por ejemplo, 1.0.0). |
Identidad y ámbito
| Corto | Largo | Valor | Predeterminado | Descripción |
|---|---|---|---|---|
| — | --folder-path | Ruta | — | Carpeta de destino por ruta. |
| — | --folder-key | GUID | — | Carpeta de destino por clave. |
Configuración del proceso
| Corto | Largo | Valor | Predeterminado | Descripción |
|---|---|---|---|---|
| — | --description | text | — | Descripción del proceso. |
| — | --entry-point | Ruta | — | Ruta del flujo de trabajo del punto de entrada (para paquetes de varios puntos de entrada). |
| — | --input-arguments | JSON | — | Argumentos de entrada predeterminados como JSON. |
| — | --job-priority | ENUM | — | Low, Normal, High. Mutuamente excluyente con --specific-priority. |
| — | --specific-priority | 1–100 | — | Prioridad numérica. Mutuamente excluyente con --job-priority. |
| — | --robot-size | ENUM | — | Tamaño de Cloud Robot: Small, Standard, Medium, Large. |
| — | --tags | CSV | — | Nombres de etiquetas separados por comas. |
| — | --environment-variables | text | — | Variables de entorno como pares KEY=VALUE separados por saltos de línea (no JSON), por ejemplo $'FOO=bar\nBAZ=qux'. |
| — | --auto-update / --no-auto-update | Marca | — | Habilitar/deshabilitar la actualización automática a la última versión del paquete. |
| — | --hidden-for-attended / --visible-for-attended | Marca | — | Ocultar o mostrar a los usuarios atendidos. Mutuamente excluyentes. |
| — | --auto-create-triggers / --no-auto-create-triggers | Marca | — | Crear automáticamente desencadenadores conectados en la implementación. |
Retención
| Corto | Largo | Valor | Predeterminado | Descripción |
|---|---|---|---|---|
| — | --retention-period | días (1–180) | 30 | Período de retención del trabajo. |
| — | --retention-action | ENUM | Delete | Delete, Archive o None. Archive requiere --retention-bucket. |
| — | --retention-bucket | clave de depósito (GUID) | — | Clave de depósito de almacenamiento para trabajos archivados. Obligatorio cuando --retention-action es Archive y rechazado para Delete o None. El depósito debe estar en la carpeta del proceso o compartirse con ella. Obtén la clave de uip or buckets list. |
| — | --stale-retention-period | días | 180 para Delete/None | Período de retención de trabajo obsoleto. Requiere --stale-retention-action. Obligatorio cuando la acción obsoleta es Archive. |
| — | --stale-retention-action | ENUM | — | Delete, Archive o None. Archive requiere --stale-retention-bucket. |
| — | --stale-retention-bucket | clave de depósito (GUID) | — | Clave de depósito de almacenamiento para trabajos obsoletos archivados. Obligatorio cuando --stale-retention-action es Archive. El depósito debe estar en la carpeta del proceso o compartirse con ella. Obtén la clave de uip or buckets list. |
Ejemplos
uip or processes create --folder-path "Shared" \
--name "InvoiceProcessing" \
--package-key InvoiceProcessing --package-version 1.0.2
uip or processes create --folder-path "Production/EU" \
--name "InvoiceProcessing" --package-key InvoiceProcessing --package-version 1.0.2 \
--job-priority High --auto-update --tags "finance,eu"
uip or processes create --folder-path "Shared" \
--name "InvoiceProcessing" --package-key InvoiceProcessing --package-version 1.0.2 \
--output-filter 'Key'
uip or processes create --folder-path "Shared" \
--name "InvoiceProcessing" \
--package-key InvoiceProcessing --package-version 1.0.2
uip or processes create --folder-path "Production/EU" \
--name "InvoiceProcessing" --package-key InvoiceProcessing --package-version 1.0.2 \
--job-priority High --auto-update --tags "finance,eu"
uip or processes create --folder-path "Shared" \
--name "InvoiceProcessing" --package-key InvoiceProcessing --package-version 1.0.2 \
--output-filter 'Key'
Forma de datos (--json de salida)
{
"Code": "ProcessCreated",
"Data": {
"Key": "c3d4e5f6-0000-0000-0000-000000000010",
"Name": "InvoiceProcessing",
"ProcessKey": "InvoiceProcessing",
"ProcessVersion": "1.0.2",
"Description": "",
"IsLatestVersion": true,
"RetentionPeriod": 30,
"RetentionAction": "Delete"
}
}
{
"Code": "ProcessCreated",
"Data": {
"Key": "c3d4e5f6-0000-0000-0000-000000000010",
"Name": "InvoiceProcessing",
"ProcessKey": "InvoiceProcessing",
"ProcessVersion": "1.0.2",
"Description": "",
"IsLatestVersion": true,
"RetentionPeriod": 30,
"RetentionAction": "Delete"
}
}
uip o procesos actualizar-versión
Actualiza uno o más procesos a la última versión del paquete o a una versión específica con --package-version. La carpeta es opcional: si no se proporciona, se infiere de la primera clave del proceso.
- Una clave + ninguna
--package-version→ actualizar a la última (llamada única a la API). - Una tecla +
--package-version→ actualizar a esa versión (llamada única a la API). - Varias claves + ninguna
--package-version→ actualización masiva a la última. - Varias claves +
--package-version→ rechazado (error de validación).
Los trabajos en ejecución no se ven afectados; solo los trabajos nuevos utilizan la versión actualizada.
Argumentos
| Nombre | Obligatorio | Propósito |
|---|---|---|
<process-keys...> | Sí | Una o más claves de proceso (GUID). |
Opciones
| Corto | Largo | Valor | Predeterminado | Descripción |
|---|---|---|---|---|
| — | --folder-path | Ruta | inferido | Omita la detección automática y utilice esta carpeta. |
| — | --folder-key | GUID | inferido | Omita la detección automática y utilice esta carpeta. |
| — | --package-version | 2020.x | — | Versión específica. Solo es válido con una sola clave. |
Ejemplos
uip or processes update-version c3d4e5f6-0000-0000-0000-000000000001
uip or processes update-version c3d4e5f6-0000-0000-0000-000000000001 \
--package-version 1.0.3
uip or processes update-version \
c3d4e5f6-0000-0000-0000-000000000001 \
c3d4e5f6-0000-0000-0000-000000000002 \
--output-filter 'Version'
uip or processes update-version c3d4e5f6-0000-0000-0000-000000000001
uip or processes update-version c3d4e5f6-0000-0000-0000-000000000001 \
--package-version 1.0.3
uip or processes update-version \
c3d4e5f6-0000-0000-0000-000000000001 \
c3d4e5f6-0000-0000-0000-000000000002 \
--output-filter 'Version'
Forma de datos (--json de salida)
Clave única:
{
"Code": "ProcessVersionUpdated",
"Data": { "ProcessKey": "c3d4e5f6-…-000001", "Version": "latest" }
}
{
"Code": "ProcessVersionUpdated",
"Data": { "ProcessKey": "c3d4e5f6-…-000001", "Version": "latest" }
}
Devuelve Code: "ProcessVersionsUpdated" de forma masiva con ProcessKeys, Version y un objeto Result repetido desde la API.
actualización de uip o procesos
Actualizar la configuración del proceso por clave. Lee los valores actuales, aplica los campos PATCH proporcionados y guarda. Solo se cambian los campos proporcionados; los campos omitidos en la CLI se conservan del estado actual. La clave se resuelve en todo el tenant de forma predeterminada. Pasa --folder-path o --folder-key para establecer el ámbito de la búsqueda en una carpeta, lo que requiere una identidad con acceso a una sola carpeta (como una aplicación externa).
edit es un alias registrado para este verbo: uip or processes edit funciona de forma idéntica a uip or processes update.
Argumentos
| Nombre | Obligatorio | Propósito |
|---|---|---|
<process-key> | Sí | Clave de proceso (GUID). |
Opciones
Los mismos campos que processes create excepto las tres opciones de paquete necesarias y --tags. Las reglas de exclusión mutua y validación coinciden con create (--job-priority frente a --specific-priority, --hidden-for-attended frente a --visible-for-attended). La retención de archivos necesita un depósito de almacenamiento: mientras la acción permanece Archive, se mantiene el depósito actual, y cuando la acción cambia a Delete o None, el depósito se borra.
| Corto | Largo | Valor | Predeterminado | Descripción |
|---|---|---|---|---|
| — | --folder-path | Ruta | — | Ámbito de la búsqueda de claves a esta carpeta en lugar de resolverla en todo el tenant. |
| — | --folder-key | GUID | — | Ámbito de la búsqueda de claves a esta carpeta en lugar de resolverla en todo el tenant. |
-n | --name | text | — | Nuevo nombre para mostrar. |
-d | --description | text | — | Nueva descripción. |
| — | --entry-point | Ruta | — | Nueva ruta de punto de entrada. |
| — | --input-arguments | JSON | — | Argumentos de entrada predeterminados. |
| — | --environment-variables | text | — | Pares KEY=VALUE separados por saltos de línea (no JSON). Pulse '' para borrarlos. |
| — | --job-priority | ENUM | — | Low, Normal, High. |
| — | --specific-priority | 1–100 | — | Prioridad numérica. |
| — | --robot-size | ENUM | — | Tamaño de Cloud Robot: Small, Standard, Medium, Large. |
| — | --auto-update / --no-auto-update | Marca | — | Alternar actualización automática. |
| — | --hidden-for-attended / --visible-for-attended | Marca | — | Visibilidad atendida. |
| — | --auto-create-triggers / --no-auto-create-triggers | Marca | — | Creación automática de desencadenadores conectados. |
| — | --healing-agent / --no-healing-agent | Marca | — | Habilita o deshabilita Healing Agent (Autopilot para Robots) para este proceso. Los trabajos futuros lo utilizan de forma predeterminada una vez habilitado; Autopilot a nivel de tenant ya debe estar activado. |
| — | --retention-period | días (1–180) | — | Período de retención del trabajo. |
| — | --retention-action | ENUM | — | Delete, Archive, None. Cambiar a Archive requiere --retention-bucket a menos que el proceso ya se haya archivado. |
| — | --retention-bucket | clave de depósito (GUID) | — | Clave de depósito de almacenamiento para trabajos archivados. Omitir para mantener el depósito actual. El depósito debe estar en la carpeta del proceso o compartirse con ella. Obtén la clave de uip or buckets list. |
| — | --stale-retention-period | días | — | Período de retención de trabajo obsoleto. Omitir para mantener el período actual. Cuando no se almacena ningún período, Delete/None utiliza 180 y Archive requiere esta opción. |
| — | --stale-retention-action | ENUM | — | Delete, Archive, None. Archive requiere --stale-retention-bucket. |
| — | --stale-retention-bucket | clave de depósito (GUID) | — | Clave de depósito de almacenamiento para trabajos obsoletos archivados. Omitir para mantener el depósito actual. El depósito debe estar en la carpeta del proceso o compartirse con ella. Obtén la clave de uip or buckets list. |
Ejemplos
uip or processes update c3d4e5f6-0000-0000-0000-000000000001 \
--description "Monthly invoice batch"
uip or processes update c3d4e5f6-0000-0000-0000-000000000001 \
--job-priority High --retention-period 60
# Archive completed jobs to a storage bucket after 60 days
uip or processes update c3d4e5f6-0000-0000-0000-000000000001 \
--retention-action Archive --retention-period 60 \
--retention-bucket b1b2c3d4-0000-0000-0000-000000000001
uip or processes update c3d4e5f6-0000-0000-0000-000000000001 \
--auto-update --output-filter 'Status'
uip or processes update c3d4e5f6-0000-0000-0000-000000000001 \
--description "Monthly invoice batch"
uip or processes update c3d4e5f6-0000-0000-0000-000000000001 \
--job-priority High --retention-period 60
# Archive completed jobs to a storage bucket after 60 days
uip or processes update c3d4e5f6-0000-0000-0000-000000000001 \
--retention-action Archive --retention-period 60 \
--retention-bucket b1b2c3d4-0000-0000-0000-000000000001
uip or processes update c3d4e5f6-0000-0000-0000-000000000001 \
--auto-update --output-filter 'Status'
Forma de datos (--json de salida)
{
"Code": "ProcessUpdated",
"Data": {
"Key": "c3d4e5f6-0000-0000-0000-000000000001",
"Name": "InvoiceProcessing",
"Status": "Updated successfully"
}
}
{
"Code": "ProcessUpdated",
"Data": {
"Key": "c3d4e5f6-0000-0000-0000-000000000001",
"Name": "InvoiceProcessing",
"Status": "Updated successfully"
}
}
eliminar uip o procesos
Eliminar una vinculación de proceso por clave. Esto elimina la vinculación de la versión de su carpeta; no elimina el paquete subyacente.
Argumentos
| Nombre | Obligatorio | Propósito |
|---|---|---|
<process-key> | Sí | Clave de proceso (GUID). Encuéntralo con processes list. |
Opciones
| Corto | Largo | Valor | Predeterminado | Descripción |
|---|---|---|---|---|
-y | --yes | Marca | — | Obligatorio. Confirma esta operación irreversible: la CLI nunca solicita. |
Ejemplos
uip or processes delete c3d4e5f6-0000-0000-0000-000000000001 --yes
uip or processes delete c3d4e5f6-0000-0000-0000-000000000001 --yes
Forma de datos (--json de salida)
{
"Code": "ProcessDeleted",
"Data": {
"Key": "c3d4e5f6-0000-0000-0000-000000000001",
"Name": "InvoiceProcessing",
"ProcessKey": "InvoiceProcessing",
"Status": "Deleted successfully"
}
}
{
"Code": "ProcessDeleted",
"Data": {
"Key": "c3d4e5f6-0000-0000-0000-000000000001",
"Name": "InvoiceProcessing",
"ProcessKey": "InvoiceProcessing",
"Status": "Deleted successfully"
}
}
reversión de uip o procesos
Revierte un proceso a su versión anterior del paquete. La carpeta es opcional: si no se proporciona, se infiere de la clave del proceso.
Argumentos
| Nombre | Obligatorio | Propósito |
|---|---|---|
<process-key> | Sí | Clave de proceso (GUID). |
Opciones
| Corto | Largo | Valor | Predeterminado | Descripción |
|---|---|---|---|---|
| — | --folder-path | Ruta | inferido | Omitir la detección automática. |
| — | --folder-key | GUID | inferido | Omitir la detección automática. |
Ejemplos
uip or processes rollback c3d4e5f6-0000-0000-0000-000000000001
uip or processes rollback c3d4e5f6-0000-0000-0000-000000000001 \
--folder-path "Shared"
uip or processes rollback c3d4e5f6-0000-0000-0000-000000000001 \
--output-filter 'Status'
uip or processes rollback c3d4e5f6-0000-0000-0000-000000000001
uip or processes rollback c3d4e5f6-0000-0000-0000-000000000001 \
--folder-path "Shared"
uip or processes rollback c3d4e5f6-0000-0000-0000-000000000001 \
--output-filter 'Status'
Forma de datos (--json de salida)
{
"Code": "ProcessRolledBack",
"Data": {
"ProcessKey": "c3d4e5f6-0000-0000-0000-000000000001",
"Status": "Rolled back to previous version"
}
}
{
"Code": "ProcessRolledBack",
"Data": {
"ProcessKey": "c3d4e5f6-0000-0000-0000-000000000001",
"Status": "Rolled back to previous version"
}
}
Códigos de salida
Consulta Códigos de salida. No hay anulaciones específicas de verbos más allá de los errores de validación estándar.
Comandos relacionados
uip or packages— busca claves de paquete (packages list), versiones (packages versions) y puntos de entrada (packages entry-points) antes de llamar aprocesses create.uip or jobs, especialmentejobs start, que requiere una clave de proceso.uip or folders: crea o localiza la carpeta de destino antes de vincular.
Ver también
- Sinopsis
- Verbos
- uip o lista de procesos
- Opciones
- Ejemplos
- Forma de datos (--json de salida)
- uip o procesos get
- Argumentos
- Opciones
- Ejemplos
- Forma de datos (--json de salida)
- recursos uip o de procesos
- Argumentos
- Opciones
- Ejemplos
- Forma de datos (--json de salida)
- UIP o el historial de versiones de los procesos
- Argumentos
- Opciones
- Ejemplos
- Forma de datos (--json de salida)
- creación de uip o procesos
- Opciones
- Ejemplos
- Forma de datos (--json de salida)
- uip o procesos actualizar-versión
- Argumentos
- Opciones
- Ejemplos
- Forma de datos (--json de salida)
- actualización de uip o procesos
- Argumentos
- Opciones
- Ejemplos
- Forma de datos (--json de salida)
- eliminar uip o procesos
- Argumentos
- Opciones
- Ejemplos
- Forma de datos (--json de salida)
- reversión de uip o procesos
- Argumentos
- Opciones
- Ejemplos
- Forma de datos (--json de salida)
- Códigos de salida
- Comandos relacionados
- Ver también