Izmantot rindu sarakstus plūsmās

Izmantojiet darbību Saraksta rindas, lai strukturētā vaicājumā vienlaikus izgūtu vairākas rindas Microsoft Dataverse .

Rindu saraksta iegūšana

Veiciet šīs darbības, lai plūsmai pievienotu darbību Saraksta rindas un atgrieztu līdz pat 5 000 kontu no tabulas Konti Dataverse.

Piezīmes

Power Automate izmanto klasisko mākoņa plūsmu noformētāju vai mākoņa plūsmu noformētāju ar Copilot. Lai noteiktu, kuru noformētāju izmantojat, dodieties uz piezīmju sadaļu rakstā Izpratne par mākoņa plūsmu noformētāju ar kopilota iespējām.

Klasisks dizainers

1. Atlasiet Jauna darbība , lai plūsmai pievienotu darbību.
2. Ievadiet sarakstrindasmeklēšanas lodziņā Meklēšanas savienotāji un darbības (Search connectors and actions ) sadaļā Izvēlieties operāciju kartīti.
3. Atlasiet Microsoft Dataverse , lai filtrētu meklēšanas rezultātus un parādītu tikai darbības un trigerus Microsoft Dataverse.
4. Atlasiet Saraksta rindas.
5. Sarakstā Tabulas nosaukums atlasiet tabulu Konti .
6. Saglabājiet un palaidiet plūsmu, lai apstiprinātu, ka tiek atgrieztas ne vairāk kā 5 000 rindas.

Rediģēšana, izmantojot Copilot

1. Atlasiet pluszīmi (+) >Pievienot darbību.
2. Darbības sceen pievienot ievadiet saraksta rindas laukā Meklēt .
3. Sadaļā Microsoft Dataverse atlasiet Saraksta rindas (priekšskatījums).
4. Cilnes Parametri kreisajā pusē nolaižamajā izvēlnē Tabulas nosaukums atlasiet Konti .
5. Aizveriet ekrānu, atlasot (<<).

Paginācijas ieslēgšana, lai pieprasītu vairāk nekā 5 000 rindu

Lai no vaicājuma automātiski iegūtu vairāk nekā 5 000 rindu, sadaļā Iestatījumi ieslēdziet lappušu veidošanas līdzekli.

Ja ir iestatīta lapošana un rindu skaits pārsniedz konfigurētā sliekšņa skaitu, atbildē netiks iekļauts parametrs @odata.nextLink , lai pieprasītu nākamo rindu kopu. Izslēdziet lapošanu, lai atbildē tiktu iekļauts parametrs @odata.nextLink , ko var izmantot, lai pieprasītu nākamo rindu kopu. Dodieties uz Izlaist marķieri , lai uzzinātu, kā to izmantot.

Tiek piemēroti satura caurlaidspējas un ziņojumu lieluma ierobežojumi , lai nodrošinātu vispārējās pakalpojumu garantijas.

Klasisks dizainers

1. Saraksta rindu kartītes augšējā labajā stūrī atlasiet izvēlni (...).

2. Atlasiet Iestatījumi.

3. Pārvietojiet slīdni Pagination pozīcijā Ieslēgts , ja tas vēl nav ieslēgts .

4. Sadaļā Slieksnis ievadiet maksimālo pieprasīto rindu skaitu. Maksimālais konfigurējamais slieksnis ir 100 000.

   Iekšēji šis skaitlis tiek noapaļots ar noklusējuma lappuses izmēru soli. Piemēram, ja šis lappuses lielums ir 5 000 un ievadāt 7 000, atgriezto rindu skaits ir 10 000.

Rediģēšana, izmantojot Copilot

1. Atlasiet kartīti Saraksta rindas .

2. Rūtī pa kreisi atlasiet cilni Iestatījumi >Tīklošana.

3. Pārvietojiet slīdni Pagination pozīcijā Ieslēgts , ja tas vēl nav ieslēgts .

4. Sadaļā Slieksnis ievadiet maksimālo pieprasīto rindu skaitu. Maksimālais konfigurējamais slieksnis ir 100 000.

   Iekšēji šis skaitlis tiek noapaļots ar noklusējuma lappuses izmēru soli. Piemēram, ja šis lappuses lielums ir 5 000 un ievadāt 7 000, atgriezto rindu skaits ir 10 000.

Papildiespējas

Darbības Saraksta rindas papildu opcijas ļauj kārtot, filtrēt, kārtot un paplašināt vaicājuma rezultātus.

Klasisks dizainers

Papildu opcijas var iestatīt tieši kartītē Saraksta rindas . Lai skatītu opcijas, atlasiet Rādīt papildu opcijas. Kad to atlasāt, nosaukums tiek mainīts uz Paslēpt papildu opcijas.

Rediģēšana, izmantojot Copilot

Opcijas var iestatīt darbības konfigurācijas rūtī.

1. Lai skatītu opcijas, atlasiet kartīti Saraksta rindas .

2. Cilnes Parametri nolaižamajā izvēlnē Pievienot jaunus parametrus atlasiet papildu opciju .

   

Kolonnu atlase

Ievadiet ar komatu atdalītu atgriežamo kolonnu sarakstu, piemēram, tabulas Konts ievadiet ar komatu atdalītu sarakstu ar kolonnām, piemēram, "name,createdon,preferredthoughtmethodcode,emailaddress1,phone1".

Filtrēt rindas

Izmantojiet, lai definētu OData stila filtra izteiksmi, lai sašaurinātu atgriezto rindu Dataverse kopu, piemēram, "createdon ge 2021-01-01T00:00:00-00:00" rindām, kuru izveide ir lielāka vai vienāda ar 2021. gadu.

Uzziniet, kā izmantot standarta filtru operatorus un vaicājumu funkcijas , lai izveidotu filtrēšanas vaicājuma izteiksmes.

Noteiktas rakstzīmes, piemēram , &,, # un + tās ir jāaizstāj ar to URL kodēto ekvivalentu. Papildinformācija: URL kodē speciālās rakstzīmes

Svarīgi

Filtra izteiksmēs nevar būt šī virkne,$filter= , jo tā tiek lietota tikai tad, ja API izmantojat tieši.

Kārtot pēc

Izmantojiet, lai definētu OData stila izteiksmi, kas definē secību, kādā tiek atgriezti vienumi, piemēram, "name desc". Izmantojiet asc vai desc sufiksu , lai norādītu attiecīgi augošā vai dilstošā secībā. Noklusējuma secība ir augošā secībā.

Izvērst vaicājumu

Izmantojiet, lai norādītu OData stila izteiksmi, kas definē datus, kas Dataverse atgriežas no saistītajām tabulām, piemēram primarycontactid($select=contactid,fullname) , izmantojot konta primārokontaktid, lai izgūtu pilnu vārda kolonnu no atbildē norādītās saistītās kontaktpersonas ar ID contactid .

Programmā Izvērst vaicājumu var izmantot divu veidu navigācijas rekvizītus:

1. Vienas vērtības navigācijas rekvizīti atbilst uzmeklēšanas kolonnām, kas atbalsta relācijas daudzi pret vienu, un ļauj iestatīt atsauci uz citu tabulu.

2. Kolekcijas vērtības navigācijas rekvizīti atbilst relācijām viens pret daudziem vai daudzi pret daudziem.

Ja iekļausit tikai navigācijas rekvizīta nosaukumu, saņemsit visus saistīto rindu rekvizītus. Papildinformāciju skatiet rakstā Saistīto tabulas rindu izgūšana ar vaicājumu.

Lai to izmantotu plūsmas solī, ievadiet šo Odata izteiksmi laukā Izvērst vaicājumu : primarycontactid(contactid,fullname). Tas ir veids, kā iegūt kontaktpersonas id un pilna vārda kolonnas katra konta primārajamkontaktid .

Rindu skaits

Izmantojiet, lai norādītu konkrētu atgriežamo rindu Dataverse skaitu. Tālāk ir sniegts piemērs, kurā parādīts, kā pieprasīt 10 rindas.

Fetch XML vaicājums

Apkopošanas vaicājumi pašlaik netiek atbalstīti , izmantojot darbību Saraksta rindas ar FetchXML vaicājumiem. Tomēr tiek atbalstīts atšķirīgais operators.

Klasisks dizainers

Izmantojiet stila Dataverse FetchXML vaicājumu, kas nodrošina lielāku elastību pielāgotu vaicājumu veidošanā. Šie vaicājumi var būt noderīgi, strādājot ar tabulu, kurā ir vairākas saistītas tabulas, vai veicot lapošanu. Tālāk redzamajā ekrānuzņēmumā ir parādīts, kā lietot FetchXML.

Laukā Ienest Xml vaicājumu ierakstiet sekojošo .

Tā kā atšķirīgais operators pašlaik netiek atbalstīts tieši FetchXML vaicājumos no darbības Saraksta rindas, apvienošanas funkciju var izmantot, lai noņemtu rindu dublikātus. Piemēram, varat izmantot darbību Atlasīt, lai pārveidotu savienojuma Saraksta rindas atbildi noteiktā nepieciešamajā masīva formātā, pēc tam izveidojiet mainīgo ar izteiksmju savienību(pamatteksts('Atlasīt'),pamatteksts('Atlasīt'))), lai iegūtu masīvu ar atšķirīgām rindām.

Rediģēšana, izmantojot Copilot

Izmantojiet stila Dataverse FetchXML vaicājumu, kas nodrošina lielāku elastību pielāgotu vaicājumu veidošanā. Šie vaicājumi var būt noderīgi, strādājot ar tabulu, kurā ir vairākas saistītas tabulas, vai veicot lapošanu. Tālāk redzamajā ekrānuzņēmumā ir parādīts, kā lietot FetchXML.

FetchXML vaicājuma piemērs tabulai Konts:

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

Tā kā atšķirīgais operators pašlaik netiek atbalstīts tieši FetchXML vaicājumos no darbības Saraksta rindas, apvienošanas funkciju var izmantot, lai noņemtu rindu dublikātus. Piemēram, varat izmantot darbību Atlasīt, lai pārveidotu savienojuma Saraksta rindas atbildi noteiktā nepieciešamajā masīva formātā, pēc tam izveidojiet mainīgo ar izteiksmju savienību(pamatteksts('Atlasīt'),pamatteksts('Atlasīt'))), lai iegūtu masīvu ar atšķirīgām rindām.

Izlaišanas marķieris

Tā kā tiek lietoti Power Automate satura caurlaidspējas un ziņojumu lieluma ierobežojumi , lai nodrošinātu vispārējas pakalpojumu garantijas, bieži vien ir lietderīgi izmantot lapošanu , lai atgrieztu mazāku rindu skaitu paketē, nevis atgriezto tabulas rindu skaita noklusējuma ierobežojumus.

Noklusējuma lappušu ierobežojums 5,000 rindas tiek piemērots, ja neizmantojat lapiņu.

Lai to izmantotu, ieviesiet cilpu, lai JSON atbildē parsētu vērtību @odata.nextLink , izvilktu izlaišanas marķieri un pēc tam nosūtītu vēl vienu pieprasījumu, līdz esat norādījis nepieciešamo rindu skaitu.

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

Nodalījuma ID

Iespēja norādīt partitionId, izgūstot datus NoSQL tabulām. Papildinformāciju skatiet rakstā Veiktspējas uzlabošana, izmantojot krātuves nodalījumus, piekļūstot tabulas datiem.