Uporaba seznamov vrstic v tokovih

Uporabite dejanje Seznam vrstic za pridobitev več vrstic hkrati iz Microsoft Dataverse s strukturirano poizvedbo.

Pridobite seznam vrstic

Sledite tem korakom, da svojemu toku dodate dejanje Seznam vrstic za vrnitev do 5000 računov iz Računi tabela v Dataverse.

opomba,

Power Automate uporablja klasični oblikovalnik tokov v oblaku ali oblikovalec tokov v oblaku s Copilotom. Če želite ugotoviti, kateri oblikovalnik uporabljate, pojdite na razdelek Opomba v Razumevanje oblikovalnika tokov v oblaku z zmožnostmi kopilota.

Klasični oblikovalec

1. Izberite Nov korak , da svojemu toku dodate dejanje.
2. Vnesite vrstice seznama v Iskalni priključki in dejanja iskalno polje na Izberite operacijska kartica .
3. Izberite Microsoft Dataverse , če želite filtrirati rezultate iskanja, da prikažejo samo dejanja in sprožilce za Microsoft Dataverse.
4. Izberite Seznam vrstic.
5. Izberite tabelo Računi s seznama Ime tabele .
6. Shranite in zaženite tok, da potrdite, da ni vrnjenih več kot 5000 vrstic.

Urejanje s Copilotom

1. Izberite znak plus (+) >Dodaj dejanje.
2. Na zaslonu Dodaj dejanje vnesite vrstice seznama v Iskanje polje.
3. Pod Microsoft Dataverse izberite Vrstice seznama (predogled).
4. Na zavihku Parametri na levi izberite Računi v Ime tabele spustni meni.
5. Zaprite zaslon z izbiro (<<).

Vklopite ostranjevanje, če želite zahtevati več kot 5000 vrstic

Če želite samodejno pridobiti več kot 5000 vrstic iz poizvedbe, vklopite Funkcijo Pagination v Settings.

Ko je ostranjevanje nastavljeno in število vrstic preseže to število konfiguriranega praga, odgovor ne bo vseboval parametra @odata.nextLink za zahtevo naslednjega niza vrstic. Izklopite številčenje strani, tako da odgovor vključuje parameter @odata.nextLink , ki ga lahko uporabite za zahtevo po naslednjem naboru vrstic. Pojdite na Preskoči žeton , če želite izvedeti, kako ga uporabljati.

Omejitve prepustnosti vsebine in omejitve velikosti sporočil veljajo za zagotavljanje splošnih garancij storitev.

Klasični oblikovalec

1. V zgornjem desnem kotu kartice Seznam vrstic izberite meni (...).

2. Izberite Nastavitve.

3. Premaknite drsnik Pagination na On položaj, če še ni vklopljen.

4. V Threshold vnesite največje zahtevano število vrstic. Najvišji nastavljiv prag je 100.000.

   Interno je ta številka zaokrožena v korakih glede na privzeto velikost strani. Na primer, če je ta velikost strani 5.000 in vnesete 7.000, je število vrnjenih vrstic 10.000.

Urejanje s Copilotom

1. Izberite kartico Seznam vrstic .

2. V podoknu na levi izberite Nastavitve zavihek >Omrežje.

3. Premaknite drsnik Pagination na On položaj, če še ni vklopljen.

4. V Threshold vnesite največje zahtevano število vrstic. Najvišji nastavljiv prag je 100.000.

   Interno je ta številka zaokrožena v korakih glede na privzeto velikost strani. Na primer, če je ta velikost strani 5.000 in vnesete 7.000, je število vrnjenih vrstic 10.000.

Dodatne možnosti

Dodatne možnosti za dejanje Vrstice seznama omogočajo razvrščanje, filtriranje, razporejanje in razširitev rezultatov poizvedbe.

Klasični oblikovalec

Dodatne možnosti lahko nastavite neposredno na kartici Vrstice seznama. Če si želite ogledati možnosti, izberite Pokaži dodatne možnosti. Ko ga izberete, se ime spremeni v Skrij dodatne možnosti.

Urejanje s Copilotom

Možnosti lahko nastavite v podoknu konfiguracije dejanja.

1. Če si želite ogledati možnosti, izberite kartico Vrstice seznama .

2. Na zavihku Parametri izberite napredno možnost v spustnem meniju Dodajanje novih parametrov .

   

Izbira stolpcev

Vnesite seznam stolpcev, ločenih z vejico, ki jih želite vrniti, na primer »ime,ustvarjeno,prednostna koda načina stika,e-poštni naslov1,telefon1« za tabelo »Račun«.

Filtriranje vrstic

Uporabite za določanje izraza filtra v slogu OData, da zožite nabor vrstic, ki Dataverse se vrnejo, na primer »createdon ge 2021-01-01T00:00:00-00:00« za vrstice z ustvarjenim, večjim ali enakim letu 2021.

Naučite se uporabljati standardne operatorje filtriranja in funkcije poizvedbe za ustvarjanje izrazov poizvedbe filtra.

Nekatere znake, kot so in# jih je treba zamenjati z ekvivalentom, + kodiranim z URL-jem. Več informacij: URL kodira posebne znake

Pomembno

Izrazi filtra ne smejo vsebovati tega niza,$filter= , ker velja le, če API-je uporabljate neposredno.

Razvrsti po

Uporablja se za določanje izraza v slogu OData, ki določa vrstni red, v katerem so elementi vrnjeni, na primer »desc imena«. S pripono asc ali desc označite naraščajoči oziroma padajoči vrstni red. Privzeti vrstni red narašča.

Razširitev poizvedbe

Uporabite za določanje izraza v slogu OData, ki določa podatke, ki Dataverse se vrnejo iz povezanih tabel, na primer primarycontactid($select=contactid,fullname) za uporabo primarnega kontakta računa za pridobivanje stolpca s polnim imenom iz povezanega stika z ID-jemstika v odgovoru.

V razširitvi poizvedbe lahko uporabitedve vrsti lastnosti krmarjenja:

1. Lastnosti krmarjenja z eno vrednostjo ustrezajo iskanju stolpcev, ki podpirajo Odnosi »veliko proti ena« in vam omogočajo, da nastavite sklic na drugo tabelo.

2. Navigacijske lastnosti z vrednostjo zbirke ustrezajo ena proti mnogo ali mnogo proti mnogo Odnosi.

Če vključite samo ime lastnosti navigacije, boste prejeli vse lastnosti za povezane vrstice. Če želite izvedeti več, glejte Pridobivanje povezanih vrstic tabele s poizvedbo.

Če ga želite uporabiti v koraku poteka, vnesite ta izraz Odata v polje Razširi poizvedbo : primarycontactid(contactid,fullname). Tako dobite stolpca contactid in polno ime za primarni kontaktid vsakega računa.

Število vrstic:

Uporabite za označevanje določenega števila vrstic, ki jih želite Dataverse vrniti. Tukaj je primer, ki prikazuje, kako zahtevate 10 vrstic.

Poizvedba v jeziku FetchXML

Poizvedbe za združevanje trenutno niso podprte , če uporabite dejanje Vrstice seznama s poizvedbami FetchXML. Vendar pa je podprt ločen operater.

Klasični oblikovalec

Uporabite poizvedbo Dataverse FetchXML v slogu a, ki omogoča večjo prilagodljivost pri ustvarjanju poizvedb po meri. Te poizvedbe so lahko uporabne, ko delate s tabelo, ki ima več sorodnih tabel, ali pri označevanju strani. Naslednji posnetek zaslona prikazuje, kako uporabljati FetchXML.

V polje Fetch Xml Query vnesite naslednje.

Ker ločeni operater trenutno ni podprt neposredno v poizvedbah FetchXML iz dejanja Seznam vrstic, je mogoče uporabiti funkcijo združevanja za odstranjevanje podvojenih vrstic. Uporabite lahko na primer dejanje Izberi za pretvorbo odziva povezave vrstic seznama v določeno obliko polja, ki jo potrebujete, nato ustvarite spremenljivko z izrazom union(body('Select'),body('Select')) da dobite matriko z različnimi vrsticami.

Urejanje s Copilotom

Uporabite poizvedbo Dataverse FetchXML v slogu a, ki omogoča večjo prilagodljivost pri ustvarjanju poizvedb po meri. Te poizvedbe so lahko uporabne, ko delate s tabelo, ki ima več sorodnih tabel, ali pri označevanju strani. Naslednji posnetek zaslona prikazuje, kako uporabljati FetchXML.

Primer poizvedbe FetchXML za tabelo računa:

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

Ker ločeni operater trenutno ni podprt neposredno v poizvedbah FetchXML iz dejanja Seznam vrstic, je mogoče uporabiti funkcijo združevanja za odstranjevanje podvojenih vrstic. Uporabite lahko na primer dejanje Izberi za pretvorbo odziva povezave vrstic seznama v določeno obliko polja, ki jo potrebujete, nato ustvarite spremenljivko z izrazom union(body('Select'),body('Select')) da dobite matriko z različnimi vrsticami.

Žeton za preskok

Ker Power Automate uporablja omejitve prepustnosti vsebine in omejitve velikosti sporočil za zagotovitev splošnih garancij storitev, pogosto je koristno uporabiti paginacijo za vrnitev manjšega števila vrstic v paketu namesto privzetih omejitev števila vrnjenih vrstic tabele.

Privzeta omejitev strani na 5.000 vrstic velja, če ne uporabljate paginacije.

Če ga želite uporabiti, implementirajte zanko za razčlenitev @odata.nextLink vrednosti v odgovoru JSON, ekstrahirajte skip token in nato pošiljajte še eno zahtevo, dokler ne navedete števila vrstic, ki jih potrebujete.

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

Možnost, da določite ID particije med pridobivanjem podatkov za tabele mehanizma NoSQL. Če želite izvedeti več, glejte Izboljšanje zmogljivosti z uporabo particij za shranjevanje pri dostopu do podatkov tabele.