uip maestro case process & job

Syntax and options for `uip maestro case process`, `processes`, `job`, `instance`, and `incident` — running and inspecting Case Management processes and their executions.

Runtime commands for uip maestro case: process runs a case process and manages its settings/variable tags, job inspects one execution attempt, instance inspects/steers the resulting process instance, processes gives a cross-process summary view, and incident reads incidents. See Case overview for concepts shared across the whole case subsystem.

所有子命令都需要uip login并遵循全局选项。退出代码遵循标准合同。

instance, incident, and processes share their implementation with the equivalent BPMN and Flow commands (@uipath/maestro-sdk's shared-commands module) — same defects, same fixes apply, parameterized here for Case (toolLabel: "Case", processType: "CaseManagement"). One real behavioral difference: instance's --folder-key is optional here (folderKeyRequired: false), where it's required on the BPMN/Flow equivalents.

大纲

uip maestro case process list --folder-key <key> [--filter <odata>] [--login-validity <minutes>]
uip maestro case process get <process-key> <feed-id> --folder-key <key> [--login-validity <minutes>]
uip maestro case process run <process-key> <folder-key> [--inputs <json|@file>] [--release-key <key>] [--feed-id <id>] [--robot-ids <ids>] [--validate] [--login-validity <minutes>]
uip maestro case process settings get <process-key> --folder-key <key>
uip maestro case process settings set <process-key> --folder-key <key> --inputs <json|@file>
uip maestro case process variable-tags get <process-key> --folder-key <key>
uip maestro case process variable-tags set <process-key> --folder-key <key> [--variable <name>]... [--element-id <id>] [--all] [--searchable <true|false>] [--tags <csv>] [--add-tags <csv>] [--remove-tags <csv>] [--inputs <json|@file>]

uip maestro case processes list [--folder-key <key>] [--limit <n>] [--offset <n>] [--status <status>]
uip maestro case processes incidents <process-key> --folder-key <key>
uip maestro case processes diagnose <process-key> --folder-key <key>
uip maestro case processes error-codes <process-key> --folder-key <key>

uip maestro case job traces <job-key> [--folder-key <key>] [--poll-interval <ms>] [--traces-service <name>] [--pretty] [--login-validity <minutes>]
uip maestro case job status <job-key> [--folder-key <key>] [--detailed] [--login-validity <minutes>]

uip maestro case instance list --folder-key <key> [-l <limit>] [--next-page <cursor>] [--process-key <k>] [--package-id <id>] [--error-code <code>] [--status <status>]... [--from-date <iso-8601>] [--to-date <iso-8601>]
uip maestro case instance get <instance-id> [--folder-key <key>]
uip maestro case instance pause|resume|cancel|retry <instance-id> [--folder-key <key>] [--comment <text>]
uip maestro case instance migrate <instance-id> <new-version> [--folder-key <key>] [--comment <text>]
uip maestro case instance incidents|asset|cursors|element-executions|variables|variables-all|global-variables <instance-id> [--folder-key <key>]
uip maestro case instance variables-set <instance-id> [--folder-key <key>] --inputs <json|@file>
uip maestro case instance goto <instance-id> <transitions> [--folder-key <key>]
uip maestro case instance element cancel|retry <instance-id> <element-id> [--folder-key <key>] [--comment <text>]
uip maestro case instance message send [--folder-key <key>] [--inputs <json|@file>]

uip maestro case incident summary [--folder-key <key>] [-l <limit>] [--offset <n>] [--process-key <k>] [--status <status>] [--severity <severity>]
uip maestro case incident get <incident-id> --folder-key <key>

uip maestro case process

Manage Case processes: list what's published to a folder, inspect an entry point's input/output schema, and run one.

备注：

process run takes <folder-key> as a positional argument, not a flag — different from every other verb on this page (list/get/settings/variable-tags), which all use --folder-key/-f. This asymmetry is real, not a typo — verify against your own CLI version's --help if a copy-pasted example seems to fail.

uip maestro case process list

List Case processes published to a folder.

选项

选项	必填	描述
-f, --folder-key <key>	是	文件夹密钥 (GUID)。
--filter <odata>	否	Additional OData filter.
--login-validity <minutes>	否	Minimum minutes before token expiration to trigger a refresh. Default 10.

数据形状

{
  "Code": "CaseProcessList",
  "Data": [
    {
      "name": "InvoiceReview",
      "processKey": "a1b2c3d4-0000-0000-0000-000000000001: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 case process get

Get a process's entry-point schemas — the input/output shape process run expects.

参数

名称	必填	用途
<process-key>	是	Process key.
<feed-id>	是	Feed ID, from process list's feedId field.

选项

选项	必填	描述
-f, --folder-key <key>	是	文件夹密钥 (GUID)。
--login-validity <minutes>	否	Default 10.

数据形状

{
  "Code": "CaseProcessGet",
  "Data": [
    {
      "Path": "/content/caseplan.json.bpmn#Trigger_1",
      "DisplayName": "Start",
      "Type": "CaseManagement",
      "InputSchema": "{\"type\":\"object\",\"properties\":{}}",
      "OutputSchema": "{\"type\":\"object\",\"properties\":{}}"
    }
  ]
}

Data is an array — one entry per entry point the process exposes, not a single object. Fails with an explicit error if the process has zero entry points.

uip maestro case process run

Start a Case process instance.

参数

名称	必填	用途
<process-key>	是	Process key.
<folder-key>	是	Folder key (GUID) — positional here, not a flag.

选项

选项	必填	描述
-i, --inputs <json>	否	Input parameters as a JSON string or @file.json. Omit to read from stdin instead; omit both for empty inputs ({}).
--release-key <key>	否	Release key (GUID), from process list.
--feed-id <id>	否	Feed ID for package lookup.
--robot-ids <ids>	否	Comma-separated numeric robot IDs. Fails fast if any entry isn't a number.
--validate	否	Run basic client-side validation (required fields + primitive types) against the process's input schema before submitting. Prints ✅/❌ and exits 1 on failure without starting a job.
--login-validity <minutes>	否	Default 10.

示例

uip maestro case process run a1b2c3d4-0000-0000-0000-000000000001 c3d4e5f6-0000-0000-0000-000000000001 \
  --inputs '{"amount":100}'

数据形状

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

The success message points you at uip maestro case job traces <jobKey> to watch execution.

uip maestro case process settings

Read or replace a process's raw settings object (the same object variable-tags reads/writes one field of).

动词	参数	选项	注意
get	<process-key>	-f, --folder-key <key> 必填	Code: "ProcessSettingsGet"。
set	<process-key>	-f, --folder-key <key> required, --inputs <json|@file>	Read-modify-write: GETs current settings, PUTs your payload as the new object. Code: "ProcessSettingsSet".

uip maestro case process variable-tags

Tag a process's output variables (for example, marking one searchable for instance-list filtering). Two independent modes — pick one, not both:

• Friendly mode: --variable <name> (repeatable) + --element-id/--all to target, plus --searchable <true|false> or the lower-level --tags/--add-tags/--remove-tags to mutate.
• Raw mode: --inputs <json|@file> with the full variableTags payload.

动词	参数	选项	注意
get	<process-key>	-f, --folder-key <key> 必填	Returns just the variableTags object. Code: "ProcessVariableTagsGet".
set	<process-key>	-f, --folder-key <key> required, plus the friendly/raw flags above	Mixing --inputs with any friendly flag is an error. --element-id only works with exactly one --variable. --searchable can't combine with --tags/--add-tags/--remove-tags. Code: "ProcessVariableTagsSet".

示例

# Mark the "amount" output searchable
uip maestro case process variable-tags set a1b2c3d4-… --folder-key <key> --variable amount --searchable true

uip maestro case processes

Cross-process summary view — list every process's aggregate counts, or drill into one by key. Shares implementation with BPMN processes and Flow's equivalent, filtered to processType: "CaseManagement".

动词	参数	选项	注意
list	—	--folder-key <key>、-l/--limit <n>、--offset <n>、--status <status>	Code: "ProcessList"。
incidents	<process-key>	--folder-key <key> 必填	Code: "ProcessIncidents"。
diagnose	<process-key>	--folder-key <key> 必填	Correlates summary + incidents + error codes in one call. Code: "ProcessDiagnostics" with FaultedCount/RunningCount/IncidentCount/ErrorCodeCount rollups.
error-codes	<process-key>	--folder-key <key> 必填	Code: "ProcessIncidentErrorCodes"。

uip maestro case job

Inspect one execution attempt (a job) of a Case process.

uip maestro case job traces

正在运行或最近完成的作业的流执行追踪事件。

选项

选项	默认	描述
--folder-key <key>	—	Optional — scopes the trace request.
--poll-interval <ms>	2000	Polling interval.
--traces-service <name>	llmopstenant_	Traces 服务名称。
--pretty	关闭	Human-readable trace lines instead of raw JSON.
--login-validity <minutes>	10	令牌刷新阈值。

Traces stream directly to output — no final Data payload. Exit code 0 on success, 1 otherwise.

uip maestro case job status

Get a job's status.

选项

选项	必填	默认	描述
--folder-key <key>	否	经过身份验证的文件夹	Folder key (GUID, from process list). Optional here — omit to let the backend resolve your default folder.
--detailed	否	关闭	Full response instead of the curated summary.
--login-validity <minutes>	否	10	令牌刷新阈值。

数据形状（默认摘要）

{
  "Code": "CaseJobStatus",
  "Data": {
    "key": "b2c3d4e5-0000-0000-0000-000000000001",
    "state": "Successful",
    "runtimeType": "…",
    "processType": "CaseManagement",
    "startTime": "2025-04-15T10:30:00Z",
    "endTime": "2025-04-15T10:32:11Z",
    "creationTime": "…",
    "inputArguments": "…",
    "outputArguments": "…",
    "info": "…",
    "releaseName": "InvoiceReviewProcess",
    "processKey": "a1b2c3d4-0000-0000-0000-000000000001",
    "robotName": "…",
    "hostMachineName": "…"
  }
}

uip maestro case instance

Inspect and steer individual process instances — one execution of a case process. Shares implementation with BPMN instance and Flow instance; refer to either page for the full verb-by-verb reference (list, get, pause, resume, cancel, retry, migrate, variables, variables-set, variables-all, global-variables, incidents, asset, cursors, goto, element-executions, element cancel/retry, message send) — every option name, default, and data shape is identical.

The one real difference: -f, --folder-key is optional on every instance subcommand for Case (folderKeyRequired: false in the shared-commands config), where BPMN and Flow require it. Omit it to scope to your authenticated default folder.

uip maestro case incident

Read incidents across processes or by ID. Identical implementation to BPMN incident/Flow's equivalent — see either page for the full 6-flag summary Options table and get's single required --folder-key.

示例

# Publish check, then run
uip maestro case process list --folder-key <key>
uip maestro case process get a1b2c3d4-… default --folder-key <key>
uip maestro case process run a1b2c3d4-… <key> --inputs '{"amount":100}'

# Watch it through to completion
JOB_KEY=$(uip maestro case process run a1b2c3d4-… <key> --inputs '{}' --output-filter "Data.jobKey" --output plain)
uip maestro case job traces "$JOB_KEY" --pretty
uip maestro case job status "$JOB_KEY" --detailed

# Diagnose a failing process in one call
uip maestro case processes diagnose a1b2c3d4-… --folder-key <key>

另请参阅

• Case overview
• uip maestro instance / uip maestro flow instance — full shared-instance reference
• uip maestro incident — full shared-incident reference
• Orchestrator 作业