Riviluetteloiden käyttäminen työnkuluissa

Listaa rivit -toiminnolla voit hakea useita rivejä kerralla Microsoft Dataversesta rakenteellisen kyselyn avulla.

Hae rivien luettelo

Lisää näiden vaiheiden avulla Luetteloi rivit -toiminto työnkulkuun, jos haluat palauttaa enintään 5 000 tiliä Dataversen Tilit-taulukosta.

Power Automate voit käyttää joko new designer:tä tai luokkaista suunnittelutyökalua pilvipalvelutyönkulun määrittämiseen. Vaiheet ovat samanlaiset molemmissa suunnitteluohjelmissa. Lisätietoja (esimerkein): Uuden suunnitteluohjelman ja perinteisen suunnitteluohjelman erojen tunnistaminen.

  1. Valitse plusmerkki (+) >Lisää toiminto.
  2. Kirjoita Lisää toiminto -näytössä luettelorivitHaku-kenttään .
  3. Valitse Microsoft Dataverse -kohdassa Luettelorivit (esiversio).
  4. Valitse vasemmalla olevassa Parametrit-välilehden avattavassa Taulukon nimi -valikossa Tilit.
  5. Sulje näyttö valitsemalla (<<).

Ota sivutus käyttöön, jos haluat pyytää yli 5 000 riviä

Jos haluat saada kyselyn vastauksena automaattisesti yli 5 000 riviä, ota Sivutus-ominaisuus käyttöön asetuksissa.

Kun määrität sivutuksen ja rivien määrä ylittää määrittämäsi raja-arvon, vastaus ei sisällä @odata.nextLink parametria, joka pyytää seuraavaa rivijoukkoa. Poista sivutus käytöstä niin, että vastaus sisältää parametrin @odata.nextLink , jonka avulla voit pyytää seuraavaa rivijoukkoa. Siirry tunnuksen ohittamiseen opettelemaan sen käyttö.

Sisällön siirtomäärän rajoitukset ja viestien koon rajoitukset kohdistetaan yleisen palvelun takaamiseksi.

  1. Valitse Luettele rivit -kortti.

  2. Valitse vasemmalla olevassa ruudussa Asetukset-välilehti >Verkkopalvelut.

  3. Siirrä Sivutus-liukusäädinKäytössä-sijaintiin , jos se ei ole jo käytössä.

  4. Anna raja-arvoksi pyydettyjen rivien vähimmäismäärä. Suurin määritettävä raja-arvo on 100 000.

    Sisäisesti tämä numero pyöristetään oletussivun koon mukaan. Jos sivun koko on esimerkiksi 5 000 ja syötät luvuksi 7 000, palautettavien rivien määräksi pyöristetään 10 000.

Lisäasetukset

Luettelorivit-toiminnon lisäasetusten avulla voit lajitella, suodattaa, järjestellä ja laajentaa kyselyn tuloksia.

Määritä asetukset toiminnon määritysruudussa.

  1. Asetukset saadaan näkyviin valitsemalla Luettelorivit-kortti

  2. Valitse Parametrit-välilehdestä lisäasetus avattavasta Lisäparametrit-valikosta .

    Näyttökuvassa toiminnon määritysruudun Luettelorivit-toiminnon lisäasetukset

Palauta täydelliset metatiedot

Tällä asetuksella määritetään, ladataanko kaikki sarakkeet taulukosta vai vain oleellisia sarakkeita suorituskyvyn parantamiseksi. Jos et määritä sitä, toiminto palauttaa automaattisesti täydelliset metatiedot, jos työnkulkusi käyttää sitä tarvitsempaa dynaamista sisältöä tai lausekkeita.

Valitse sarakkeet

Kirjoita pilkuin eroteltu luettelo palautetta olevista sarakkeista, esimerkiksi name,createdon,preferredcontactmethodcode,emailaddress1,telephone1 Tili-taulukolle.

Suodata rivit

Tämän kentän avulla voit määrittää OData-tyylisen suodatinlausekkeen rajataksesi Dataversen palauttamien rivien joukkoa, esimerkiksi createdon ge 2021-01-01T00:00:00-00:00 rivejä, joiden luotu on suurempi tai yhtä suuri kuin vuosi 2021.

Opi suodattamaan rivejäsuodatinkyselylausekkeiden muodostamiseksi.

Korvaa tietyt merkit, kuten &, #ja +, niiden URL-koodatulla vastineella. Lisätietoja on artikkelissa ERIKOISmerkkien URL-koodaus.

Tärkeää

Suodatuslausekkeet eivät voi sisältää merkkijonoa $filter=, koska sitä käytetään vain, kun ohjelmointirajapintaa käytetään suoraan.

Lajitteluperuste

Tämän kentän avulla voit määrittää OData-tyylisen lausekkeen, joka määrittää järjestyksen, jossa kohteet palautetaan, kuten name desc. Käytä asc- tai desc-loppuliitettä, jos haluat määrittää nousevan tai laskevan järjestyksen. Oletusjärjestys on nouseva.

Laajenna kyselyä

Tämän kentän avulla voit määrittää OData-tyylisen lausekkeen, joka määrittää Dataversen palauttamia tietoja liittyvistä taulukoista. Voit esimerkiksi primarycontactid($select=contactid,fullname) käyttää tilin primarycontactid-toimintoakoko nimi -sarakkeen noutamiseen liittyvästä yhteyshenkilöstä id contactid -yhteydellä vastauksessa.

Voit käyttää Laajenna kyselyä -kohdassa seuraavia kahta siirtymisominaisuutta:

  1. Yhden arvon siirtymisominaisuudet vastaavat valintasarakkeita, jotka tukevat monta yhteen -suhteita ja sallii viitteen määrittämisen toiselle taulukolle.

  2. Kokoelma-arvon siirtymisominaisuudet vastaavat yksi moneen- tai monta moneen -suhteita.

Jos sisällytät mukaan vain siirtymisominaisuuden nimen, saat liittyvien rivien kaikki ominaisuudet. Lue lisätietoja Liitostaulukot ODatan avulla.

Voit käyttää sitä työnkulun vaiheessa kirjoittamalla tämän OData-lausekkeen Laajenna kysely - kenttään: primarycontactid(contactid,fullname). Tällä tavoin haetaan kunkin tilinprimarycontactid-arvon contactid- ja fullname-sarakkeet.

Rivimäärä

Rivimäärä-asetuksen avulla voit määrittää niiden rivien määrän, jotka haluat Dataversen palauttavan.

XML-kyselyn noutaminen

Tällä hetkellä et voi käyttää koostekyselyitä , kun käytät Luettelorivit-toimintoa FetchXML-kyselyiden kanssa. Voit kuitenkin käyttää -operaattoria distinct .

Käytä Dataverse-tyylistä FetchXML-kyselyä, joka tarjoaa enemmän joustavuutta mukautettujen kyselyiden luomiseen. Näistä kyselyistä voi olla hyötyä, kun käsittelet taulukkoa, jossa on useita liittyviä taulukoita, tai kun käsittelet sivutusta. Seuraavassa näyttökuvassa näytetään, miten FetchXML:ää käytetään.

Tärkeää

Sivutus-asetus ei tue FetchXML-kyselyitä. Jos haluat pyytää yli 5 000 riviä, sinun on hallittava sivutusta suoraan FetchXML-kyselyllä .

Tilitaulukon FetchXML-kyselyesimerkki:

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

Operaattoria distinct ei tällä hetkellä tueta suoraan FetchXML-kyselyissä Luettelorivit-toiminnosta , mutta union-funktiolla voit poistaa rivien kaksoiskappaleet. Voit esimerkiksi Käyttää Valitse-toimintoa , jos haluat muuntaa Luettelorivit-yhteyden vastauksen haluamaasi matriisimuotoon. Luo sitten muuttuja lausekkeella union(body('Select'),body('Select')) , jotta saat erilliset rivit sisältävän matriisin.

Ohita tunnus

Power Automate soveltaa sisällön siirtomäärärajoja ja sanomakokorajoituksia yleisiin palvelutakuisiin takaamiseksi. Jos haluat toimia näiden rajojen sisällä, käytä sivutusta , kun haluat palauttaa erän pienemmän määrän rivejä eikä oletusarvoisia rajoituksia palautettavien taulukon rivien määrälle.

Jos et käytä sivutusta, sivun oletusrajoitus on 5 000 riviä.

Jos haluat käyttää sivutusta, ota silmukka käyttöön JSON-vastauksen arvon jäsentämiseksi \@odata.nextLink , poimi ohitustunnus ja lähetä sitten toinen pyyntö, kunnes luettelet tarvitsemasi rivien määrän.

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

Osion tunnus

Määritä , partitionId kun noudet tietoja joustaville taulukoille. Lisätietoja on artikkelissa Elastic-taulukoiden osiointi ja vaakasuuntainen skaalaus.

  • Viimeksi päivitetty