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.
Lisää toiminto työnkulkuun valitsemalla Uusi vaihe.
Kirjoita luettelorivi Hakuyhdistimet ja toiminnot -hakuruutuun Valitse toimintokortti -kohdassa.
Valitse Microsoft Dataverse, jos haluat suodattaa hakutulokset niin, että näkyvillä ovat vain Microsoft Dataversen toiminnot ja käynnistimet.
Valitse Luettelorivit.

Valitse Tilit-taulukko taulukon nimi -luettelosta.

Tallenna ja suorita työnkulku, jotta voit varmistaa, että palautettavia rivejä on enintään 5 000.
Ota sivutus käyttöön, jos haluat pyytää yli 5 000 riviä
Jos haluat saada kyselystä automaattisesti yli 5 000 riviä, ota sivutustoiminto käyttöön asetuksissa seuraavien vaiheiden mukaisesti.
Valitse Luetteloi rivit -kortin oikeapuoleisessa yläkulmassa valikko (...).
Valitse Asetukset.

Siirrä Pagination-liukusäätimen Päällä-sijaintiin, jos se ei ole jo käytössä.
Syötä Raja-arvo-kohtaan pyydettyjen rivien enimmäismäärä. 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.

Note
Sisällön siirtomäärän rajoitukset ja viestien koon rajoitukset kohdistetaan yleisen palvelun takaamiseksi. Kun sivutusta ei ole määritetty, vastaus sisältää parametrin @odata.nextLink. Sitä käytetään seuraavan rivijoukon pyytämisessä. Lisätietoja sen käytöstä on jäljempänä tämän artikkelin Ohita tunnus -osassa.
Lisäasetukset
Luettelorivit-toiminnon lisäasetusten avulla voit lajitella, suodattaa, järjestää ja laajentaa kyselyn tuloksia. Seuraavassa on esimerkki siitä, miten ne voidaan koota:

Valitse sarakkeet
Syötä Tili-taulukon palautettavien sarakkeiden pilkuilla eroteltu luettelo, esimerkiksi "name,createdon,preferredcontactmethodcode,emailaddress1,telephone1".
Suodata rivit
Rajaa Dataversen palauttamien rivijoukkojen määrää kirjoittamalla Odata-tyylinen suodatuslauseke. Se voi olla esimerkiksi "createdon ge 2021-01-01T00:00:00-00:00" riveille, joiden createdon-arvo on yhtä suuri tai suurempi kuin vuosi 2021.
Tip
Lisätietoja vakiosuodatusoperaattoreista ja kyselyfunktioista, joiden avulla suodatuskyselyn lausekkeet muodostetaan.
Important
Suodatuslausekkeet eivät voi sisältää merkkijonoa $filter=, koska se koskee vain suoraa ohjelmointirajapinnan käyttämistä.
Lajitteluperuste:
Määritä OData-tyylinen lauseke, joka määrittää nimikkeiden palautusjärjestyksen. Se voi olla esimerkiksi "nimi kuvaus". Käytä asc- tai desc-loppuliitettä, jos haluat määrittää nousevan tai laskevan järjestyksen. Oletusjärjestys on nouseva.
Laajenna kysely
Määritä OData-tyylinen lauseke, joka määrittää Dataversen liittyvistä taulukoista palauttamat tiedot. Niitä voivat olla esimerkiksi "primarycontactid($select=contactid,fullname)" tilin primarycontactid-kohtaan haettaessa fullname-sarake liittyvältä yhteyshenkilöltä, jonka tunnus on contactid vastauksessa.
Voit käyttää Laajenna kyselyä -kohdassa seuraavia kahta siirtymisominaisuutta:
Yhden arvon siirtymisominaisuudet vastaavat valintasarakkeita, jotka tukevat monta yhteen -suhteita ja sallii viitteen määrittämisen toiselle taulukolle.
Kokoelma-arvon siirtymisominaisuudet vastaavat yksi moneen- tai monta moneen -suhteita.
Jos lisäät vain siirtymisominaisuuden nimen, vastaanotat kaikki liittyvien rivien ominaisuudet. Lisätietoja on kohdassa Liittyvien taulukon rivien ja kyselyn hakeminen.
Jos haluat käyttää sitä työnkulun vaiheessa, syötä Odata-lauseke seuraavassa kuvassa esitetyllä tavalla. Tässä esimerkissä kerrotaan, miten contactid- ja fullname-sarakkeet haetaan kunkin asiakkaan primarycontactid-kohteelle.
Rivimäärä
Osoittaa Dataversen palautettavien rivien määrätyn määrän. Tässä esimerkissä näytetään, miten pyydetään 10 riviä.
Hae XML-kysely
Tämän avulla määritetään Dataverse-tyylinen FetchXML-katkelma, jonka avulla mukautettujen kyselyjen luominen on aiempaa joustavampaa. Ne voivat olla hyödyllisiä, kun käytät taulukkoa, jolla on useita liittyviä taulukoita, tai käsittelet sivutusta. Seuraavassa näyttökuvassa näkyy, kuinka FetchXML:ää käytetään samoja suodattamia ja lajitteluehtoja varten kuin edellisessä esimerkissä:
Esimerkki: FetchXML-kysely Tili-taulukolle:
<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>
Ohita tunnus
Koska Power Automate käyttää sisällön siirtomäärän rajoituksia ja viestien koon rajoituksia yleisten palvelutakuiden varmistamiseksi, yleensä kannattaa käyttää sivutusta oletusarvoisen palautettavien taulukkorivien määrän rajoituksen sijaan, jotta erässä on vähemmän rivejä.
Sivun oletusrajoitus 5 000 riviä on käytössä, jos sivutusta käytetä.
Jos haluat käyttää tätä, ota käyttöön silmukka ja jäsennä arvo @odata.nextLink JSON-vastauksessa, poimi ohitustunnus ja lähetä toinen pyyntö, kunnes sinulla on tarvittava määrä rivejä.
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"
}
Osan tunnus
Asetus, joka määrittää partitionId-tunnuksen noudettaessa NoSQL-taulukoiden tietoja. Lisätietoja on ohjeaiheessa Suorituskyvyn parantaminen tallennusosioiden avulla taulukkotietoja käytettäessä.