Realoendite kasutamine voogudes

Toimingu Rivide loetlemine abil saate struktureeritud päringuga tuua korraga Microsoft Dataverse mitu rida.

Ridade loendi hankimine

Järgige neid juhiseid, et lisada voogu toiming Loetle read, et tagastada tabelist Kontod kuni 5 000 kontot Dataverse.

Power Automate Võimaldab teil pilvevoo konfigureerimiseks kasutada kas uut kujundajat või klassikalist kujundajat. Sammud on mõlemal disaineril sarnased. Lisateavet (koos näidetega) leiate teemast Uue kujundaja ja klassikalise kujundaja erinevuste tuvastamine.

Uus disainer

1. Valige plussmärk (+) >Lisa toiming.
2. Sisestage väljal Toimingu lisamine loendiread väljale Otsing .
3. Valige jaotises Microsoft Dataverse Loetle read (eelvaade).
4. Valige vasakul vahekaardil Parameetrid rippmenüüst Tabeli nimi Kontod.
5. Sulgege ekraan, valides (<<).

Klassikaline disainer

1. Valige Uus etapp , et lisada oma voogu toiming.
2. Sisestage loendiread otsinguväljale Otsi konnektoreid ja toiminguid kaardil Toimingu valimine.
3. Valige Microsoft Dataverse otsingutulemite filtreerimiseks, et kuvada ainult toimingud Microsoft Dataverse ja päästikud.
4. Valige Loetlege read.
5. Valige loendist Tabeli nimi tabel Kontod .
6. Salvestage ja käivitage voog, et veenduda, et tagastatakse mitte rohkem kui 5,000 rida.

Lehekülgede sisselülitamine, et taotleda rohkem kui 5 000 rida

Kui soovite päringust automaatselt saada rohkem kui 5,000 rida, lülitage jaotises Sätted sisse funktsioon Lehekülgemine.

Kui lehekülgede arv on määratud ja ridade arv ületab konfigureeritud läve arvu, ei sisalda vastus parameetrit @odata.nextLink järgmise ridade komplekti taotlemiseks. Lülitage lehekülgede kasutamine välja, et vastus sisaldaks parameetrit @odata.nextLink, mida saab kasutada järgmise ridade komplekti taotlemiseks. Minge lehele Jäta märk vahele, et teada saada, kuidas seda kasutada.

Üldiste teenusegarantiide tagamiseks kehtivad sisu läbilaskevõime jasõnumi mahu piirangud .

Uus disainer

1. Valige kaart Loetle read.

2. Valige vasakpoolsel paanil vahekaart Sätted >Võrgundus.

3. Liigutage liugur Lehekülgimine asendisse Sees, kui see pole veel sisse lülitatud.

4. Sisestage väljale Lävi taotletavate ridade maksimaalne arv. Maksimaalne konfigureeritav lävi on 100 000.

   Sisemiselt ümardatakse see arv lehe vaikesuuruse sammuga. Näiteks kui lehe suurus on 5 000 ja sisestate 7 000, on tagastatud ridade arv 10 000.

Klassikaline disainer

1. Valige kaardi Loendiread paremas ülanurgas menüü (...).

2. Tehke valik Sätted.

3. Liigutage liugur Lehekülgimine asendisse Sees, kui see pole veel sisse lülitatud.

4. Sisestage väljale Lävi taotletavate ridade maksimaalne arv. Maksimaalne konfigureeritav lävi on 100 000.

   Sisemiselt ümardatakse see arv lehe vaikesuuruse sammuga. Näiteks kui lehe suurus on 5 000 ja sisestate 7 000, on tagastatud ridade arv 10 000.

Täpsemad suvandid

Toimingu Loetle read täpsemad suvandid võimaldavad teil päringu tulemeid sortida, filtreerida, korraldada ja laiendada.

Uus disainer

Suvandeid saate määrata toimingu konfiguratsioonipaanil.

1. Suvandite vaatamiseks valige kaart Loetle read.

2. Valige vahekaardil Parameetrid rippmenüüst Lisa uued parameetrid täpsema valiku.

   

Klassikaline disainer

Täpsemaid suvandeid saate määrata otse kaardil Loetlege read . Suvandite vaatamiseks valige Kuva täpsemad suvandid. Kui valite selle, muutub nimeks Peida täpsemad suvandid.

Valige veerud

Sisestage tagastatavate veergude komaeraldusega loend (nt "name,createdon,preferredcontactmethodcode,emailaddress1,phone1" tabeli Account jaoks.

Filtreeri ridu

Kasutage OData-stiilis filtriavaldise määratlemiseks, et kitsendada ridade komplekti, mille Dataverse tagastab, nt „createdon ge 2021-01-01T00:00:00-00:00“ ridade puhul, mille createdon on võrdne või suurem kui aastaga 2021.

Siit saate teada, kuidas kasutada standardseid filtritehtemärke ja päringufunktsioone filtripäringu avaldiste koostamiseks .

Teatud märgid, näiteks &, #, tuleb + asendada nende URL-kodeeritud ekvivalendiga. Lisateave: URL-i erimärkide kodeerimine

Oluline

Filtriavaldised ei saa seda stringi sisaldada, $filter=, kuna see rakendub ainult siis, kui kasutate API-sid otse.

Sortimisalus:

Kasutage OData-laadi avaldise määratlemiseks, mis määratleb üksuste tagastamise järjekorra (nt "name desc"). Kasutage asc või desc järelliidet, et tähistada vastavalt tõusvat või kahanevat järjestust. Vaikejärjestus on tõusev.

Laienda päringut

Kasutage OData-laadi avaldise määramiseks, mis määratleb seotud tabelitest tagastatavad Dataverse andmed, näiteks primarycontactid($select=contactid,fullname) konto primarycontactid kasutamiseks täisnimeveeru toomiseks seotud kontaktilt, kelle ID contactid on vastuses.

Päringu laiendamisel saate kasutadakahte tüüpi navigeerimisatribuute.

1. Üheväärtuselised navigeerimisatribuudid vastavad otsinguveergudele, mis toetavad mitu-ühele seoseid ja võimaldavad teil määrata viite mõnele muule tabelile.

2. Kollektsiooni väärtusega navigeerimisatribuudid vastavad üks-mitmele või mitu-mitmele seostele.

Kui lisate ainult navigeerimisatribuudi nime, saate kõik seotud ridade atribuudid. Lisateavet leiate teemast Seotud tabeliridade toomine päringuga.

Selle kasutamiseks vooetapis sisestage see Odata avaldis väljale Laienda päringut :. primarycontactid(contactid,fullname) Nii saate iga konto kontakti ID ja täisnime veerud esmakordse kontakti ID jaoks .

Ridade arv

Kasutage tagastatavate ridade arvu näitamiseks. Dataverse Siin on näide, mis näitab, kuidas taotleda 10 rida.

Päring Fetch XML

Koondpäringuid ei toetata praegu toimingu ridade loendi kasutamisel koos päringutega FetchXML . Siiski on toetatud eristav operaator.

Uus disainer

Kasutage päringut Dataversestiilis FetchXML päringut, mis võimaldab kohandatud päringute loomisel suuremat paindlikkust. Need päringud võivad olla kasulikud mitme omavahel seotud tabeliga töötamisel või lehekülgjaotuse haldamisel. Järgmisel ekraanipildil on näidatud, kuidas FetchXML-d kasutada.

Näidispäring FetchXML konto tabeli jaoks:

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

Kuna distinct-operaatorit ei toetata praegu otse FetchXML-i päringutes loendiridade toimingust, saab duplikaatridade eemaldamiseks kasutada ühendamisfunktsiooni. Näiteks saate kasutada toimingut Select , et teisendada loendirudade ühenduse vastus vajalikku massiivivormingusse, seejärel luua muutuja avaldisega union(body(’Select’),body(’Select’)) , et saada erinevate ridadega massiiv.

Klassikaline disainer

Kasutage päringut Dataversestiilis FetchXML päringut, mis võimaldab kohandatud päringute loomisel suuremat paindlikkust. Need päringud võivad olla kasulikud mitme omavahel seotud tabeliga töötamisel või lehekülgjaotuse haldamisel. Järgmisel ekraanipildil on näidatud, kuidas FetchXML-d kasutada.

Tippige väljale Fetch XML Query järgmine tekst.

Kuna distinct-operaatorit ei toetata praegu otse FetchXML-i päringutes loendiridade toimingust, saab duplikaatridade eemaldamiseks kasutada ühendamisfunktsiooni. Näiteks saate kasutada toimingut Select , et teisendada loendirudade ühenduse vastus vajalikku massiivivormingusse, seejärel luua muutuja avaldisega union(body(’Select’),body(’Select’)) , et saada erinevate ridadega massiiv.

Jäta tõend vahele

Kuna üldise teenuse garantii tagamiseks kehtivad Power Automate sisu läbilaskevõime piirangud ja sõnumi suuruse piirangud , on sageli kasulik kasutada lehekülgi , et tagastada partiis väiksem arv ridu, mitte vaikimisi piiranguid tagastatavate tabeliridade arvule .

Vaikimisi leheküljepiirang 5000 rida kehtib siis, kui te lehekülgi ei kasuta.

Selle kasutamiseks rakendage tsükkel, mis parsib JSON-vastuses olevat ` @odata.nextLink väärtust, ekstraheerige ` skip token` ja saatke seejärel uus päring, kuni olete loetlenud vajaliku arvu ridu.

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

Sektsiooni ID

Võimalus määrata partitionId andmete toomisel NoSQL tabelitele. Lisateabe saamiseks vaadake jaotist Jõudluse parandamine salvestuspartitsioonide abil tabeli andmetele juurdepääsul.

Seotud teave

• Koolitus: Kasutage Dataverse päästikuid ja toiminguid Power Automate (moodulis)
• Koolitus: Integreeri voogusid ja (õppetee) Power Automate Dataverse