Atividades de tarefa de fila

Queue task activities in BPMN processes: required fields for creating, updating, and resolving Orchestrator queue items, organized by activity.

Queue task activities create, update, and resolve Orchestrator queue items from a task in a BPMN process. Queue activities are accessed from the Action dropdown in a task's Properties panel. Queue activities are available in the following task types — refer to Tasks for the full list:

• Tarefas de serviço
• Tarefas do usuário
• Enviar tarefas
• Receber tarefas
• Tarefas de regras de negócios
• Tarefas do script

Ciclo de vida do item da fila

Estado	Como é alcançada
Novo	O item é adicionado à fila.
InProgress	Um gatilho de fila inicia uma instância de processo para o item e a define como InProgress.
Êxito / Falha	O processo define o estado final com Set transaction status.
Abandonado	Automático, se um item permanece InProgress por 24 horas sem atingir um estado final. Se a nova tentativa estiver configurada na fila, o Orchestrator clona o item e o coloca novamente na fila.

Observação:

One queue item starts exactly one BPMN process instance. A single instance consuming multiple items in a loop isn't supported in this release.

Criar itens da fila

Adiciona um novo item a fila do Orchestrator com status Novo .

Campo	Required	Description
Nome da fila	Sim	A fila do Orchestrator à qual adicionar o item.
Caminho da pasta	Sim	A pasta do Orchestrator que contém a fila.
Prioridade	Não	A prioridade de processamento do item.
Prazo	Não	A data e a hora até as quais o item deve ser processado.
Adiar data	Não	A primeira data e hora em que o item fica disponível para processamento.
Dados personalizados	Não	Dados adicionais anexados ao item, disponíveis para o robô ou processo que o processa.

Criar e aguardar itens da fila

Adiciona um item a uma fila e aguarda o item atingir um estado final antes de continuar o processo. Usa os mesmos campos que Criar itens de fila.

Get queue items

Consulta itens em uma fila do Orchestrator sem removê-los da fila ou bloqueá-los, para inspeção somente leitura ou ramificação condicional com base no estado da fila.

Campo	Required	Description
Nome da fila	Sim	A fila do Orchestrator a ser consultada.
Caminho da pasta	Sim	A pasta do Orchestrator que contém a fila.
Status	Não	Filtra por status do item.
Referência	Não	Filtra por referência de item.
Intervalo de datas de criação	Não	Filtre pelo intervalo de datas em que o item foi criado.
Prioridade	Não	Filtra por prioridade do item.

A atividade retorna os 100 itens correspondentes mais recentes e uma contagem total. Um filtro que corresponde a mais de 100 itens retorna uma lista truncada — restrinja o filtro para ver os itens restantes.

Aguardar evento da fila

Disponível em uma tarefa de recebimento ou um evento de captura intermediário, esse elemento de espera bloqueia a execução até que um item de transação fique disponível em uma fila do Orchestrator.

Campo	Required	Description
Nome da fila	Sim	A fila do Orchestrator para aguardar.
Caminho da pasta	Sim	A pasta do Orchestrator que contém a fila.

Quando um item é removido da fila, seus campos ficam disponíveis como saídas de processo, no mesmo formato que Get queue items. A espera não tem tempo limite — anexe um temporizador de limite para parar de esperar após uma duração definida. Esse elemento é compatível com os mecanismos de execução V1 e V2.

Bulk add queue items

Adiciona vários itens a uma fila em um único lote, até 15.000 itens por chamada.

Campo	Required	Description
Nome da fila	Sim	A fila do Orchestrator à qual adicionar itens.
Caminho da pasta	Sim	A pasta do Orchestrator que contém a fila.
Itens	Sim	A lista de itens a serem adicionados, até 15.000 por chamada.
Tipo de confirmação	Sim	AllOrNothing rejeita o lote inteiro se algum item falhar na validação. ProcessAllIndependently adiciona todos os itens válidos e relata falhas individualmente.

Quando o tipo de confirmação é ProcessAllIndependently, a atividade retorna a lista de itens que não puderam ser adicionados.

Delete queue items

Remove itens com status Novo de uma fila especificada.

Campo	Required	Description
Nome da fila	Sim	A fila do Orchestrator da qual remover itens.
Caminho da pasta	Sim	A pasta do Orchestrator que contém a fila.
Itens	Sim	Os itens a serem removidos. Somente itens com status Novo podem ser removidos.

Postpone transaction item

Define uma data de adiamento e, opcionalmente, uma data de vencimento para um item de transação em andamento, e retorna o item para o status Novo .

Campo	Required	Description
Data de Adiamento	Sim	A primeira data e hora em que o item fica disponível para processamento novamente.
Data de conclusão	Não	O prazo até o qual o item deve ser processado.

Observação:

Adiar o item de transação não é repetido automaticamente quando a chamada subjacente falha com um erro 4xx.

Set transaction progress

Atualiza um item de transação InProgress com uma string de status personalizada. O status é visível no Orchestrator.

Campo	Required	Description
Progresso	Sim	Uma string de texto personalizada que descreve o estado de processamento atual do item.

Set transaction status

Define o estado final de um item de transação como Bem-sucedido ou Falhado.

Campo	Required	Description
Status	Sim	Bem-sucedido ou Falhado.
Tipo de Erro	Condicional	Obrigatório quando o status é Failed. BusinessException ou ApplicationException.
Motivo do erro	Condicional	Obrigatório quando o status é Failed. Uma breve descrição do erro.
Detalhes do Erro	Não	Informações adicionais de erro.

Maestro Orchestrate automatically retries the task unless the underlying call fails with a 4xx error. On failure, the task returns the error code OrchestratorSetTransactionResultFailed.

Para o gatilho que inicia um processo a partir de um item da fila, consulte Eventos. Para obter mais informações sobre tarefas, consulte Tarefas na modelagem BPMN.