Upotreba popisa redaka u tokovima

Koristite akciju Reci popisa za dohvaćanje više redaka odjednom iz Microsoft Dataverse strukturiranog upita.

Dohvaćanje popisa redaka

Slijedite ove korake da biste u tijek dodali akciju Reci popisa da biste vratili do 5000 računa iz tablice Računi u Dataverse.

Napomena

Power Automate koristi klasični dizajner tokova oblaka ili dizajner tokova oblaka s kopilotom. Da biste odredili koji dizajner koristite, idite na odjeljak Bilješke u odjeljku Objašnjenje dizajnera tokova oblaka s mogućnostima kopilota.

Klasični dizajner

1. Odaberite Novi korak da biste dodali akciju u tijek.
2. Unesite retke popisa u okvir za pretraživanje poveznika za pretraživanje i akcije pretraživanja na kartici Odaberite operaciju .
3. Odaberite Microsoft Dataverse za filtriranje rezultata pretraživanja tako da prikazuje samo akcije i okidače za Microsoft Dataverse.
4. Odaberite Reci popisa.
5. S popisa Naziv tablice odaberite tablicu Računi .
6. Spremite i pokrenite tijek da biste potvrdili da se ne vraća više od 5000 redaka.

Uredi pomoću kopilota

1. Odaberite znak plus (+) >Dodajte akciju.
2. U polje Pretraživanje unesite retke popisa Dodaj akciju .
3. U odjeljku Microsoft Dataverse odaberite Reci popisa (pretpregled).
4. Na padajućem izborniku Naziv tablice na padajućem izborniku Naziv tablice odaberite Računi .
5. Zatvorite zaslon tako da odaberete (<<).

Uključite numeriranje stranica da biste zatražili više od 5000 redaka

Da biste automatski dobili više od 5000 redaka iz upita, uključite značajku numeriranja stranica iz Postavke.

Kada je numeriranje stranica postavljeno@odata a količina redaka premašuje taj broj konfiguriranog praga, odgovor neće uključivati parametar .nextLink za traženje sljedećeg skupa redaka. Isključite numeriranje stranica tako da odgovor uključuje parametar @odata.nextLink koji se može koristiti za traženje sljedećeg skupa redaka. Idite na Preskoči token da biste saznali kako ga koristiti.

Ograničenja protoka sadržaja i ograničenja veličine poruke primjenjuju se kako bi se osigurala opća jamstva za usluge.

Klasični dizajner

1. U gornjem desnom kutu kartice Reci popisa odaberite izbornik (...).

2. Odaberite Postavke.

3. Pomaknite klizač Paginacija na položaj Uključeno ako već nije uključen.

4. U okvir Prag unesite maksimalan broj traženih redaka. Maksimalni podesivi prag je 100.000.

   Interno se taj broj zaokružuje u koracima zadane veličine stranice. Na primjer, ako je ta veličina stranice 5.000, a unesete 7.000, broj vraćenih redaka je 10.000.

Uredi pomoću kopilota

1. Odaberite karticu Reci popisa .

2. U oknu s lijeve strane odaberite karticu Postavke >Umrežavanje.

3. Pomaknite klizač Paginacija na položaj Uključeno ako već nije uključen.

4. U okvir Prag unesite maksimalan broj traženih redaka. Maksimalni podesivi prag je 100.000.

   Interno se taj broj zaokružuje u koracima zadane veličine stranice. Na primjer, ako je ta veličina stranice 5.000, a unesete 7.000, broj vraćenih redaka je 10.000.

Dodatne mogućnosti

Dodatne mogućnosti za akciju Reci popisa omogućuju sortiranje, filtriranje, raspoređivanje i proširivanje rezultata upita.

Klasični dizajner

Napredne mogućnosti možete postaviti izravno na kartici Reci popisa . Da biste vidjeli mogućnosti, odaberite Pokaži dodatne mogućnosti. Kada ga odaberete, naziv se mijenja u Sakrij dodatne mogućnosti.

Uredi pomoću kopilota

Mogućnosti možete postaviti u oknu za konfiguraciju akcije.

1. Da biste vidjeli mogućnosti, odaberite karticu Reci popisa .

2. Na kartici Parametri odaberite naprednu mogućnost na padajućem izborniku Dodavanje novih parametara .

   

Odabir stupaca

Unesite popis stupaca razdvojenih zarezom za vraćanje, kao što su "ime,stvoreno,preferiranikontaktmetodcode,adresa e-pošte1,telefon1" za tablicu Račun.

Filtriraj retke

Koristi se za definiranje izraza filtra u stilu OData za sužavanje skupa redaka koji Dataverse se vraćaju, kao što je "createdon ge 2021-01-01T00:00:00-00:00" za retke s stvorenimna većim ili jednakim godini 2021.

Saznajte kako koristiti standardne operatore filtra i funkcije upita za izradu izraza upita filtra .

Određene znakove, kao što je &,, #+ i treba zamijeniti ekvivalentom kodiranim URL-om. Dodatne informacije: URL kodiranje posebnih znakova

Važno

Izrazi filtra ne mogu sadržavati ovaj niz, $filter=, jer se primjenjuje samo kada izravno koristite API-je.

Sortiraj prema

Koristi se za definiranje izraza u stilu OData koji definira redoslijed vraćanja stavki, kao što je "name desc". Koristite asc ili descsufiks za označavanje uzlaznog ili silaznog redoslijeda. Zadani redoslijed se uzdiže.

Proširi upit

Koristi se za određivanje izraza u stilu OData koji definira podatke koji Dataverse se vraćaju iz povezanih tablica, kao što primarycontactid($select=contactid,fullname) je korištenje primarnog kontaktnog ID-a računa za dohvaćanje stupca punog imena iz povezanog kontakta s ID-om kontakta u odgovoru.

Postoje dvije vrste navigacijskih svojstava koje možete koristiti u proširenju upita:

1. Svojstva navigacije s jednom vrijednošću odgovaraju stupcima za pretraživanje stupaca koji podržavaju Odnosi više na jedan i omogućuju postavljanje reference na drugu tablicu.

2. Svojstva navigacije s vrijednostima zbirke odgovaraju Odnosi jedan-prema-više ili više-prema-više.

Ako uključite samo naziv svojstva navigacije, dobit ćete sva svojstva za povezane retke. Dodatne informacije potražite u članku Dohvaćanje povezanih redaka tablice s upitom.

Da biste ga koristili u koraku toka, unesite ovaj izraz Odata u polje Proširi upit : primarycontactid(contactid,fullname). Na taj način možete dobiti stupce ID-a kontakta i punog imena za IDprimarnog kontakta svakog računa.

Zbroj redaka

Koristi se za označavanje određenog broja redaka za Dataverse povratak. Evo primjera koji pokazuje kako zatražiti 10 redaka.

Upit za Fetch XML

Upiti zbrajanja trenutno nisu podržani kada koristite akciju Reci popisa s upitima FetchXML. Međutim, podržan je poseban operator.

Klasični dizajner

Koristite A-style Dataverse FetchXML upit, koji omogućuje veću fleksibilnost u stvaranju prilagođenih upita. Ti upiti mogu biti korisni kada radite s tablicom koja sadrži više povezanih tablica ili rukujete numeriranjem stranica. Sljedeća snimka zaslona prikazuje kako koristiti FetchXML.

U polje Fetch Xml Query upišite sljedeće.

Budući da zasebni operator trenutno nije podržan izravno u upitima FetchXML iz akcije Reci popisa, funkcija unije može se koristiti za uklanjanje dupliciranih redaka. Na primjer, možete koristiti akciju Odaberite za pretvaranje odgovora veze redaka popisa na određeni oblik polja koji vam je potreban, a zatim stvoriti varijablu s izrazom unija(tijelo('Odaberi'),tijelo('Odaberi'))) da biste dobili polje s različitim recima.

Uredi pomoću kopilota

Koristite A-style Dataverse FetchXML upit, koji omogućuje veću fleksibilnost u stvaranju prilagođenih upita. Ti upiti mogu biti korisni kada radite s tablicom koja sadrži više povezanih tablica ili rukujete numeriranjem stranica. Sljedeća snimka zaslona prikazuje kako koristiti FetchXML.

Primjer upita DohvaćanjeXML-a za tablicu Poslovni subjekt:

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

Budući da zasebni operator trenutno nije podržan izravno u upitima FetchXML iz akcije Reci popisa, funkcija unije može se koristiti za uklanjanje dupliciranih redaka. Na primjer, možete koristiti akciju Odaberite za pretvaranje odgovora veze redaka popisa na određeni oblik polja koji vam je potreban, a zatim stvoriti varijablu s izrazom unija(tijelo('Odaberi'),tijelo('Odaberi'))) da biste dobili polje s različitim recima.

Token za preskakanje

Budući da Power Automate primjenjuje ograničenja protoka sadržaja i ograničenja veličine poruke kako bi se osigurala opća jamstva usluge, često je korisno koristiti numeriranje stranica za vraćanje manjeg broja redaka u seriji, a ne zadana ograničenja broja vraćenih redaka tablice.

Ako ne koristite numeriranje stranica, primjenjuje se zadano ograničenje stranice od 5000 redaka.

Da biste ga koristili, implementirajte petlju da biste raščlanili vrijednost @odata.nextLink u JSON odgovoru, izdvojite token za preskakanje, a zatim pošaljite drugi zahtjev dok ne navedete broj redaka koji vam je potreban.

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 particije

Mogućnost koja navodi ID particije dok dohvaća podatke za NoSQL tablice. Dodatne informacije potražite u članku Poboljšanje performansi pomoću particija za pohranu prilikom pristupa podacima tablice.