Usar listas de linhas nos fluxos

Use a ação Listar linhas para recuperar várias linhas de uma vez do Microsoft Dataverse com uma consulta estruturada.

Obter uma lista de linhas

Siga estas etapas para adicionar a ação Listar linhas para o seu fluxo para retornar até 5000 contas da tabela Contas em Dataverse.

Power Automate permite usar o novo designer ou o designer clássico para configurar o fluxo na nuvem. As etapas são semelhantes em ambos os designers. Saiba mais (com exemplos) em Identificar diferenças entre o novo designer e o designer clássico.

Novo criador

1. Selecione o sinal de mais (+) >Adicionar uma ação.
2. Na tela Adicionar uma ação , insira linhas de lista no campo Pesquisar .
3. Em Microsoft Dataverse, selecione Listar linhas (Versão preliminar).
4. Na guia Parâmetros à esquerda, selecione Contas no menu suspenso Nome da Tabela.
5. Feche a tela selecionando (<<).

Designer clássico

1. Selecione Nova etapa para adicionar uma ação ao seu fluxo.
2. Digite 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 gatilhos para o Microsoft Dataverse.
4. Selecione Listar linhas.
5. Selecione a tabela Contas na lista Nome da tabela.
6. Salve e execute seu fluxo para confirmar que não sejam retornadas mais de 5.000 linhas.

Ativar a paginação para solicitar mais de 5.000 linhas

Para obter mais de 5.000 linhas de uma consulta automaticamente, ative o recurso Paginação em Configurações.

Quando você define a paginação e o número de linhas excede o limite configurado, a resposta não inclui o @odata.nextLink parâmetro para solicitar o próximo conjunto de linhas. Desative a paginação para que a resposta inclua o @odata.nextLink parâmetro que você pode usar para solicitar o próximo conjunto de linhas. Vá para token Skip para saber como usá-lo.

Os limites de taxa de transferência de conteúdo e limites de tamanho de mensagem são aplicados para assegurar garantias gerais de serviço.

Novo criador

1. Selecione o cartão Listar linhas.

2. No painel à esquerda, selecione a guia Configurações>Rede.

3. Mova o controle deslizante de Paginação para a posição Ativado, caso ainda não esteja ativado.

4. Em Limite, insira o número máximo de linhas solicitadas. O limite máximo configurável é 100.000.

   Internamente, esse número é arredondado em incrementos do tamanho de página padrão. Por exemplo, se o tamanho da página for 5.000 e você inserir 7.000, o número de linhas retornadas será 10.000.

Designer clássico

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

2. Selecione Configurações.

3. Mova o controle deslizante de Paginação para a posição Ativado, caso ainda não esteja ativado.

4. Em Limite, insira o número máximo de linhas solicitadas. O limite máximo configurável é 100.000.

   Internamente, esse número é arredondado para múltiplos do tamanho padrão da página. Por exemplo, se o tamanho da página for 5.000 e você inserir 7.000, o número de linhas retornadas será 10.000.

Opções avançadas

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

Novo Designer

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

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

2. Na guia Parâmetros , selecione uma opção avançada no menu suspenso Parâmetros avançados .

   

Designer clássico

Defina opções avançadas diretamente no cartão listar linhas . Para ver as opções, selecione Mostrar opções avançadas. Quando você selecioná-la, o nome será alterado para Ocultar opções avançadas.

Retornar metadados completos

Essa configuração controla se todas as colunas devem ser carregadas da tabela ou apenas das essenciais para melhorar o desempenho. Se você não defini-lo, a ação retornará automaticamente metadados completos se o fluxo usar conteúdo dinâmico ou expressões que precisam dele.

Selecionar colunas

Insira uma lista separada por vírgulas de colunas a serem retornadas, como name,createdon,preferredcontactmethodcode,emailaddress1,telephone1 para a tabela Conta.

Filtrar linhas

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

Saiba como filtrar linhas para construir expressões de Consulta de Filtro .

Substitua determinados caracteres, como &, #e +, pelo equivalente codificado em URL. Para obter mais informações, consulte codificar caracteres especiais em URL.

Importante

As expressões de filtro não podem conter esta cadeia de caracteres, $filter=, porque ela só se aplica quando você usa as APIs diretamente.

Classificar por

Use esse campo para definir uma expressão de estilo OData que define a ordem na qual os itens são retornados, como name desc. Use o sufixo asc ou desc para indicar ordem crescente ou decrescente, respectivamente. A ordem padrão é crescente.

Expandir consulta

Use este campo para especificar uma expressão no estilo OData que define os dados que o Dataverse retorna das tabelas relacionadas, como primarycontactid($select=contactid,fullname) para usar o primarycontactid da conta para recuperar a coluna fullname do contato relacionado com o ID contactid na resposta.

Existem dois tipos de propriedades de navegação que você pode usar em Expandir Consulta:

1. As propriedades de navegação de valor único correspondem a colunas de pesquisa que dão suporte a relacionamentos muitos para um e permitem que você defina uma referência a outra tabela.

2. As propriedades de navegação do tipo coleção correspondem a relacionamentos de um para muitos ou de muitos para muitos.

Se você incluir apenas o nome da propriedade de navegação, receberá todas as propriedades das linhas relacionadas. Saiba mais em Unir tabelas usando o OData.

Para usá-la em uma etapa de fluxo, insira esta expressão OData no campo Expandir Consulta : primarycontactid(contactid,fullname). Isso mostra como obter as colunas contactid e fullname para o primarycontactid de cada conta.

Número de linhas

Use a configuração de contagem de linhas para especificar o número de linhas que você deseja que o Dataverse retorne.

Buscar consulta XML

Atualmente, você não pode usar consultas de agregação ao usar a ação Listar linhas com consultas FetchXML. No entanto, você pode usar o distinct operador.

Novo criador

Use uma consulta FetchXML no estilo Dataverse, que oferece mais flexibilidade para criar consultas personalizadas. Essas consultas podem ser úteis quando você trabalha com uma tabela que tem várias tabelas relacionadas ou quando você lida com paginação. A captura de tela a seguir mostra com usar o FetchXML.

Importante

A configuração de paginação não dá suporte a consultas FetchXML. Para solicitar mais de 5.000 linhas, você precisa gerenciar a paginação diretamente com a consulta FetchXML.

Exemplo de consulta FetchXML da tabela Contas:

<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 tem suporte direto atualmente nas consultas FetchXML da ação Listar linhas, mas você pode usar a função de união para remover linhas duplicadas. Por exemplo, você pode usar a ação Selecionar para transformar a resposta da conexão de linhas de lista para o formato de matriz específico necessário e, em seguida, criar uma variável com a expressão union(body('Select'),body('Select')) para obter uma matriz com linhas distintas.

Designer clássico

Use uma consulta FetchXML no estilo Dataverse, que oferece mais flexibilidade para criar consultas personalizadas. Essas consultas podem ser úteis quando você trabalha com uma tabela que tem várias tabelas relacionadas ou quando você lida com paginação. A captura de tela a seguir mostra com usar o FetchXML.

Digite o texto a seguir no campo consulta FetchXML.

Como o operador distinct ainda não tem suporte direto nas consultas FetchXML da ação Listar linhas, use a função union para remover linhas duplicadas. Por exemplo, você pode usar a ação Selecionar para transformar a resposta da conexão de linhas de lista no formato de matriz específico necessário e, em seguida, criar uma variável com a expressão union(body('Select'),body('Select')) para obter uma matriz com linhas distintas.

Token de omissão

Power Automate aplica limites de taxa de transferência de conteúdo e limites de tamanho de mensagem para garantir garantias gerais de serviço. Para trabalhar dentro desses limites, use a paginação para retornar um número menor de linhas em um lote, em vez dos limites padrão no número de linhas de tabela retornadas.

Se você não usar paginação, o limite de página padrão será de 5.000 linhas.

Para usar a paginação, implemente um loop para analisar o valor \@odata.nextLink na resposta JSON, extrair o token de skip e, em seguida, enviar outra solicitação até listar o número de linhas de que você precisa.

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"
}

ID da Partição

Especifique o partitionId ao recuperar dados de tabelas elásticas. Para saber mais, consulte Particionamento e dimensionamento horizontal para tabelas elásticas.

Informações relacionadas

• Treinamento: Usar gatilhos e ações do Dataverse no Power Automate (módulo)
• Treinamento: Integrar fluxos do Power Automate ao Dataverse (trilha de aprendizagem)