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 naujas dizaino įrankis arba klasikinis dizaino įrankis debesies srautui konfigūruoti. 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. Ekrane Įtraukti veiksmą įveskite sąrašo eilutes lauke Ieška .
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 nustatote puslapių numeraciją ir eilučių skaičius viršija jūsų konfigūruotą ribą, atsake nėra parametro @odata.nextLink prašyti kito eilučių rinkinio. Išjunkite numeraciją, kad atsakymas apimtų parametrą @odata.nextLink , kurį galite naudoti kito eilučių rinkinio užklausai. 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 slankiklį Numeravimas į padėtį Įjungta , jei dar neįjungta.

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 slankiklį Numeravimas į padėtį Įjungta , jei dar neįjungta.

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 rikiuoti, filtruoti, išdėstyti ir išplėsti užklausos rezultatus.

Naujas dizaineris

Parinkčių nustatymas veiksmų konfigūravimo srityje.

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

2. Skirtuke Parametrai pasirinkite išplėstinę parinktį išplečiamajame meniu Išplėstiniai parametrai .

   

Klasikinis dizaineris

Išplėstinės parinktys nustatomos tiesiogiai 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.

Pateikti visus metaduomenis

Šis parametras kontroliuoja, ar norite įkelti visus stulpelius iš lentelės, ar tik pagrindinius, kad našumas būtų geresnis. Jei jo nenustatysite, veiksmas automatiškai pateiks visus metaduomenis, jei jūsų srautas naudoja dinaminį turinį arba reiškinius, kuriems jo reikia.

Pasirinkite stulpelius

Įveskite kableliais atskirtų stulpelių, kurie turi būti pateikti, sąrašą, pvz name,createdon,preferredcontactmethodcode,emailaddress1,telephone1 ., skirtą lentelei Paskyra.

Filtruoti eilutes

Naudokite šį lauką norėdami apibrėžti "OData" stiliaus filtro išraišką, kad susiaurintumėte eilučių rinkinį, kurį pateikia "Dataverse", pvz createdon ge 2021-01-01T00:00:00-00:00 ., eilučių, sukurtų daugiau nei 2021 m. arba jai lygu.

Sužinokite, kaip filtruoti eilutes , kad būtų galima kurti filtro užklausos reiškinius.

Pakeiskite tam tikrus simbolius, pvz., &, #ir +, jų URL koduotu atitikmeniu. Daugiau informacijos žr. URL, koduojantis specialiuosius simbolius.

Svarbu

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

Rikiuoti pagal

Naudokite šį lauką norėdami apibrėžti "OData" stiliaus išraišką, apibrėžiančią elementų 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 šį lauką, jei norite nurodyti "OData" stiliaus išraišką, kuri apibrėžia duomenis, kuriuos "Dataverse" grąžina iš susijusių lentelių, pvz primarycontactid($select=contactid,fullname) ., naudoti kliento pirminįkontaktą , kad gautų viso vardo stulpelį iš susijusio kontakto, kurio ID contactid yra atsake.

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. Sužinokite daugiau Dalyje Lentelių sujungimas naudojant "OData".

Norėdami jį naudoti srauto veiksme, įveskite šį "OData" reiškinį 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

Naudodami parametrą Eilučių skaičius nurodykite, kiek eilučių turi grąžinti "Dataverse".

Iškviesti XML užklausą

Šiuo metu negalite naudoti agregavimo užklausų naudodami veiksmą Sąrašo eilutės su "FetchXML" užklausomis. Tačiau galite naudoti operatorių distinct .

Naujas dizaineris

Naudokite "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 kai tvarkote puslapių numeraciją. Toliau pateiktoje ekrano kopijoje parodyta, kaip naudoti FetchXML.

Svarbu

Puslapių numeracijos parametras nepalaiko "FetchXML" užklausų. Jei norite prašyti daugiau nei 5 000 eilučių, turite valdyti puslapių kaitas tiesiogiai naudodami "FetchXML " užklausą.

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>

Operatorius distinct šiuo metu tiesiogiai nepalaikomas fetchXML užklausose iš veiksmo Sąrašo eilutės , tačiau galite naudoti "union" funkciją , kad pašalintumėte 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 sukurti kintamąjį su išraiška union(body('Select'),body('Select')) , kad gautumėte masyvą su skirtingomis eilutėmis.

Klasikinis dizaineris

Naudokite "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 kai tvarkote puslapių numeraciją. Toliau pateiktoje ekrano kopijoje parodyta, kaip naudoti FetchXML.

Lauke Iškviesti XML užklausą įveskite šį tekstą.

Atskiras operatorius šiuo metu tiesiogiai nepalaikomas fetchXML užklausose iš veiksmo Sąrašo eilutės, todėl naudokite "union" funkciją , kad pašalintumėte pasikartojančias eilutes. Pavyzdžiui, galite naudoti veiksmą Pasirinkti , kad pakeistumėte sąrašo eilučių ryšio atsaką į reikiamą konkretų masyvo formatą, tada sukurti kintamąjį su reiškiniu union(body('Select'),body('Select')) , kad gautumėte masyvą su skirtingomis eilutėmis.

Praleidimo atpažinimo ženklas

Power Automate taiko turinio pralaidumo apribojimus ir pranešimų dydžio apribojimus, kad užtikrintų bendrąsias paslaugų garantijas. Norėdami dirbti pagal šiuos apribojimus, naudokite puslapių numeraciją , kad būtų pateiktas mažesnis eilučių skaičius pakete, o ne numatytieji pateikiamų lentelės eilučių skaičiaus apribojimai.

Jei nenaudojate puslapių numeracijos, numatytasis puslapių limitas yra 5 000 eilučių.

Norėdami naudoti puslapių numeraciją, įdiekite ciklą, kad išanalizuotumėte reikšmę JSON atsakyme \@odata.nextLink , išskleiskite praleisto atpažinimo ženklą ir nusiųskite kitą užklausą, kol išvardysite 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

Nurodykite partitionId , kada nuskaitomi elastinių lentelių duomenys. Norėdami sužinoti daugiau, žr. Elastinių lentelių skaidymas ir horizontalus mastelis.

Susijusi informacija

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