Sorlisták használata folyamatokban

A Sorok listázása művelettel egyszerre több sort is beolvashat egy strukturált lekérdezéssel Microsoft Dataverse .

Sorok listájának beolvasása

Kövesse az alábbi lépéseket a Sorok listázása művelet hozzáadásához a folyamathoz, hogy legfeljebb 5 000 fiókot adjon vissza a Partnerek táblából Dataverse.

Feljegyzés

Power Automate a klasszikus felhőfolyamat-tervezőt vagy a Copilottal rendelkező felhőfolyamat-tervezőt használja. A használt tervező azonosításához lépjen a Jegyzet szakaszra A felhőfolyamat-tervező ismertetése másodpilótával képességekkel.

Klasszikus tervező

1. Válassza az Új lépés lehetőséget , ha műveletet szeretne hozzáadni a folyamathoz.
2. Írja be a listasorokat az Összekötők és műveletek keresése keresőmezőbe aMűvelet kiválasztása kártyán.
3. Válassza ezt Microsoft Dataverse a lehetőséget a keresési eredmények szűréséhez, hogy csak a műveleteit Microsoft Dataverse és eseményindítóit jelenítse meg.
4. Válassza a Listasorok lehetőséget .
5. Válassza ki a Számlák táblát a Táblanév listából.
6. Mentse el és futtassa a folyamatot, hogy megerősítse, hogy legfeljebb 5000 sor legyen visszaküldve.

Szerkesztés a Copilottal

1. Válassza a pluszjelet (+) >Művelet hozzáadása.
2. A Művelet hozzáadása párbeszédpanelen írja be a listasorokat a Keresés mezőbe.
3. A alatt válassza a Listasorok Microsoft Dataverse (előzetes verzió) lehetőséget.
4. A bal oldali Paraméterek lapon válassza a Fiókok lehetőséget a Táblanév legördülő menüben.
5. Zárja be a képernyőt a ()<< lehetőség kiválasztásával.

Több mint 5000 sor igénylése esetén kapcsolja be a tördelést

Ha automatikusan több mint 5 000 sort szeretne beolvasni egy lekérdezésből, kapcsolja be a Tördelés funkciót a Beállításokban.

Ha a tördelés be van állítva, és a sorok száma meghaladja a konfigurált küszöbérték számát, a válasz nem tartalmazza a @odata.nextLink paramétert a következő sorok kéréséhez. Kapcsolja ki a tördelést, hogy a válasz tartalmazza a következő sorok lekéréséhez használható @odata.nextLink paramétert. A Token kihagyása menüpontban megtudhatja, hogyan kell használni.

A tartalom átviteli sebességére és az üzenetek méretére vonatkozó korlátozások az általános szolgáltatási garanciák biztosítása érdekében érvényesek.

Klasszikus tervező

1. A Listasorok kártya jobb felső sarkában válassza a menüt (...).

2. Válassza a Beállítások lehetőséget.

3. Mozgassa a tördelési csúszkát Be állásba, ha még nincs bekapcsolva.

4. A Küszöbérték mezőbenadja meg a kért sorok maximális számát. A maximálisan konfigurálható küszöbérték 100 000.

   Belsőleg ez a szám az alapértelmezett oldalméret lépéseiben van kerekítve. Ha például az oldalméret 5000, és Ön 7000-et ad meg, a visszaadott sorok száma 10 000.

Szerkesztés a Copilottal

1. Válassza ki a Sorok listázása kártyát .

2. A bal oldali panelen válassza a Beállítások lapot >Hálózatkezelés.

3. Mozgassa a tördelési csúszkát Be állásba, ha még nincs bekapcsolva.

4. A Küszöbérték mezőbenadja meg a kért sorok maximális számát. A maximálisan konfigurálható küszöbérték 100 000.

   Belsőleg ez a szám az alapértelmezett oldalméret lépéseiben van kerekítve. Ha például az oldalméret 5000, és Ön 7000-et ad meg, a visszaadott sorok száma 10 000.

Speciális beállítások

A Sorok listázása művelet speciális beállításai lehetővé teszik a lekérdezések eredményeinek rendezését, szűrését, elrendezését és kiterjesztését.

Klasszikus tervező

A speciális beállításokat közvetlenül a Listasorok kártyán adhatja meg. A beállítások megtekintéséhez válassza a Speciális beállítások megjelenítése lehetőséget. Ha kijelöli, a név Speciális beállítások elrejtése névre változik.

Szerkesztés a Copilottal

A beállításokat a művelet konfigurációja ablaktáblán adhatja meg.

1. A beállítások megtekintéséhez válassza a Sorok listázása kártyát.

2. A Paraméterek lapon válasszon egy speciális beállítást az Új paraméterek hozzáadása legördülő menüből.

   

Oszlopok kiválasztása

Adja meg a visszaadni kívánt oszlopok vesszővel elválasztott listáját, például a "name,createdon,preferredcontactmethodcode,emailaddress1,telephone1" a Partner táblához.

Sorok szűrése

OData-stílusú szűrőkifejezés definiálásával szűkítheti a visszaadott sorok halmazát, például "createdon ge 2021-01-01T00:00:00-00:00" a createdon 2021-nél Dataverse nagyobb vagy azzal egyenlő sorok esetében.

Megtudhatja, hogyan használhat szabványos szűrőoperátorokat és lekérdezési függvényeket szűrőlekérdezési kifejezések létrehozásához .

Bizonyos karaktereket, például &, # és + le kell cserélni az URL-kódolású megfelelőjükre. További információ: Speciális karakterek URL-kódolása

Fontos

A szűrőkifejezések nem tartalmazhatják ezt a sztringet,$filter= , mert csak akkor érvényes, ha közvetlenül használja az API-kat.

Sort by

OData-stílusú kifejezés definiálja az elemek visszaküldésének sorrendjét, például "név leírás". Használja az asc vagy descutótagot a növekvő vagy csökkenő sorrend jelzésére. Az alapértelmezett sorrend a növekvő.

Lekérdezés kibontása

Használatával megadhat egy OData-stílusú kifejezést, amely meghatározza a kapcsolódó táblákból visszaadott adatokat Dataverse , például primarycontactid($select=contactid,fullname) a fiók primarycontactid azonosítójával kérheti le a teljes név oszlopot a válaszban szereplő contactidazonosítóval rendelkező kapcsolódó kapcsolattartótól.

A Lekérdezés kibontása funkcióbankétféle navigációs tulajdonság használható:

1. Az egyértékű navigációs tulajdonságok olyan oszlopok keresésének felelnek meg, amelyek támogatják a több-az-egyhez kapcsolatok, és lehetővé teszik egy másik táblára mutató hivatkozás beállítását.

2. A gyűjteményértékű navigációs tulajdonságok egy-a-többhöz vagy több-a-többhöz kapcsolatok felelnek meg.

Ha csak a navigációs tulajdonság nevét foglalja bele, a kapcsolódó sorok minden tulajdonságát megkapja. További információ: Kapcsolódó táblasorok beolvasása lekérdezéssel.

Ha folyamatlépésben szeretné használni, írja be ezt az Odata-kifejezést a Lekérdezés kibontása mezőbe: . primarycontactid(contactid,fullname) Így szerezheti be az egyes fiókok primarycontactid azonosítójának contactid és fullnameoszlopait.

Sorok száma

A Dataverse által visszaadni kívánt sorok adott számának jelzésére használható. Az alábbi példa 10 sor lekérését mutatja be.

XML-lekérdezés lekérése

Az összesítő lekérdezések jelenleg nem támogatottak, ha a Sorok listázása műveletet FetchXML-lekérdezésekkel használja. A különálló operátor azonban támogatott.

Klasszikus tervező

Használjon a-stílusú Dataverse FetchXML lekérdezést, amely nagyobb rugalmasságot biztosít az egyéni lekérdezések létrehozásához. Ezek a lekérdezések akkor lehetnek hasznosak, ha több kapcsolódó táblát tartalmazó táblával dolgozik, vagy tördelést kezel. Az alábbi képernyőképen a FetchXML használata látható.

Írja be a következőt az XML-lekérdezés lekérése mezőbe.

Mivel a különálló operátor jelenleg nem támogatott közvetlenül a FetchXML lekérdezésekben a Sorok listázása műveletből, az union függvény használható az ismétlődő sorok eltávolítására. Például a Kijelölés művelettel átalakíthatja a Listasorok kapcsolat válaszát a kívánt tömbformátumra, majd létrehozhat egy változóta kifejezéssel union(body('Select'),body('Select')), hogy különálló sorokkal rendelkező tömböt kapjon.

Szerkesztés a Copilottal

Használjon a-stílusú Dataverse FetchXML lekérdezést, amely nagyobb rugalmasságot biztosít az egyéni lekérdezések létrehozásához. Ezek a lekérdezések akkor lehetnek hasznosak, ha több kapcsolódó táblát tartalmazó táblával dolgozik, vagy tördelést kezel. Az alábbi képernyőképen a FetchXML használata látható.

Példa FetchXML lekérdezésre a Partner táblához:

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

Mivel a különálló operátor jelenleg nem támogatott közvetlenül a FetchXML lekérdezésekben a Sorok listázása műveletből, az union függvény használható az ismétlődő sorok eltávolítására. Például a Kijelölés művelettel átalakíthatja a Listasorok kapcsolat válaszát a kívánt tömbformátumra, majd létrehozhat egy változóta kifejezéssel union(body('Select'),body('Select')), hogy különálló sorokkal rendelkező tömböt kapjon.

Kihagyási jogkivonat

Mivel Power Automate tartalomátviteli sebességkorlátokat és üzenetméret-korlátokat alkalmaz az általános szolgáltatási garanciák biztosítása érdekében, gyakran hasznos lapszámozással kevesebb sort visszaadni egy kötegben, nem pedig a visszaadott táblasorok számára vonatkozó alapértelmezettkorlátokat.

Az alapértelmezett 5 000 soros oldalkorlát akkor érvényes, ha nem használ tördelést.

A használatához implementáljon egy hurkot a @odata.nextLink érték elemzéséhez a JSON-válaszban, bontsa ki a kihagyási jogkivonatot , majd küldjön egy másik kérést, amíg meg nem adja a szükséges sorok számát.

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

Partícióazonosító

Lehetőség a partitionId megadására a NoSQL-táblák adatainak lekérésekor. További információ: A teljesítmény javítása tárolópartíciók használatával táblaadatok elérésekor.