Lijsten met rijen gebruiken in stromen

Gebruik de actie Rijen vermelden om met een gestructureerde query meerdere rijen tegelijk op te halen uit Microsoft Dataverse.

Een lijst met rijen ophalen

Voer de volgende stappen uit om de actie Rijen weergeven toe te voegen aan uw stroom om maar liefst 5000 accounts te retourneren van de tabel Accounts in Dataverse.

Notitie

• Power Automate maakt gebruik van de klassieke cloudstroomontwerper of de nieuwe moderne ontwerper met Copilot-mogelijkheden. Om te bepalen welke ontwerper u gebruikt, gaat u naar het gedeelte Opmerking in De cloudstroomontwerper verkennen.
• Wanneer u schakelt tussen de klassieke en moderne ontwerper, wordt u gevraagd uw flow op te slaan. U kunt pas opslaan en overschakelen als alle fouten zijn opgelost.

Bewerken met copilot

1. Selecteer het plusteken (+) >Een actie toevoegen.
2. Voer in het scherm Een actie toevoegen de tekst rijen weergeven in het veld Zoeken in.
3. Onder Microsoft Dataverse selecteert u Rijen weergeven (preview).
4. Selecteer op het tabblad Parameters aan de linkerkant de optie Accounts in de vervolgkeuzelijst Tabelnaam.
5. Sluit het scherm door (<<) te selecteren.

Klassieke ontwerper

1. Selecteer Nieuwe stap om een actie aan uw stroom toe te voegen.
2. Voer in het zoekvak Connectors en acties doorzoeken op de kaart Een bewerking kiezen de tekst rijen weergeven in.
3. Selecteer Microsoft Dataverse om de zoekresultaten te filteren om alleen acties en triggers voor Microsoft Dataverse weer te geven.
4. Selecteer Rijen weergeven.
5. Selecteer de tabel Accounts in de lijst Tabelnaam.
6. Sla uw stroom op en voer deze uit om te bevestigen dat er niet meer dan 5000 rijen worden geretourneerd.

Paginering inschakelen om meer dan 5000 rijen aan te vragen

Als u automatisch meer dan 5000 rijen uit een query wilt halen, schakelt u de functie Paginering via Instellingen in.

Wanneer paginering is ingesteld en het aantal rijen dat aantal geconfigureerde drempelwaarden overschrijdt, bevat het antwoord niet de parameter @odata.nextLink om de volgende reeks rijen aan te vragen. Schakel paginering uit, zodat het antwoord de parameter @odata.nextLink bevat die kan worden gebruikt om de volgende set rijen aan te vragen. Ga naar Token overslaan voor meer informatie over het gebruik ervan.

Limieten voor de doorvoer van inhoud en limieten voor berichtgrootte worden toegepast om algemene servicegaranties te garanderen.

Bewerken met copilot

1. Selecteer de kaart Rijen weergeven.

2. Selecteer in het deelvenster aan de linkerkant het tabblad Instellingen en >Netwerken.

3. Verplaats de schuifregelaar Paginering naar de positie Aan als deze nog niet is ingeschakeld.

4. Voer in Drempelwaarde het maximale aantal aangevraagde rijen in. De maximaal configureerbare drempelwaarde is 100.000.

   Intern wordt dit aantal afgerond in verhogingen van het standaardpaginaformaat. Als dat paginaformaat bijvoorbeeld 5.000 is en u voert 7.000 in, dan is het aantal geretourneerde rijen 10.000.

Klassieke ontwerper

1. Selecteer het menu (...) in de rechterbovenhoek van de kaart Rijen weergeven.

2. Selecteer Instellingen.

3. Verplaats de schuifregelaar Paginering naar de positie Aan als deze nog niet is ingeschakeld.

4. Voer in Drempelwaarde het maximale aantal aangevraagde rijen in. De maximaal configureerbare drempelwaarde is 100.000.

   Intern wordt dit aantal afgerond in verhogingen van het standaardpaginaformaat. Als dat paginaformaat bijvoorbeeld 5.000 is en u voert 7.000 in, dan is het aantal geretourneerde rijen 10.000.

Geavanceerde opties

Met de geavanceerde opties voor de Lijst rijen actie kunt u de resultaten van een query sorteren, filteren, ordenen en uitbreiden.

Bewerken met copilot

U kunt opties instellen in het actieconfiguratievenster.

1. Selecteer de kaart Rijen weergeven om de beschikbare opties te zien.

2. Selecteer op het tabblad Parameters een geavanceerde optie in de vervolgkeuzelijst Nieuwe parameters toevoegen.

   

Klassieke ontwerper

U kunt geavanceerde opties rechtstreeks op de kaart Rijen weergeven instellen. Selecteer Geavanceerde opties weergeven om de opties te bekijken. Wanneer u dit selecteert, verandert de naam van de vervolgkeuzelijst in Geavanceerde opties verbergen.

Kolommen selecteren

Voer een door komma's gescheiden lijst met kolommen in die moeten worden geretourneerd, zoals "name,createdon,preferredcontactmethodcode,emailaddress1,telephone1" voor de tabel Account.

Rijen filteren

Gebruik dit om een filterexpressie in OData-stijl te definiëren om de reeks rijen te verfijnen die Dataverse retourneert, zoals "createdon ge 2021-01-01T00:00:00-00:00" voor rijen waarbij createdon groter dan of gelijk aan het jaar 2021 is.

Leer hoe u standaardfilteroperators en queryfuncties gebruikt om Filterquery-expressies te construeren.

Bepaalde tekens, zoals &, # en + moeten worden vervangen door hun URL-gecodeerde equivalent. Meer informatie: URL codeert speciale tekens

Belangrijk

Filterexpressies mogen deze tekenreeks, $filter=, niet bevatten omdat deze alleen van toepassing is als u de API's rechtstreeks gebruikt.

Sorteren op

Gebruik dit om een expressie in OData-stijl te definiëren die de volgorde definieert waarin items worden geretourneerd, zoals "name desc". Gebruik het achtervoegsel asc of desc om respectievelijk oplopende of aflopende volgorde aan te geven. De standaardvolgorde is oplopend.

Query uitbreiden

Gebruik dit om een expressie in OData-stijl op te geven die de gegevens definieert die Dataverse retourneert uit de gerelateerde tabellen, zoals primarycontactid($select=contactid,fullname), om de primarycontactid van het account te gebruiken om de kolom fullname van de gerelateerde contactpersoon met id contactid op te halen in de respons.

Er zijn twee soorten navigatie-eigenschappen die u kunt gebruiken Query uitvouwen:

1. Single-valued navigatie-eigenschappen komen overeen met opzoekkolommen die veel-op-één-relaties ondersteunen en waarmee u een verwijzing naar een andere tabel kunt instellen.

2. Navigatie-eigenschappen met een collectie komen overeen met een-op-veel of veel-op-veel relaties.

Als u alleen de naam van de navigatie-eigenschap opneemt, ontvangt u alle eigenschappen voor de gerelateerde rijen. Zie voor meer informatie Haal gerelateerde tabelrijen op met een query.

Om dit in een stroomstap te gebruiken, voert u deze Odata-expressie in het veld Query bewerken in: primarycontactid(contactid,fullname). Dit laat zien hoe u de kolommen contactid en fullname ophaalt voor de primarycontactid van elke account.

Aantal rijen

Gebruik om het specifieke aantal rijen aan te geven dat door Dataverse moet worden geretourneerd. Hier is een voorbeeld dat laat zien hoe u 10 rijen kunt aanvragen.

XML-query ophalen

Aggregatiequery's worden momenteel niet ondersteund bij gebruik van de actie Rijen weergeven met FetchXML-query's. De operator distinct wordt echter wel ondersteund.

Bewerken met copilot

Gebruik een Dataverse-stijl FetchXML-query, waarmee meer flexibiliteit wordt geboden bij het bouwen van aangepaste query's. Deze query's kunnen handig zijn wanneer u werkt met een tabel die meerdere gerelateerde tabellen heeft, of wanneer u paginering afhandelt. In de volgende schermopname wordt weergegeven hoe u FetchXML gebruikt.

Voorbeeld van FetchXML-query voor de tabel Account:

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

Aangezien de operator distinct momenteel niet rechtstreeks wordt ondersteund in FetchXML-query's van de actie Lijst weergeven, kan de functie union worden gebruikt om dubbele rijen te verwijderen. U kunt bijvoorbeeld de actie Selecteren gebruiken om de respons van de verbinding Lijstrijen te transformeren naar de specifieke matrixindeling die u nodig hebt en vervolgens een variabele maken met de uitdrukking union(body('Select'),body('Select')) om een matrix met verschillende rijen te krijgen.

Klassieke ontwerper

Gebruik een Dataverse-stijl FetchXML-query, waarmee meer flexibiliteit wordt geboden bij het bouwen van aangepaste query's. Deze query's kunnen handig zijn wanneer u werkt met een tabel die meerdere gerelateerde tabellen heeft, of wanneer u paginering afhandelt. In de volgende schermopname wordt weergegeven hoe u FetchXML gebruikt.

Typ het volgende in het veld XML-query ophalen.

Aangezien de operator distinct momenteel niet rechtstreeks wordt ondersteund in FetchXML-query's van de actie Lijst weergeven, kan de functie union worden gebruikt om dubbele rijen te verwijderen. U kunt bijvoorbeeld de actie Selecteren gebruiken om de respons van de verbinding Lijstrijen te transformeren naar de specifieke matrixindeling die u nodig hebt en vervolgens een variabele maken met de uitdrukking union(body('Select'),body('Select')) om een matrix met verschillende rijen te krijgen.

Skip-token

Omdat Power Automate doorvoerlimieten voor inhoud en limieten voor berichtgrootte toepast om algemene servicegaranties te bieden, is het vaak handig om paginering te gebruiken om een kleiner aantal rijen in een batch te retourneren in plaats van de standaard limieten voor het aantal geretourneerde tabelrijen.

De standaardpaginalimiet van 5.000 rijen is van toepassing als u geen paginering gebruikt.

Om het te gebruiken, implementeert u een lus om de waarde @odata.nextLink in de JSON-respons te parseren, extraheert u het skip token en verzendt u vervolgens nog een verzoek totdat u het aantal rijen hebt weergegeven dat u nodig hebt.

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

Partitie-id

Een optie om de partitie-id op te geven tijdens het ophalen van gegevens voor NoSQL-tabellen. Zie voor meer informatie De prestaties met behulp van opslagpartities verbeteren bij het openen van tabelgegevens.

Gerelateerde informatie

• Training: Gebruik Dataverse triggers en acties in Power Automate (module)
• Training: Power Automate- en Dataverse-stromen integreren (leertraject)