Utilitzar llistes de files als fluxos

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

Obtenir una llista de files

Seguiu aquests passos per afegir l'acció Files de llista al flux i tornar fins a 5.000 comptes de la taula Comptes Dataverse.

Nota

Power Automate utilitza el dissenyador de fluxos de núvol clàssic o el dissenyador de fluxos al núvol amb Copilot. Per identificar quin dissenyador utilitzeu, aneu a la secció Nota a Entendre el dissenyador de fluxos al núvol amb capacitats de copilot.

Dissenyador clàssic

1. Seleccioneu Pas nou per afegir una acció al flux.
2. Introduïu files de llista al quadre de cerca 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 Files de llista.
5. Seleccioneu la taula Comptes de la llista Nom de la taula.
6. Deseu i executeu el flux per confirmar que no es retornin més de 5.000 files.

Edita amb Copilot

1. Seleccioneu el signe més (+) >Afegeix una acció.
2. Al sceen Afegeix una acció , introduïu files de llista al camp 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. Per tancar la pantalla, seleccioneu (<<).

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 la paginació estigui definida i la quantitat de files superi aquest número del llindar configurat, la resposta no inclourà el paràmetre @odata.nextLink per sol·licitar el següent conjunt de files. Desactiveu la paginació perquè la resposta inclogui el paràmetre @odata.nextLink que es pot utilitzar per sol·licitar el següent conjunt de files. Aneu a Omet el testimoni per obtenir informació sobre com utilitzar-lo.

Els límits de rendiment del contingut i els límits de mida dels missatges s'apliquen per garantir les garanties generals del servei.

Dissenyador clàssic

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

2. Seleccioneu Configuració.

3. Moveu el control lliscant Paginació a la posició Activat 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 predeterminada. Per exemple, si la mida de la pàgina és 5.000 i n'introduïu 7.000, el nombre de files retornades és de 10.000.

Edita amb Copilot

1. Seleccioneu la targeta Files de llista.

2. A la subfinestra de l'esquerra, seleccioneu la pestanya Configuració >Xarxes.

3. Moveu el control lliscant Paginació a la posició Activat 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 predeterminada. Per exemple, si la mida de la pàgina és 5.000 i n'introduïu 7.000, el nombre de files retornades és de 10.000.

Opcions avançades

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

Dissenyador clàssic

Podeu definir opcions avançades directament a la targeta Llista files . Per veure les opcions, selecciona Mostra les opcions avançades. Quan la selecciones, el nom canvia a Amaga les opcions avançades.

Edita amb Copilot

Podeu definir opcions a la subfinestra de configuració de l'acció.

1. Per veure les opcions, seleccioneu la targeta Files de llista.

2. A la pestanya Paràmetres , seleccioneu una opció avançada al menú desplegable Afegeix paràmetres nous .

   

Selecciona les columnes

Introduïu una llista de columnes separades per comes que vulgueu retornar, com ara "nom,createdon,preferredcontactmethodcode,emailaddress1,telephone1" per a la taula Compte.

Filtra les files

S'utilitza per definir una expressió de filtre a l'estil OData per restringir el conjunt de files que Dataverse retorna, com ara "createdon 2021-01-01T00:00:00-00:00" per a files amb creaon major o igual a l'any 2021.

Obteniu informació sobre com podeu utilitzar operadors de filtre estàndard i funcions de consulta per construir expressions de consulta de filtre.

Alguns caràcters, com ara &,, # i + s'han de substituir pel seu equivalent codificat amb URL. Més informació: URL codificar caràcters especials

Important

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

Ordena per

S'utilitza per definir una expressió a l'estil OData que defineix l'ordre en què es retornen els elements, com ara "name desc". Utilitzeu el sufix asc o descper indicar ordre ascendent o descendent, respectivament. L'ordre per defecte és ascendent.

Amplia la consulta

Utilitzeu per especificar una expressió d'estil OData que defineixi les dades que Dataverse retornen de les taules relacionades, com ara primarycontactid($select=contactid,fullname) utilitzar el contactarycontactid principal del compte per recuperar la columna de nom complet del contacte relacionat amb ID contactida la resposta.

Hi ha dos tipus de propietats de navegació que podeu utilitzar a Expand Query:

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

2. Les propietats de navegació valorades en la col·lecció corresponen a relacions d'un a molts o de diversos a molts.

Si incloeu només el nom de la propietat de navegació, rebreu totes les propietats de les files relacionades. Per obtenir més informació, consulta Recuperar files de taules relacionades amb una consulta.

Per utilitzar-lo en un pas de flux, introduïu aquesta expressió Odata al camp Expandeix la consulta : primarycontactid(contactid,fullname). Així és com obtenir les columnes contactid i nom complet per al contactarycontactid principal de cada compte.

Recompte de files

S'utilitza per indicar el nombre concret de files per Dataverse tornar. Aquí teniu un exemple que mostra com sol·licitar 10 files.

Consulta FetchXML

Actualment, les consultes d'agregació no s'admeten quan s'utilitza l'acció Files de llista amb consultes FetchXML. No obstant això, s'admet l'operador diferent.

Dissenyador clàssic

Utilitzeu una consulta Dataverse FetchXML d'estil A, que permet més flexibilitat a l'hora de crear consultes personalitzades. Aquestes consultes poden ser útils quan treballeu amb una taula que té diverses taules relacionades o quan gestioneu la paginació. La següent captura de pantalla mostra com utilitzar FetchXML.

Escriviu el següent al camp Consulta Fetch Xml .

Com que actualment l'operador diferent no és compatible directament amb les consultes FetchXML de l'acció Llista files, la funció d'unió es pot utilitzar per eliminar files duplicades. Per exemple, podeu utilitzar l'acció Selecciona per transformar la resposta de la connexió de files de llista al format de matriu específic que necessiteu i, a continuació, crear una variable amb l'expressió union(body('Select'),body('Select' ... ))) per obtenir una matriu amb files diferents.

Edita amb Copilot

Utilitzeu una consulta Dataverse FetchXML d'estil A, que permet més flexibilitat a l'hora de crear consultes personalitzades. Aquestes consultes poden ser útils quan treballeu amb una taula que té diverses taules relacionades o quan gestioneu la paginació. La següent captura de pantalla mostra com utilitzar FetchXML.

Exemple de consulta FetchXML per a la taula de comptes:

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

Com que actualment l'operador diferent no és compatible directament amb les consultes FetchXML de l'acció Llista files, la funció d'unió es pot utilitzar per eliminar files duplicades. Per exemple, podeu utilitzar l'acció Selecciona per transformar la resposta de la connexió de files de llista al format de matriu específic que necessiteu i, a continuació, crear una variable amb l'expressió union(body('Select'),body('Select' ... ))) per obtenir una matriu amb files diferents.

Omet el testimoni

Com que Power Automate aplica límits de rendiment del contingut i límits de mida dels missatges per garantir garanties generals del servei, sovint és útil utilitzar la paginació per retornar un nombre més reduït de files d'un lot, en lloc dels límitspredeterminats del nombre de files de la taula retornades.

El límit de pàgines per defecte de 5.000 files s'aplica si no utilitzeu la paginació.

Per utilitzar-lo, implementeu un bucle per analitzar el valor @odata.nextLink a la resposta JSON, extraieu el testimoni d'omissió i, a continuació, envieu una altra sol·licitud fins que hàgiu llistat el nombre de files que necessiteu.

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ó

Opció per especificar el valor partitionId en recuperar les dades per a les taules NoSQL. Per obtenir més informació, vegeu Millorar el rendiment mitjançant particions d'emmagatzematge quan accediu a les dades de la taula.