Brug lister med rækker i flows

Brug handlingen Listerækker til at hente flere rækker på én gang fra Microsoft Dataverse med struktureret forespørgsel.

Hente en liste over rækker

Følg disse trin for at føje handlingen Listerækker til flowet for at returnere op til 5000 firmaer fra tabellen Firmaer i Dataverse.

Power Automate giver dig mulighed for at bruge enten ny designer eller classic designer til at konfigurere dit cloudflow. Trinnene er ens i begge designere. Få mere at vide om (med eksempler) i Identificer forskelle mellem den nye designer og den klassiske designer.

Ny designer

1. Vælg plustegnet (+) >Tilføj en handling.
2. På skærmen Tilføj en handling skal du angive listerækker i feltet Søg .
3. Vælg Vis rækker (forhåndsversion) under Microsoft Dataverse.
4. På fanen Parametre til venstre skal du vælge Konti i rullemenuen Tabelnavn.
5. Luk skærmen ved at vælge (<<).

Klassisk designer

1. Vælg Nyt trin for at føje en handling til flowet.
2. Angiv Vis rækker i søgefeltet Søg i connectorer og handlinger på kortet Vælg en handling.
3. Vælg Microsoft Dataverse for at filtrere søgeresultaterne, så der kun vises handlinger og udløsere for Microsoft Dataverse.
4. Vælg Listerækker.
5. Vælg tabellen Firmaer på listen Tabelnavn.
6. Gem og kør flowet for at bekræfte, at højst 5.000 rækker returneres.

Slå sideinddeling til for at anmode om mere end 5000 rækker

Hvis du automatisk vil hente mere end 5000 rækker fra en forespørgsel, skal du slå funktionen Sideinddeling fra Indstillinger til.

Når du angiver sideinddeling, og antallet af rækker overskrider den tærskel, du konfigurerer, indeholder @odata.nextLink svaret ikke parameteren for at anmode om det næste sæt rækker. Deaktiver sideinddeling, så svaret indeholder den @odata.nextLink parameter, du kan bruge til at anmode om det næste sæt rækker. Gå til Spring over-token for at lære, hvordan du bruger den.

Men Grænseværdier for indhold og Størrelsesgrænser for meddelelser anvendes for at sikre generelle servicegarantier.

Ny designer

1. Vælg kortet Vis rækker.

2. Vælg fanen Indstillinger>Netværk i ruden til venstre.

3. Flyt Sideinddeling-skydeknappen til positionen Til, hvis den ikke allerede er slået til.

4. Angiv en Tærskel for at angive det antal rækker, der kræves som minimum. Den maksimale tærskelværdi, der kan konfigureres, er 100.000.

   Internt afrundes dette tal i trin af standardsidens størrelse. Hvis den pågældende sidestørrelse f.eks. er 5.000, og du angiver 7.000, returneres antallet af returnerede rækker 10.000.

Klassisk designer

1. Vælg menuen (...) i øverste højre hjørne af Listerækker-kortet.

2. Vælg Indstillinger.

3. Flyt skyderen Sideinddeling til positionen Til , hvis den ikke allerede er slået til.

4. Angiv en Tærskel for at angive det antal rækker, der kræves som minimum. Den maksimale tærskelværdi, der kan konfigureres, er 100.000.

   Internt afrundes dette tal i trin af standardsidens størrelse. Hvis den pågældende sidestørrelse f.eks. er 5.000, og du angiver 7.000, returneres antallet af returnerede rækker 10.000.

Avancerede indstillinger

De avancerede indstillinger for handlingen Listerækker giver dig mulighed for at sortere, filtrere, arrangere og udvide resultaterne af en forespørgsel.

Ny designer

Angiv indstillinger i handlingskonfigurationsruden.

1. Hvis du vil se indstillinger, skal du vælge kortet Vis rækker.

2. Under fanen Parametre skal du vælge en avanceret indstilling i rullemenuen Avancerede parametre .

   

Klassisk designer

Angiv avancerede indstillinger direkte på kortet Listerækker . Hvis du vil se indstillinger, skal du vælge Vis avancerede indstillinger. Når du vælger det, ændres navnet til Skjul avancerede indstillinger.

Returnér fulde metadata

Denne indstilling styrer, om du vil indlæse alle kolonner fra tabellen eller blot de vigtige kolonner for at opnå en bedre ydeevne. Hvis du ikke angiver den, returnerer handlingen automatisk komplette metadata, hvis dit flow bruger dynamisk indhold eller udtryk, der har brug for det.

Vælg kolonner

Angiv en kommasepareret liste over kolonner, der skal returneres, f.eks name,createdon,preferredcontactmethodcode,emailaddress1,telephone1 . for tabellen Konto.

Filtrér rækker

Brug dette felt til at definere et OData-filterudtryk for at indsnævre sættet af rækker, som Dataverse returnerer, f.eks createdon ge 2021-01-01T00:00:00-00:00 . for rækker med oprettet på større end eller lig med året 2021.

Få mere at vide om, hvordan du filtrerer rækker for at oprette filterforespørgselsudtryk .

Erstat visse tegn, f.eks. &, #og +, med deres URL-kodede ækvivalent. Du kan få mere at vide under URL-kode specialtegn.

Vigtigt

Filterudtryk kan ikke indeholde denne streng, $filter=, da den kun gælder, når du bruger API direkte.

Sortér efter

Brug dette felt til at definere et OData-typografiudtryk, der definerer den rækkefølge, elementerne returneres i, f.eks name desc. . Brug asc- eller desc-suffikset til at angive henholdsvis stigende eller faldende rækkefølge. Standardrækkefølgen er stigende.

Udvid forespørgsel

Brug dette felt til at angive et OData-typeudtryk, der definerer de data, som Dataverse returnerer fra de relaterede tabeller, f.eksprimarycontactid($select=contactid,fullname). til at bruge kontoens primære indhold til at hente kolonnen fullname fra den relaterede kontakt med id-kontakt-id'et i svaret.

Der findes to typer navigationsegenskaber, du kan bruge i Udvid forespørgsel:

1. Egenskaber for navigation med en enkelt værdi svarer til opslagskolonner, der understøtter mange til en-relationer og giver dig mulighed for at angive en reference til en anden tabel.

2. Navigationsegenskaber med samlingsværdi svarer til en til mange- eller mange-til-mange-relationer.

Hvis du kun inkluderer navnet på navigationsegenskaben, modtager du alle egenskaberne for de relaterede rækker. Få mere at vide i Jointabeller ved hjælp af OData.

Hvis du vil bruge det i et flowtrin, skal du angive dette OData-udtryk i feltet Udvid forespørgsel : primarycontactid(contactid,fullname). Sådan får du kolonnerne contactid og fullname for primarycontactid for hvert firma.

Antal rækker

Brug indstillingen Rækkeantal til at angive det antal rækker, Dataverse skal returnere.

Hent XML-forespørgsel

I øjeblikket kan du ikke bruge sammenlægningsforespørgsler , når du bruger handlingen Listerækker med FetchXML-forespørgsler. Du kan dog bruge operatoren distinct .

Ny designer

Brug en FetchXML-forespørgsel i Dataverse-stil, hvilket giver større fleksibilitet til at oprette brugerdefinerede forespørgsler. Disse forespørgsler kan være nyttige, når du arbejder med en tabel, der har flere relaterede tabeller, eller når du håndterer sideinddeling. Følgende skærmbillede viser, hvordan du bruger FetchXML.

Vigtigt

Indstillingen for sideinddeling understøtter ikke FetchXML-forespørgsler. Hvis du vil anmode om mere end 5.000 rækker, skal du administrere sideopdeling direkte med FetchXML-forespørgslen .

Eksempel på FetchXML-forespørgsel for 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>

Operatoren distinct understøttes i øjeblikket ikke direkte i FetchXML-forespørgsler fra handlingen Listerækker , men du kan bruge foreningsfunktionen til at fjerne dublerede rækker. Du kan f.eks. bruge handlingen Vælg til at transformere svaret fra forbindelsen Listerækker til det specifikke matrixformat, du har brug for, og derefter oprette en variabel med udtrykket union(body('Select'),body('Select')) for at få en matrix med særskilte rækker.

Klassisk designer

Brug en FetchXML-forespørgsel i Dataverse-stil, hvilket giver større fleksibilitet til at oprette brugerdefinerede forespørgsler. Disse forespørgsler kan være nyttige, når du arbejder med en tabel, der har flere relaterede tabeller, eller når du håndterer sideinddeling. Følgende skærmbillede viser, hvordan du bruger FetchXML.

Skriv følgende tekst i feltet Fetch XML Query .

Da den entydige operator i øjeblikket ikke understøttes direkte i FetchXML-forespørgsler fra handlingen Listerækker, skal du bruge foreningsfunktionen til at fjerne dublerede rækker. Du kan f.eks. bruge handlingen Vælg til at transformere svaret fra forbindelsen Listerækker til det specifikke matrixformat, du har brug for, og derefter oprette en variabel med udtrykket union(body('Select'),body('Select')) for at få en matrix med særskilte rækker.

Spring token over

Power Automate anvender grænser for gennemløb for indhold og grænser for meddelelsesstørrelse for at sikre generelle tjenestegarantier. Hvis du vil arbejde inden for disse grænser, skal du bruge sideinddeling til at returnere et mindre antal rækker i en batch i stedet for standardgrænserne for antallet af returnerede tabelrækker.

Hvis du ikke bruger sideinddeling, er standardsidens grænse 5.000 rækker.

Hvis du vil bruge sideinddeling, skal du implementere en løkke for at fortolke \@odata.nextLink værdien i JSON-svaret, udtrække skip-tokenet og derefter sende en anden anmodning, indtil du angiver det antal rækker, du har brug for.

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

Angiv partitionId ved hentning af data til elastiske tabeller. Du kan få mere at vide under Partitionering og vandret skalering for elastiske tabeller.

Relaterede oplysninger

• Kursus: Brug Dataverse-udløsere og -handlinger i Power Automate (modul)
• Kursus: Integrer Power Automate-flows og Dataverse (læringsforløb)