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.

  1. Lisää toiminto työnkulkuun valitsemalla Uusi vaihe.

  2. Kirjoita luettelorivi Hakuyhdistimet ja toiminnot -hakuruutuun Valitse toimintokortti -kohdassa.

  3. Valitse Microsoft Dataverse, jos haluat suodattaa hakutulokset niin, että näkyvillä ovat vain Microsoft Dataversen toiminnot ja käynnistimet.

  4. Valitse Luettelorivit.

    Suodata rivitoimintojen luettelemiseksi.

  5. Valitse Tilit-taulukko taulukon nimi -luettelosta.

    Valitse Tilit-taulukko.

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

  1. Valitse Luetteloi rivit -kortin oikeapuoleisessa yläkulmassa valikko (...).

  2. Valitse Asetukset.

    Luettelorivien asetukset -kortti.

  3. Siirrä Pagination-liukusäätimen Päällä-sijaintiin, jos se ei ole jo käytössä.

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

    Luettelorivien sivutusasetukset -kortti.

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:

Luettelorivit-toiminnon lisäasetusten esimerkki.

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:

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

Tilien luetteleminen -esimerkki, jossa käytetään FetchXML:ää.

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