Použití seznamů řádků v rámci toků

Použijte akci Seznam řádků pro načtení více řádků najednou z Microsoft Dataverse se strukturovaným dotazem.

Získat seznam řádků

Pomocí těchto kroků přidejte do svého toku akci Řádky seznamu, aby vrátila až 5 000 účtů z tabulky Účty v Dataverse.

Power Automate umožňuje použít buď nového návrháře, nebo klasického návrháře ke konfiguraci cloudového toku. Postup je v obou návrhářích podobný. Další informace (včetně příkladů) najdete v tématu Rozdíly mezi novým návrhářem a klasickým návrhářem.

Nový designer

1. Vyberte znaménko plus (+) >Přidat akci.
2. Na obrazovce Přidat akci zadejte řádky seznamudo vyhledávacího pole.
3. V části Microsoft Dataverse vyberte Zobrazit seznam řádků (Preview).
4. Na kartě Parametry vlevo vyberte v rozevírací nabídce Název tabulky možnost Účty.
5. Zavřete obrazovku výběrem (<<).

Klasický návrhář

1. Vyberte Nový krok pro přidání akce do vašeho toku.
2. Zadejte uvést seznam řádků do vyhledávacího pole Hledat konektory a akce na kartě Zvolte operaci.
3. Vyberte Microsoft Dataverse k filtrování výsledků hledání tak, aby zobrazovaly pouze akce a spouštěče pro Microsoft Dataverse.
4. Vyberte Seznam řádků.
5. Vyberte tabulku Účty ze seznamu Název tabulky.
6. Uložte a spusťte tok, abyste potvrdili, že se nevrátí více než 5 000 řádků.

Chcete-li požádat o více než 5 000 řádků, zapněte stránkování

Chcete-li z dotazu automaticky získat více než 5000 řádků, zapněte funkci Stránkování z Nastavení.

Když nastavíte stránkování a počet řádků překročí nakonfigurovanou prahovou hodnotu, odpověď neobsahuje @odata.nextLink parametr pro vyžádání další sady řádků. Vypněte stránkování tak, aby odpověď obsahovala @odata.nextLink parametr, který můžete použít k vyžádání další sady řádků. Přejděte na Přeskočit token, kde se dozvíte, jak ho používat.

Limity propustnosti obsahu a limity velikosti zprávy se používají k zajištění obecných záruk na služby.

Nový designer

1. Vyberte kartu Zobrazit seznam řádků.

2. V podokně vlevo vyberte kartu Nastavení>Sítě.

3. Pokud ještě není Stránkování zapnuté, přesuňte posuvník do polohy Zapnuto.

4. Do pole Práh zadejte maximální počet požadovaných řádků. Maximální konfigurovatelný práh je 100 000.

   Interně se tato hodnota zaokrouhluje na násobky výchozí velikosti stránky. Pokud je například velikost stránky 5 000 a zadáte 7 000, je počet vrácených řádků 10 000.

Klasický návrhář

1. V pravém horním rohu karty Řádky seznamu vyberte nabídku (...).

2. Vyberte Nastavení.

3. Pokud ještě není zapnutý, přesuňte posuvník Stránkování na pozici Zapnuto .

4. Do pole Práh zadejte maximální počet požadovaných řádků. Maximální konfigurovatelný práh je 100 000.

   Interně se toto číslo zaokrouhluje na násobky výchozí velikosti stránky. Pokud je například velikost stránky 5 000 a zadáte 7 000, je počet vrácených řádků 10 000.

Rozšířené možnosti

Rozšířené možnosti akce Řádky seznamu umožňují řadit, filtrovat, uspořádat a rozšířit výsledky dotazu.

Nový designer

Nastavte možnosti v podokně konfigurace akcí.

1. Chcete-li zobrazit možnosti, vyberte kartu Zobrazit seznam řádků.

2. Na kartě Parametry vyberte rozšířenou možnost v rozevírací nabídce Pokročilé parametry.

   

Klasický návrhář

Nastavte pokročilé možnosti přímo v kartě Vypsat řádky. Chcete-li zobrazit možnosti, vyberte Zobrazit pokročilé možnosti. Když ji vyberete, název se změní na Skrýt rozšířené možnosti.

Vrácení úplných metadat

Toto nastavení určuje, jestli se mají načíst všechny sloupce z tabulky, nebo jenom ty, které jsou nezbytné pro lepší výkon. Pokud ji nenastavíte, akce automaticky vrátí úplná metadata, pokud váš tok používá dynamický obsah nebo výrazy, které ho potřebují.

Vyberte sloupce

Zadejte čárkami oddělený seznam sloupců, které se mají vrátit, například name,createdon,preferredcontactmethodcode,emailaddress1,telephone1 pro tabulku Účet.

Filtrovat řádky

Pomocí tohoto pole definujte filtrační výraz ve stylu OData, abyste zúžili množinu řádků, které Dataverse vrátí, například createdon ge 2021-01-01T00:00:00-00:00 pro řádky, u nichž je createdon větší nebo rovno roku 2021.

Naučte se filtrovat řádky a vytvářet výrazy dotazu filtru .

Nahraďte určité znaky, například &, #a +, jejich ekvivalentem zakódovanými adresou URL. Další informace najdete v tématu Kódování speciálních znaků adresy URL.

Důležité

Výrazy filtru nemohou obsahovat tento řetězec: $filter=, protože platí pouze při přímém použití API.

Seřadit podle

Pomocí tohoto pole definujte výraz ve stylu OData, který definuje pořadí, ve kterém se položky vrátí, například name desc. Použijte příponu asc nebo desc k označení vzestupného nebo sestupného pořadí. Výchozí pořadí je vzestupné.

Rozbalit dotaz

Toto pole použijte k určení výrazu ve stylu OData, který definuje data, jež Dataverse vrátí ze souvisejících tabulek, například primarycontactid($select=contactid,fullname) pro použití hodnoty primarycontactid účtu k načtení sloupce fullname ze souvisejícího kontaktu s ID contactid v odpovědi.

Existují dva typy navigačních vlastností, které můžete použít v Rozbalit dotaz:

1. Vlastnosti navigace s jednou hodnotou odpovídají vyhledávacím sloupcům, které podporují vztahy N:1 a umožňují vám nastavit odkaz na jinou tabulku.

2. Kolekční navigační vlastnosti odpovídají vztahům jeden k mnoha nebo mnoho k mnoha.

Pokud zahrnete pouze název navigační vlastnosti, obdržíte všechny vlastnosti souvisejících řádků. Další informace najdete v článku Jak spojovat tabulky pomocí OData.

Pokud ho chcete použít v kroku toku, zadejte tento výraz OData do pole Rozbalit dotaz : primarycontactid(contactid,fullname). Takto získáte sloupce contactid a fullname pro primarycontactid u každého účtu.

Počet řádků

Pomocí nastavení Počet řádků určete počet řádků, které má funkce Dataverse vrátit.

Načtení dotazu XML

V současné době nemůžete použít agregační dotazy při použití akce Vypsat řádky s dotazy FetchXML. Můžete ale použít operátor distinct.

Nový designer

Použijte dotaz FetchXML ve stylu Dataverse, který nabízí větší flexibilitu při vytváření vlastních dotazů. Tyto dotazy můžou být užitečné při práci s tabulkou, která obsahuje více souvisejících tabulek nebo při zpracování stránkování. Následující obrázek ukazuje, jak používat FetchXML.

Důležité

Nastavení stránkování nepodporuje dotazy FetchXML. Pokud chcete požádat o více než 5 000 řádků, musíte stránkování spravovat přímo pomocí dotazu FetchXML .

Příklad dotazu FetchXML pro tabulku obchodních vztahů:

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

Operátor distinct se v současné době nepodporuje přímo v dotazech FetchXML z akce Řádky seznamu , ale funkci sjednocení můžete použít k odebrání duplicitních řádků. Pomocí akce Vybrat můžete například transformovat odpověď na připojení řádků seznamu ke konkrétnímu formátu pole, který potřebujete, a pak vytvořit proměnnou s výrazem union(body('Select'),body('Select')) pro získání pole s jedinečnými řádky.

Klasický návrhář

Použijte dotaz FetchXML ve stylu Dataverse, který nabízí větší flexibilitu při vytváření vlastních dotazů. Tyto dotazy můžou být užitečné při práci s tabulkou, která obsahuje více souvisejících tabulek nebo při zpracování stránkování. Následující obrázek ukazuje, jak používat FetchXML.

Do pole Fetch Xml Query zadejte následující text.

Vzhledem k tomu, že operátor distinct není aktuálně podporován přímo v dotazech FetchXML z akce Řádky seznamu, pomocí sjednocovacího operátoru odeberte duplicitní řádky. Pomocí akce Vybrat můžete například transformovat odpověď na připojení řádků seznamu do požadovaného konkrétního formátu pole a pak vytvořit proměnnou s výrazem union(body('Select'),body('Select')) pro získání pole s jedinečnými řádky.

Přeskakovací token

Power Automate platí omezení propustnosti obsahu a omezení velikosti zpráv, aby se zajistily obecné záruky služeb. Pokud chcete pracovat v rámci těchto limitů, použijte stránkování k vrácení menšího počtu řádků v dávce, nikoli výchozích limitů počtu vrácených řádků tabulky.

Pokud stránkování nepoužíváte, výchozí limit stránky je 5 000 řádků.

Pokud chcete použít stránkování, implementujte smyčku pro parsování \@odata.nextLink hodnoty v odpovědi JSON, extrahujte token skipu a pak odešlete další požadavek, dokud nevypíšete požadovaný počet řádků.

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 oddílu

partitionId Zadejte při načítání dat pro elastické tabulky. Další informace najdete v tématu Dělení a horizontální škálování elastických tabulek.

Související informace

• Školení: Používání triggerů Dataverse a akcí v Power Automate (modul)
• Školení: Integrace toků Power Automate a Dataverse (studijní program)