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.

Nota

O Power Automate utiliza o estruturador de fluxos de cloud clássico ou o estruturador de fluxos de cloud com o Copilot. Para identificar o estruturador que está a utilizar, aceda à secção Nota em Compreender o novo estruturador de fluxos de cloud com capacidades de copiloto.

Estruturador clássico

1. Selecione Novo passo para adicionar uma ação ao seu fluxo.
2. Introduza linhas de lista na caixa de pesquisa de 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 obtidas mais de 5.000 linhas.

Editar com o Copilot

1. Selecione o sinal de adição (+) >Adicionar uma ação.
2. No ecrã Adicionar uma ação, introduza linhas de lista no campo Pesquisar.
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 (<<).

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 a paginação está definida e a quantidade de linhas excede esse número do limiar configurado, a resposta não inclui o parâmetro @odata.nextLink para pedir o conjunto de linhas seguinte. Desligue a paginação para que a resposta inclua o parâmtero @odata.nextLink para que possa ser usado para pedir o conjunto de linhas seguinte. Aceda a Token de omissão para aprender a utilizá-lo.

Aplicam-se limites de débito de conteúdo e limites de tamanho de mensagens para assegurar as garantias gerais do serviço.

Estruturador clássico

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

2. Selecione Definições.

3. Mova o controlo de deslize de Paginação para a posição Ativado se ainda não o estiver.

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.

Editar com o Copilot

1. Selecione o cartão Listar linhas.

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

3. Mova o controlo de deslize de Paginação para a posição Ativado se ainda não o estiver.

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 expandir os resultados de uma consulta.

Estruturador clássico

Pode definir opções avançadas diretamente no cartão Listar linhas. Para ver as opções, selecione Mostrar opções avançadas. Quando a seleciona, o nome muda para Ocultar opções avançadas.

Editar com o Copilot

Pode definir opções no painel de configuração da ação.

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

   

Selecionar colunas

Introduza uma lista de colunas separada por vírgulas a obter, tal como "name,createdon,preferredcontactmethodcode,emailaddress1,telephone1" para a tabela Conta.

Filtrar linhas

Utilize para definir uma expressão de filtro de estilo OData para reduzir o conjunto de linhas que o Dataverse obtém, como "createdon ge 2021-01-01T00:00:00-00:00" para linhas com createdon superior ou igual ao ano de 2021.

Aprenda a utilizar operadores de filtros padrão e funções de consulta para construir expressões de Consulta de Filtro.

Certos caráteres, como &, # e + precisam de ser substituídos pelos respetivos equivalentes codificados em URL. Mais informações: URL codifica carateres especiais

Importante

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

Ordenar por

Utilize para definir uma expressão de estilo OData que define a ordem em que os itens são obtidos, como "nome desc". Utilize o sufixo asc ou desc para indicar a ordem ascendente ou descendente, respetivamente. A ordem predefinida é ascendente.

Expandir consulta

Utilize para especificar uma expressão de estilo OData que define os dados que o Dataverse obtém das tabelas relacionadas, tais como 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 Valor único correspondem às colunas de pesquisa que suportam relações muitos para um e permitem definir uma referência a 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, receberá todas as propriedades para as linhas relacionadas. Para saber mais, consulte Obter linhas de tabela relacionadas com uma consulta.

Para a utilizar num passo 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.

Contagem de linhas

Utilize para indicar o número específico de linhas para o Dataverse obter. Eis um exemplo que mostra como pedir 10 linhas.

Consulta Fetch XML

As consultas de agregação não são atualmente suportadas ao utilizar a ação Listar linhas com as consultas FetchXML. No entanto, é suportado o operador distinto.

Estruturador clássico

Utilize uma consulta FetchXML estilo Dataverse que permite mais flexibilidade na criação de consultas personalizadas. Estas consultas podem ser úteis quando trabalha com uma tabela que tenha várias tabelas relacionadas ou com o processamento de paginação. A captura de ecrã seguinte mostra como utilizar FetchXML.

Escreve o seguinte no campo Obter Consulta XML.

Uma vez que o operador distinto não é atualmente suportado diretamente em consultas FetchXML a partir da ação Listar linhas, a função Union pode ser usada para remover linhas duplicadas. Por exemplo, pode utilizar a ação Selecionar para transformar a resposta da ligação Listar linhas para o formato de matriz específico de que necessita e, em seguida, criar uma variável com a expressão union(body(‘Select’),body(‘Select’)) para obter uma matriz com linhas distintas.

Editar com o Copilot

Utilize uma consulta FetchXML estilo Dataverse que permite mais flexibilidade na criação de consultas personalizadas. Estas consultas podem ser úteis quando trabalha com uma tabela que tenha várias tabelas relacionadas ou com o processamento de paginação. A captura de ecrã seguinte mostra como utilizar 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>

Uma vez que o operador distinto não é atualmente suportado diretamente em consultas FetchXML a partir da ação Listar linhas, a função Union pode ser usada para remover linhas duplicadas. Por exemplo, pode utilizar a ação Selecionar para transformar a resposta da ligação Listar linhas para o formato de matriz específico de que necessita 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

Uma vez que o Power Automate aplica limites de débito de conteúdo e limites de tamanho de mensagem para garantir garantias gerais do serviço, é muitas vezes útil usar paginação para obter um número menor de linhas num lote, em vez dos limites no número de linhas de tabelas obtidas predefinidos.

O limite de página predefinido de 5.000 linhas aplica-se se não utilizar a paginação.

Para o utilizar, implemente um ciclo para analisar o valor @odata.nextLink na resposta JSON, extraia o token de omissão e, em seguida, envie outro pedido até ter listado 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"
}

ID da Partição

Uma opção para especificar o partitionId ao obter dados para tabelas NoSQL. Para saber mais, consulte Melhorar o desempenho utilizando partições de armazenamento ao aceder aos dados da tabela.

Informações relacionadas

• Treinamento: Use Dataverse gatilhos e ações em Power Automate (módulo)
• Formação: Integrar fluxos do Power Automate e Dataverse (percurso de aprendizagem)