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.

Observação

O Power Automate usa o designer de fluxos da nuvem clássica ou o designer de fluxos da nuvem com o Copilot. Para identificar qual designer você está usando, vá para a seção Observação em Entender o novo designer de fluxos da nuvem com os recursos do copiloto.

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.

Editar com o Copilot

1. Selecione o sinal de mais (+) >Adicionar uma ação.
2. Na tela Adicionar uma ação, digite listar linhas 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 (<<).

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 a paginação é definida e a quantidade de linhas excede esse número do limite configurado, a resposta não incluirá o parâmetro @odata.nextLink para solicitar o próximo conjunto de linhas. Desative a paginação para que a resposta inclua o parâmetro @odata.nextLink, que pode ser usado para solicitar o próximo conjunto de linhas. Acesse Token de omissão para saber como usá-lo.

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

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 Paginação para a posição Ativado se ainda não estiver 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.

Editar com o Copilot

1. Selecione o cartão Listar linhas.

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

3. Mova o controle deslizante Paginação para a posição Ativado se ainda não estiver 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.

Opções avançadas

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

Designer clássico

Você pode definir 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.

Editar com o Copilot

Você pode definir opções no painel de configuração de ações.

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 Adicionar novos parâmetros.

   

Selecionar colunas

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

Filtrar linhas

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

Aprenda a usar os operadores de filtro padrão e as funções de consulta para criar expressões de Consulta de Filtro.

Determinados caracteres, como &, #+ precisam ser substituídos por seu equivalente codificado em URL. Mais Informações: Caracteres especiais de codificação da 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 para definir uma expressão estilo OData que define a ordem em que 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 para especificar uma expressão de 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 a 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 Valor único correspondem a colunas de pesquisa que são compatíveis com relacionamentos muitos para um e permitem que você defina uma referência para outra tabela.

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

Se você incluir apenas o nome da propriedade de navegação, receberá todas as propriedades das linhas relacionadas. Para saber mais, consulte Recuperar linhas de tabela relacionadas com uma consulta.

Para usá-la em uma etapa do fluxo, insira uma 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.

Contagem de linhas

Use para indicar o número específico de linhas a serem retornadas pelo Dataverse. Veja a seguir um exemplo que mostra como solicitar 10 linhas.

Buscar Consulta XML

No momento, consultas de agregação não são suportadas ao usar a ação List rows com FetchXML consultas. No entanto, o operador distinto é suportado.

Designer clássico

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

Digite o seguinte no campo Extrair Consulta Xml.

Como atualmente o operador distinto não é compatível diretamente em FetchXML consultas da ação Listar linhas, a função de união pode ser usada para remover linhas duplicadas. Por exemplo, você pode usar a ação Selecionar para transformar a resposta da conexão de linhas Lista para o formato de matriz específico que você precisa e, em seguida, crie uma variável com a expressão union(body(‘Select’),body(‘Select’)) para obter uma matriz com linhas distintas.

Editar com o Copilot

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

Exemplo FetchXML consulta 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>

Como atualmente o operador distinto não é compatível diretamente em FetchXML consultas da ação Listar linhas, a função de união pode ser usada para remover linhas duplicadas. Por exemplo, você pode usar a ação Selecionar para transformar a resposta da conexão de linhas Lista para o formato de matriz específico que você precisa e, em seguida, crie uma variável com a expressão union(body(‘Select’),body(‘Select’)) para obter uma matriz com linhas distintas.

Token de omissão

Como o Power Automate aplica limites de taxa de transferência de conteúdo e limites de tamanho de mensagem para assegurar garantias gerais de serviço, muitas vezes é útil usar 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.

O limite de página padrão de 5.000 linhas se aplica se você não usar a paginação.

Para usá-lo, implemente um loop para analisar o valor @odata.nextLink na resposta JSON, extraia o token de omissão e, depois, envie outra solicitação até listar o número de linhas de que 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

Uma opção para especificar a partitionId ao recuperar dados de tabelas NoSQL. Para saber mais, consulte Melhorar o desempenho usando partições de armazenamento ao acessar os dados da tabela.