Bruk lister med rader i flyter

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

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

Power Automate lar deg bruke den nye designeren eller den klassiske designeren for å konfigurere skyflyten. Trinnene er like i begge utformingene. Finn ut mer (med eksempler) i Finn forskjellene mellom den nye utformingen og den klassiske utformingen.

  1. Velg plusstegnet (+) >Legg til en handling.
  2. Skriv inn listerader i søkefeltet på skjermbildet 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 du angir paginering og antall rader overskrider terskelen du konfigurerer, inkluderer ikke svaret parameteren @odata.nextLink for å be om det neste settet med rader. Deaktiver paginering slik at svaret inneholder parameteren @odata.nextLink du kan bruke til å be om neste sett med rader. Gå til Hopp over token for å lære hvordan du bruker det.

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

  1. Velg kortet Vis rader.

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

  3. Flytt glidebryteren for paginering til På-posisjonen 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 Listerader kan du sortere, filtrere, ordne og utvide resultatene av en spørring.

Angi alternativer i handlingskonfigurasjonsruten.

  1. Velg kortet Vis rader for å vise alternativene.

  2. Velg et avansert alternativ i rullegardinmenyen Avanserte parametere i kategorien Parametere.

    Skjermbilde av avanserte alternativer for handlingen Vis rader i handlingsruten for konfigurasjon.

Returner fullstendige metadata

Denne innstillingen styrer om du vil laste inn alle kolonnene fra tabellen eller bare de viktigste for bedre ytelse. Hvis du ikke angir det, returnerer handlingen automatisk fullstendige metadata hvis flyten bruker dynamisk innhold eller uttrykk som trenger det.

Velg kolonner

Skriv inn en kommadelt liste med kolonner som skal returneres, for eksempel name,createdon,preferredcontactmethodcode,emailaddress1,telephone1 for Konto-tabellen.

Filtrer rader

Bruk dette feltet til å definere et OData-filteruttrykk 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 år 2021.

Lær hvordan du filtrerer rader for å konstruere filterspørringsuttrykk .

Erstatt bestemte tegn, for eksempel &, #og +, med den url-kodede ekvivalenten. Hvis du vil ha mer informasjon, kan du se URL-kode spesialtegn.

Viktig

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

Sorter etter

Bruk dette feltet til å definere et OData-stiluttrykk som definerer rekkefølgen elementene returneres i, for eksempel name desc. Bruk asc- eller desc-suffikset til å angi henholdsvis stigende eller synkende rekkefølge. Standardrekkefølge er stigende.

Utvid spørring

Bruk dette feltet til å angi et OData-stiluttrykk som definerer dataene som Dataverse returnerer fra de relaterte tabellene, for eksempel primarycontactid($select=contactid,fullname) for å bruke kontoens primærkontactid til å hente fullnavnkolonnen fra den relaterte kontakten med ID-kontakt-ID 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. Finn ut mer i Sammenføyningstabeller ved hjelp av OData.

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

Antall rader

Bruk innstillingen radantall til å angi antall rader du vil at dataverset skal returnere.

Hent XML-spørring

For øyeblikket kan du ikke bruke Aggregasjonsspørringer når du bruker handlingen Listerader med FetchXML-spørringer. Du kan imidlertid bruke operatoren distinct .

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

Viktig

Pagineringsinnstillingen støtter ikke FetchXML-spørringer. Hvis du vil be om mer enn 5000 rader, må du behandle sideveksling direkte med FetchXML-spørringen .

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>

Operatoren distinct støttes for øyeblikket ikke direkte i FetchXML-spørringer fra handlingen Listerader , men du kan bruke unionsfunksjonen til å fjerne dupliserte rader. Du kan for eksempel bruke handlingen Velg til å transformere svaret på listeradtilkoblingen 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

Power Automate bruker begrensninger for innholdsgjennomstrømming og begrensninger for meldingsstørrelse for å sikre generelle servicegarantier. Hvis du vil arbeide innenfor disse grensene, kan du bruke paginering til å returnere et mindre antall rader i en bunke, i stedet for standardgrensene for antall tabellrader som returneres.

Hvis du ikke bruker paginering, er standard sidegrense 5000 rader.

Hvis du vil bruke paginering, implementerer \@odata.nextLink du en løkke for å analysere verdien i JSON-svaret, trekker ut skip-tokenet og sender deretter en annen forespørsel til du viser 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

partitionId Angi mens du henter data for elastiske tabeller. Hvis du vil ha mer informasjon, kan du se Partisjonering og vannrett skalering for elastiske tabeller.

  • Sist oppdatert