Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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 fila de trabalho no Power Automate para computador são uma funcionalidade premium, que requer 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. Tenha em atenção que a utilização de filas de trabalho baseadas em fluxos na cloud não pode ser restringida por políticas de 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 solicita um novo item precisa de ter privilégios suficientes na fila de trabalho e na tabela de itens da fila de trabalho para processar filas de trabalho.
A fila de trabalho referenciada na ação anterior é usada 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 do ambiente de trabalho percorre as ações dentro do ciclo Processar itens da fila de trabalho que esta ação gera, pode aceder ao valor utilizando a variável que designou 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%
Importante
Ao fornecer uma expressão FetchXML no campo "Filtrar linhas", contorna a lógica FIFO predefinida do orquestrador da fila de trabalho para os itens na fila. Isto permite definir uma ordem personalizada de retirada da fila e ignorar as datas de expiração dos itens e outras definições que são aplicadas automaticamente quando não é fornecida nenhuma expressão de filtro.
Processworkqueueitemaction
A ação Process work queue item action 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 que contém os itens a processar. | |
| Filtrar linhas | Sim | Texto | A expressão de consulta FetchXML utilizada para obter os itens da fila de trabalho. | |
| Substituir configuração de nova tentativa automática da fila de trabalho | Sim | booleano | Falso | Quando esta opção é ativada, é apresentado um campo que lhe permite definir ou sobrescrever o número máximo de tentativas para IT Exceptions. |
| Contagem máxima de tentativas | Não | Valor de texto, Valor numérico | Quando este valor não é substituído, é utilizado o número máximo de tentativas predefinido no registo da fila de trabalho. | O número máximo de repetições permitidas para IT Exceptions. Este parâmetro permite ajustar a contagem de repetições para um valor maior ou menor ou até mesmo desativar o mecanismo de repetição definindo a contagem como 0. |
Variáveis produzidas
| Argumento | Tipo | Descrição |
|---|---|---|
| WorkQueueItem | Item de fila de trabalho | 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. |
| Fila de trabalho em pausa ou parada | A fila de trabalho está pausada ou parada, o que não é um estado válido durante o processamento de itens. |
| FetchXML inválido | Foi fornecida uma expressão FetchXML inválida. |
| Falha ao processar fila de trabalho | Pedido incorreto — erro na sintaxe da consulta. |
O que são FetchXML consultas?
Microsoft Dataverse FetchXML é uma linguagem usada para recuperar dados de um Dataverse banco de dados. Foi concebido para ser fácil de criar, utilizar e compreender. Por exemplo, poderá querer pedir ao orquestrador para processar itens segundo uma ordem diferente da FIFO (primeiro a entrar, primeiro a sair) e dentro de um prazo de expiração específico.
Para limitar o suporte da consulta FetchXML ao processamento de itens da fila de trabalho, é suportado um conjunto limitado de termos e expressões de FetchXML. Estes termos incluem filtros, condições e expressões de ordenação, sendo todos limitados à tabela de itens da fila de trabalho (workqueueitem). Apenas os itens que estão num estado Queued são devolvidos.
Exemplo de consulta FetchXML
Segue-se um exemplo de expressão de consulta sobre como filtrar pelo name e ordenar os resultados pelos registos que expiram primeiro (FEFO).
<filter type="and">
<condition attribute="expirydate" operator="on-or-before" value="2024-10-18" />
<condition attribute="name" operator="eq" value="MyNonUniqueNameString" />
</filter>
<order attribute="expirydate" descending="false" />
Detalhes e dados de referência do suporte de consultas
- Lista de operadores de consulta disponíveis para utilizar, incluindo operadores como em ou antes de, entre e mês passado.
- Lista de atributos disponíveis na tabela de itens da fila de trabalho.
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 item da fila de trabalho requer os seguintes argumentos.
| Argumento | Opcional | Aceita | Valor Predefinido | Descrição |
|---|---|---|---|---|
| Elemento da 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 | Exceção Genérica Processada | Processado | Atualize o item de fila de trabalho que está a ser processado utilizando um estado a partir da lista de opções. |
| Notas de processamento | Sim | Texto | Notas de processamento personalizadas ou valor a acrescentar ao item na fila que está a ser processado. | |
| Limpar notas de processamento | Sim | booleano | Falso | Quando ativado, oculta e limpa o campo de notas de processamento neste ecrã e remove quaisquer notas de processamento da base de dados que tenham sido anteriormente capturadas para este item. |
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 da 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 à 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.
Enqueueworkqueueitemaction
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 do texto | O item da fila de trabalho ao qual adicionar o item | |
| Prioridade | Não | Alta, Normal, Baixa | Normal | A prioridade a atribuir ao item da 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 que pertencem à coluna de valores a processar | |
| Expira em | Sim | Data e hora | O valor de data e hora definido para expirar o item da fila; caso contrário, é adotado o valor predefinido, se tiver sido 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 | |
| Tem ID ou referência exclusiva | Sim | Valor de texto, Valor numérico | Quando ativado, deve ser fornecido um valor exclusivo dentro desta fila. Se deixado vazio, um valor exclusivo no formato de system-<GUID> é fornecido automaticamente pelo sistema |
Variáveis produzidas
| Argumento | Tipo | Descrição |
|---|---|---|
| WorkQueueItem | Item de fila de trabalho | 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 da fila de trabalho na fila de trabalho. Pedido incorreto - erro na sintaxe da consulta |
Adicionar vários itens de fila de trabalho
A ação Adicionar vários itens da fila de trabalho permite que os utilizadores adicionem um ou mais itens da fila de trabalho a uma fila de trabalho com base nos dados fornecidos como tabela de dados de item da fila de trabalho.
Esta ação requer uma tabela de dados personalizada que contenha um ou mais itens da fila de trabalho. A tabela de dados tem de ter oito colunas e estar em conformidade com o seguinte esquema:
| Nome da Coluna | Descrição | Obrigatório | Valores Permitidos |
|---|---|---|---|
| Nome | O nome do item. | Não | Qualquer cadeia alfanumérica |
| Entrada | Detalhes ou dados de entrada do item. | Sim | Qualquer cadeia alfanumérica |
| Expira em | Especifica a duração até que o item expire. | Não | Valor de data e hora |
| Notas de processamento | Processamento de notas relacionadas com o item. | Não | Qualquer cadeia alfanumérica |
| Prioridade | O nível de prioridade do item. | Sim | Valor numérico de ou 100 (Alto), 200 (Normal), 300 (Baixo) |
| Referência exclusiva | Um identificador exclusivo ou valor de referência para o item. | Não | Qualquer cadeia alfanumérica ou referência exclusiva |
| Estado | Estado do item durante a ingestão. | Sim | Valor numérico igual a zero (Em fila) ou a um (Em espera). |
| Adiar até | Especifica uma data e hora até à qual os itens da fila de trabalho devem ser ignorados no processamento. | Não | Valor de data e hora |
Fragmento de código Robin para criar a tabela de dados
O exemplo a seguir é um fragmento de código Robin (utilizado em fluxos tradicionais) que pode copiar e colar diretamente na janela do estruturador do ambiente de trabalho do Power Automate. Este fragmento adiciona uma ação Criar nova tabela de dados com o conjunto de campos esperado ao seu fluxo.
Variables.CreateNewDatatable InputTable: { ^['Name', 'Input', 'Expires in', 'Processing notes', 'Priority', 'Unique reference', 'Status', 'Delay until'], [$'''''', $'''''', $'''''', $'''''', $'''''', $'''''', $'''''', $''''''] } DataTable=> DataTable
Fragmento de código PowerFx para criar a tabela de dados
O exemplo a seguir é um fragmento de código PowerFx que pode copiar e colar diretamente na janela do estruturador do Power Automate para computadores. Este fragmento adiciona uma ação Criar nova tabela de dados com o conjunto de campos esperado ao seu fluxo.
Variables.CreateNewDatatable InputTable: { ^['Name', 'Input', 'Expires in', 'Processing notes', 'Priority', 'Unique reference', 'Status', 'Delay until'], [$fx'', $fx'', $fx'', $fx'', $fx'', $fx'', $fx'', $fx''] } DataTable=> DataTable
Batchenqueueworkqueueitemsaction
A ação Adicionar vários itens de fila de trabalho requer os argumentos seguintes.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor Predefinido | Descrição |
|---|---|---|---|---|
| Fila de trabalho | Não | Valor do texto | O item da fila de trabalho ao qual adicionar o item | |
| Dados do item da fila de trabalho | Sim | Tabela de dados | A tabela de dados personalizada que contém os itens da fila de trabalho a serem adicionados à fila de trabalho |
Variáveis produzidas
| Argumento | Tipo | Valor Predefinido | Descrição |
|---|---|---|---|
| FailedWorkQueueItems | Não | Ativado | Se houver falhas, este objeto manterá o índice do item que não pôde ser inserido junto com um código de erro. O índice devolvido é a posição (índice) do item na tabela de dados da fila de trabalho fornecida da ação Adicionar vários itens de fila de trabalho. |
| HasFailedItems | Não | Ativado | Um indicador que indica se ocorreram erros de ingestão nas ações devido a problemas com os dados dos itens da fila de trabalho. |
| SuccessfulWorkQueueItems | Desativado | Não | Um objeto personalizado que contém o índice e os itens da fila de trabalho que foram adicionados com êxito à fila de trabalho. |
Exceções
| Argumento | Descrição |
|---|---|
| Fila de trabalho não encontrada | O valor introduzido no parâmetro de fila de trabalho é inválido |
| Fila de trabalho em pausa ou parada | O item da fila de trabalho não pôde ser adicionado à fila de trabalho porque a fila de trabalho está em pausa ou parada. |
| Falha ao colocar em fila em lote uma lista de itens da fila de trabalho | Os itens da fila de trabalho não puderam ser adicionados à fila de trabalho devido a um pedido ou erro de comunicação. |
Colocar novamente o item em fila com atraso
A ação Colocar novamente o item em fila com atraso permite que os utilizadores voltem a colocar um item de fila que está a ser processado no fluxo do ambiente de trabalho na fila de origem. Além disso, o item em fila pode ser retido e libertado até uma hora determinada.
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 |
|---|---|---|---|---|
| Elemento da fila de trabalho | Não | Item de fila de trabalho | O item da fila de trabalho ao qual adicionar o item | |
| Aguardar até | Não | Valor de data e hora | O valor de data e hora utilizado para adiar o item da fila até | |
| Expira em | Sim | Valor de data e hora | Tempo de expiração personalizado para o item que será novamente colocado na fila | |
| Notas de processamento | Sim | Valor de texto, Valor numérico | Notas de processamento personalizadas a adicionar ao novo item de fila | |
| Limpar notas de processamento | Sim | booleano | Falso | Quando ativado, oculta e limpa o campo de notas de processamento neste ecrã e remove quaisquer notas de processamento da base de dados que tenham sido anteriormente capturadas para este item |
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 na fila o item da fila de trabalho | Não foi possível adicionar o item da fila de trabalho na fila de trabalho. Pedido incorreto - erro na sintaxe da consulta |
Atualizar notas de processamento do item da fila de trabalho
A ação Atualizar notas de processamento de itens da fila de trabalho permite que os utilizadores atualizem ou limpem as notas de processamento do item da fila de trabalho selecionado sem alterar o respetivo estado ou qualquer outra propriedade.
updateprocessingnotesaction
A ação Atualizar as notas de processamento do item da fila de trabalho requer os seguintes argumentos.
| Argumento | Opcional | Aceita | Valor Predefinido | Descrição |
|---|---|---|---|---|
| Elemento da fila de trabalho | Não | Texto | Variável do item da fila de trabalho que foi anteriormente devolvida pelo orquestrador de filas | |
| Notas de processamento | Sim | Texto | Resultado ou valor de processamento personalizados a anexar ao item de fila processado | |
| Limpar notas de processamento | Sim | booleano | Falso | Quando ativado, oculta e limpa o campo de notas de processamento neste ecrã e remove quaisquer notas de processamento da base de dados que foram anteriormente capturadas para este item |
Exceções
| Argumento | Descrição |
|---|---|
| Fila de trabalho não encontrada | A fila de trabalho associada ao item foi eliminada ou já não está acessível |
| Item de fila de trabalho não encontrado | O item de fila de trabalho é inválido |
| Falha ao acrescentar os resultados do processamento | O item de fila de trabalho que está a ser atualizado encontrou um erro inesperado. Verifique a mensagem de erro para obter mais detalhes. |
Obter itens de fila de trabalho por filtro
A ação Obter itens da fila de trabalho por filtro permite que os utilizadores obtenham um ou mais itens da fila de trabalho com base numa expressão de filtro FetchXML.
Getworkqueueitemsaction
A ação Obter itens da fila de trabalho por filtro requer os argumentos a seguir.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor Predefinido | Descrição |
|---|---|---|---|---|
| Fila de trabalho | Não | Texto | Fila de trabalho de onde obter os itens | |
| Filtrar linhas | Não | Texto | A expressão de consulta FetchXML utilizada para obter os itens da fila de trabalho | |
| Linhas a retornar | Não | Número | 5000 | O número máximo de itens da fila de trabalho devolvidos pelo orquestrador |
Variáveis produzidas
| Argumento | Tipo | Valor Predefinido | Descrição |
|---|---|---|---|
| WorkQueueItems | Não | Ativado | Lista de itens da fila de trabalho que correspondem à expressão de filtro. |
O que são FetchXML consultas?
Microsoft Dataverse FetchXML é uma linguagem usada para recuperar dados de um Dataverse banco de dados. Foi concebido para ser fácil de criar, utilizar e compreender. Por exemplo, talvez pretenda solicitar ao Dataverse que lhe forneça uma lista de todos os itens da fila de trabalho que estão no estado IT Exception.
Para limitar o suporte à consulta FetchXML à obtenção de itens da fila de trabalho, oferecemos suporte apenas a um conjunto limitado de termos e expressões FetchXML. Estes termos e expressões incluem atributos, filtros, condições e expressões de ordenação, todos limitados à tabela de itens da fila de trabalho (workqueueitem). Tem de indicar explicitamente quais as propriedades a devolver da tabela dos itens da fila de trabalho e a ordem de ordenação pretendida.
Exemplo de consulta FetchXML
O exemplo seguinte é uma expressão de consulta sobre como obter várias propriedades, filtrar itens com erro marcados como IT Exceptions e ordenar os resultados pelos registos que expiram primeiro (FEFO).
<attribute name="statecode" />
<attribute name="uniqueidbyqueue" />
<attribute name="createdon" />
<attribute name="completedon" />
<attribute name="workqueueitemid" />
<attribute name="executioncontext" />
<attribute name="name" />
<attribute name="expirydate" />
<attribute name="processingresult" />
<attribute name="priority" />
<attribute name="statuscode" />
<attribute name="modifiedon" />
<attribute name="processingstarttime" />
<attribute name="retrycount" />
<attribute name="requeuecount" />
<attribute name="input" />
<attribute name="delayuntil" />
<filter type="and">
<condition attribute="statecode" operator="eq" value="4" />
<condition attribute="statuscode" operator="eq" value="5" />
<condition attribute="expirydate" operator="on-or-before" value="2024-10-18" />
</filter>
<order attribute="expirydate" descending="false" />
Detalhes de suporte da consulta e dados de referência
- Lista de operadores de consulta disponíveis para utilização, incluindo operadores como em ou antes de, entre e mês passado.
- Lista de atributos disponíveis na tabela de itens da fila de trabalho.
Estado (statecode)
| Estado | Código | Descrição |
|---|---|---|
| Em espera | 0 | O item está na fila |
| Em processamento | 1 | O item está a ser processado |
| Processada | 2 | O item foi processado |
| Em Espera | 3 | Item está em espera |
| Erro | 4 | O item encontrou um erro |
Motivo do Estado (statuscode)
| Motivo do estado | Código | Descrição |
|---|---|---|
| Em espera | 0 | O item está na fila |
| Em processamento | 1 | O item está a ser processado |
| Processado | 2 | O item foi processado |
| Em pausa | 3 | O item está pausado ou em espera |
| Exceção Genérica | 4 | O item encontrou uma exceção genérica |
| ITException | 5 | O item encontrou uma exceção de TI |
| Exceção de Negócio | 6 | O elemento encontrou uma exceção de negócio |
| Mensagem não entregue | 7 | O item está em espera |
| Tempo limite de processamento | 8 | O processamento do item excedeu o tempo limite |