Ações de filas de trabalho
As filas de trabalho no Power Automate podem ser utilizadas para armazenar dados relevantes do processo e fornecer uma forma de desassociar processos e automatizações complexos, permitindo-lhes comunicar de forma assíncrona.
As filas de trabalho podem ter um papel crucial para melhorar a eficácia, a escalabilidade e a resiliência das automatizações, bem como ajudar a dar prioridade ao trabalho. As filas de trabalho permitem-lhe concluir primeiro os itens com a prioridade máxima, quer sejam processados por trabalhadores digitais, trabalhadores humanos ou integrações.
Nota
- O suporte ao nível de produção para o primeiro conjunto de ações relacionadas com a fila de trabalho requer a versão 2.37 ou posterior do Power Automate desktop.
- As ações de filas de trabalho no Power Automate para o ambiente de trabalho são uma caraterística premium que necessita de uma subscrição do Power Automate.
- Atualmente, apenas as ações Processar itens da fila de trabalho e Atualizar item da fila de trabalho podem ser classificadas e permitidas ou restritas por meio de políticas de prevenção de perda de dados (DLP), com outras ações em breve. Note que a utilização de filas de trabalho baseadas no fluxo de cloud não pode ser restringida pelas políticas DLP.
Processar itens de fila de trabalho
A ação Processar itens de fila de trabalho indica ao orquestrador de filas que a máquina está pronta para processar um ou mais itens de fila de trabalho. O contexto do utilizador que pede um novo item precisa de ter privilégios suficientes na fila de trabalho e na tabela de itens de fila de trabalho para processar as filas de trabalho.
A fila de trabalho referenciada na ação acima é utilizada pelo orquestrador de filas para determinar os próximos itens disponíveis nessa fila de trabalho que estão no estado Em fila. À medida que o fluxo de ambiente de trabalho percorre as ações dentro do ciclo Processar itens de fila de trabalho que esta ação compõe, pode chamar o valor utilizando a variável designada para a ação juntamente com a propriedade .Value. Neste caso, pode chamar o valor do item de fila de trabalho utilizando a variável %WorkQueueItem.Value%
processworkqueueitemaction
A ação Processar ação do item da fila de trabalho requer os seguintes argumentos.
Parâmetros de Entrada
| Argumento | Opcional | Aceita | Valor Predefinido | Descrição |
|---|---|---|---|---|
| Fila de trabalho | Não | Texto | O ID da fila de trabalho da fila de trabalho que contém os itens a processar |
Variáveis produzidas
| Argumento | Tipo | Descrição |
|---|---|---|
| WorkQueueItem | Não | Informações armazenadas no item de fila de trabalho que está a ser processado |
Exceções
| Exceção | Descrição |
|---|---|
| Fila de trabalho não encontrada | O valor introduzido no parâmetro de fila de trabalho é inválido |
| Falha ao processar fila de trabalho | Pedido incorreto - erro na sintaxe da consulta |
Atualizar item de fila de trabalho
A ação Atualizar item de fila de trabalho permite que os utilizadores alterem o estado e os resultados de processamento do item de fila de trabalho selecionado.
updateworkqueueitemaction
A ação Atualizar ação do item da fila de trabalho requer os seguintes argumentos.
| Argumento | Opcional | Aceita | Valor Predefinido | Descrição |
|---|---|---|---|---|
| Item de fila de trabalho | Não | Texto | Variável do item de fila de trabalho que foi anteriormente devolvida pelo orquestrador de filas | |
| Status | Não | Processado, Exceção Genérica | Processada | Atualize o item de fila de trabalho que está a ser processado utilizando um estado a partir da lista de opções. |
| Resultado de processamento | Sim | Texto | Resultado ou valor de processamento personalizados para definir a anexação ao item de fila que está a ser processado |
Exceções
| Argumento | Descrição |
|---|---|
| Item de fila de trabalho não encontrado | O item de fila de trabalho que está a ser processado foi eliminado ou já não pertence à fila da qual foi chamado. |
| Item de fila de trabalho em espera | O item de fila de trabalho que está a ser processado contém um estado de on hold no orquestrador de filas e já não pode ser atualizado. |
| Falha ao atualizar item de fila de trabalho | O item de fila de trabalho que está a ser atualizado encontrou um erro inesperado, verifique a mensagem de erro para obter mais detalhes. |
Adicionar item de fila de trabalho
A ação Adicionar item de fila de trabalho permite aos utilizadores preencherem os itens de fila de trabalho numa fila de trabalho, que foi configurada no portal do fluxo.
Ação addworkqueueitem
A ação Adicionar item da fila de trabalho requer os seguintes argumentos.
Parâmetros de Entrada
| Argumento | Opcional | Aceita | Valor Predefinido | Descrição |
|---|---|---|---|---|
| Fila de trabalho | Não | Valor de texto | O item de fila de trabalho em que adicionar o item | |
| Prioridade | Não | Alta, Normal, Baixa | Normal | A prioridade em que definir o item de fila de trabalho |
| Name | Não | Valor de texto, Valor numérico | Nome ou ID personalizado do novo item de fila de trabalho | |
| Entrada | Não | Valor de texto, Valor numérico | Os dados pertencentes à coluna de valor a ser processada | |
| Expira em | Sim | Datetime | O valor de datetime definido para expirar o item de fila, caso contrário, adota o valor predefinido se estiver definido um para a fila | |
| Notas de processamento | Sim | Valor de texto, Valor numérico | Notas de processamento personalizadas a adicionar ao novo item de fila |
Variáveis produzidas
| Argumento | Tipo | Descrição |
|---|---|---|
| WorkQueueItem | Não | Informações armazenadas para o item de fila de trabalho a ser adicionado |
Exceções
| Argumento | Descrição |
|---|---|
| Fila de trabalho não encontrada | O valor introduzido no parâmetro de fila de trabalho é inválido |
| Falha ao adicionar item à fila de trabalho | Não foi possível adicionar o item de fila de trabalho à fila de trabalho. Pedido incorreto - erro na sintaxe da consulta |
Colocar novamente o item em fila com atraso
A ação Recolocar item na fila com atraso permite que os utilizadores adicionem novamente um item da fila que está a ser processada no fluxo de trabalho, de volta à fila de origem do mesmo. Além disso, o item da fila pode ser mantido e lançado até uma hora definida.
requeueworkqueueitemaction
A ação Recolocar item na fila com atraso requer os seguintes argumentos.
Parâmetros de Entrada
| Argumento | Opcional | Aceita | Valor Predefinido | Descrição |
|---|---|---|---|---|
| Item de fila de trabalho | Não | Item de fila de trabalho | O item de fila de trabalho em que adicionar o item | |
| Atrasar até | Não | Valor de datetime | Normal | O valor de datetime aplicado para adiar o item da fila até |
| Expira em | Sim | Valor de datetime | Tempo de expiração personalizado para o item que está a ser colocado de novo na fila | |
| Resultado de processamento | Sim | Valor de texto, Valor numérico | Resultado de processamento personalizado a adicionar ao novo item de fila |
Exceções
| Argumento | Descrição |
|---|---|
| Fila de trabalho não encontrada | O valor introduzido no parâmetro de fila de trabalho é inválido |
| Item de fila de trabalho não encontrado | O valor do item de fila é inválido |
| Falha ao voltar a colocar item na fila de trabalho | Não foi possível adicionar o item de fila de trabalho à fila de trabalho. Pedido incorreto - erro na sintaxe da consulta |