uip maestro bpmn process and uip maestro bpmn processes

Syntax and options for `uip maestro bpmn process` and `uip maestro bpmn processes`, covering per-folder and tenant-wide published Maestro BPMN process operations.

Once a Maestro BPMN package is published to Orchestrator it becomes a process of type ProcessOrchestration. Both command groups below are registered under the bpmn branch. This page covers two related command groups:

• uip maestro bpmn process — per-folder operations on a single process definition (list in a folder, get its schema, run it, pack+publish it).
• uip maestro bpmn processes (plural) — tenant-wide summaries, per-process incident lookup, and diagnostics.

Sinopsis

# Singular — per-folder, operational
uip maestro bpmn process list    -f <folder-key> [--filter <odata>] [--login-validity <minutes>]
uip maestro bpmn process get     <process-key> <feed-id> -f <folder-key> [--login-validity <minutes>]
uip maestro bpmn process run     <process-key> <folder-key> --release-key <key>
                                  [-i, --inputs <json>] [--feed-id <id>] [--robot-ids <ids>]
                                  [--login-validity <minutes>]
uip maestro bpmn process publish <project-path> [output-path] -f <folder-key>
                                  [-n, --name <name>] [--process-name <name>] [-v, --version <version>]
                                  [-i, --inputs <json>] [--feed-id <id>] [--entry-point <path>]
                                  [--wait [--timeout <seconds>] [--poll-interval <seconds>]] [--login-validity <minutes>]

# Plural — tenant-wide summary, incidents, and diagnostics
uip maestro bpmn processes list       [--folder-key <key>] [-l <limit>] [--offset <n>] [--status <status>]
uip maestro bpmn processes incidents  <process-key> --folder-key <key>
uip maestro bpmn processes diagnose   <process-key> --folder-key <key>
uip maestro bpmn processes error-codes <process-key> --folder-key <key>

Todos los subcomandos requieren uip login y respetan las opciones globales. Los códigos de salida siguen el contrato estándar.

---

uip maestro bpmn process list

Enumera los procesos de Maestro disponibles (versiones) en una carpeta específica.

Opciones

Opción	Obligatorio	Descripción
-f, --folder-key <key>	Sí	Clave de carpeta (GUID).
--filter <odata>	No	Filtro OData adicional aplicado en el lado del servidor.
--login-validity <minutes>	No	Umbral de actualización del token (predeterminado 10).

Forma de datos (--output json)

{
  "Code": "MaestroProcessList",
  "Data": [
    {
      "name":           "InvoiceOrchestration",
      "processKey":     "a1b2c3d4-0000-0000-0000-000000000001",
      "processVersion": "1.0.0",
      "packageId":      "a1b2c3d4-0000-0000-0000-000000000001",
      "packageVersion": "1.0.0",
      "releaseKey":     "e5f6a7b8-0000-0000-0000-000000000001",
      "folderKey":      "c3d4e5f6-0000-0000-0000-000000000001",
      "feedId":         "default",
      "folderId":       42,
      "active":         "Yes",
      "latest":         "Yes"
    }
  ]
}

---

uip maestro bpmn process get

Obtén el esquema de punto de entrada (esquemas JSON de entrada/salida) para un proceso de Maestro.

Argumentos

• <process-key> (obligatorio) : clave de proceso.
• <feed-id> (obligatorio) : ID de fuente (de list).

Opciones

• -f, --folder-key <key> (obligatorio)
• --login-validity <minutes> (default 10)

Forma de datos

{
  "Code": "MaestroProcessGet",
  "Data": [
    {
      "Path":         "/content/main.bpmn#Event_start",
      "DisplayName":  "Manual trigger",
      "Type":         "processorchestration",
      "InputSchema":  "{\"type\":\"object\",\"properties\":{}}",
      "OutputSchema": "{\"type\":\"object\",\"properties\":{}}"
    }
  ]
}

InputSchema y OutputSchema son cadenas de esquema JSON restringidas.

---

uip maestro bpmn process run

Inicia un trabajo de Maestro para un proceso publicado.

Argumentos

• <process-key> (required) — versioned package process key from process list, for example MyProcess:1.0.0.
• <folder-key> (obligatorio) : clave de carpeta (GUID).

Opciones

Opción	Obligatorio	Descripción
--release-key <key>	Sí	Clave de versión (GUID): desde process list.
-i, --inputs <json>	No	Entradas como una cadena JSON o @path/to/file.json. Si se omite y se canaliza la entrada estándar, se analiza la entrada estándar.
--feed-id <id>	No	ID de fuente para la búsqueda de paquetes (opcional).
--robot-ids <ids>	No	Comma-separated robot IDs (optional).
--login-validity <minutes>	No	Umbral de actualización del token (predeterminado 10).

There is no --validate option on this command — inputs are sent as-is; the process itself is responsible for rejecting bad input.

Precedencia de entrada: --inputs <json> / --inputs @file.json > stdin > objeto vacío {}.

Ejemplos

# Inline JSON
uip maestro bpmn process run "InvoiceOrchestration:1.0.0" "<folder-key>" \
  --release-key <release-key> --inputs '{"amount":100}'

# From a file
uip maestro bpmn process run "InvoiceOrchestration:1.0.0" "<folder-key>" \
  --release-key <release-key> --inputs @inputs.json

# Piped stdin
echo '{"amount":100}' | uip maestro bpmn process run "InvoiceOrchestration:1.0.0" "<folder-key>" --release-key <release-key>

Forma de datos

{
  "Code": "MaestroJobStarted",
  "Data": {
    "jobKey":  "b2c3d4e5-0000-0000-0000-000000000001",
    "state":   "Pending",
    "traceId": "d4e5f6a7-0000-0000-0000-000000000001"
  }
}

Siguiente paso: uip maestro bpmn job traces <jobKey> a la ejecución de la transmisión o uip maestro bpmn job status <jobKey> al sondeo.

---

uip maestro bpmn process publish

Pack a Maestro BPMN project directory into a .nupkg and publish it as an Orchestrator process release, in one step.

Argumentos

• <project-path> (required) — path to the Maestro BPMN project directory.
• [output-path] (optional) — output directory for the generated .nupkg. Defaults to a temp directory.

Opciones

Opción	Descripción
-f, --folder-key <key>	Required. Folder key (GUID).
-n, --name <name>	Package name. Default: the project folder name.
--process-name <name>	Process release name. Default: the package name.
-v, --version <version>	Package version. Default 1.0.0.
-i, --inputs <json>	Default input parameters as a JSON string, @file.json, or - for stdin.
--feed-id <id>	Feed ID for package upload (optional).
--entry-point <path>	Entry point path for the process.
--wait	Wait until the published package's entry points are available, instead of returning immediately after upload.
--timeout <seconds>	Maximum seconds to wait for publish propagation when --wait is set. Default 300.
--poll-interval <seconds>	Seconds between publish propagation checks when --wait is set. Default 5.
--login-validity <minutes>	Token-refresh threshold. Default 10.

Ejemplo

uip maestro bpmn process publish ./invoice-process \
  --folder-key <folder-key> --version 1.2.0 --wait

Forma de datos

{
  "Code": "MaestroProcessPublished",
  "Data": {
    "Package": "invoice-process@1.2.0",
    "PackagePath": "/tmp/maestro-process-publish-.../invoice-process.processOrchestration.ProcessOrchestration.1.2.0.nupkg",
    "ProcessKey": "invoice-process.processOrchestration.ProcessOrchestration",
    "ProcessVersion": "1.2.0",
    "ReleaseKey": "e5f6a7b8-0000-0000-0000-000000000001",
    "ReleaseName": "invoice-process",
    "Action": "Created",
    "Upload": [
      { "key": "invoice-process.processOrchestration.ProcessOrchestration", "status": "Created" }
    ],
    "EntryPoints": 1
  }
}

Action is "Created" on first publish of a given process key, "Updated" on subsequent publishes.

---

uip maestro bpmn processes list

Tenant-wide (or folder-scoped) summary of Maestro processes. Unlike the singular process list, no processType filter is applied server-side — the plural command is shared across tools (Maestro, Flow, Case) and does not scope to ProcessOrchestration on its own.

Opciones

Opción	Descripción
--folder-key <key>	Optional. Scope the summary to one folder.
-l, --limit <number>	Número de elementos a devolver (1-10000).
--offset <number>	Number of items to skip (0-1000000). Default 0.
--status <status>	Filter by process status.

Forma de datos

{
  "Code": "ProcessList",
  "Data": [ /* array of Maestro process summaries */ ]
}

Nota:

El tiempo de ejecución de Maestro especifica el conjunto de campos exacto de cada resumen de proceso y puede evolucionar; ejecuta el comando una vez con --output json en un tenant con datos para ver los campos que consumirás y ancla @uipath/cli en CI si analizas campos específicos.

---

uip maestro bpmn processes incidents

Obtener todos los incidentes para una definición de proceso de Maestro específica.

Argumentos

• <process-key> (obligatorio) : clave de definición del proceso.

Opciones

• --folder-key <key> (obligatorio)

Forma de datos

{
  "Code": "ProcessIncidents",
  "Data": [ /* array of process incidents */ ]
}

---

uip maestro bpmn processes diagnose

Correlate a process's summary, incidents, and error codes in a single call — a convenience wrapper over processes list, processes incidents, and processes error-codes.

Argumentos

• <process-key> (obligatorio) : clave de definición del proceso.

Opciones

• --folder-key <key> (obligatorio)

Forma de datos

{
  "Code": "ProcessDiagnostics",
  "Data": {
    "ProcessKey": "InvoiceOrchestration",
    "FolderKey": "c3d4e5f6-0000-0000-0000-000000000001",
    "Summary": { /* the matching process summary object, or null if not found */ },
    "FaultedCount": 2,
    "RunningCount": 5,
    "Incidents": [ /* array of incident objects */ ],
    "IncidentCount": 1,
    "ErrorCodes": [ /* array of error code strings */ ],
    "ErrorCodeCount": 1
  }
}

---

uip maestro bpmn processes error-codes

Get the unique error codes raised by incidents for a specific process.

Argumentos

• <process-key> (obligatorio) : clave de definición del proceso.

Opciones

• --folder-key <key> (obligatorio)

Forma de datos

{
  "Code": "ProcessIncidentErrorCodes",
  "Data": [ /* array of error code strings */ ]
}

Ver también

• uip maestro bpmn instances : inspeccionar y dirigir las ejecuciones en ejecución
• uip maestro bpmn job : seguimientos y estado de un solo trabajo
• uip maestro bpmn incidents — resúmenes y detalles de incidentes
• Trabajos de Orchestrator, procesos de Orchestrator
• Descripción general de Maestro