Utilitzar llistes de files als fluxos

Utilitzeu l'acció Llista de files per recuperar diverses files alhora amb Microsoft Dataverse una consulta estructurada.

Obtenir una llista de files

Seguiu aquests passos per afegir l'acció Llista files al flux per retornar fins a 5.000 comptes de la taula Comptes a Dataverse.

Power Automate et permet utilitzar o bé el nou dissenyador o el classic designer per configurar el teu flux al núvol. Els passos són similars en ambdós dissenyadors. Obteniu més informació (amb exemples) a Identificar les diferències entre el dissenyador nou i el dissenyador clàssic.

Nou dissenyador

1. Seleccioneu el signe més (+) >Afegeix una acció.
2. A la pantalla Afegeix una acció , introdueix files de llista al camp de cerca .
3. A sota Microsoft Dataverse, seleccioneu Files de llista (visualització prèvia).
4. A la pestanya Paràmetres de l'esquerra, seleccioneu Comptes al menú desplegable Nom de la taula.
5. Tanqueu la pantalla seleccionant (<<).

Dissenyador clàssic

1. Seleccioneu Pas nou per afegir una acció al flux.
2. Introduïu files de llista al quadre de cerca de connectors i accions de cerca de la targeta Tria una operació .
3. Seleccioneu Microsoft Dataverse aquesta opció per filtrar els resultats de la cerca per mostrar només les accions i els activadors Microsoft Dataverse.
4. Seleccioneu Llista files.
5. Seleccioneu la taula Comptes a la llista Nom de la taula.
6. Deseu i executeu el flux per confirmar que no es retornen més de 5.000 files.

Activar la paginació per sol·licitar més de 5.000 files

Per obtenir més de 5.000 files d'una consulta automàticament, activeu la funció Paginació des de Configuració.

Quan configures la paginació i el nombre de files supera el llindar que configures, la resposta no inclou el @odata.nextLink paràmetre per sol·licitar el següent conjunt de files. Desactiva la paginació perquè la resposta inclogui el @odata.nextLink paràmetre que pots utilitzar per demanar el següent conjunt de files. Aneu a Saltar testimoni per obtenir informació sobre com utilitzar-lo.

S'apliquen límits de rendiment de contingut i límits de mida del missatge per garantir les garanties generals del servei.

Nou dissenyador

1. Seleccioneu la targeta Llista de files .

2. Al panell de l'esquerra, seleccioneu la pestanya Configuració Xarxes >.

3. Mou el control lliscant de Paginació a la posició d'On si encara no està activat.

4. A Llindar, introduïu el nombre màxim de files sol·licitades. El llindar màxim configurable és de 100.000.

   Internament, aquest número s'arrodoneix en increments de la mida de pàgina per defecte. Per exemple, si la mida de la pàgina és de 5.000 i introduïu 7.000, el nombre de files retornades és de 10.000.

Dissenyador clàssic

1. A la cantonada superior dreta de la targeta Llista de files , seleccioneu el menú (...).

2. Seleccioneu Configuració.

3. Mou el control lliscant de Paginació a la posició d'On si encara no està activat.

4. A Llindar, introduïu el nombre màxim de files sol·licitades. El llindar màxim configurable és de 100.000.

   Internament, aquest número s'arrodoneix en increments de la mida de pàgina per defecte. Per exemple, si la mida de la pàgina és de 5.000 i introduïu 7.000, el nombre de files retornades és de 10.000.

Opcions avançades

Les opcions avançades per a l'acció Llisten Files et permeten ordenar, filtrar, ordenar i ampliar els resultats d'una consulta.

Nou dissenyador

Configura opcions al panell de configuració d'accions.

1. Per veure les opcions, seleccioneu la targeta Llista de files .

2. A la pestanya Paràmetres, selecciona una opció avançada al menú desplegable de paràmetres avançats.

   

Dissenyador clàssic

Configura opcions avançades directament a la targeta de files de llista . Per veure les opcions, seleccioneu Mostra les opcions avançades. Quan el seleccioneu, el nom canvia a Amaga les opcions avançades.

Retorna les metadades completes

Aquesta configuració controla si carregar totes les columnes de la taula o només les essencials per a un millor rendiment. Si no ho configures, l'acció retorna automàticament les metadades completes si el teu flux utilitza contingut dinàmic o expressions que ho necessiten.

Selecció de columnes

Introdueix una llista de columnes separades per comes a tornar, com name,createdon,preferredcontactmethodcode,emailaddress1,telephone1 per exemple a la taula de Compte.

Filtra les files

Utilitza aquest camp per definir una expressió de filtre d'estil OData per acotar el conjunt de files que retorna Dataverse, com createdon ge 2021-01-01T00:00:00-00:00 ara per a files amb createdon igual o superior a l'any 2021.

Aprèn a filtrar files per construir expressions de consulta de filtre .

Substitueix certs caràcters, com ara &, #, i +, pel seu equivalent codificat per URL. Per a més informació, vegeu la codificació de caràcters especials per a URL.

Important

Les expressions de filtre no poden contenir aquesta cadena, $filter=, perquè només s'aplica quan feu servir les API directament.

Ordena per

Utilitza aquest camp per definir una expressió d'estil OData que defineix l'ordre en què es retornen els elements, com name descara . Feu servir el sufix asc o desc per indicar ordre ascendent o descendent, respectivament. L'ordre per defecte és ascendent.

Expandeix la consulta

Utilitza aquest camp per especificar una expressió d'estil OData que defineixi les dades que Dataverse retorna de les taules relacionades, com primarycontactid($select=contactid,fullname) ara per utilitzar el primarycontactid del compte per recuperar la columna de nom complet del contactid de contacte relacionat amb l'ID a la resposta.

Hi ha dos tipus de propietats de navegació que podeu utilitzar a Expandir consulta:

1. Les propietats de navegació d'un sol valor corresponen a columnes de cerca que admeten relacions de molts a un i permeten establir una referència a una altra taula.

2. Les propietats de navegació amb valor de col·lecció corresponen a relacions d'un a molts o de molts a molts.

Si només inclous el nom de la propietat de navegació, reps totes les propietats de les files relacionades. Aprèn més a les taules d'unió utilitzant OData.

Per utilitzar-la en un pas de flux, introdueix aquesta expressió OData al camp Expandeix la consulta : primarycontactid(contactid,fullname). Així és com s'obtenen les columnes *contactidid* i *fullname* per al *primarycontactidid* de cada *compte*.

Recompte de files

Utilitza la configuració de recompte de files per especificar el nombre de files que vols que retorni Dataverse.

Consulta XML de Fetch

Actualment, no pots utilitzar consultes d'agregació quan utilitzes l'acció de files de llista amb consultes FetchXML. Tot i així, pots utilitzar l'operador distinct .

Nou dissenyador

Utilitza una consulta FetchXML d'estil Dataverse, que ofereix més flexibilitat per construir consultes personalitzades. Aquestes consultes poden ser útils quan treballes amb una taula que té diverses taules relacionades o quan gestiones la paginació. La captura de pantalla següent mostra com utilitzar FetchXML.

Important

La configuració de paginació no admet consultes FetchXML. Per sol·licitar més de 5.000 files, cal gestionar la paginació directament amb la consulta FetchXML .

Exemple FetchXML de consulta per a la taula Compte:

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

L'operador distinct actualment no està suportat directament en consultes FetchXML des de l'acció de files de llista , però pots utilitzar la funció d'unió per eliminar files duplicades. Per exemple, pots utilitzar l'acció Select per transformar la resposta de la connexió de files de Llista al format d'array específic que necessites, i després crear una variable amb l'expressió union(body('Select'),body('Select')) per obtenir un array amb files diferents.

Dissenyador clàssic

Utilitza una consulta FetchXML d'estil Dataverse, que ofereix més flexibilitat per construir consultes personalitzades. Aquestes consultes poden ser útils quan treballes amb una taula que té diverses taules relacionades o quan gestiones la paginació. La captura de pantalla següent mostra com utilitzar FetchXML.

Escriu el text següent al camp de consulta Fetch Xml .

Com que l'operador distinct actualment no està suportat directament en les consultes FetchXML des de l'acció de files de llista, utilitza la funció d'unió per eliminar files duplicades. Per exemple, pots utilitzar l'acció Select per transformar la resposta de la connexió de files de Llista en el format d'array específic que necessites, i després crear una variable amb l'expressió union(body('Select'),body('Select')) per obtenir un array amb files diferents.

Omet el testimoni

Power Automate aplica límits de rendiment de contingut i límits de mida dels missatges per garantir garanties generals de servei. Per treballar dins d'aquests límits, utilitza la paginació per retornar un nombre menor de files en un lot, en lloc dels límits per defecte sobre el nombre de files de taula retornades.

Si no utilitzes paginació, el límit per defecte de pàgina és de 5.000 files.

Per utilitzar la paginació, implementa un bucle per analitzar el \@odata.nextLink valor de la resposta JSON, extreu el token de salt i després envia una altra petició fins que indiquis el nombre de files que necessites.

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 de partició

Especifica el partitionId moment de recuperar dades per a les taules elàstiques. Per saber-ne més, vegeu Partició i escalat horitzontal per a taules elàstiques.

Informació relacionada

• Formació: Utilitzeu Dataverse activadors i accions a Power Automate (mòdul)
• Formació: Integrar fluxos i (itinerari d'aprenentatge) Power Automate Dataverse