Použití seznamů řádků v tocích

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

Načíst seznam všech řádků

Podle těchto pokynů přidejte akci Řádky seznamu do toku k návratu až 5 000 obchodních vztahů z tabulky Obchodní vztahy v Dataverse.

Poznámka:

Power Automate používá buď klasického návrháře cloudových toků, nebo návrháře cloudových toků s funkcí Copilot. Chcete-li zjistit, kterého návrháře používáte, přejděte do části Poznámka v tématu Principy návrháře cloudových toků s funkcemi kopilota.

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

Upravit pomocí Kopilota

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

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ž je nastaveno stránkování a počet řádků překročí počet nakonfigurovaných prahových hodnot, odpověď nebude obsahovat parametr @odata.nextLink pro vyžádání další sady řádků. Stránkování vypněte, aby odpověď zahrnovala parametr @odata.nextLink, který lze 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.

Klasický návrhář

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

2. Vyberte Nastavení.

3. Přesuňte jezdec Stránkování do polohy Zapnuto, pokud ještě není zapnutý.

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

   Interně je toto číslo zaokrouhleno v přírůstcích 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.

Upravit pomocí Kopilota

1. Vyberte kartu Zobrazit seznam řádků.

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

3. Přesuňte jezdec Stránkování do polohy Zapnuto, pokud ještě není zapnutý.

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

   Interně je toto číslo zaokrouhleno v přírůstcích 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 pro akci Seznam řádků umožňuje třídit, filtrovat, uspořádat a rozšířit výsledky dotazu.

Klasický návrhář

Pokročilé možnosti můžete nastavit přímo na kartě Zobrazit seznam řádků. 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.

Upravit pomocí Kopilota

Možnosti můžete nastavit v podokně konfigurace akce.

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

2. Na kartě Parametry vyberte pokročilou možnost v rozevírací nabídce Přidat nové parametry.

   

Vyberte sloupce

Zadejte seznam sloupců, které chcete vracet, oddělený čárkami, například „name,createdon,preferredcontactmethodcode,emailaddress1,telephone1“ pro tabulku Účet.

Řádky filtru

Použijte k definování výrazu filtru ve stylu OData k zúžení sady řádků, které Dataverse vrací, například „reatedon ge 2021-01-01T00:00:00-00:00“ pro řádky s createdon větším nebo rovným roku 2021.

Naučte se používat standardní operátori filtrů a dotazovací funkce, chcete-li vytvářet výrazy Dotazy filtru.

Některé znaky jako &, # a + je třeba nahradit jejich ekvivalentem zakódovaným v adrese URL. Další informace: Speciální znaky kódování 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

Slouží k definování výrazu ve stylu OData, který definuje pořadí, ve kterém jsou položky vráceny, 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

Použijte k určení výrazu ve stylu OData, který definuje data, která Dataverse vrací ze souvisejících tabulek, jako například primarycontactid($select=contactid,fullname), abyste mohli použít primarycontactid účtu k načtení sloupce fullname sloupec 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. Vlastnosti navigace s hodnotou kolekce odpovídají vztahům 1:N nebo N:N.

Pokud uvedete pouze název navigační vlastnosti, obdržíte všechny vlastnosti pro související řádky. Chcete-li se dozvědět více, podívejte se na Načíst související řádky tabulky pomocí dotazu.

Pro použití v kroku toku zadejte výraz Odata do pole Rozšířit dotaz: primarycontactid(contactid,fullname). Tak, získáte sloupce contactid a fullname pro primarycontactid každého účtu.

Počet řádků

Použijte k označení konkrétního počtu řádků, které má Dataverse vrátit. Zde je příklad, který ukazuje, jak požádat o 10 řádků.

Načtení dotazu XML

Agregační dotazy se v současné době nepodporují při použití akce Vypsat řádky s dotazy FetchXML. Je však podporován jenom zvláštní operátor.

Klasický návrhář

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

Zadejte následující údaje do pole Načíst dotaz XML.

Vzhledem k tomu, že odlišný operátor není aktuálně podporován přímo v dotazech FetchXML z akce Vypsat řádky, funkci sjednocení lze použít k odstranění duplicitních řádků. Můžete například použít akci Vybrat pro transformaci odpovědi připojení Vypsat řádky na konkrétní formát pole, který potřebujete, a pak vytvořit proměnnou s výrazem union(body('Vybrat'),body('Vybrat')) pro získání pole s odlišenými řádky.

Upravit pomocí Kopilota

Použijte dotaz FetchXML ve stylu Dataverse, který umožňuje větší flexibilitu při vytváření vlastních dotazů. Tyto dotazy mohou být užitečné při práci s tabulkou, která má více souvisejících tabulek, nebo při práci se stránkováním. Následující obrázek ukazuje, jak používat 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>

Vzhledem k tomu, že odlišný operátor není aktuálně podporován přímo v dotazech FetchXML z akce Vypsat řádky, funkci sjednocení lze použít k odstranění duplicitních řádků. Můžete například použít akci Vybrat pro transformaci odpovědi připojení Vypsat řádky na konkrétní formát pole, který potřebujete, a pak vytvořit proměnnou s výrazem union(body('Vybrat'),body('Vybrat')) pro získání pole s odlišenými řádky.

Vynechávaný token

Protože Power Automate používá limity propustnosti obsahu a omezení velikosti zprávy k zajištění všeobecných záruk služeb, je často užitečné použít stránkování pro vrácení menšího počtu řádků v dávce namísto výchozích limitů počtu vrácených řádků tabulek.

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

Chcete-li jej použít, implementujte smyčku pro analýzu hodnoty @odata.nextLink v odpovědi JSON, extrahujte údaj vynechávaný token a poté odešlete další požadavek, dokud neuvedete počet řádků, které potřebujete.

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

Možnost zadat partitionId (ID oddílu) při načítání dat pro tabulky NoSQL. Chcete-li se dozvědět více, podívejte se na téma Vylepšení výkonu pomocí oddílů úložiště při přístupu k datům tabulky .

Související informace

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