Share via


Realoendite kasutamine voogudes

Kasutage toimingut Loendiread mitme rea korraga toomiseks liigendatud päringuga Microsoft Dataverse .

Ridade loendi hankimine

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

Märkus.

Power Automate kasutab Copilotiga kas klassikalist pilvevoogude kujundajat või pilvevoogude kujundajat. Kasutatava kujundaja tuvastamiseks lugege jaotist Märkus teemas Pilvevoogude kujundaja mõistmine koos piloodi võimalustega.

  1. Valige Uus etapp , et lisada toiming oma voogu.
  2. Sisestage loendireadoperatsioonikaardi valimine otsinguväljale Otsingukonnektorid ja toimingud .
  3. Valige otsingutulemite Microsoft Dataverse filtreerimiseks nii, et kuvataks ainult toimingud ja päästikud Microsoft Dataverse.
  4. Valige Loendi read.
  5. Valige loendist Tabeli nimi tabel Accounts (Kontod ).
  6. Salvestage ja käivitage oma voog, et kinnitada, et tagastatakse mitte rohkem kui 5,000 rida.

Rohkem kui 5,000 rea taotlemiseks lehitsemise sisselülitamine

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

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

Sisu läbilaskevõime piirangud ja sõnumi mahupiirangud kehtivad teenuse üldiste garantiide tagamiseks.

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

  2. Tehke valik Sätted.

  3. Liigutage liugur Lehitsemine asendisse Sees , kui see pole juba sisse lülitatud.

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

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

Täpsemad suvandid

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

Täpsemaid suvandeid saate määrata otse kaardil Loendiread . Suvandite nägemiseks valige Kuva täpsemad suvandid. Kui selle valite, muutub nimi peidetuks Täpsemad suvandid .

Kuvatõmmis loendiridade kaardi täpsematest suvanditest.

Valige veerud

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

Filtreeri ridu

Kasutage OData-laadi filtriavaldise määratlemiseks, et kitsendada tagastatavate ridade kogumit, nt Dataverse "createdon ge 2021-01-01T00:00:00-00:00" ridade puhul, mille loomine on suurem kui aasta 2021 või sellega võrdne.

Siit saate teada, kuidas kasutada päringuavaldiste filtreerimiseksstandardseid filtritehtemärke ja päringufunktsioone .

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

Oluline

Filtriavaldised ei tohi sisaldada seda stringi,$filter= , kuna see rakendub ainult API-de otsesel kasutamisel.

Sortimisalus:

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

Päringu laiendamine

Kasutage OData-laadi avaldise määramiseks, mis määratleb seotud tabelitest tagastatavad andmed, näiteks Dataverse saate kasutada konto primarycontactid($select=contactid,fullname) peamist kontakt-ID-d täisnime veeru toomiseks vastuses olevast ID-ga kontaktiga seotud kontaktist.

Laiendatud päringus saate kasutada kahte tüüpi navigeerimisatribuute.

  1. Ühe väärtusega navigeerimisatribuudid vastavad otsinguveergudele, mis toetavad mitut-ühele seoseid ja võimaldavad teil määrata viite teisele tabelile.

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

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

Selle kasutamiseks vooetapis sisestage see Odata avaldis väljale Laienda päring : primarycontactid(contactid,fullname). Nii saate hankida iga konto esmase kontaktid veerud contactid ja fullname.

Ridade arv

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

Päring Fetch XML

Liitmispäringud pole praegu toetatud, kui kasutate toimingut Loendiread koos päringutega FetchXML. Siiski toetatakse eraldi operaatorit.

Kasutage a-stiilis Dataverse FetchXML-päringut, mis võimaldab kohandatud päringute loomisel suuremat paindlikkust. Need päringud võivad olla kasulikud, kui töötate tabeliga, millel on mitu seotud tabelit, või käsitlete lehitsemist. Järgmine ekraanipilt näitab, kuidas FetchXML-i kasutada.

Tippige järgmine tekst väljale Toomise Xml-päring .

Loendikontode näide FetchXML-iga.

Kuna eristatavat tehtemärki ei toetata praegu otse funktsiooni FetchXML-i päringutes toimingust Loendiread, saab liitfunktsiooni kasutada duplikaatridade eemaldamiseks. Näiteks saate kasutada toimingut Vali, et teisendada loendiridade ühenduse vastus konkreetsele vajalikule massiivivormingule, seejärel luua muutuja avaldisega union(’Select’),body(’Select’))), et saada erinevate ridadega massiiv.

Jäta tõend vahele

Kuna Power Automate üldiste teenusegarantiide tagamiseks rakendatakse sisu läbilaskevõime piiranguid ja sõnumi mahupiiranguid , on sageli kasulik kasutada lehitsemist , et tagastada partiis väiksem arv ridu, mitte tagastatud tabeliridade vaikepiirangud.

Lehekülje vaikepiirang 5,000 rida rakendub siis, kui te ei kasuta lehekülgede arvu.

Selle kasutamiseks rakendage silmus, et sõeluda JSON-vastuses väärtus@odata.nextLink , ekstraktige vahelejätmise luba ja saatke seejärel uus päring, kuni olete loetlenud vajaliku ridade arvu.

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. Lisateavet leiate teemast Jõudluse parandamine salvestussektsioonide abil tabeliandmetele juurdepääsul.