Použitie zoznamov riadkov v postupoch

Akcia Zobraziť riadky načíta viacero riadkov naraz zo Microsoft Dataverse pomocou štruktúrovaného dopytu.

Získajte zoznam riadkov

Ak chcete do postupu pridať akciu Zobraziť riadky a vrátiť až 5 000 účtov z tabuľky Účty v Dataverse, postupujte podľa týchto krokov.

Power Automate umožňuje vám použiť buď nový návrhár alebo klasický návrhár na konfiguráciu cloudového toku. Kroky sú v oboch dizajnéroch podobné. Viac informácií (s príkladmi) nájdete v časti *Identifikácia rozdielov medzi novým a klasickým návrhárom*. ...

Nový dizajnér

1. Vyberte znamienko plus (+) >Pridať akciu.
2. Na obrazovke Pridať akciu zadajte riadky zoznamu do poľa Hľadať .
3. V časti Microsoft Dataverse vyberte možnosť Zoznam riadkov (Ukážka).
4. Na karte Parametre vľavo vyberte v rozbaľovacej ponuke Názov tabuľky možnosť Účty .
5. Obrazovku zatvoríte výberom položky (<<).

Klasický dizajnér

1. Vyberte možnosť Nový krok a pridajte akciu do svojho postupu.
2. Zadajte riadky zoznamu do vyhľadávacieho poľa Hľadať konektory a akcie na karte Vybrať operáciu .
3. Vyberte Microsoft Dataverse , ak chcete filtrovať výsledky vyhľadávania tak, aby sa zobrazovali iba akcie a spúšťače pre Microsoft Dataverse.
4. Vyberte Zoznam riadkov.
5. Vyberte tabuľku Účty zo zoznamu Názov tabuľky .
6. Uložte a spustite postup, aby ste potvrdili, že sa nevráti viac ako 5000 riadkov.

Zapnite stránkovanie a požiadajte o viac ako 5000 riadkov

Ak chcete z dotazu automaticky získať viac ako 5 000 riadkov, zapnite funkciu Stránkovanie v časti Nastavenia.

Keď je nastavené stránkovanie a počet riadkov prekročí nakonfigurovaný prah, odpoveď nebude obsahovať parameter @odata.nextLink na vyžiadanie ďalšej sady riadkov. Vypnite stránkovanie, aby odpoveď obsahovala parameter @odata.nextLink , ktorý možno použiť na vyžiadanie ďalšej sady riadkov. Prečítajte si, ako ho používať, v časti Preskočiť token .

Na zabezpečenie všeobecných záruk služby sa uplatňujú limity priepustnosti obsahu a limity veľkosti správ .

Nový dizajnér

1. Vyberte kartu Zoznam riadkov .

2. Na table vľavo vyberte kartu Nastavenia Siete >.

3. Ak ešte nie je zapnutý, presuňte posúvač Stránkovanie do polohy Zapnuté.

4. V poli Prahová hodnota zadajte maximálny požadovaný počet riadkov. Maximálna konfigurovateľná prahová hodnota je 100 000.

   Interne je toto číslo zaokrúhlené v prírastkoch predvolenej veľkosti stránky. Ak je táto veľkosť stránky napríklad 5000 a zadáte 7000, počet vrátených riadkov je 10 000.

Klasický dizajnér

1. V pravom hornom rohu karty Riadky zoznamu vyberte ponuku (...).

2. Vyberte Nastavenia.

3. Ak ešte nie je zapnutý, presuňte posúvač Stránkovanie do polohy Zapnuté.

4. V poli Prahová hodnota zadajte maximálny požadovaný počet riadkov. Maximálna konfigurovateľná prahová hodnota je 100 000.

   Interne je toto číslo zaokrúhlené v prírastkoch predvolenej veľkosti stránky. Ak je táto veľkosť stránky napríklad 5000 a zadáte 7000, počet vrátených riadkov je 10 000.

Rozšírené možnosti

Rozšírené možnosti pre akciu Zobraziť riadky umožňujú triediť, filtrovať, usporiadať a rozširovať výsledky dotazu.

Nový dizajnér

Možnosti môžete nastaviť v table konfigurácie akcie.

1. Ak chcete zobraziť možnosti, vyberte kartu Zoznam riadkov .

2. Na karte Parametre vyberte rozšírenú možnosť v rozbaľovacej ponuke Pridať nové parametre .

   

Klasický dizajnér

Rozšírené možnosti môžete nastaviť priamo na karte Riadky zoznamu . Ak chcete zobraziť možnosti, vyberte možnosť Zobraziť rozšírené možnosti. Keď ho vyberiete, názov sa zmení na Skryť rozšírené možnosti.

Vybrať stĺpce

Zadajte zoznam stĺpcov, ktoré chcete vrátiť, oddelené čiarkami, napríklad "name,createdon,preferredcontactmethodcode,emailaddress1,telephone1" pre tabuľku Obchodný vzťah.

Filtrovanie riadkov

Používa sa na definovanie výrazu filtra v štýle OData na zúženie množiny riadkov, ktoré sa vrátia, napríklad „createdon ge 2021-01-01T00:00:00-00:00“ pre riadky s hodnotou Dataverse createdon väčšou alebo rovnou roku 2021.

Naučte sa, ako používať štandardné operátory filtrovania a funkcie dotazov na vytváranie výrazov filtrovania dotazov. ......

Niektoré znaky, ako napríklad &, # a + , je potrebné nahradiť ich ekvivalentom kódovaným v URL. Viac informácií: Špeciálne znaky kódovania URL

Dôležité

Výrazy filtrov nemôžu obsahovať tento reťazec $filter=, pretože sa uplatňuje iba pri priamom použití rozhraní API.

Sort by

Používa sa na definovanie výrazu v štýle OData, ktorý definuje poradie, v akom sa položky vracajú, ako napríklad „názov zostupne“. Na označenie vzostupného alebo zostupného poradia použite príponu asc alebo desc . Predvolené poradie je vzostupné.

Dotaz slúžiaci na rozbalenie

Používa sa na zadanie výrazu v štýle OData, ktorý definuje údaje, ktoré sa vracajú zo súvisiacich tabuliek, napríklad na použitie primárneho kontaktného ID účtu (primarycontactid) na načítanie stĺpca fullname (fullname) zo súvisiaceho kontaktu s ID contactid (contactid) v odpovedi. Dataverse primarycontactid($select=contactid,fullname)

V Rozbaliť dotaz môžete použiť dva typy navigačných vlastností:

1. Jednohodnotové navigačné vlastnosti zodpovedajú vyhľadávacím stĺpcom, ktoré podporujú vzťahy typu „mnohé k jednému“ a umožňujú vám nastaviť odkaz na inú tabuľku.

2. Vlastnosti navigácie s hodnotou kolekcie zodpovedajú vzťahom typu jeden k mnohým alebo mnoho k mnohým.

Ak uvediete iba názov vlastnosti navigácie, získate všetky vlastnosti pre súvisiace riadky. Viac informácií nájdete v časti Načítanie súvisiacich riadkov tabuľky pomocou dotazu.

Ak ho chcete použiť v kroku postupu, zadajte tento výraz Odata do poľa Rozbaliť dotaz : primarycontactid(contactid,fullname). Takto získate stĺpce contactid a fullname pre primarycontactid každého účtu.

Počet riadkov

Použite na označenie konkrétneho počtu riadkov, ktoré má vrátiť Dataverse. Tu je príklad, ktorý ukazuje, ako požiadať o 10 riadkov.

Načítanie dotazu Xml

Agregačné dotazy nie sú momentálne podporované pri použití akcie Zobraziť riadky s dotazmi FetchXML . Operátor distinctu je však podporovaný.

Nový dizajnér

Použite dotaz v štýle Dataverse- FetchXML dotaz, ktorý umožňuje väčšiu flexibilitu pri vytváraní vlastných dotazov. Tieto dotazy môžu byť užitočné pri práci s tabuľkou, ktorá má viacero súvisiacich tabuliek, alebo pri spracovaní stránkovania. Nasledujúca snímka obrazovky ukazuje, ako sa používa FetchXML.

Príklad dotazu pre tabuľku Účet: 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>

Keďže operátor distinctu momentálne nie je priamo podporovaný v dotazoch z akcie Zoznam riadkov, na odstránenie duplicitných riadkov je možné použiť funkciu zjednotenia. FetchXML FetchXML Napríklad môžete použiť akciu Select na transformáciu odpovede pripojenia List riadkov na požadovaný formát poľa a potom vytvoriť premennú s výrazom union(body('Select'),body('Select')) na získanie poľa s odlišnými riadkami.

Klasický dizajnér

Použite dotaz v štýle Dataverse- FetchXML dotaz, ktorý umožňuje väčšiu flexibilitu pri vytváraní vlastných dotazov. Tieto dotazy môžu byť užitočné pri práci s tabuľkou, ktorá má viacero súvisiacich tabuliek, alebo pri spracovaní stránkovania. Nasledujúca snímka obrazovky ukazuje, ako sa používa FetchXML.

Do poľa Dotaz na načítanie XML zadajte nasledujúci text.

Keďže operátor distinctu momentálne nie je priamo podporovaný v dotazoch z akcie Zoznam riadkov, na odstránenie duplicitných riadkov je možné použiť funkciu zjednotenia. FetchXML Napríklad môžete použiť akciu Select na transformáciu odpovede pripojenia List riadkov na požadovaný formát poľa a potom vytvoriť premennú s výrazom union(body('Select'),body('Select')) na získanie poľa s odlišnými riadkami.

Vynechať token

Keďže Power Automate platia limity priepustnosti obsahu a limity veľkosti správ na zabezpečenie všeobecných záruk služieb, je často užitočné použiť stránkovanie na vrátenie menšieho počtu riadkov v dávke, a nie predvolené limity počtu vrátených riadkov tabuľky.

Ak nepoužívate stránkovanie, platí predvolený limit strán 5 000 riadkov.

Ak ho chcete použiť, implementujte slučku na analýzu hodnoty @odata.nextLink v odpovedi JSON, extrahujte token preskočenia a potom odošlite ďalšiu požiadavku, kým neuvediete požadovaný počet riadkov.

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 oblasti

Možnosť zadať partitionId pri načítavaní údajov pre tabuľky NoSQL. Viac informácií nájdete v časti Zlepšenie výkonu pomocou úložných oddielov pri prístupe k údajom tabuľky.

Súvisiace informácie

• Školenie: Používajte spúšťače a akcie v module Dataverse (modul) Power Automate
• Školenie: Integrácia postupov a (vzdelávacej cesty) Power Automate Dataverse