Eilučių sąrašų naudojimas srautuose

Norėdami vienu metu gauti kelias eilutes iš naudodami struktūrizuotą užklausą, naudokite veiksmą Eilučių sąrašas Microsoft Dataverse .

Gaukite eilučių sąrašą

Atlikite šiuos veiksmus, kad pridėtumėte veiksmą Eilučių sąrašo rodymas į savo srautą, kad iš lentelės Sąskaitos , esančios , būtų grąžinta iki 5000 sąskaitų Dataverse.

Power Automate leidžia naudoti arba **naująjį** dizaino įrankį**,** arba klasikinį dizaino įrankį**, kad sukonfigūruotumėte debesies srautą. ... Abiejų dizainerių žingsniai yra panašūs. Sužinokite daugiau (su pavyzdžiais) skiltyje Nustatykite skirtumus tarp naujojo ir klasikinio dizainerio.

Naujas dizaineris

1. Pasirinkite pliuso ženklą (+) >Pridėti veiksmą.
2. Scenoje Pridėti veiksmą į paieškos laukelį įveskite „sąrašo eilutės“ .
3. Skiltyje Microsoft Dataverse pasirinkite Sąrašo eilutės (peržiūra).
4. Kairėje pusėje esančiame skirtuke Parametrai išskleidžiamajame meniu Lentelės pavadinimas pasirinkite Paskyros .
5. Uždarykite ekraną pasirinkdami (<<).

Klasikinis dizaineris

1. Pasirinkite Naujas žingsnis , kad pridėtumėte veiksmą prie savo srauto.
2. Įveskite sąrašo eilutes į Paieškos jungčių ir veiksmų paieškos laukelį, esantį Pasirinkite operaciją kortelėje.
3. Pasirinkite Microsoft Dataverse , kad filtruotumėte paieškos rezultatus ir rodytumėte tik veiksmus bei paleidiklius, skirtus Microsoft Dataverse.
4. Pasirinkite Sąrašo eilutės.
5. Pasirinkite lentelę Sąskaitos iš sąrašo Lentelės pavadinimas .
6. Išsaugokite ir paleiskite srautą, kad patvirtintumėte, jog grąžinama ne daugiau kaip 5 000 eilučių.

Įjunkite puslapiavimą, kad galėtumėte pateikti užklausą daugiau nei 5000 eilučių

Norėdami automatiškai gauti daugiau nei 5 000 eilučių iš užklausos, įjunkite **puslapiavimo** funkciją iš **nustatymų**.

Kai nustatytas puslapiavimas ir eilučių skaičius viršija sukonfigūruotą slenkstį, atsakyme nebus parametro @odata.nextLink , kad būtų galima užklausti kito eilučių rinkinio. Išjunkite puslapiavimą, kad atsakyme būtų parametras @odata.nextLink , kurį būtų galima naudoti norint pateikti užklausą dėl kito eilučių rinkinio. Norėdami sužinoti, kaip naudoti, eikite į Praleisti prieigos raktą .

Siekiant užtikrinti bendras paslaugų garantijas, taikomi turinio pralaidumo apribojimai ir pranešimų dydžio apribojimai .

Naujas dizaineris

1. Pasirinkite kortelę Sąrašo eilutės .

2. Kairėje esančioje srityje pasirinkite skirtuką Parametrai >Tinklas.

3. Perkelkite puslapių numeravimo slankiklį į padėtį Įjungta , jei jis dar neįjungtas.

4. Dalyje Slenkstis įveskite maksimalų prašomų eilučių skaičių. Didžiausia konfigūruojama riba yra 100 000.

   Viduje šis skaičius suapvalinamas numatytojo puslapio dydžio žingsniais. Pavyzdžiui, jei puslapio dydis yra 5 000, o jūs įvedate 7 000, pateikiamas 10 000 eilučių skaičius.

Klasikinis dizaineris

1. Viršutiniame dešiniajame kortelės Sąrašo eilutės kampe pasirinkite meniu (...).

2. Paspauskite Parametrai.

3. Perkelkite puslapių numeravimo slankiklį į padėtį Įjungta , jei jis dar neįjungtas.

4. Dalyje Slenkstis įveskite maksimalų prašomų eilučių skaičių. Didžiausia konfigūruojama riba yra 100 000.

   Viduje šis skaičius suapvalinamas numatytojo puslapio dydžio žingsniais. Pavyzdžiui, jei puslapio dydis yra 5 000, o jūs įvedate 7 000, pateikiamas 10 000 eilučių skaičius.

Išplėstinės parinktys

Išplėstinės veiksmo Sąrašo eilutės parinktys leidžia rūšiuoti, filtruoti, tvarkyti ir išplėsti užklausos rezultatus.

Naujas dizaineris

Galite nustatyti parinktis veiksmų konfigūravimo srityje.

1. Norėdami pamatyti parinktis, pasirinkite kortelę Sąrašo eilutės .

2. Skirtuke Parametrai išskleidžiamajame meniu Pridėti naujų parametrų pasirinkite išplėstinę parinktį.

   

Klasikinis dizaineris

Išplėstines parinktis galite nustatyti tiesiai kortelėje Sąrašo eilutės . Norėdami peržiūrėti parinktis, pasirinkite Rodyti išplėstines parinktis. Kai jį pasirenkate, pavadinimas pasikeičia į Slėpti išplėstines parinktis.

Pasirinkite stulpelius

Įveskite grąžintinų stulpelių kableliais atskirtą sąrašą, pvz., lentelės Abonementas "name,createdon,preferredcontactmethodcode,emailaddress1,phone1".

Filtruoti eilutes

Naudokite norėdami apibrėžti "OData" stiliaus filtro išraišką, kad susiaurintumėte grįžtantį eilučių Dataverse rinkinį, pvz., "createdon ge 2021-01-01T00:00:00-00:00" eilutėms, kurių createdon yra didesnis arba lygus 2021 metams.

Sužinokite, kaip naudoti standartinius filtro operatorius ir užklausos funkcijas kuriant filtro užklausos išraiškas.

Tam tikrus simbolius, pvz., &, #ir + juos reikia pakeisti jų URL užkoduotu atitikmeniu. Daugiau informacijos: URL kodavimo specialieji simboliai

Svarbu

Filtro išraiškose negali būti šios eilutės, $filter=, nes ji taikoma tik tada, kai API naudojate tiesiogiai.

Rikiuoti pagal

Naudokite norėdami apibrėžti "OData" stiliaus išraišką, kuri apibrėžia prekių grąžinimo tvarką, pvz., "name desc". Naudokite asc arba desc priesagą , kad nurodytumėte atitinkamai didėjimo arba mažėjimo tvarką. Numatytoji tvarka yra didėjimo tvarka.

Išplėsti užklausą

Naudokite norėdami nurodyti "OData" stiliaus išraišką, apibrėžiančią duomenis, kurie Dataverse gaunami iš susijusių lentelių, pvz., primarycontactid($select=contactid,fullname) naudoti abonemento pirminį kontaktinį ID , kad gautumėte stulpelį Full name iš susijusio kontakto, kurio atsakyme yra ID contactid .

Yra dviejų tipų naršymo ypatybės, kurias galite naudoti dalyje Išplėsti užklausą:

1. Vienos reikšmės naršymo ypatybės atitinka stulpelių, kurie palaiko ryšius "daugelis su vienu" ir leidžia nustatyti nuorodą į kitą lentelę, paiešką.

2. Rinkinio reikšmių naršymo ypatybės atitinka ryšius Vienas su daugeliu arba Daugelis su daugeliu.

Jei įtrauksite tik naršymo ypatybės pavadinimą, gausite visas susijusių eilučių ypatybes. Norėdami sužinoti daugiau, žiūrėkite Susijusių lentelių eilučių gavimas su užklausa.

Norėdami jį naudoti srauto veiksme, įveskite šią Odata išraišką lauke Išplėsti užklausą : primarycontactid(contactid,fullname). Štai kaip gauti kiekvienos paskyros pagrindinio kontaktinio asmens kontakto ID ir viso vardo stulpelius.

Eilučių skaičius

Naudokite norėdami nurodyti konkretų grįžtinų Dataverse eilučių skaičių. Štai pavyzdys, rodantis, kaip pateikti 10 eilučių užklausą.

XML iškvietimo užklausa

Agregavimo užklausos šiuo metu nepalaikomos, kai su užklausomis naudojamas veiksmas Sąrašo eilutės FetchXML . Tačiau palaikomas atskiras operatorius.

Naujas dizaineris

Naudokite a Dataverse stiliaus FetchXML užklausą, kuri suteikia daugiau lankstumo kuriant pasirinktines užklausas. Šios užklausos gali būti naudingos, kai dirbate su lentele, kurioje yra kelios susijusios lentelės, arba tvarkote puslapių numeravimą. Toliau pateiktoje ekrano kopijoje parodyta, kaip naudoti FetchXML.

Lentelės Abonementas užklausos pavyzdys FetchXML :

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

Kadangi atskiras operatorius šiuo metu tiesiogiai nepalaikomas FetchXML užklausose iš veiksmo Sąrašo eilutės, "union" funkciją galima naudoti norint pašalinti pasikartojančias eilutes. Pavyzdžiui, galite naudoti veiksmą Pasirinkti, kad pakeistumėte sąrašo eilučių ryšio atsaką į konkretų jums reikalingą masyvo formatą, tada sukurkite kintamąjį su išraiška union(body('Select'),body('Select'))), kad gautumėte masyvą su atskiromis eilutėmis.

Klasikinis dizaineris

Naudokite a Dataverse stiliaus FetchXML užklausą, kuri suteikia daugiau lankstumo kuriant pasirinktines užklausas. Šios užklausos gali būti naudingos, kai dirbate su lentele, kurioje yra kelios susijusios lentelės, arba tvarkote puslapių numeravimą. Toliau pateiktoje ekrano kopijoje parodyta, kaip naudoti FetchXML.

Lauke "Fetch Xml Query " įveskite:

Kadangi atskiras operatorius šiuo metu tiesiogiai nepalaikomas FetchXML užklausose iš veiksmo Sąrašo eilutės, "union" funkciją galima naudoti norint pašalinti pasikartojančias eilutes. Pavyzdžiui, galite naudoti veiksmą Pasirinkti, kad pakeistumėte sąrašo eilučių ryšio atsaką į konkretų jums reikalingą masyvo formatą, tada sukurkite kintamąjį su išraiška union(body('Select'),body('Select'))), kad gautumėte masyvą su atskiromis eilutėmis.

Praleidimo atpažinimo ženklas

Kadangi Power Automate taikomi turinio pralaidumo ir pranešimo dydžio apribojimai , siekiant užtikrinti bendrąsias paslaugų garantijas, dažnai naudinga naudoti puslapių numeraciją , kad būtų pateiktas mažesnis paketo eilučių skaičius, o ne numatytieji pateiktų lentelės eilučių skaičiaus apribojimai.

Numatytasis 5 000 eilučių puslapio apribojimas taikomas, jei nenaudojate puslapių numeracijos.

Norėdami jį naudoti, įdiekite ciklą, kad išanalizuotumėte @odata.nextLink reikšmę JSON atsakyme, ištraukite praleidimo atpažinimo ženklą ir siųskite kitą užklausą, kol nurodysite reikiamą eilučių skaičių.

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

Skaidinio ID

Galimybė nurodyti „partitionId“ nuskaitant „NoSQL“ lentelių duomenis. Norėdami sužinoti daugiau, žiūrėkite Našumo gerinimas naudojant saugyklos skaidinius pasiekiant lentelės duomenis.

Susijusi informacija

• Mokymas: Naudokite **trigerius** ir veiksmus **modulyje** Dataverse Power Automate
• Mokymai: Integruoti srautus ir (mokymosi kelią) Power Automate Dataverse