Bruge lister over 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.

Bemærk

Power Automate bruger enten den klassiske cloudflowdesigner eller cloudflowdesigneren med Copilot. Du kan se, hvilken designer du bruger, ved at gå til afsnittet Note i Om den cloudflowdesigner med Copilot-funktioner.

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.

Rediger med copilot

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

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 siddeinddeling angives, og antallet af rækker overstiger det antal af tærskelværdien, der er konfigureret, omfatter svaret ikke parameteren @odata.nextLink , hvis du vil anmode om det næste sæt rækker. Når sideinddeling ikke er angivet, indeholder svaret en parameter @odata.nextLink, der kan bruges til at anmode om det næste sæt af rækker. Gå til Spring token over for at få mere at vide om, hvordan du bruger den.

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

Klassisk designer

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

2. Vælg Indstillinger.

3. Flyt Sideinddeling-skyderen til 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.

Rediger med copilot

1. Vælg kortet Vis rækker.

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

3. Flyt Sideinddeling-skyderen til 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.

Klassisk designer

Du kan angive avancerede indstillinger direkte på kortet Vis ræ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.

Rediger med copilot

Du kan angive indstillinger i ruden til konfiguration af handlinger.

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

2. Vælg en avanceret indstilling i menuen Tilføj nye parametre under fanen Parametre.

   

Vælg kolonner

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

Filtrer rækker

Brug til at definere et OData-filterudtryk for at indsnævre det sæt af rækker, som Dataverse returnerer, f.eks. "createdon ge 2021-01-01T00:00:00-00:00" for rækker, hvor createdon er større end eller lig med år 2021.

Få mere at vide om, hvordan du bruger standardfilteroperatører og forespørgselsfunktioner til at oprette filterforespørgselsudtryk.

Visse tegn som f.eks. &, # og + skal erstattes med deres URL-kodede ækvivalens. Flere oplysninger: URL-kodning af specialtegn

Vigtigt

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

Sortér efter

Bruges til at definere et OData-udtryk, der definerer den rækkefølge, som elementer 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

Bruges til at angive et OData-typografiudtryk, der definerer de data, som Dataverse returnerer fra de relaterede tabeller, f.eks. primarycontactid($select=contactid,fullname), for at bruge firmaets primarycontactid til at hente kolonnen fullname fra den relaterede kontakt med id'et contactid 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 medtager navnet på navigationsegenskaben, modtager du alle egenskaberne for de relaterede rækker. Du kan få mere at vide under Hente relaterede tabelrækker med en forespørgsel.

Hvis du vil bruge den 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.

Rækkeantal

Bruges til at angive det bestemte antal rækker, som Dataverse skal returnere. Her er et eksempel, der viser, hvordan du anmoder om 10 rækker.

Hent XML-forespørgsel

Aggregeringsforespørgsler understøttes ikke i øjeblikket, når du bruger handlingen List rækker sammen med FetchXML-forespørgsler. Men den separate operator understøttes.

Klassisk designer

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

Skriv følgende i feltet Hent XML-forespørgsel.

Da den distinkte operator i øjeblikket ikke understøttes direkte i FetchXML-forespørgsler fra handlingen Listerækker, kan foreningsfunktionen bruges til at fjerne dubletrækkerne. Hvis du f.eks. bruger Vælg handlingen til at transformere svaret til forbindelsen af listerækkerne 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 separate rækker.

Rediger med copilot

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

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>

Da den distinkte operator i øjeblikket ikke understøttes direkte i FetchXML-forespørgsler fra handlingen Listerækker, kan foreningsfunktionen bruges til at fjerne dubletrækkerne. Hvis du f.eks. bruger Vælg handlingen til at transformere svaret til forbindelsen af listerækkerne 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 separate rækker.

Spring token over

Da Power Automate anvender grænser for indholdsgennemløb og grænser for meddelelsesstørrelse for at sikre generelle servicegarantier, er det ofte en god ide at bruge sideinddeling til at returnere et mindre antal rækker i en batch i stedet for standardgrænserne for antallet af returnerede tabelrækker.

Standardsidens grænse på 5.000 rækker gælder, hvis du ikke bruger sideinddeling.

Hvis du vil bruge den, skal du implementere en løkke for at fortolke værdien af @odata.nextLink i JSON-svaret, udtrække spring token over og derefter sende en anden forespørgsel, indtil du har angivet det antal rækker, du skal bruge.

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

En indstilling til at angive partitions-id'et under hentning af data til NoSQL-tabeller. Du kan få mere at vide under Forbedre ydeevnen ved hjælp af lagerpartitioner under adgang til tabeldata.

Relaterede oplysninger

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