Uporaba seznamov vrstic v tokovih

Z dejanjem Seznam vrstic pridobite več vrstic hkrati iz Microsoft Dataverse s strukturirano poizvedbo.

Pridobi seznam vrstic

Sledite tem korakom, da v svoj potek dodate dejanje Seznam vrstic , ki bo vrnilo do 5000 računov iz tabele Računi v Dataverse.

Power Automate omogoča uporabo novega oblikovalnika ali klasičnega oblikovalnika za konfiguriranje pretoka v oblaku. ... Koraki so v obeh oblikovalcih podobni. Več o tem (s primeri) v poglavju Prepoznavanje razlik med novim in klasičnim oblikovalnikom .

Nov oblikovalec

1. Izberite znak plus (+) >Dodaj dejanje.
2. Na zaslonu Dodaj dejanje v polje Iskanje vnesite seznam vrstic .
3. V razdelku Microsoft Dataverse izberite Seznam vrstic (predogled).
4. Na zavihku Parametri na levi strani v spustnem meniju Ime tabele izberite Računi .
5. Zaslon zaprite tako, da izberete (<<).

Klasični oblikovalec

1. Izberite Nov korak , da dodate dejanje v potek.
2. V iskalno polje Iskanje povezovalnikov in dejanj na kartici Izberi operacijo vnesite seznam vrstic .
3. Izberite Microsoft Dataverse , da filtrirate rezultate iskanja tako, da prikažejo samo dejanja in sprožilce za Microsoft Dataverse.
4. Izberite Seznam vrstic.
5. Izberite tabelo Računi na seznamu Ime tabele .
6. Shranite in zaženite potek, da potrdite, da ni vrnjenih več kot 5000 vrstic.

Vklopite oštevilčenje strani, če želite zahtevati več kot 5000 vrstic

Če želite iz poizvedbe samodejno pridobiti več kot 5000 vrstic, vklopite funkcijo Oštevilčenje v nastavitvah .

Ko je nastavljeno oštevilčenje strani in število vrstic presega konfigurirani prag, odgovor ne bo vključeval parametra @odata.nextLink za zahtevo naslednjega niza vrstic. Izklopite oštevilčenje strani, tako da bo odgovor vključeval parameter @odata.nextLink , ki ga je mogoče uporabiti za zahtevo naslednjega niza vrstic. Za več informacij o uporabi žetona pojdite na Preskoči žeton .

Za zagotavljanje splošnih jamstev za storitev veljajo omejitve pretoka vsebine in omejitve velikosti sporočil .

Nov oblikovalec

1. Izberite kartico Vrstice seznama .

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

3. Premaknite drsnik Oštevilčenje strani v položaj Vklopljeno , če še ni vklopljeno.

4. V polje *Threshold* vnesite največje število zahtevanih vrstic. Najvišji nastavljivi prag je 100.000.

   Ta številka se interno zaokroži v korakih po privzeti velikosti strani. Na primer, če je velikost strani 5000 in vnesete 7000, je število vrnjenih vrstic 10.000.

Klasični oblikovalec

1. V zgornjem desnem kotu kartice Vrstice seznama izberite meni (...).

2. Izberite Nastavitve.

3. Premaknite drsnik Oštevilčenje strani v položaj Vklopljeno , če še ni vklopljeno.

4. V polje *Threshold* vnesite največje število zahtevanih vrstic. Najvišji nastavljivi prag je 100.000.

   Ta številka se interno zaokroži v korakih po privzeti velikosti strani. Na primer, če je velikost strani 5000 in vnesete 7000, je število vrnjenih vrstic 10.000.

Dodatne možnosti

Napredne možnosti za dejanje Seznam vrstic vam omogočajo razvrščanje, filtriranje, urejanje in razširjanje rezultatov poizvedbe.

Nov oblikovalec

Možnosti lahko nastavite v podoknu za konfiguracijo dejanj.

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

2. Na zavihku Parametri v spustnem meniju Dodaj nove parametre izberite napredno možnost.

   

Klasični oblikovalec

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

Izbira stolpcev

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

Filtriranje vrstic

Uporabite za definiranje izraza filtra v slogu OData za zožitev nabora vrstic, ki se vrnejo, na primer »createdon ge 2021-01-01T00:00:00-00:00« za vrstice z vrednostjo Dataverse createdon večjo ali enako letu 2021.

Naučite se uporabljati standardne operatorje filtrov in funkcije poizvedb za izdelavo izrazov za filtriranje poizvedb .

Določene znake, kot so &, # in + , je treba zamenjati z njihovimi ustrezniki, kodiranimi v URL-jih. Več informacij: URL kodiranje posebnih znakov

Pomembno

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

Razvrsti po

Uporablja se za definiranje izraza v slogu OData, ki določa vrstni red vračanja elementov, na primer »name desc«. Za označevanje naraščajočega oziroma padajočega vrstnega reda uporabite pripono asc ali desc . Privzeti vrstni red je naraščajoč.

Razširi poizvedbo

Uporabite za določitev izraza v slogu OData, ki definira podatke, ki se vrnejo iz povezanih tabel, na primer za uporabo primarycontactid računa za pridobitev stolpca fullname iz povezanega stika z ID-jem contactid. Dataverse primarycontactid($select=contactid,fullname)

V Razširi poizvedbo lahko uporabite dve vrsti navigacijskih lastnosti:

1. Enovrednostne navigacijske lastnosti ustrezajo iskalnim stolpcem, ki podpirajo relacije »mnogo proti ena« in omogočajo nastavitev sklicevanja na drugo tabelo.

2. Lastnosti navigacije z vrednostmi zbirke ustrezajo odnosom ena proti mnogo ali mnogo proti mnogo.

Če vključite samo ime navigacijske lastnosti, 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, v polje Razširi poizvedbo vnesite ta izraz Odata: primarycontactid(contactid,fullname). Takole dobite stolpca contactid in fullname za primarycontactid vsakega računa.

Število vrstic:

Uporabite za označevanje določenega števila vrstic, ki jih naj se vrne. Dataverse Tukaj je primer, ki prikazuje, kako zahtevati 10 vrstic.

Poizvedba v jeziku FetchXML

Združevalne poizvedbe trenutno niso podprte pri uporabi dejanja Seznam vrstic s FetchXML poizvedbami. Vendar pa je operator »distinct« podprt.

Nov oblikovalec

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

Primer poizvedbe za tabelo Račun: FetchXML

<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 operator »distinct« trenutno ni neposredno podprt v poizvedbah FetchXML iz dejanja »Seznam vrstic«, se lahko funkcija »Union« uporabi za odstranjevanje podvojenih vrstic. Na primer, lahko uporabite dejanje Select za pretvorbo odgovora povezave List rows v določeno obliko polja, ki jo potrebujete, nato pa ustvarite spremenljivko z izrazom union(body('Select'),body('Select')) , da dobite polje z različnimi vrsticami.

Klasični oblikovalec

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

V polje Poizvedba za pridobivanje XML vnesite naslednje.

Ker operator »distinct« trenutno ni neposredno podprt v poizvedbah FetchXML iz dejanja »Seznam vrstic«, se lahko funkcija »Union« uporabi za odstranjevanje podvojenih vrstic. Na primer, lahko uporabite dejanje Select za pretvorbo odgovora povezave List rows v določeno obliko polja, ki jo potrebujete, nato pa ustvarite spremenljivko z izrazom union(body('Select'),body('Select')) , da dobite polje z različnimi vrsticami.

Žeton za preskok

Ker Power Automate velja omejitve pretoka vsebine in omejitve velikosti sporočil za zagotavljanje splošnih jamstev za storitev, je pogosto koristno uporabiti ostranjevanje za vrnitev manjšega števila vrstic v paketu namesto privzetih omejitev števila vrnjenih vrstic tabele.

Če ne uporabljate oštevilčenja strani, velja privzeta omejitev strani 5000 vrstic.

Če ga želite uporabiti, implementirajte zanko za razčlenjevanje vrednosti @odata.nextLink v odgovoru JSON, izvlecite žeton za preskok in nato pošljite drugo zahtevo, dokler ne navedete potrebnega števila vrstic.

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.

Sorodne informacije

• Usposabljanje: Uporaba sprožilcev in dejanj v modulu Dataverse Power Automate
• Usposabljanje: Integracija pretokov in (učne poti) Power Automate Dataverse