Atividades da tarefa

Atividades de tarefas de fila em processos BPMN do Maestro: campos necessários para criar, atualizar e resolver itens de fila do Orchestrator, organizados por atividade.

As atividades de tarefa de fila criam, atualizam e resolvem itens de fila do Orchestrator de uma tarefa em um processo BPMN do Maestro. As atividades de fila são acessadas a partir do menu suspenso Ação no painel Propriedades de uma tarefa. As atividades de fila estão disponíveis nos seguintes tipos de tarefa — consulte Tarefas para ver a lista completa:

• 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:

Um item da fila inicia exatamente uma instância de processo BPMN do Maestro. Uma única instância consumindo vários itens em um loop não é compatível com esta versão.

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.

O Maestro tenta novamente a tarefa automaticamente, a menos que a chamada subjacente falhe com um erro 4xx. Em caso de falha, a tarefa retorna o código de erro 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.