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.

Huomautus

Power Automate käyttää joko perinteistä pilvityönkulkujen suunnitteluohjelmaa tai Copilotin sisältävää pilvityönkulkujen suunnitteluohjelmaa. Käytettävän suunnitteluohjelman version voi selvittää siirtymällä Huomautus-osaan artikkelissa Tietoja avustajaominaisuuksia sisältävästä pilvityönkulkujen suunnitteluohjelmasta.

Perinteinen suunnitteluohjelma

1. Lisää toiminto työnkulkuun valitsemalla Uusi vaihe.
2. Kirjoita luettelorivit Hakuyhdistimet ja toiminnot -hakuruutuun Valitse toiminto -kortissa.
3. Valitse Microsoft Dataverse, jos haluat suodattaa hakutulokset niin, että näkyvillä ovat vain Microsoft Dataversen toiminnot ja käynnistimet.
4. Valitse Luettelorivit.
5. Valitse Tilit-taulukko taulukon nimi -luettelosta.
6. Tallenna ja suorita työnkulku, jotta voit varmistaa, että palautettavia rivejä on enintään 5 000.

Muokkaa ehdotustoiminnon avulla

1. Valitse plusmerkki (+) >Lisää toiminto.
2. Kirjoita Lisää toiminto -näytön hakukenttään luettelorivit.
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 sivutus on määritetty ja rivien määrä ylittää määritetyn raja-arvon, vastaus ei sisällä @odata.nextLink-parametria, joka pyytää seuraavan rivijoukon. Poista sivutus käytöstä, jolloin sisältää parametrin @odata.nextLink. Sitä käytetään seuraavan rivijoukon pyytämiseen. Siirry tunnuksen ohittamiseen opettelemaan sen käyttö.

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

Perinteinen suunnitteluohjelma

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

2. Valitse Asetukset.

3. Siirrä Pagination-liukusäätimen Päällä-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.

Muokkaa ehdotustoiminnon avulla

1. Valitse Luettelorivit-kortti.

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

3. Siirrä Pagination-liukusäätimen Päällä-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ärjestää ja laajentaa kyselyn tuloksia.

Perinteinen suunnitteluohjelma

Lisäasetuksia voi määrittää suoraan Luettelorivit-kortissa. Asetukset saadaan näkyviin valitsemalla Näytä lisäasetukset. Kun se valitaan, nimeksi tulee Piilota lisäasetukset.

Muokkaa ehdotustoiminnon avulla

Asetukset voidaan määrittää toiminnon määritysruudussa.

1. Asetukset saadaan näkyviin valitsemalla Luettelorivit-kortti

2. Valitse Parametrit-välilehden avattavassa Lisää uudet parametrit -valikko lisäasetusvaihtoehto.

   

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.

Lisätietoja vakiosuodatusoperaattoreista ja kyselyfunktioista, joiden avulla suodatuskyselyn lausekkeet muodostetaan.

Tietyt merkit, kuten &, # ja +, on korvattava niiden URL-koodatulla vastineella. Lisätietoja: URL-koodaa erikoismerkit

Tärkeää

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

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. Sellaisia voivat olla esimerkiksi primarycontactid($select=contactid,fullname), jolla noudetaan tilin primarycontactid-tunnuksen avulla fullname-sarake liittyvältä yhteyshenkilöltä, jonka tunnus vastauksessa on contactid.

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.

Sitä voi käyttää työnkulun vaiheessa, syöttämällä tämän OData-lausekkeen Laajenna kysely -kenttään: primarycontactid(contactid,fullname). Tällä tavoin haetaan kunkin tilin primarycontactid-arvon contactid- ja fullname-sarakkeet.

Rivimäärä

Osoittaa Dataversen palautettavien rivien määrätyn määrän. Tässä esimerkissä näytetään, miten pyydetään 10 riviä.

Fetch Xml -kysely

Koostekyselyjä ei tueta tällä hetkellä, kun Luettelorivit-toimintoa käytetään FetchXML-kyselyjen kanssa. Erillistä operaattoria kuitenkin tuetaan.

Perinteinen suunnitteluohjelma

Dataverse-tyylisen FetchXML-kyselyn avulla voidaan muodostaa mukautettuja kyselyjä entistä joustavammin. Näitä kyselyjä voidaan käyttää muokattaessa taulukoita, joilla on useita liittyviä taulukoita, tai käsiteltäessä sivutusta. Seuraavassa näyttökuvassa näytetään, miten FetchXML:ää käytetään.

Kirjoita seuraava Fetch Xml -kysely -kenttään.

Koska erittelyoperaattoria ei tueta tällä hetkellä suoraan rivien luettelointiyhdistimen FetchXML-kyselyissä, rivien kaksoiskappaleita voidaan poistaa union-funktiolla. Esimerkiksi rivien luettelointiyhteys voidaan muuntaa Valinta-toiminnolla tietyksi tarvittavaksi matriisimuodoksi, jonka jälkeen union(body(‘Select’),body(‘Select’))-lausekkeella luodaan muuttuja hakemaan matriisi, jossa on erilliset rivit.

Muokkaa ehdotustoiminnon avulla

Dataverse-tyylisen FetchXML-kyselyn avulla voidaan muodostaa mukautettuja kyselyjä entistä joustavammin. Näitä kyselyjä voidaan käyttää muokattaessa taulukoita, joilla on useita liittyviä taulukoita, tai käsiteltäessä sivutusta. Seuraavassa näyttökuvassa näytetään, miten FetchXML:ää käytetään.

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>

Koska erittelyoperaattoria ei tueta tällä hetkellä suoraan rivien luettelointiyhdistimen FetchXML-kyselyissä, rivien kaksoiskappaleita voidaan poistaa union-funktiolla. Esimerkiksi rivien luettelointiyhteys voidaan muuntaa Valinta-toiminnolla tietyksi tarvittavaksi matriisimuodoksi, jonka jälkeen union(body(‘Select’),body(‘Select’))-lausekkeella luodaan muuttuja hakemaan matriisi, jossa on erilliset rivit.

Tunnuksen ohittaminen

Koska Power Automate käyttää sisällön siirtomäärän rajoituksia ja viestien koon rajoituksia yleisten palvelutakuiden varmistamiseen, yleensä kannattaa käyttää sivutusta oletusarvoisen palautettavien taulukkorivien määrän rajoituksen sijaan, jolloin erässä on vähemmän rivejä.

Jos sivutus ei ole käytössä, sivun oletusrajoitus on 5 000 riviä.

Voit käyttää sitä toteuttamalla silmukka, joka jäsentää arvon @odata.nextLink JSON-vastauksessa, poimii ohitustunnuksen ja lähettää sitten toisen pyynnön niin kauan, kunnes tarvittu rivimäärä on saatu.

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

Asetus, joka määrittää partitionId-tunnuksen noudettaessa NoSQL-taulukoiden tietoja. Lisätietoja on ohjeaiheessa Suorituskyvyn parantaminen tallennusosioiden avulla taulukkotietoja käytettäessä.

Liittyvät tiedot

• Opetus: Dataverse-käynnistimien ja -toimintojen käyttäminen Power Automatessa (moduuli)
• Opetus: Power Automate -työnkulkujen ja Dataversen integrointi (oppimispolku)