Använd listor med rader i flöden

Använd åtgärden Listrader om du vill hämta flera rader samtidigt från Microsoft Dataverse med en strukturerad fråga.

Hämta en lista med rader

Följ stegen nedan om du vill lägga till åtgärden Radlistor i ditt flöde för att returnera upp till 5 000 konton från tabellen Konton i Dataverse.

Power Automate kan du använda antingen ny designer eller klassisk designer för att konfigurera ditt molnflöde. Stegen är likartade i båda designerna. Läs mer (med exempel) i artikeln Identifiera skillnader mellan den nya redigeraren och den klassiska redigeraren.

  1. Välj plustecknet (+) >Lägg till en åtgärd.
  2. På skärmen Lägg till en åtgärd anger du listrader i fältet Sök .
  3. Under Microsoft Dataverse väljer du Listrader (förhandsversion).
  4. På fliken Parametrar till vänster, välj Konton i listrutan Tabellnamn.
  5. Stäng skärmen genom att välja (<<).

Aktivera sidnumrering om du vill begära mer än 5 000 rader

Om du vill hämta fler än 5 000 rader från en fråga automatiskt aktiverar du funktionen Sidnumrering från Inställningar.

När du anger sidnumrering och antalet rader överskrider det tröskelvärde som du konfigurerar innehåller svaret inte parametern @odata.nextLink för att begära nästa uppsättning rader. Inaktivera sidnumrering så att svaret innehåller parametern @odata.nextLink som du kan använda för att begära nästa uppsättning rader. Gå till Hoppa över token för att lära dig hur du använder den.

Gränser för innehållsgenomströmning och gränser för meddelandestorlek gäller för att säkerställa allmänna tjänstegarantier.

  1. Markera kortet Visa rader.

  2. I rutan till vänster väljer du Inställningar>Nätverk.

  3. Flytta skjutreglaget Sidindelning till läget På om det inte redan är påslaget.

  4. I Tröskel ange det maximala antalet rader som begärs. Det största konfigurerbara tröskelvärdet är 100 000.

    Internt avrundas detta värde med intervall motsvarande standardstorleken för en sida. Om sidans storlek exempelvis är 5 000 och du anger 7 000 blir antalet rader som returneras 10 000.

Avancerade alternativ

Med de avancerade alternativen för åtgärden Listrader kan du sortera, filtrera, ordna och utöka resultatet av en fråga.

Ange alternativ i åtgärdskonfigurationsfönstret.

  1. Om du vill se alternativen markerar du kortet Visa rader.

  2. På fliken Parametrar väljer du ett avancerat alternativ i listrutan Avancerade parametrar .

    Skärmbild av avancerade alternativ för åtgärden Visa rader i konfigurationsåtgärdsfönstret.

Returnera fullständiga metadata

Den här inställningen styr om du vill läsa in alla kolumner från tabellen eller bara de viktigaste kolumnerna för bättre prestanda. Om du inte anger det returnerar åtgärden automatiskt fullständiga metadata om ditt flöde använder dynamiskt innehåll eller uttryck som behöver det.

Välj kolumner

Ange en kommaavgränsad lista med kolumner som ska returneras, till exempel name,createdon,preferredcontactmethodcode,emailaddress1,telephone1 för tabellen Konto.

Filtrera rader

Använd det här fältet om du vill definiera ett filteruttryck i OData-format för att begränsa den uppsättning rader som Dataverse returnerar, till exempel createdon ge 2021-01-01T00:00:00-00:00 för rader med skapade på större än eller lika med året 2021.

Lär dig hur du filtrerar rader för att konstruera filterfrågeuttryck .

Ersätt vissa tecken, till exempel &, #och +, med deras URL-kodade motsvarighet. Mer information finns i URL-kodning av specialtecken.

Viktigt!

Filtertryck får inte innehålla strängen $filter=, eftersom denna bara gäller när du använder API:erna direkt.

Sortera efter

Använd det här fältet för att definiera ett OData-uttryck som definierar i vilken ordning objekt returneras, till exempel name desc. Använd asc eller desc suffix för att ange stigande eller fallande ordning. Standardsorteringen är stigande.

Expandera fråga

Använd det här fältet om du vill ange ett OData-uttryck som definierar de data som primarycontactid($select=contactid,fullname) Dataverse returnerar från de relaterade tabellerna, till exempel för att använda kontots primarycontactid för att hämta kolumnen fullname från den relaterade kontakten med ID-kontaktid i svaret.

Du kan använda två typer av navigeringsegenskaper i Expandera fråga:

  1. Enkelvärda navigeringsegenskaper motsvarar uppslagskolumner som har stöd för många-till-en-relationer och gör det möjligt att ange en referens till en annan tabell.

  2. Samlingsbaserade navigeringsegenskaper motsvarar relationer av typen en-till-många eller många-till-många.

Om du bara inkluderar namnet på navigeringsegenskapen får du alla egenskaper för de relaterade raderna. Läs mer i Anslut tabeller med hjälp av OData.

Om du vill använda det i ett flödessteg anger du det här OData-uttrycket i fältet Expandera fråga : primarycontactid(contactid,fullname). Så här hämtar du kolumner contactid och fullname för primarycontactid för varje konto.

Antal rader

Använd inställningen Antal rader för att ange antalet rader som du vill att Dataverse ska returnera.

Hämta XML-fråga

För närvarande kan du inte använda aggregeringsfrågor när du använder åtgärden Lista rader med FetchXML-frågor. Du kan dock använda operatorn distinct .

Använd en FetchXML-fråga i Dataverse-stil, vilket ger mer flexibilitet för att skapa anpassade frågor. Dessa frågor kan vara användbara när du arbetar med en tabell som har flera relaterade tabeller eller när du hanterar sidnumrering. Följande skärmbild visar hur du använder FetchXML.

Viktigt!

Sidnumreringsinställningen stöder inte FetchXML-frågor. Om du vill begära mer än 5 000 rader måste du hantera sidindelning direkt i FetchXML-frågan.

Exempel på FetchXML-fråga för tabellen Konto:

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

Operatorn distinct stöds för närvarande inte direkt i FetchXML-frågor från åtgärden Lista rader , men du kan använda union-funktionen för att ta bort dubblettrader. Du kan till exempel använda åtgärden Välj för att transformera svaret för anslutningen Listrader till det specifika matrisformat du behöver och sedan skapa en variabel med uttrycket union(body('Select'),body('Select')) för att hämta en matris med distinkta rader.

Hoppa över token

Power Automate tillämpar gränser för innehållsdataflöde och storleksgränser för meddelanden för att säkerställa allmänna tjänstgarantier. Om du vill arbeta inom dessa gränser använder du sidnumrering för att returnera ett mindre antal rader i en batch i stället för standardgränserna för antalet returnerade tabellrader.

Om du inte använder sidnumrering är standardgränsen för sidor 5 000 rader.

Om du vill använda sidnumrering implementerar du en loop för att parsa \@odata.nextLink värdet i JSON-svaret, extraherar hopptoken och skickar sedan en annan begäran tills du anger antalet rader som du behöver.

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

Partitions-ID

Ange partitionId när du hämtar data för elastiska tabeller. Mer information finns i Partitionering och horisontell skalning för elastiska tabeller.

  • Uppdaterades senast