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.
- Selecione Nova etapa para adicionar uma ação ao seu fluxo.
- Digite listar linhas na caixa de pesquisa Pesquisar conectores e ações no cartão Escolher uma operação.
- Selecione Microsoft Dataverse para filtrar os resultados da pesquisa para exibir apenas ações e gatilhos para o Microsoft Dataverse.
- Selecione Listar linhas.
- Selecione a tabela Contas na lista Nome da tabela.
- 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 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 limites de tamanho de mensagem são aplicados para assegurar garantias gerais de serviço.
No canto superior direito do cartão Listar linhas, selecione o menu (...).
Selecione Configurações.
Mova o controle deslizante Paginação para a posição Ativado se ainda não estiver ativado.
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.
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.
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:
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.
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
As consulta de agregação não têm suporte no momento ao usar a ação Listar linhas com as consultas de FetchXML. No entanto, o operador distinto é suportado.
Use uma Consulta de FetchXML ao estilo do Dataverse, que permite mais flexibilidade ao criar 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 com usar o FetchXML.
Digite o seguinte no campo Extrair Consulta Xml.
Como o operador distinto não é compatível diretamente com as consultas de FetchXML 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.