Itens da Fila de recurso do UIP

Gerenciar itens de fila — transações de trabalho individuais dentro de filas. Os itens fluem por estados: New → InProgress → Successful / Failed / Abandoned / Retried / Deleted. Os itens de fila têm escopo de pasta; a maioria dos subcomandos requer --folder-path ou --folder-key. Para a própria fila, consulte uip resource queues.

Para as convenções entre recursos (autenticação, escopo de pasta, tipos de chave, envelope de saída), consulte a visão geraluip resource .

Resumo

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

Liste itens de fila em uma pasta. Filtro: --queue-definition-key <guid> e/ou --queue-name <name> e/ou --status <state>.

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

get

Obtenha um item de fila por <queue-item-key> (o campo uniqueKey da saída list , exclusivo por tentativa).

Atualizar

Alterar campos em um item da fila. Opcional --progress, --priority <High|Normal|Low>, --due-date <ISO-8601>, --defer-date <ISO-8601>, --specific-content <json>.

definir progresso

Atualizar o texto de progresso de um item em progresso: set-progress <queue-item-key> <progress>.

excluir / excluir em massa

Exclua um ou muitos itens por <queue-item-key> / <queue-item-key...>. O formulário em massa exige que todos os itens pertençam à mesma pasta.

definir-revisão-status

Defina <status> (Retried, Abandoned, Deleted) como um ou mais <queue-item-key...>.

definir revisor / unset-reviewer

Atribuir ou limpar um revisor em um ou mais <queue-item-key...>. set-reviewer requer --user-key <guid>.

obter-revisores

Listar usuários disponíveis como revisores (com escopo de --folder-path / --folder-key , se fornecido). Feed de chaves retornadas set-reviewer --user-key.

Obter histórico

Retorna o histórico de processamento de um item da fila. Paginado por meio de -l, --limit / --offset.

obter a última tentativa

Retorna a repetição mais recente de um item. O argumento é a chave da cadeia de nova tentativa (o campo key de list, não de uniqueKey).

tem vídeo

Retorna se um item da fila tem uma gravação de vídeo anexada.

Adicionar

Adicione um único item a uma fila por nome. Requer <queue-name> e --specific-content <json>. Opcional -r, --reference, -p, --priority <High|Normal|Low> (padrão Normal), --defer-date, --due-date.

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

adição em massa

Adicione vários itens em uma solicitação. Requer <queue-name> e --queue-items <json-array>. Opcional --commit-type <AllOrNothing|StopOnFirstFailure|ProcessAllIndependently> (padrão ProcessAllIndependently).

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

Veja também

• uip resource queues — CRUD no nível da fila.
• Visão geraluip resource — convenções compartilhadas para cada verbo uip resource .
• Como fazer: gerenciar ativos e filas do Orchestrator — padrões em massa e envio orientado por CSV.