Lijsten met rijen gebruiken in werkstromen

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 tot wel 5000 accounts te retourneren uit de tabel Accounts in Dataverse.

Met Power Automate kunt u de nieuwe ontwerper of de klassieke ontwerper gebruiken voor het configureren van uw cloudstroom. De stappen zijn bij beide ontwerpers vergelijkbaar. Meer informatie (met voorbeelden) vindt u in Verschillen tussen de nieuwe ontwerper en de klassieke ontwerper identificeren.

  1. Selecteer het plusteken (+) >Een actie toevoegen.
  2. Voer op het scherm Een actie toevoegenlijst met rijen 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.

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 u paginering instelt en het aantal rijen de drempelwaarde overschrijdt die u configureert, bevat het antwoord niet de @odata.nextLink parameter om de volgende set rijen aan te vragen. Schakel paginering uit zodat het antwoord de @odata.nextLink parameter bevat die u kunt gebruiken om de volgende set rijen aan te vragen. Ga naar Skip token om te leren hoe u het gebruikt.

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

  1. Selecteer de kaart Rijen weergeven.

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

  3. Zet de schakelaar Paginering op Aan als die nog niet is ingeschakeld.

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

    Intern wordt dit getal afgerond in stappen van de standaard paginagrootte. 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 actie Lijstrijen kunt u de resultaten van een query sorteren, filteren, rangschikken en uitbreiden.

Stel opties in het deelvenster actieconfiguratie in.

  1. Om de opties te zien, selecteert u de kaart Rijen weergeven.

  2. Selecteer op het tabblad Parameters een geavanceerde optie in het vervolgkeuzemenu Geavanceerde parameters .

    Schermafbeelding van geavanceerde opties voor de actie Lijst met rijen weergeven in het actievenster Configuratie.

Volledige metagegevens retourneren

Met deze instelling bepaalt u of alle kolommen uit de tabel moeten worden geladen of alleen de essentiële kolommen voor betere prestaties. Als u deze niet instelt, retourneert de actie automatisch volledige metagegevens als uw stroom dynamische inhoud of expressies gebruikt die deze nodig hebben.

Kolommen selecteren

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

Rijen filteren

Gebruik dit veld om een filterexpressie in OData-stijl te definiëren om de set records te beperken die Dataverse retourneert, zoals createdon ge 2021-01-01T00:00:00-00:00 voor records waarbij createdon groter dan of gelijk aan 2021 is.

Informatie over het filteren van rijen om filterquery-expressies te maken.

Vervang bepaalde tekens, zoals &, #en +, door hun DOOR URL gecodeerde equivalent. Zie URL-codering voor speciale tekens voor meer informatie.

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 veld om een OData-stijlexpressie te definiëren waarmee de volgorde wordt gedefinieerd 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 veld om een OData-stijlexpressie op te geven die de gegevens definieert die Dataverse uit de gerelateerde tabellen retourneert, zoals primarycontactid($select=contactid,fullname) om de primarycontactid van het account te gebruiken om de kolom fullname op te halen van de gerelateerde contactpersoon met ID contactid in de respons.

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

  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 van het type verzameling komen voor bij een-op-veel- of veel-op-veelrelaties.

Als u alleen de naam van de navigatie-eigenschap opneemt, ontvangt u alle eigenschappen voor de gerelateerde rijen. Meer informatie over tabellen samenvoegen met OData.

Als u deze wilt gebruiken in een stroomstap, voert u deze OData-expressie in het veld Query uitvouwen in: primarycontactid(contactid,fullname). Dit laat zien hoe u de kolommen contactid en fullname ophaalt voor de primarycontactid van elke account.

Aantal rijen

Gebruik de instelling Aantal rijen om op te geven hoeveel rijen Dataverse moet retourneren.

XML-query ophalen

Op dit moment kunt u geen aggregatiequery's gebruiken bij het gebruik van de actie Lijstrijen met FetchXML-query's. U kunt de distinct operator echter gebruiken.

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

Belangrijk

De pagineringsinstelling biedt geen ondersteuning voor FetchXML-query's. Als u meer dan 5000 rijen wilt aanvragen, moet u paginering rechtstreeks beheren met de FetchXML-query .

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>

De distinct operator wordt momenteel niet rechtstreeks ondersteund in FetchXML-query's uit de actie Lijstrijen , maar u kunt de samenvoegfunctie gebruiken om dubbele rijen te verwijderen. U kunt bijvoorbeeld de actie Selecteren gebruiken om het antwoord van de verbinding met de lijstrijen te transformeren naar de specifieke matrixindeling die u nodig hebt. Vervolgens maakt u een variabele met de expressie union(body('Select'),body('Select')) om een matrix met afzonderlijke rijen op te halen.

Skip-token

Power Automate past doorvoerlimieten en berichtgroottelimieten toe om algemene servicegaranties te garanderen. Als u binnen deze limieten wilt werken, gebruikt u paginering om een kleiner aantal rijen in een batch te retourneren in plaats van de standaardlimieten voor het aantal geretourneerde tabelrijen.

Als u geen paginering gebruikt, is de standaardpaginalimiet 5000 rijen.

Als u paginering wilt gebruiken, implementeert u een lus om de \@odata.nextLink waarde in het JSON-antwoord te parseren, extraheert u het skip-token en verzendt u vervolgens een andere aanvraag totdat u het aantal rijen weergeeft 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

Geef de partitionId op bij het ophalen van gegevens voor elastische tabellen. Zie Partitionering en horizontaal schalen voor elastische tabellen voor meer informatie.

  • Laatst bijgewerkt om