Processar filas de trabalho

O processamento de filas de trabalho refere-se à gestão de uma lista de itens de trabalho que têm de ser concluídas numa determinada ordem. Esta lista contém informações sobre cada item, como o nome, prioridade, data de expiração, estado e o valor real a ser processado.

Formas de processar filas de trabalho:

• Processamento baseado em fluxo de ambiente de trabalho no ambiente de trabalho do Power Automate(PAD).

• Processamento baseado em fluxo de cloud e conector.

• Processamento baseado em fluxos de cloud com suporte de fluxo de ambiente de trabalho.

• Utilizar funcionalidades de desenvolvimento profissional do Dataverse (apenas para cenários de integração avançadas):

  • DataverseAPI Web
  • DataverseSDK para .NET

Saiba mais sobre as ferramentas de código profissional do Dataverse: documentação para programadores do Dataverse.

Processar procedimentos

Para demonstrar algumas das opções de processamento disponíveis, eis três cenários de processamento diferentes.

Processamento de filas de trabalho baseadas no fluxo de ambiente de trabalho no Power Automate Desktop (PAD)

Processar itens da fila de trabalho & Exemplos de atualização

O primeiro passo para utilizar as ações da fila de trabalho no Power Automate Desktop é criar uma fila de trabalho no ambiente em que está a trabalhar e carregar alguns itens da fila com dados a consumir a jusante. Os itens de filas podem ser carregados numa fila de trabalho através de um fluxo de ambiente de trabalho, fluxo de cloud ou em massa, conforme descrito aqui para preencher itens de fila. Neste exemplo, alguns itens de fila foram adicionados manualmente a uma fila de trabalho para explicar como as ações no Power Automate Desktop podem ser utilizadas.

Os itens da fila de trabalho foram criados e o campo de valor inclui texto no formato JSON que será utilizado a jusante no fluxo de ambiente de trabalho.

O fluxo de exemplo que vamos utilizar para demonstrar a utilização de ações de fila de trabalho simula um processo que consumiria um item da fila de trabalho a partir da nuvem, processar os dados incluídos no campo de valor e convertê-los num objeto personalizado para serem processados a jusante. Note que não é obrigatório utilizar objetos personalizados ou JSON como valores para os itens da fila de trabalho, mas pode ser um método útil para organizar valores que tenham várias propriedades e seguir um esquema específico.

1. A ação Processar itens de fila de trabalho é utilizada para designar a fila de trabalho a partir da qual os itens devem ser consumidos e processar no seu fluxo de ambiente de trabalho. A ação pode ser configurada para selecionar uma fila de trabalho a partir de uma lista utilizando a seta da lista pendente, transmitir uma variável, incluindo o nome da fila. Quando é executada, esta ação funciona ao trazer o primeiro item (mais antigo) da fila de trabalho no seu fluxo que contém o estado em fila. Quando o item da fila começa a ser processado no seu fluxo, o estado é alterado automaticamente para a processar.

   

   

2. Foi definido um ponto de interrupção (ponto vermelho) ao clicar junto à ação 3 no fluxo e, em seguida, ao executar através da consola PAD. Quando o processo entra em pausa no ponto de interrupção, a variável WorkQueueItem pode ser aberta ao fazer duplo clique no valor preenchido em Variáveis do fluxo, o que mostra todas as propriedades associadas ao item de fila de trabalho a ser processado.

   

3. Na ação 2 do fluxo, converti o valor JSON devolvido, que neste caso é acedido através de %WorkQueueItem.Value% num objeto personalizado. O motivo para isto é que ajuda a analisar o JSON e utiliza as propriedades JSON a jusante no seu fluxo. Neste caso hipotético, as informações seriam utilizadas para criar entradas no portal financeiro da Farbrikam.

   {
    "InvoiceId": "I-1006",
    "InvoiceDate": "06/04/2023",
    "AccountName": "Fabrikam",
    "ContactEmail": "invoicing@fabrikam.com",
    "Amount": 1253.78,
    "Status": "Paid",
    "WorkQueueKey": "Vendor Invoices",
    "ComponentState": 0,
    "OverwriteTime": "1900-01-01T00:00:00"
   }
   

   

   Por exemplo, se houvesse a necessidade de introduzir o ID da fatura num campo de um sistema financeiro como parte de um processo onde está a automatizar a IU de uma aplicação Web ou de computador, poderia chamar esse valor utilizando %JsonAsCustomObject.InvoiceId% para preencher um campo de texto e premir um botão.

4. Avançando, este exemplo contém algumas instruções condicionais depois de concluir o processamento dos passos e utiliza os dados do objeto personalizado na Entrada de Dados Fabrikam do subfluxo. Se o processo for executado ponto a ponto sem encontrar quaisquer exceções relacionadas com o sistema de entrada, a ação Atualizar item de fila de trabalho é utilizada para alterar o estado do item da fila de trabalho para Processado e o campo resultado do processamento pode ser utilizado para introduzir algumas notas opcionais. Se o campo expira ficar em branco, o novo item da fila retém o valor Os itens expiram após definido nas propriedades da fila de trabalho.

   

   As opções de processamento de exceções podem ser configuradas ao clicar em com erro na janela de configuração da ação atualizar item de fila de trabalho. Estão disponíveis três opções para personalização no separador avançado. Item de fila de trabalho não encontrado poderá ocorrer se o item de fila de trabalho for removido da fila, seja manualmente ou através de outro processo sistemático, antes de terminar o processamento no PAD. O Item de fila de trabalho em espera poderá ocorrer se um processo automatizado ou alguém alterar o estado do item de fila de trabalho a ser processado para em espera no portal do fluxo enquanto o item de fila estiver a ser processado. Falha ao atualizar item de fila de trabalho poderá ocorrer se o item de fila já não existir na fila ou tiver sido colocado no estado em espera. Todos os exemplos anteriores são casos limite, que podem ocorrer: saiba mais sobre a gestão de erros nos fluxos de ambiente de trabalho aqui.

   

5. Se algum problema tiver sido determinado no processamento dos dados do item de fila de trabalho no sistema de entrada de dados, em alternativa, poderá ser atribuído ao item o estado exceção genérica, exceção de TI ou exceção empresarial. Estes estados de exceção estão disponíveis para serem utilizados quando, ou se, o seu caso de utilização automatizada satisfizer os critérios que podem ser aplicados.

   

   Imagine que durante o processamento de um item de fila o cenário 2 foi cumprido. Neste caso, o item de fila está marcado como exceção genérica na fila de origem. Consoante o cenário, poderá decidir alterar o estado dos itens da fila que não foi possível processar com êxito como uma das opções de estado alternativas. A partir daí, pode decidir se a é necessária intervenção humana ou criar um processo subsequente com a lógica necessária para gerir cada estado de exceção.

   

Padrão de repetição automática

A ação Processar itens da fila de trabalho no ambiente de trabalho do Power Automate inclui uma opção avançada para configurar ou substituir um mecanismo de repetição automática. Esse recurso permite especificar a contagem máxima de tentativas automáticas por item da fila de trabalho, o que é útil para lidar com exceções de TI, como erros de rede transitórios ou indisponibilidade temporária do sistema. Permite que a máquina retenha o item e execute repetições controladas sem recolocar o item em fila, garantindo um processamento mais eficiente e resiliente da fila de trabalho.

Pode definir e controlar centralmente a contagem máxima de tentativas no registo da fila de trabalho do Dataverse. Este valor predefinido aplica-se a todos os fluxos de ambiente de trabalho que processam esta fila de trabalho através da ação Processar Itens da Fila de Trabalho.

Para substituir a predefinição a nível da fila no seu fluxo, navegue até a secção Avançado da ação Processar itens da fila de trabalho e alterne a opção Substituir configuração de repetição automática da fila de trabalho. Esta definição permite ajustar a contagem máxima de repetições para um valor maior ou menor ou até mesmo desativar o mecanismo de repetição definindo a contagem máxima de repetições para 0.

Quando usa a ação Atualizar item da fila de trabalho com um estado definido como IT exception e uma contagem máxima de tentativas automáticas maior que 0, o sistema não envia imediatamente a atualização para o orquestrador da fila de trabalho. Em vez disso, tenta novamente a operação até atingir a contagem máxima de tentativas especificada. O único valor atualizado no item da fila de trabalho é o retrycount. Esse valor aumenta a partir da segunda tentativa de atualização até que a contagem máxima de tentativas automáticas seja atingida. Além disso, uma variável de item da fila de trabalho local chamada CurrentRetryCount incrementa a cada nova tentativa. Essa variável permite implementar lógica personalizada com base no seu valor, se necessário.

O fluxo não solicitará um novo item quando voltar para a parte superior da ação Processar itens da fila de trabalho se as seguintes condições forem atendidas:

• A contagem máxima de tentativas não é atingida.
• Nenhuma outra atualização ocorre, exceto exceções de TI.

Quando a contagem máxima de tentativas é atingida, a ação de atualização envia a atualização para o orquestrador, alterando o estado do item para Exceção de TI e incluindo quaisquer notas de processamento fornecidas.

Adicionando e colocando exemplos de itens de trabalho em fila do PAD

Adicionar item de fila de trabalho permite aos utilizadores do fluxo de ambiente de trabalho preencher os itens de fila de trabalho numa fila de trabalho que foi configurada no portal do fluxo. A criação de itens em lote é suportada usando a ação Adicionar itens da fila de trabalho.

Neste exemplo, um ficheiro Excel em .csv é largado diariamente num diretório, sendo necessário adicionar cada linha a uma fila de trabalho.

O primeiro par de ações neste processo de exemplo mapeia uma pasta onde o ficheiro diário Invoices.csv da Contoso é largado: quando o processo é executado, começa por ler a tabela de dados a partir do ficheiro CSV. A variável CSVTable contém os dados que foram importados e será tratada para novos itens de fila.

As ações 3 e 4 geram o momento em que escolhemos os novos itens de fila para expirar depois de serem adicionados a uma fila de trabalho. A Ação 3 captura a data e hora do sistema atuais e, para este exemplo, são adicionados 7 dias ao mesmo utilizando a ação %Add to datetime%. Os resultados são armazenados numa variável denominada ExpiryDatetime, que será utilizada na ação Adicionar item de fila de trabalho.

A Ação 5 introduz o ciclo Por cada utilizado para iterar através de cada linha de dados na CSVTable importada: esta ação compõe uma fila de dados para o item atual que está a ser processado.

Todas as ações anteriores neste fluxo de ambiente de trabalho de exemplo são agora incorporadas na definição dos valores para a ação Adicionar item de fila de trabalho.

O parâmetro fila de trabalho está definido para a fila à qual pretendemos adicionar novos itens de fila de trabalho: neste caso, a Fila PAD de demonstração foi selecionada ao escolhê-la no menu pendente.

O parâmetro Prioridade é deixado com o valor predefinido, Normal, mas as opções para Baixo e Alto também são opcionais. Os itens da fila de trabalho de prioridade elevada são processados primeiro, depois os de prioridade normal e os últimos quando são misturados na mesma fila de trabalho.

O parâmetro Nome foi definido com um prefixo estático junto ao valor da variável CurrentItem['ID'] que contém o valor da célula de ID da fila de dados que está a ser processada. Isto é opcional, mas pode ser útil consoante o seu caso de utilização.

Ao utilizar os valores da linha de dados na variável CurrentItem, o parâmetro Entrada foi introduzido no formato JSON. Note que cada nome de cabeçalho foi anexado à variável currentitem utilizando a notação ['nome do cabeçalho']

O campo Expira em é preenchido com a variável datetime com que adicionámos 7 dias nos passos anteriores. Quando fica em branco, o item de fila de trabalho que está a ser adicionado contém o valor Os itens expiram após definido para a fila de trabalho.

As notas de processamento são opcionais - utilize-as como considerar necessário.

Quando o processo é executado, cada linha de dados no CSV importado cria um item de fila de trabalho contendo o estado Em fila, o que significa que está disponível para processamento.

Estas são apenas algumas das várias formas como as ações da fila de trabalho podem ser utilizadas no PAD. Dedique algum tempo a explorar e a encontrar utilizações criativas para incorporar filas de trabalho nos seus fluxos do Power Automate!

Exemplo de recolocar item na fila com atraso

A ação Recolocar item na fila com atraso permite que os utilizadores do fluxo de ambiente de trabalho recoloquem itens na fila e definam um período de atraso no qual o item pode ser libertado novamente para processamento.

Neste exemplo, há uma fila de trabalho carregada com itens, que são definidos para expirar em 24 horas, mas não podem ser processados a tempo porque há alguma manutenção de rotina contínua do sistema a ser executada pelas TI e os itens precisam de ser recolocados na fila. A manutenção será concluída durante a noite, então vamos continuar a atrasar cada item da fila por 24 horas e, em seguida, defini-los para expirar 24 horas após o período de libertação.

As três primeiras ações deste processo de exemplo são ações de data e hora. A ação "Obter data e hora atuais" captura a datetime do sistema no momento em que a ação é executada. Em seguida, usamos a ação "Adicionar à datetime" para cobrir dois requisitos, primeiro precisamos de definir o tempo de atraso adicionando 24 horas à datetime atual - depois precisamos de adicionar 48 horas à datetime atual como uma expiração.

Em seguida, no exemplo, a ação "Processar itens da fila de trabalho" é configurada para apontar para a fila de trabalho carregada e "Recolocar item na fila com atraso" é colocada dentro do ciclo.

Os valores gerados para o atraso e a expiração podem agora ser passados para a ação "Recolocar item na fila com atraso". O campo "item da fila de trabalho" é preenchido pela variável produzida pelo ciclo - isso instrui que item da fila deve ser recolocado na fila. Em seguida, conectamos os valores criados usando as ações datetime para os campos "atrasar até" e "expira". O "atrasar até" é obrigatório, mas pode usar "expira" e "resultado do processamento" a seu critério.

Com este processo simples, pode recolocar na fila todos os itens disponíveis numa fila, atrasá-los por um determinado tempo, com opções para também definir uma data de expiração e resultado do processamento.

Fluxo de cloud e processamento baseado em conectores

A forma mais simples de remover da fila um item da fila de trabalho e processá-lo é da seguinte forma:

1. Aceda a Power Automate e inicie sessão com as suas credenciais.

2. No menu esquerdo, selecione Os meus fluxos.

3. Na barra de ferramentas, selecione + Novo fluxo e, em seguida, selecione Fluxo de cloud instantâneo.

4. Forneça um Nome de fluxo, como O meu primeiro fluxo de fila de trabalho e, em seguida, selecione Acionar manualmente um fluxo.

5. Selecione Criar.

6. Depois de o estruturador de fluxos abrir, selecione + Novo passo e, em seguida, selecione o conector do Microsoft Dataverse.

7. Na lista de ações, selecione Efetuar uma ação dependente.

Parâmetro	valor	Descrição
Nome da tabela	Filas de Trabalho	O nome da tabela da fila de trabalho.
Nome da ação	Remover da fila	A ação, que obtém o próximo item disponível da fila.
ID da Linha	[ID da Fila de Trabalho]	O ID da fila de trabalho (GUID) da fila a partir da qual gostaria de remover da fila. Pode chegar a este valor navegando até a página de detalhes da fila de trabalho da fila e abrindo o painel Detalhes avançados.

Nota

Uma ação dependente é uma ação do Dataverse que está definida numa tabela específica (filas de trabalho no nosso exemplo) e só pode ser executada nos registos dessa tabela. As ações dependentes são utilizadas pela plataforma para executar lógica de negócio personalizada ou operações num registo específico.

1. Agora, o seu fluxo deve ser semelhante a este.

1. Selecione Guardar e, em seguida, Teste o fluxo.

2. No painel lateral de testes, selecione Manualmente, Testar, Executar fluxo e, em seguida, Concluído.

3. Se o fluxo tiver sido executado com êxito, deverá obter um resultado semelhante (mas com ID diferentes).

1. Em seguida, copie o conteúdo JSON completo a partir do campo corpo e, em seguida, selecione Editar no canto superior direito do fluxo.

Gorjeta

Depois de remover da fila um item da fila de trabalho, utilize o conteúdo JSON do item como exemplo de esquema para analisar as propriedades JSON do item. Isto permite-lhe aceder facilmente a qualquer propriedade do item devolvida pelo orquestrador da fila de trabalho em ações subsequentes do fluxo.

1. Adicione um novo passo selecionando + Novo passo e pesquise por uma ação chamada Analisar JSON e selecione-a.

1. Posicione o rato no campo Conteúdo e selecione a propriedade corpo na ação anterior.

1. Em seguida, selecione Gerar a partir da amostra e cole a cadeia JSON anteriormente copiada para o diálogo e selecione Concluído.

2. Selecione + Novo passo e, em seguida, selecione o conector do Microsoft Dataverse.

3. A partir da lista de ações, selecione Atualizar uma linha.

4. No campo Nome da tabela, seleccione a tabela Itens da Fila de Trabalho e posicione o cursor no campo ID da Linha.

5. Na lista Conteúdo dinâmico , tem agora todos os campos disponíveis na tabela de itens da fila de trabalho.

6. Selecione Mostrar opções avançadas e, em seguida, defina os campos RowID, Processamento do resultado, Estado e Razão do Estado aos seguintes valores.

Campo	valor	Details
ID da Linha	workqueueitemid	Este valor pode ser selecionado no diálogo de lista de conteúdo dinâmico.
Resultado do Processamento	O item foi processado com sucesso.
Status	Processada
Razão do Estado	Processada

1. Selecione Guardar e Teste o fluxo mais uma vez.

2. Se o fluxo tiver sido executado com êxito, deverá obter um resultado semelhante ao seguinte.

   

3. Agora, navegue para a página de detalhes da fila de trabalho e na secção da lista de itens da fila de trabalho selecione Ver tudo.

4. Filtre o campo Estado para mostrar apenas os itens Em processamento e Processados para confirmar que as nossas ações remover da fila e atualizar funcionaram como previsto.

   

   

   

   Parabéns, acabou de concluir o primeiro cenário de processamento da fila de trabalho!

Processamento baseado em fluxos de cloud com suporte de fluxo de ambiente de trabalho

Neste cenário, expandimos o anterior adicionando também um passo de processamento do fluxo de ambiente de trabalho.

1. Volte atrás e edite o Meu primeiro fluxo de fila de trabalho.

2. Adicione uma nova ação imediatamente após a ação Analisar JSON e pesquise pelo conector Fluxos de ambiente de trabalho e Executar um fluxo criado com o Power Automate para ambiente de trabalho.

3. Na lista pendente do fluxo de ambiente de trabalho, escolha e edite um fluxo de ambiente de trabalho existente ou selecione + Criar um novo fluxo de ambiente de trabalho e siga as instruções no ecrã para criar o fluxo de ambiente de trabalho e iniciar o Power Automate para computadores. Se for novo nos fluxos de ambiente de trabalho, pode saber mais aqui.

4. Assim que o estruturador do Power Automate para computadores abre, crie duas variáveis de entrada chamadas WorkQueueItemValue e WorkQueueItemName e, em seguida, adicione duas variáveis de saída chamadas ProcessingNotes e ProcessingStatus respetivamente, que vem ter todas Texto como o seu tipo de dados.

5. Forneça um valor predefinido para a variável WorkQueueItem , para que possa testar posteriormente o script localmente. Caso tenha seguido o tutorial de importação em massa, deve ter itens da fila de trabalho na fila de faturas do Fornecedor que tenham os seus valores no formato JSON. Eis um exemplo de um dos valores utilizados.

   {
    "InvoiceId": "I-1006",
    "InvoiceDate": "06/04/2023",
    "AccountName": "Fabrikam",
    "ContactEmail": "invoicing@fabrikam.com",
    "Amount": 1253.78,
    "Status": "Paid",
    "WorkQueueKey": "Vendor Invoices",
    "ComponentState": 0,
    "OverwriteTime": "1900-01-01T00:00:00"
   }
   

   

6. Agora, Guarde o fluxo.

7. No painel de ação, abra o grupo de ações Variáveis e clique duas vezes na ação Converter JSON em objeto personalizado para o adicionar à tela do estruturador, que abre a sua janela de propriedades.

8. Selecione o ícone de variável no campo JSON e escolha a variável WorkQueueItemValue.

9. Mudar a variável de saída produzida de JsonAsCustomObject para VendorInvoice e selecione Guardar.

10. Em seguida, adicione uma ação Se a partir do grupo Condicionais e configure as propriedades do seguinte modo:

    First operand	Operator	Second operand
    %VendorInvoice['Amount']%	Menor que (<)	5000

11. Selecione Guardar.

12. Adicione outra ação a partir do grupo Condicionais chamada Caso contrário e adicione-a entre a ação Se e Fim.

13. Agora, adicione outras duas ações a partir do grupo Variáveis chamada Definir variável e adicione-as às ações Se e Caso contrário e defina as variáveis ProcessingNotes e ProcessingStatus com os seguintes valores:

    Variável	valor
    %ProcessingNotes%	A fatura foi processada
    %ProcessingStatus%	Processada

14. Copie as duas ações Definir variável e cole-as entre a a ação Caso contrário e Fim e altere os seus valores para corresponderem aos seguintes:

    Variável	valor
    %ProcessingNotes%	Exceção de negócio: o montante da fatura é maior que 5.000 USD, pelo que necessita da aprovação do gestor.
    %ProcessingStatus%	Exceção

15. Agora, o seu fluxo deve ser semelhante a este.

    

16. Guarde o fluxo e execute-o para confirmar que a lógica de fluxo funciona conforme esperado.

17. Volte atrás para editar o Meu primeiro fluxo de fila de trabalho.

18. Selecione o fluxo de ambiente de trabalho recém-criado (ou editado) a partir da lista e, em seguida, selecione Assistido como o seu Modo de Execução.

19. Preencha os parâmetros Valor de Item da Fila de Trabalho e Nome de Item da Fila de Trabalho como mostrado aqui:

    

20. Adicione uma ação de Condição antes da ação Atualizar uma linha.

21. Posicione o rato no campo Escolher um valor e selecione Estado de Processamento a partir do diálogo da lista de conteúdo dinâmico.

22. Posicione o rato no outro campo Escolher um valor e introduza Processado como valor de texto.

23. Arraste e largue a ação Atualizar uma linha na secção Se sim da ação de condição.

24. Abra os detalhes da ação Atualizar uma linha e substitua os valores para corresponderem ao seguinte:

    

25. Na caixa vermelha Se não, adicione outra ação Atualizar uma linha e selecione Itens da Fila de Trabalho como Nome da tabela.

26. Em seguida, selecione workqueueitemid como ID de Linha e abra a secção Mostrar opções avançadas, selecione Notas de processamento como o valor Processamento do resultado.

27. Selecione Erro como Estado e GenericException para Razão do Estado.

    

28. Selecione Guardar e Testar para testar a automatização global e observar os resultados da ação de fluxo de ambiente de trabalho.

    

29. Para confirmar que o item da fila de trabalho foi processado, pode ir à página de detalhes da fila de trabalho, selecionar Ver tudo na secção de itens da fila de trabalho e filtrar os itens pelo estado Processado.

    

Muito bem, acabou de concluir um cenário mais avançado que incluía o processamento de filas de trabalho híbridas!

Próximos passos

Aprender a acionar filas de trabalho

Saber mais

• Descrição geral da fila de trabalho
• Gerir filas de trabalho
• Importar em massa os dados da fila de trabalho
• Acionar filas de trabalho
• Problemas e limitações conhecidos