uip oder queue-items

Syntax und Optionen für „uip or queue-items“, das einzelne Arbeitstransaktionen innerhalb von Orchestrator-Warteschlangen verwaltet.

Warteschlangenelemente verwalten – einzelne Arbeitstransaktionen innerhalb von Warteschlangen. Elemente durchlaufen Status: New → InProgress → Successful / Failed / Abandoned / Retried / Deleted. Warteschlangenelemente haben einen Ordner-Scope; Die meisten Unterbefehle erfordern --folder-path oder --folder-key. Die Warteschlange selbst finden Sie unter uip or queues.

Die ressourcenübergreifenden Konventionen (Authentifizierung, Ordner-Scoping, Schlüsseltypen, Ausgabeumschlag) finden Sie in der uip or -Übersicht.

Zusammenfassung

uip or queue-items list                [--folder-path <path> | --folder-key <key> | --all-folders] [--queue-definition-key <key>] [--queue-name <name>] [--status <status>] [-l <n>] [--offset <n>] [--sort-by <field>] [--all-fields]
uip or queue-items get                 <queue-item-key> [--all-fields]
uip or queue-items update              <queue-item-key> [--priority <p>] [--due-date <iso>] [--defer-date <iso>] [--specific-content <json>]
uip or queue-items delete              <queue-item-key> --yes
uip or queue-items delete-bulk         <queue-item-key...> --yes
uip or queue-items set-review-status   <status> <queue-item-key...>
uip or queue-items set-reviewer        <queue-item-key...> --user-key <guid>
uip or queue-items unset-reviewer      <queue-item-key...>
uip or queue-items get-reviewers       [--folder-path <path> | --folder-key <key>] [--all-fields]
uip or queue-items get-history         <queue-item-key> [-l <n>] [--offset <n>] [--all-fields]
uip or queue-items get-last-retry      <retry-chain-key> [--all-fields]
uip or queue-items has-video           <queue-item-key>
uip or queue-items add                 <queue-name> --folder-path <path> | --folder-key <key> --specific-content <json> [-r <ref>] [-p <priority>] [--defer-date <iso>] [--due-date <iso>] [--all-fields]
uip or queue-items bulk-add            <queue-name> --folder-path <path> | --folder-key <key> --queue-items <json-array> [--commit-type <mode>]

Hinweis:

Derzeit gibt es keinen set-progress -Befehl und kein --progress -Flag auf update – der Fortschrittstext kann nicht über diese CLI festgelegt werden. Wenn Sie danach gesucht haben, überprüfen Sie, ob es seit der letzten Überprüfung dieser Seite hinzugefügt wurde, oder verwenden Sie die Orchestrator-API in der Zwischenzeit direkt.

Liste

Listen Sie Warteschlangenelemente in einem Ordner oder in jedem zugänglichen Ordner mit --all-folders auf. Filter: --queue-definition-key <guid> und/oder --queue-name <name> und/oder --status <state>. Paginiert über -l, --limit / --offset; --sort-by <field> sortiert Ergebnisse (Standard: Id desc). --all-fields gibt die vollständige API-Antwort anstelle der kuratierten Teilmenge zurück.

uip or queue-items list --folder-path Shared \
  --queue-name InvoiceQueue --status Failed

get

Rufen Sie ein Warteschlangenelement nach <queue-item-key> ab (das Feld uniqueKey aus der Ausgabe von list, eindeutig pro Versuch). --all-fields gibt die vollständige API-Antwort anstelle der kuratierten Teilmenge zurück.

Aktualisieren

Ändern Sie Felder für ein Warteschlangenelement. Optional: --priority <High|Normal|Low>, --due-date <ISO-8601>, --defer-date <ISO-8601>, --specific-content <json>.

Delete/Delete-Bulk

Löschen Sie ein oder mehrere Elemente nach <queue-item-key> / <queue-item-key...>. Das Massenformular erfordert, dass alle Elemente zum selben Ordner gehören. Beide erfordern -y, --yes – die CLI fordert nie zu destruktiven Vorgängen auf.

uip or queue-items delete a1b2c3d4-0000-0000-0000-000000000001 --yes

Überprüfungsstatus festlegen

Legen Sie <status> (Retried, Abandoned, Deleted) für ein oder mehrere <queue-item-key...> fest.

set-reviewer/unset-reviewer

Prüfer für ein oder mehrere <queue-item-key...> zuweisen oder löschen. set-reviewer erfordert --user-key <guid>.

get-reviewers

Listen Sie Benutzer auf, die als Prüfer verfügbar sind (Scope von --folder-path / --folder-key, wenn vorhanden). Schlüsselfeed set-reviewer --user-key zurückgegeben. --all-fields gibt die vollständige API-Antwort anstelle der kuratierten Teilmenge zurück.

Get-History

Verarbeitungsverlauf für ein Warteschlangenelement zurückgeben. Paginiert über -l, --limit / --offset.

Letzte-Wiederholung erhalten

Gibt die letzte Wiederholung für ein Element zurück. Das Argument ist der Wiederholungskettenschlüssel (das Feld key von list, nicht uniqueKey).

Has-Video

Gibt zurück, ob an ein Warteschlangenelement eine Videoaufzeichnung angehängt ist.

Hinzufügen

Fügen Sie ein einzelnes Element zu einer Warteschlange anhand des Namens hinzu. Erfordert <queue-name> und --specific-content <json>. Optional: -r, --reference, -p, --priority <High|Normal|Low> (Standard: Normal), --defer-date, --due-date.

uip or queue-items add InvoiceQueue --folder-path Shared \
  --specific-content '{"InvoiceId":"INV-001","Amount":1500}'

Massenhinzufügen

Fügen Sie mehrere Elemente in einer Anforderung hinzu. Erfordert <queue-name> und --queue-items <json-array>. Optional: --commit-type <AllOrNothing|StopOnFirstFailure|ProcessAllIndependently> (Standard: ProcessAllIndependently).

ITEMS=$(jq -c . ./items.json)
uip or queue-items bulk-add InvoiceQueue \
  --folder-path Shared \
  --queue-items "$ITEMS" \
  --commit-type StopOnFirstFailure

Exitcodes

Siehe Austrittscodes für den gemeinsamen Vertrag. delete / delete-bulk 2 beenden (Validierungsfehler), wenn -y, --yes weggelassen wird.

Zugehörige Befehle

• uip or queues – CRUD auf Warteschlangenebene.

Siehe auch

• uip or Übersicht – gemeinsame Konventionen für jedes uip or -Verb.
• So: Verwalten von Orchestrator-Assets und Warteschlangen – Massenmuster und CSV-gesteuerter Versand.