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.

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.