Utilizar listas de linhas em fluxos

Utilize a ação Listar linhas para obter várias linhas de uma só vez do Microsoft Dataverse com uma consulta estruturada.

Obter uma lista de linhas

Siga estes passos para adicionar a ação Listar linhas ao seu fluxo para obter até 5000 contas da tabela Contas no Dataverse.

Power Automate permite usar o new designer ou o classic designer para configurar o teu fluxo cloud. Os passos são semelhantes em ambos os estruturadores. Obtenha mais informações (com exemplos) em Identificar as diferenças entre o novo estruturador e o estruturador clássico.

Novo estruturador

1. Selecione o sinal de adição (+) >Adicionar uma ação.
2. No ecrã Adicionar uma ação , introduza as linhas da lista no campo de Pesquisa .
3. Em Microsoft Dataverse, selecione Listar linhas (Pré-visualização).
4. No separador Parâmetros à esquerda, selecione Contas no menu pendente Nome da Tabela.
5. Feche o ecrã selecionando (<<).

Estruturador clássico

1. Selecione Novo passo para adicionar uma ação ao seu fluxo.
2. Introduza listar linhas na caixa de pesquisa Pesquisar conectores e ações no cartão Escolher uma operação.
3. Selecione Microsoft Dataverse para filtrar os resultados da pesquisa para exibir apenas ações e acionadores para o Microsoft Dataverse.
4. Selecione Listar linhas.
5. Selecione a tabela Contas da lista Nome da tabela.
6. Guarde e execute o seu fluxo para confirmar que não são devolvidas mais de 5.000 linhas.

Ative a paginação para pedir mais de 5000 linhas

Para obter mais de 5.000 linhas de uma consulta automaticamente, ative a caraterística Paginação a partir de Definições.

Quando defines a paginação e o número de linhas ultrapassa o limiar que configuras, a resposta não inclui o @odata.nextLink parâmetro para pedir o próximo conjunto de linhas. Desligue a paginação para que a resposta inclua o @odata.nextLink parâmetro que pode usar para pedir o próximo conjunto de linhas. Aceda a Ignorar token para aprender a utilizá-lo.

Aplicam-se limites de taxa de transferência de conteúdo e limites de tamanho das mensagens para assegurar as garantias gerais de serviço.

Novo estruturador

1. Selecione o cartão Listar linhas.

2. No painel à esquerda, selecione o separador Definições>Rede.

3. Mova o slider de Paginação para a posição Ligado se ainda não estiver ativado.

4. Em Limiar, introduza o número máximo de linhas pedidas. O limiar máximo configurável é 100.000.

   Internamente, este número é arredondado em múltiplos do tamanho predefinido da página. Por exemplo, se o tamanho da página for de 5.000 e introduzir 7.000, o número de linhas obtidas é 10.000.

Estruturador clássico

1. No canto superior direito do cartão Listar linhas, selecione o menu (…).

2. Selecione Definições.

3. Mova o slider de Paginação para a posição Ligado se ainda não estiver ativado.

4. Em Limiar, introduza o número máximo de linhas pedidas. O limiar máximo configurável é 100.000.

   Internamente, este número é arredondado em incrementos do tamanho da página predefinido. Por exemplo, se o tamanho da página for de 5.000 e introduzir 7.000, o número de linhas obtidas é 10.000.

Opções avançadas

As opções avançadas para a ação Listar Linhas permitem-lhe ordenar, filtrar, organizar e estender os resultados de uma consulta.

Novo estruturador

Define opções no painel de configuração de ações.

1. Para ver as opções avançadas, selecione o cartão Listar linhas.

2. No separador Parâmetros, selecione uma opção avançada no menu pendente Parâmetros avançados.

   

Estruturador clássico

Defina opções avançadas diretamente no cartão Linhas da Lista. Para ver as opções, selecione Mostrar opções avançadas. Quando a seleciona, o nome muda para Ocultar opções avançadas.

Devolver metadados completos

Esta configuração controla se deve carregar todas as colunas da tabela ou apenas as essenciais para melhor desempenho. Se não o definires, a ação devolve automaticamente metadados completos se o teu flow usar conteúdo dinâmico ou expressões que precisem disso.

Selecionar colunas

Introduza uma lista separada por vírgulas de colunas para devolver, como name,createdon,preferredcontactmethodcode,emailaddress1,telephone1 para a tabela de Contas.

Filtrar linhas

Use este campo para definir uma expressão de filtro ao estilo OData para restringir o conjunto de linhas que o Dataverse devolve, como createdon ge 2021-01-01T00:00:00-00:00 para linhas com createdon maior ou igual ao ano de 2021.

Aprenda a filtrar linhas para construir expressões de Consulta de Filtro .

Substitua certos caracteres, como &, #, e +, pelo seu equivalente codificado por URL. Para mais informações, consulte Codificar caracteres especiais em URL.

Importante

As expressões de filtro não podem conter esta cadeia, $filter=, porque só é aplicável quando utiliza diretamente as APIs.

Ordenar por

Use este campo para definir uma expressão ao estilo OData que define a ordem em que os itens são devolvidos, como name desc. Utilize o sufixo asc ou desc para indicar a ordem ascendente ou descendente, respetivamente. A ordem predefinida é ascendente.

Expandir consulta

Utilize este campo para especificar uma expressão no estilo OData que define os dados que o Dataverse devolve das tabelas relacionadas, como, por exemplo, primarycontactid($select=contactid,fullname) para utilizar o primarycontactid da conta para obter a coluna fullname do contacto relacionado com o ID contactid na resposta.

Existem dois tipos de propriedades de navegação que pode utilizar em Expandir Consulta:

1. As propriedades de navegação de valor único correspondem às colunas de pesquisa que suportam relações muitos-para-um e permitem definir uma referência para outra tabela.

2. As propriedades de navegação com valor de coleção correspondem a relações um para muitos ou muitos para muitos.

Se incluir apenas o nome da propriedade de navegação, recebe todas as propriedades das linhas relacionadas. Saiba mais em Associar tabelas com OData.

Para o usar numa etapa de fluxo, introduza esta expressão OData no campo Expandir Consulta : primarycontactid(contactid,fullname). Eis como obter as colunas contactid e fullname para o primarycontactid de cada conta.

Número de linhas

Usa a definição de contagem de linhas para especificar o número de linhas que queres que o Dataverse devolva.

Consulta Fetch XML

Atualmente, não pode utilizar consultas de agregação ao utilizar a ação Listar linhas com consultas FetchXML. Mas podes usar o distinct operador.

Novo estruturador

Use uma consulta FetchXML ao estilo Dataverse, que oferece mais flexibilidade para construir consultas personalizadas. Estas consultas podem ser úteis quando trabalha com uma tabela com múltiplas tabelas associadas ou quando lida com a paginação. A captura de ecrã seguinte mostra como utilizar FetchXML.

Importante

A definição de paginação não suporta consultas FetchXML. Para solicitar mais de 5.000 linhas, é necessário gerir a paginação diretamente com a consulta FetchXML .

Exemplo de consulta FetchXML para a tabela Conta:

<fetch count="10">
   <entity name="account">
      <attribute name="name" />
      <attribute name="preferredcontactmethodcode" />
      <attribute name="emailaddress1" />
      <attribute name="telephone1" />
         <link-entity name="contact" to="primarycontactid" from="contactid">
               <attribute name="fullname" />
      </link-entity>
      <filter> 
         <condition attribute="createdon" operator="ge" value="2021-01-01T00:00:00-00:00" />
      </filter>
      <order attribute="name" descending="true" />
   </entity>
</fetch>

O operador distinct não é atualmente suportado diretamente nas consultas FetchXML da ação Listar linhas, mas pode utilizar a função union para remover linhas duplicadas. Por exemplo, podes usar a ação Select para transformar a resposta da ligação das linhas da Lista para o formato de array específico de que precisas, depois criar uma variável com a expressão union(body('Select'),body('Select')) para obter um array com linhas distintas.

Estruturador clássico

Use uma consulta FetchXML ao estilo Dataverse, que oferece mais flexibilidade para construir consultas personalizadas. Estas consultas podem ser úteis quando trabalha com uma tabela com várias tabelas relacionadas ou quando lida com a paginação. A captura de ecrã seguinte mostra como utilizar FetchXML.

Escreva o texto seguinte no campo Fetch XML Inquiry .

Como o operador distinto não é atualmente suportado diretamente em consultas FetchXML a partir da ação Lista de linhas, use a função de união para remover linhas duplicadas. Por exemplo, pode usar a ação Select para transformar a resposta da ligação de linhas da Lista no formato de array específico de que precisa, e depois criar uma variável com a expressão union(body('Select'),body('Select')) para obter um array com linhas distintas.

Token de omissão

O Power Automate aplica limites de rendimento de conteúdo e limites de tamanho de mensagem para garantir garantias gerais de serviço. Para trabalhar dentro destes limites, use a paginação para devolver um número menor de linhas num lote, em vez dos limites padrão para o número de linhas da tabela devolvidas.

Se não usares paginação, o limite padrão de páginas é de 5.000 linhas.

Para usar a paginação, implemente um ciclo para analisar o valor \@odata.nextLink na resposta em JSON, extrair o skip token e, em seguida, enviar outro pedido até listar o número de linhas de que necessita.

HTTP/1.1 200 OK  
Content-Type: application/json; odata.metadata=minimal  
OData-Version: 4.0  
Content-Length: 402  
Preference-Applied: odata.maxpagesize=3  
  
{  
   "@odata.context":"[Organization URI]/api/data/v9.1/$metadata#accounts(name)",
   "value":[  
      {  
         "@odata.etag":"W/\"437194\"",
         "name":"Fourth Coffee (sample)",
         "accountid":"7d51925c-cde2-e411-80db-00155d2a68cb"
      },
      {  
         "@odata.etag":"W/\"437195\"",
         "name":"Litware, Inc. (sample)",
         "accountid":"7f51925c-cde2-e411-80db-00155d2a68cb"
      },
      {  
         "@odata.etag":"W/\"468026\"",
         "name":"Adventure Works (sample)",
         "accountid":"8151925c-cde2-e411-80db-00155d2a68cb"
      }
   ],
   "@odata.nextLink":"[Organization URI]/api/data/v9.1/accounts?$select=name&$skiptoken=%3Ccookie%20pagenumber=%222%22%20pagingcookie=%22%253ccookie%2520page%253d%25221%2522%253e%253caccountid%2520last%253d%2522%257b8151925C-CDE2-E411-80DB-00155D2A68CB%257d%2522%2520first%253d%2522%257b7D51925C-CDE2-E411-80DB-00155D2A68CB%257d%2522%2520%252f%253e%253c%252fcookie%253e%22%20/%3E"
}

Identificador da Partição

Especifique o partitionId ao obter dados para tabelas elásticas. Para saber mais, veja Particionamento e escalabilidade horizontal para tabelas elásticas.

Informações relacionadas

• Formação: Utilize acionadores e ações do Dataverse no Power Automate (módulo)
• Formação: Integrar fluxos do Power Automate e Dataverse (percurso de aprendizagem)