Bruk lister med rader i flyter

Bruk handlingen Vis rader til å hente flere rader samtidig fra Microsoft Dataverse med en strukturert spørring.

Hente en liste over rader

Følg denne fremgangsmåten for å legge til handlingen Vis rader i flyten for å returnere opptil 5 000 kontoer fra tabellen Kontoer i Dataverse.

Merk

Power Automate bruker den klassiske skyflytutformingen eller skyflytutformingen med Copilot. Du kan finne ut hvilken utforming du bruker, ved å gå til Obs!-delen i Forstå skyflytutformingen med kopilotfunksjoner.

Klassisk utforming

1. Velg Nytt trinn for å legge til en handling i flyten.
2. Angi vis rader i søkeboksen Søk etter koblinger og handlinger på kortet Velg en operasjon.
3. Velg Microsoft Dataverse for å filtrere søkeresultatene slik at bare handlinger og utløsere vises for Microsoft Dataverse.
4. Velg Vis rader.
5. Velg tabellen Forretningsforbindelse fra listen Tabellnavn.
6. Lagre og kjør flyten for å kontrollere at det ikke returneres mer enn 5 000 rader.

Rediger med Copilot

1. Velg plusstegnet (+) >Legg til en handling.
2. Angi vis rader i Søk-feltet på skjermen Legg til en handling.
3. Velg Vis rader (forhåndsversjon) under Microsoft Dataverse.
4. Velg Kontoer på rullegardinmenyen Tabellnavn i Parametere-fanen til venstre.
5. Lukk skjermen ved å velge (<<).

Aktivere paginering for å be om mer enn 5 000 rader

Hvis du vil hente flere enn 5 000 rader automatisk fra en spørring, aktiverer du funksjonen Paginering fra Innstillinger.

Når paginering angis og antallet rader overskrider antallet terskelverdier som er konfigurert, vil svaret ikke inkludere parameteren @odata.nextLink for å be om neste radsett. Deaktiver paginering islik at svaret inkluderer parameteren @odata.nextLink-parameter som kan brukes til å be om det neste settet med rader. Gå til Hopp over token for å lære hvordan du bruker det.

Innholdsgjennomstrømmingsgrenser og meldingsstørrelsesgrenser gjelder for å sikre generelle servicegarantier.

Klassisk utforming

1. Velg menyen (...) øverst til høyre på kortet Vis rader.

2. Velg Innstillinger.

3. Flytt glidebryteren Paginering til posisjonen På hvis den ikke allerede er aktivert.

4. I Terskel angir du maksimalt antall rader forespurt. Den maksimale konfigurerbare grensen er 100 000.

   Internt rundes dette antallet av i trinn av standard sidestørrelse. Hvis for eksempel sidestørrelsen er 5 000 og du angir 7 000, er antall rader som returneres, 10 000.

Rediger med Copilot

1. Velg kortet Vis rader.

2. Velg Innstillinger-fanen >Nettverk i ruten til venstre.

3. Flytt glidebryteren Paginering til posisjonen På hvis den ikke allerede er aktivert.

4. I Terskel angir du maksimalt antall rader forespurt. Den maksimale konfigurerbare grensen er 100 000.

   Internt rundes dette antallet av i trinn av standard sidestørrelse. Hvis for eksempel sidestørrelsen er 5 000 og du angir 7 000, er antall rader som returneres, 10 000.

Avanserte alternativer

Med de avanserte alternativene for handlingen Vis rader kan du sortere, filtrere, ordne og utvide resultatene av en spørring.

Klassisk utforming

Du kan angi avanserte alternativer direkte på kortet Vis rader. Velg Vis avanserte alternativer for å vise alternativene. Når du velger det, endres navnet til Skjul avanserte alternativer.

Rediger med Copilot

Du kan angi alternativer i ruten for handlingskonfigurasjon.

1. Velg kortet Vis rader for å vise alternativene.

2. Velg et avansert alternativ på rullegardinmenyen Legg til nye parametere i fanen Parametere.

   

Velg kolonner

Angi en kommadelt liste over kolonner som skal returneres, for eksempel "name,createdon,preferredcontactmethodcode,emailaddress1,telephone1" for tabellen Konto.

Filtrer rader

Bruk til å definere et OData-stilfilteruttrykk for å begrense settet med rader som Dataverse returnerer, for eksempel "createdon ge 2021-01-01T00:00:00-00:00" for rader med createdon større enn eller lik året 2021.

Lær hvordan du bruker standard filteroperatorer og spørringsfunksjoner til å konstruere Filterspørring-uttrykk.

Enkelte tegn, for eksempel &, # og +, må erstattes med deres URL-kodede ekvivalenter. Mer informasjon: URL-kodespesialtegn

Viktig

Filteruttrykk kan ikke inneholde denne strengen, $filter=, fordi den bare gjelder når du bruker API-ene direkte.

Sorter etter

Brukes til å definere et OData-stiluttrykk som definerer rekkefølgen elementer returneres i, for eksempel "navnebeskr". Bruk asc- eller desc-suffikset til å angi henholdsvis stigende eller synkende rekkefølge. Standardrekkefølge er stigende.

Utvid spørring

Bruk for å angi et OData-stiluttrykk som definerer dataene som Dataverse returnerer fra de relaterte tabellene, for eksempel primarycontactid($select=contactid,fullname) for å bruke kontoens primarycontactid til å hente fullname-kolonnen fra den relaterte kontakten med ID contactid i svaret.

Det finnes to typer navigasjonsegenskaper som du kan bruke i Utvid spørring:

1. Navigasjonsegenskaper med én verdi tilsvarer oppslagskolonner som støtter mange-til-én-relasjoner, og gjør det mulig å angi en referanse til en annen tabell.

2. Navigasjonsegenskaper med samlingsverdi tilsvarer én-til-mange- eller mange-til-mange-relasjoner.

Hvis du bare inkluderer navnet på navigasjonsegenskapen, mottar du alle egenskapene for de relaterte radene. Hvis du vil lære mer, kan du se Hente relaterte tabellrader med en spørring.

Hvis du vil bruke det i et flyttrinn, angir du dette Odata-uttrykket i feltet Utvid spørring: primarycontactid(contactid,fullname). Det er slik du henter kolonnene contactid og fullname for primarycontactid for hver konto.

Radantall

Bruk for å angi det bestemte antallet rader som Dataverse skal returnere. Her er et eksempel som viser hvordan du ber om ti rader.

FetchXML-spørring

Aggregeringsspørringer støttes for øyeblikket ikke når du bruker handlingen Vis rader med FetchXML-spørringer. Men den distinkte operatoren støttes.

Klassisk utforming

Bruk en Dataverse-stil FetchXML-spørring, som gir mer fleksibilitet i bygging av egendefinerte spørringer. Disse spørringene kan være nyttige når du arbeider med en tabell som har flere relaterte tabeller eller håndterer paginering. Skjermbildet nedenfor viser hvordan du bruker FetchXML.

Skriv inn følgende i feltet Hent XML-spørring.

Siden distinkte operatorer for øyeblikket ikke støttes direkte i FetchXML-spørringer fra handlingen Vis rader, kan koblingsfunksjonen brukes til å fjerne dupliserte rader. Du kan for eksempel bruke handlingen Velg til å transformere svaret for koblingen Vis rader til det bestemte matriseformatet du trenger, og deretter opprette en variabel med uttrykket union(body('Select'),body('Select')) for å få en matrise med distinkte rader.

Rediger med Copilot

Bruk en Dataverse-stil FetchXML-spørring, som gir mer fleksibilitet i bygging av egendefinerte spørringer. Disse spørringene kan være nyttige når du arbeider med en tabell som har flere relaterte tabeller eller håndterer paginering. Skjermbildet nedenfor viser hvordan du bruker FetchXML.

Eksempel på FetchXML-spørring for Konto-tabellen:

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

Siden distinkte operatorer for øyeblikket ikke støttes direkte i FetchXML-spørringer fra handlingen Vis rader, kan koblingsfunksjonen brukes til å fjerne dupliserte rader. Du kan for eksempel bruke handlingen Velg til å transformere svaret for koblingen Vis rader til det bestemte matriseformatet du trenger, og deretter opprette en variabel med uttrykket union(body('Select'),body('Select')) for å få en matrise med distinkte rader.

Hopp over token

I og med at Power Automate bruker begrensninger for innholdsgjennomstrømming og begrensninger for meldingsstørrelse for å sikre generelle servicegarantier, er det ofte nyttig å bruke sideformatering til å returnere et mindre antall rader i et parti, i stedet for grenser for antall tabellrader som returneres.

Standard sidebegrensning på 5 000 rader gjelder hvis du ikke bruker paginering.

Hvis du vil bruke den, implementerer du en sløyfe for å analysere @odata.nextLink-verdien i JSON-svaret, trekker ut utelat-tokenet, og sender deretter en ny forespørsel til du har listet opp antall rader du trenger.

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

Partisjons-ID

Et alternativ for å angi partisjons-ID under henting av data for NoSQL-tabeller. Hvis du vil vite mer, kan du se Forbedre ytelsen ved hjelp av lagringspartisjoner ved tilgang til tabelldata.

Relatert informasjon

• Opplæring: Bruk Dataverse-utløsere og -handlinger i Power Automate (modul)
• Opplæring: Integrer Power Automate-flyter og Dataverse (læringsforløp)