éléments de file d’attente de ressources uip

Gérer les éléments de la file d’attente — les transactions de travail individuelles dans les files d’attente. Les éléments passent par les états: New → InProgress → Successful / Failed / Abandoned / Retried / Deleted. Les éléments de la file d'attente sont à l'échelle du dossier; la plupart des sous-commandes nécessitent --folder-path ou --folder-key. Pour la file d'attente elle-même, consultez uip resource queues.

Pour les conventions inter-ressources (authentification, étendue des dossiers, types de clés, enveloppe de sortie), consultez la vue d’ensembleuip resource .

Synthèse

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>]

List

Répertorie les éléments de la file d'attente dans un dossier. Filtre: --queue-definition-key <guid> et/ou --queue-name <name> et/ou --status <state>.

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

get

Obtenez un élément de file d'attente par <queue-item-key> (le champ uniqueKey de la sortie list , unique par tentative).

Mettre à jour

Modifiez les champs d'un élément de la file d'attente. Facultatif --progress, --priority <High|Normal|Low>, --due-date <ISO-8601>, --defer-date <ISO-8601>, --specific-content <json>.

Set-Progress

Mettez à jour le texte de progression d'un élément en cours: set-progress <queue-item-key> <progress>.

supprimer/supprimer en bloc

Supprimez un ou plusieurs éléments par <queue-item-key> / <queue-item-key...>. Le formulaire en bloc requiert que tous les éléments appartiennent au même dossier.

Définir-révision-statut

Définissez <status> (Retried, Abandoned, Deleted) pour un ou plusieurs <queue-item-key...>.

Définir-réviseur/non défini-réviseur

Affectez ou supprimez un réviseur sur un ou plusieurs <queue-item-key...>. set-reviewer nécessite --user-key <guid>.

obtenir des réviseurs

Lister les utilisateurs disponibles en tant que réviseurs (étendue par --folder-path / --folder-key si fourni). Flux de clés renvoyées set-reviewer --user-key.

Obtenir l'historique

Renvoyez l'historique de traitement d'un élément de file d'attente. Paginé via -l, --limit / --offset.

Obtenir la dernière nouvelle tentative

Renvoie la nouvelle tentative la plus récente pour un élément. L'argument est la clé de la chaîne de nouvelle tentative (le champ key de list, non uniqueKey).

comporte une vidéo

Indique si un élément de la file d'attente est associé à un enregistrement vidéo.

Ajouter (Add)

Ajoutez un seul élément à une file d'attente par nom. Nécessite <queue-name> et --specific-content <json>. Facultatif -r, --reference, -p, --priority <High|Normal|Low> (par défaut Normal), --defer-date, --due-date.

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

ajout en bloc

Ajoutez plusieurs éléments dans une même requête. Nécessite <queue-name> et --queue-items <json-array>. Facultatif --commit-type <AllOrNothing|StopOnFirstFailure|ProcessAllIndependently> (par défaut ProcessAllIndependently).

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

Voir également

• uip resource queues — CRUD au niveau de la file d'attente.
• Vue d’ensemble deuip resource — conventions partagées pour chaque uip resource verbe.
• Procédure: gérer les ressources et les files d'attente d'Orchestrator — les modèles en bloc et l'envoi basé sur des fichiers CSV.