UIP-Ressourcenwarteschlangenelemente

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 resource queues.

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

Zusammenfassung

uip resource queue-items list                <flags below>
uip resource queue-items get                 <queue-item-key>
uip resource queue-items update              <queue-item-key> [--progress <text>] [--priority <p>] [--due-date <iso>] [--defer-date <iso>] [--specific-content <json>]
uip resource queue-items set-progress        <queue-item-key> <progress>
uip resource queue-items delete              <queue-item-key>
uip resource queue-items delete-bulk         <queue-item-key...>
uip resource queue-items set-review-status   <status> <queue-item-key...>
uip resource queue-items set-reviewer        <queue-item-key...> --user-key <guid>
uip resource queue-items unset-reviewer      <queue-item-key...>
uip resource queue-items get-reviewers       [--folder-path <path> | --folder-key <key>]
uip resource queue-items get-history         <queue-item-key> [-l <n>] [--offset <n>]
uip resource queue-items get-last-retry      <retry-chain-key>
uip resource queue-items has-video           <queue-item-key>
uip resource queue-items add                 <queue-name> --folder-path <path> | --folder-key <key> --specific-content <json> [-r <ref>] [-p <priority>] [--defer-date <iso>] [--due-date <iso>]
uip resource queue-items bulk-add            <queue-name> --folder-path <path> | --folder-key <key> --queue-items <json-array> [--commit-type <mode>]

Liste

Listen Sie Warteschlangenelemente in einem Ordner auf. Filter: --queue-definition-key <guid> und/oder --queue-name <name> und/oder --status <state>.

uip resource 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).

Aktualisieren

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

Set-Progress

Aktualisieren Sie den Fortschrittstext eines sich in Bearbeitung befindenden Elements: set-progress <queue-item-key> <progress>.

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.

Ü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.

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 resource 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 resource queue-items bulk-add InvoiceQueue \
  --folder-path Shared \
  --queue-items "$ITEMS" \
  --commit-type StopOnFirstFailure

Siehe auch

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