artículos en cola de recursos de UIP

Gestionar artículos en cola : transacciones de trabajo individuales dentro de colas. Los elementos fluyen a través de estados: New → InProgress → Successful / Failed / Abandoned / Retried / Deleted. Los artículos en cola tienen ámbito de carpeta; la mayoría de los subcomandos requieren --folder-path o --folder-key. Para la cola en sí, consulta uip resource queues.

Para las convenciones de recursos cruzados (autenticación, ámbito de carpeta, tipos de clave, sobre de salida), consulta la uip resource descripción general.

Sinopsis

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

Lista

Enumera los artículos en cola en una carpeta. Filtro: --queue-definition-key <guid> y/o --queue-name <name> y/o --status <state>.

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

get

Obtener un artículo en cola por <queue-item-key> (el campo uniqueKey de la salida list , único por intento).

Actualizar

Cambiar campos en un artículo en cola. Opcional --progress, --priority <High|Normal|Low>, --due-date <ISO-8601>, --defer-date <ISO-8601>, --specific-content <json>.

establecer-progreso

Actualizar el texto de progreso de un elemento en curso: set-progress <queue-item-key> <progress>.

eliminar / eliminar masivamente

Eliminar uno o varios elementos por <queue-item-key> / <queue-item-key...>. El formulario masivo requiere que todos los elementos pertenezcan a la misma carpeta.

establecer-estado-de-revisión

Establece <status> (Retried, Abandoned, Deleted) para uno o más <queue-item-key...>.

establecer-revisor / no establecer-revisor

Asignar o borrar un revisor en uno o más <queue-item-key...>. set-reviewer requiere --user-key <guid>.

obtener revisores

Enumerar los usuarios disponibles como revisores (ámbito de --folder-path / --folder-key si se proporciona). Fuente de claves devueltas set-reviewer --user-key.

Obtener historial

Devuelve el historial de procesamiento de un artículo en cola. Paginado mediante -l, --limit / --offset.

obtener-último-reintento

Devuelve el reintento más reciente para un elemento. El argumento es la clave de la cadena de reintentos (el campo key de list, no uniqueKey).

tiene-vídeo

Devuelve si un elemento de la cola tiene una grabación de vídeo adjunta.

Añadir

Añade un único elemento a una cola por su nombre. Requiere <queue-name> y --specific-content <json>. Opcional -r, --reference, -p, --priority <High|Normal|Low> (predeterminado Normal), --defer-date, --due-date.

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

Añadir en masa

Añada varios elementos en una solicitud. Requiere <queue-name> y --queue-items <json-array>. Opcional --commit-type <AllOrNothing|StopOnFirstFailure|ProcessAllIndependently> (predeterminado ProcessAllIndependently).

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

Ver también

• uip resource queues : CRUD en el nivel de cola.
• Información generaluip resource : convenciones compartidas para cada verbo uip resource .
• Tutorial: gestionar activos y colas de Orchestrator : patrones masivos y envío impulsado por CSV.