Utilizarea listelor de rânduri în fluxuri

Folosește acțiunea List rows pentru a prelua mai multe rânduri simultan dintr-o Microsoft Dataverse interogare structurată.

Obțineți o listă de rânduri

Urmați acești pași pentru a adăuga acțiunea List rows la fluxul dvs. pentru a returna până la 5.000 de conturi din tabelul Conturi din Dataverse.

Power Automate vă permite să utilizați fie noul designer, fie designerul clasic pentru a configura fluxul în cloud. ... Pașii sunt similari la ambii designeri. Aflați mai multe (cu exemple) în Identificați diferențele dintre designerul nou și designerul clasic.

Designer nou

1. Selectați semnul plus (+) >Adăugați o acțiune.
2. Pe ecranul Adăugați o acțiune , introduceți rândurile din listă în câmpul Căutare .
3. Sub Microsoft Dataverse, selectați Listează rânduri (Previzualizare).
4. În fila Parametri din stânga, selectați Conturi din meniul derulant Nume tabel .
5. Închideți ecranul selectând (<<).

Designer clasic

1. Selectați Pas nou pentru a adăuga o acțiune la fluxul dvs.
2. Introduceți rânduri din listă în caseta de căutare Conectori și acțiuni de căutare de pe fișa Alegeți o operațiune .
3. Selectați Microsoft Dataverse pentru a filtra rezultatele căutării și a afișa doar acțiunile și declanșatoarele pentru Microsoft Dataverse.
4. Selectați Listă rânduri.
5. Selectați tabelul Conturi din lista Nume tabel .
6. Salvați și rulați fluxul pentru a confirma că nu sunt returnate mai mult de 5.000 de rânduri.

Activați paginarea pentru a solicita mai mult de 5.000 de rânduri

Pentru a obține automat mai mult de 5.000 de rânduri dintr-o interogare, activați funcția Paginare din Setări.

Când paginarea este setată și numărul de rânduri depășește pragul configurat, răspunsul nu va include parametrul @odata.nextLink pentru a solicita următorul set de rânduri. Dezactivați paginarea astfel încât răspunsul să includă parametrul @odata.nextLink care poate fi utilizat pentru a solicita următorul set de rânduri. Accesați Jetonul de omitere pentru a afla cum să îl utilizați.

Limitele de debit de conținut și limitele de dimensiune a mesajelor se aplică pentru a asigura garanțiile generale de servicii.

Designer nou

1. Selectați cardul List rows .

2. În panoul din stânga, selectați fila *Setări* *Rețea* .>

3. Mutați cursorul Paginare în poziția Activat dacă nu este deja activat.

4. În Prag, introduceți numărul maxim de rânduri solicitate. Pragul maxim configurabil este de 100.000.

   Intern, acest număr este rotunjit în trepte ale dimensiunii implicite a paginii. De exemplu, dacă dimensiunea paginii respective este de 5.000 și introduceți 7.000, numărul de rânduri returnate este de 10.000.

Designer clasic

1. În colțul din dreapta sus al cardului Rânduri din listă , selectați meniul (...).

2. Selectați Setări.

3. Mutați cursorul Paginare în poziția Activat dacă nu este deja activat.

4. În Prag, introduceți numărul maxim de rânduri solicitate. Pragul maxim configurabil este de 100.000.

   Intern, acest număr este rotunjit în trepte ale dimensiunii implicite a paginii. De exemplu, dacă dimensiunea paginii respective este de 5.000 și introduceți 7.000, numărul de rânduri returnate este de 10.000.

Opțiuni complexe

Opțiunile avansate pentru acțiunea Listare rânduri vă permit să sortați, să filtrați, să aranjați și să extindeți rezultatele unei interogări.

Designer nou

Puteți seta opțiuni în panoul de configurare a acțiunilor.

1. Pentru a vedea opțiunile, selectați cardul List rows .

2. În fila Parametri , selectați o opțiune avansată din meniul derulant Adăugați parametri noi .

   

Designer clasic

Puteți seta opțiuni avansate direct pe cardul Rânduri din listă . Pentru a vedea opțiunile, selectați Afișați opțiunile avansate. Când îl selectați, numele se schimbă în Ascundeți opțiunile avansate.

Selectați coloanele

Introduceți o listă de coloane separate prin virgulă de returnat, cum ar fi „nume,creatdata,codmetodădecontactpreferat,adresăemail1,telefon1” pentru tabelul Cont.

Filtrați rândurile

Se utilizează pentru a defini o expresie de filtrare în stil OData pentru a restrânge setul de rânduri care returnează, cum ar fi „createdon ge 2021-01-01T00:00:00-00:00” pentru rândurile cu anul Dataverse createdon mai mare sau egal cu anul 2021.

Aflați cum să utilizați operatorii standard de filtrare și funcțiile de interogare pentru a construi expresii de tip Filter Query .

Anumite caractere, cum ar fi &, # și + , trebuie înlocuite cu echivalentul lor codificat în URL. Mai multe informații: Codificarea URL a caracterelor speciale

Important

Expresiile de filtrare nu pot conține acest șir, $filter=, deoarece se aplică doar atunci când utilizați direct API-urile.

Sortare după

Se utilizează pentru a defini o expresie în stil OData care definește ordinea în care sunt returnate elementele, cum ar fi „nume desc”. Folosiți sufixul asc sau desc pentru a indica ordinea ascendentă, respectiv descendentă. Ordinea implicită este crescătoare.

Extindeți interogarea

Se utilizează pentru a specifica o expresie în stil OData care definește datele returnate din tabelele corelate, cum ar fi pentru a utiliza ID-ul primarycontactid al contului și a recupera coloana fullname din contactul corelat cu ID-ul contactid din răspuns. Dataverse primarycontactid($select=contactid,fullname)

Există două tipuri de proprietăți de navigare pe care le puteți utiliza în Expand Query:

1. Proprietățile de navigare cu valoare unică corespund coloanelor de căutare care acceptă relații de tip mai mulți-la-unu și vă permit să setați o referință la un alt tabel.

2. Proprietățile de navigare cu valori de colecție corespund relațiilor unu-la-mai-mulți sau mai-mulți-la-mai-mulți.

Dacă includeți doar numele proprietății de navigare, veți primi toate proprietățile pentru rândurile aferente. Pentru a afla mai multe, consultați Recuperarea rândurilor de tabel corelate cu o interogare.

Pentru a o utiliza într-un pas de flux, introduceți această expresie Odata în câmpul Expand Query : primarycontactid(contactid,fullname). Iată cum se obțin coloanele *contactid* și *fullname* pentru *primarycontactid* ale fiecărui cont .

Număr de rânduri

Se utilizează pentru a indica numărul specific de rânduri pe care Dataverse trebuie să le returneze. Iată un exemplu care arată cum se solicită 10 rânduri.

Preluare interogare XML

Interogările de agregare nu sunt acceptate în prezent atunci când se utilizează acțiunea List rows cu interogări FetchXML . Totuși, operatorul distinct este acceptat.

Designer nou

Folosește o interogare în stil Dataverse, care permite mai multă flexibilitate în construirea de interogări personalizate. FetchXML Aceste interogări pot fi utile atunci când lucrați cu un tabel care are mai multe tabele corelate sau când gestionați paginarea. Următoarea captură de ecran arată cum se utilizează FetchXML.

Exemplu FetchXML de interogare pentru tabelul Cont:

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

Întrucât operatorul distinct nu este acceptat în prezent direct în FetchXML interogările din acțiunea List rows, funcția union poate fi utilizată pentru a elimina rândurile duplicate. De exemplu, puteți utiliza acțiunea Select pentru a transforma răspunsul conexiunii List rows în formatul specific de matrice de care aveți nevoie, apoi puteți crea o variabilă cu expresia union(body('Select'),body('Select')) pentru a obține o matrice cu rânduri distincte.

Designer clasic

Folosește o interogare în stil Dataverse, care permite mai multă flexibilitate în construirea de interogări personalizate. FetchXML Aceste interogări pot fi utile atunci când lucrați cu un tabel care are mai multe tabele corelate sau când gestionați paginarea. Următoarea captură de ecran arată cum se utilizează FetchXML.

Introduceți următoarele în câmpul Fetch Xml Query .

Întrucât operatorul distinct nu este acceptat în prezent direct în FetchXML interogările din acțiunea List rows, funcția union poate fi utilizată pentru a elimina rândurile duplicate. De exemplu, puteți utiliza acțiunea Select pentru a transforma răspunsul conexiunii List rows în formatul specific de matrice de care aveți nevoie, apoi puteți crea o variabilă cu expresia union(body('Select'),body('Select')) pentru a obține o matrice cu rânduri distincte.

Ignorați tokenul

Deoarece Power Automate aplică limite de debit de conținut și limite de dimensiune a mesajelor pentru a asigura garanții generale de servicii, este adesea util să se utilizeze paginarea pentru a returna un număr mai mic de rânduri într-un lot, în loc de limitele implicite privind numărul de rânduri returnate în tabel.

Limita implicită de pagini de 5.000 de rânduri se aplică dacă nu utilizați paginarea.

Pentru a o utiliza, implementați o buclă pentru a analiza valoarea @odata.nextLink din răspunsul JSON, extrageți tokenul skip și apoi trimiteți o altă solicitare până când ați listat numărul de rânduri de care aveți nevoie.

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 partiție

O opțiune pentru a specifica partitionId în timp ce se regăsesc date pentru tabelele NoSQL. Pentru a afla mai multe, consultați Îmbunătățirea performanței utilizând partiții de stocare la accesarea datelor din tabel.

Informații corelate

• Instruire: Utilizarea Dataverse declanșatoarelor și acțiunilor în Power Automate (modul)
• Instruire: Integrarea fluxurilor și (cale de învățare) Power Automate Dataverse