Ағындардағы жолдар тізімдерін пайдалану

Құрылымдық сұраумен бір уақытта бірнеше жолды шығарып алу үшін Тізім жолдары Microsoft Dataverse әрекетін пайдаланыңыз.

Жолдар тізімін алыңыз

Тізім жолдары әрекетін ішінен 5000 есептік жазбанықайтару үшін ағыныңызға қосу үшін мына қадамдарды орындаңыз. >Есептік жазбалар кесте Dataverse.

Ескертпе

Power Automate классикалық бұлт ағындарының дизайнерін немесе Copilot көмегімен бұлт ағындарының дизайнерін пайдаланады. Қай дизайнерді пайдаланып жатқаныңызды анықтау үшін Копилот мүмкіндіктері бар бұлт ағындарының дизайнерін түсіну бөліміндегі Ескертпе бөліміне өтіңіз.

Классикалық дизайнер

1. Ағымға әрекет қосу үшін Жаңа қадам таңдаңыз.
2. тізім жолдарынІздеу қосқыштары мен әрекеттерді іздеу жолағына Таңдаңыз. операция карта.
3. Тек Microsoft Dataverse үшін әрекеттер мен триггерлерді көрсету үшін іздеу нәтижелерін сүзу үшін Microsoft Dataverseтаңдаңыз.
4. Тізім жолдары таңдаңыз.
5. Есептік жазбалар кестесін Кесте атауы тізімінен таңдаңыз.
6. 5000-нан көп жол қайтарылмағанын растау үшін ағыныңызды сақтаңыз және іске қосыңыз.

Copilot көмегімен өңдеу

1. Қосу белгісін таңдаңыз (+) >Әрекет қосу.
2. Әрекетті қосу көрінісінде тізім жолдарынІздеу енгізіңіз. >> өрісі.
3. Microsoft Dataverseастында Тізім жолдары (Алдын ала қарау) таңдаңыз.
4. Сол жақтағы Параметрлер қойындысында Кесте атауы ішінен Есептік жазбалар таңдаңыз. a35> ашылмалы мәзір.
5. (<<) таңдау арқылы экранды жабыңыз.

5000-нан астам жолды сұрау үшін беттеуді қосыңыз

Сұраудан 5000-нан астам жолды автоматты түрде алу үшін Беттеу мүмкіндікін Параметрлер бөлімінен қосыңыз.

Беттеу орнатылғанда және жолдар саны конфигурацияланған шекті мәннен асып кетсе, жауап келесі жолдар жинағын сұрау үшін @odata.nextLink параметрін қамтымайды. . Жауап келесі жолдар жинағын сұрау үшін пайдалануға болатын @odata.nextLink параметрін қамтитындай етіп беттеуді өшіріңіз. Оны пайдалану жолын білу үшін Өткізіп жіберу таңбалауышы бөліміне өтіңіз.

Мазмұн өткізу мүмкіндігі шектеулері және хабарлама өлшемі шектеулері жалпы қызмет кепілдіктерін қамтамасыз ету үшін қолданылады.

Классикалық дизайнер

1. Тізім жолдары картасының жоғарғы оң жақ бұрышында мәзірді таңдаңыз (...).

2. Параметрлер түймешігін таңдаңыз.

3. Егер қосылмаған болса, Беттеу слайдерді Қосулы күйіне жылжытыңыз.

4. Шек ішінде сұралған жолдардың ең көп санын енгізіңіз. Ең көп конфигурацияланатын шек – 100 000.

   Ішкі түрде бұл сан әдепкі бет өлшемінің қадамдарымен дөңгелектенеді. Мысалы, егер бұл бет өлшемі 5 000 болса және сіз 7 000 енгізсеңіз, қайтарылған жолдар саны 10 000 болады.

Copilot көмегімен өңдеу

1. Тізім жолдары картаны таңдаңыз.

2. Сол жақтағы тақтада Параметрлер қойындысын >Желілік таңдаңыз.

3. Егер қосылмаған болса, Беттеу слайдерді Қосулы күйіне жылжытыңыз.

4. Шек ішінде сұралған жолдардың ең көп санын енгізіңіз. Ең көп конфигурацияланатын шек – 100 000.

   Ішкі түрде бұл сан әдепкі бет өлшемінің қадамдарымен дөңгелектенеді. Мысалы, егер бұл бет өлшемі 5 000 болса және сіз 7 000 енгізсеңіз, қайтарылған жолдар саны 10 000 болады.

Кеңейтілген параметрлер

Тізім жолдары әрекетінің кеңейтілген опциялары сұрау нәтижелерін сұрыптауға, сүзуге, реттеуге және кеңейтуге мүмкіндік береді.

Классикалық дизайнер

Қосымша опцияларды тікелей Тізім жолдары картасында орнатуға болады. Опцияларды көру үшін Қосымша опцияларды көрсету таңдаңыз. Оны таңдаған кезде, атау Қосымша опцияларды жасыру болып өзгереді.

Copilot көмегімен өңдеу

Параметрлерді әрекетті конфигурациялау аумағында орнатуға болады.

1. Опцияларды көру үшін Тізім жолдары картаны таңдаңыз.

2. Параметрлер қойындысында Жаңа параметрлерді қосу ашылмалы мәзірінен қосымша опцияны таңдаңыз.

   

Бағандар таңдау

Қайтарылатын бағандардың үтірмен бөлінген тізімін енгізіңіз, мысалы, тіркелгі кестесі үшін "атауы, жасалған жері, таңдаулы байланыс әдісі коды, электрондық пошта мекенжайы1, телефон1".

Жолдарды сүзу

Dataverse қайтарылатын жолдар жиынын тарылту үшін OData стиліндегі сүзгі өрнегін анықтау үшін пайдаланыңыз, мысалы құрылған бар жолдар үшін "createdon ge 2021-01-01T00:00:00-00:00" 2021 жылдан үлкен немесе оған тең.

стандартты сүзгі операторларын және сұрау функцияларынСүзгі сұрауын құру үшін пайдалануды үйреніңіз. өрнектер.

&, # және + сияқты белгілі бір таңбаларды олардың URL-кодталған баламасымен ауыстыру қажет. Қосымша ақпарат: URL арнайы таңбаларды кодтайды

Маңызды

Сүзгі өрнектері бұл жолды қамтуы мүмкін емес, $filter=, себебі ол API интерфейстерін тікелей пайдаланған кезде ғана қолданылады.

Сұрыптау әдісі

Элементтердің қайтарылатын ретін анықтайтын OData мәнерінің өрнегін анықтау үшін пайдаланыңыз, мысалы, "атын азайту". Сәйкесінше өсу немесе кему ретін көрсету үшін asc немесе төмен жұрнағын пайдаланыңыз. Әдепкі рет өсу.

Сұрауды кеңейту

Есептік жазбаның Dataverse негізгі контактісін пайдалану үшін primarycontactid($select=contactid,fullname) байланысты кестелерден қайтарылатын деректерді анықтайтын OData мәнері өрнегін көрсету үшін пайдаланыңыз. жауапта толық аты бағанын ID контактісі мен байланысты контактіден шығарып алу үшін.

Сұрауды кеңейту ішінде пайдалануға болатын шарлау сипаттарының екі түрі бар:

1. Бір мәнді шарлау сипаттары көптен-бірге қатынастарды қолдайтын және басқа кестеге сілтеме орнатуға мүмкіндік беретін бағандарды іздеуге сәйкес келеді.

2. Жинақ мәні бар шарлау сипаттары бір-көп немесе көп-көп қатынастарына сәйкес келеді.

Шарлау сипатының атын ғана қоссаңыз, қатысты жолдар үшін барлық сипаттарды аласыз. Қосымша ақпарат алу үшін Сұраныспен байланысты кесте жолдарын шығарып алу бөлімін қараңыз.

Оны ағын қадамында пайдалану үшін Сұрауды кеңейту өрісіне осы Odata өрнегін енгізіңіз: primarycontactid(contactid,fullname). контактид және толық аты бағандарын негізгі контактіді үшін осылай алуға болады. әр шоттың.

Жол саны

Dataverse қайтарылатын жолдардың нақты санын көрсету үшін пайдаланыңыз. Мұнда 10 жолды сұрау жолын көрсететін мысал берілген.

XML сұрауын алу

FetchXML сұрауларымен Тізім жолдары әрекетін пайдалану кезінде агрегация сұрауларына қазіргі уақытта қолдау көрсетілмейді. Дегенмен, ерекше операторға қолдау көрсетіледі.

Классикалық дизайнер

Теңшелетін сұрауларды құруда көбірек икемділікке мүмкіндік беретін Dataverse-стилі FetchXML сұрауын пайдаланыңыз. Бұл сұраулар бірнеше қатысты кестелері бар кестемен жұмыс істегенде немесе беттеуді өңдеу кезінде пайдалы болуы мүмкін. Келесі скриншот FetchXML пайдалану жолын көрсетеді.

Fetch Xml сұрауы өрісіне келесіні теріңіз.

Айрықша операторға қазіргі уақытта Тізім жолдары әрекетіндегі FetchXML сұрауларында тікелей қолдау көрсетілмегендіктен, қайталанатын жолдарды жою үшін біріктіру функциясы қолданылуы мүмкін. Мысалы, Таңдау әрекетін Тізім жолдары қосылымының жауабын қажет арнайы жиым пішіміне түрлендіру үшін пайдалана аласыз, содан кейін жасаңыз. айнымалы өрнегі бар union(body('Select'),body('Select')) әр түрлі жолдар бар массив алу үшін.

Copilot көмегімен өңдеу

Теңшелетін сұрауларды құруда көбірек икемділікке мүмкіндік беретін Dataverse-стилі FetchXML сұрауын пайдаланыңыз. Бұл сұраулар бірнеше қатысты кестелері бар кестемен жұмыс істегенде немесе беттеуді өңдеу кезінде пайдалы болуы мүмкін. Келесі скриншот FetchXML пайдалану жолын көрсетеді.

Есептік жазба кестесіне арналған 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>

Айрықша операторға қазіргі уақытта Тізім жолдары әрекетіндегі FetchXML сұрауларында тікелей қолдау көрсетілмегендіктен, қайталанатын жолдарды жою үшін біріктіру функциясы қолданылуы мүмкін. Мысалы, Таңдау әрекетін Тізім жолдары қосылымының жауабын қажет арнайы жиым пішіміне түрлендіру үшін пайдалана аласыз, содан кейін жасаңыз. айнымалы өрнегі бар union(body('Select'),body('Select')) әр түрлі жолдар бар массив алу үшін.

Таңбалауышты өткізіп жіберу

Өйткені Power Automate жалпы қызмет кепілдіктерін қамтамасыз ету үшін мазмұн өткізу шектеулерін және хабарлама өлшемі шектеулерін қолданады, қайтарылатын кесте жолдары санының әдепкі шектеулерінен гөрі, бумадағы жолдардың азырақ санын қайтару үшін беттеу пайдалану жиі пайдалы.

Беттеуді пайдаланбасаңыз, 5000 жолдан тұратын әдепкі бет шегі қолданылады.

Оны пайдалану үшін, JSON жауабындағы @odata.nextLink мәнін талдау үшін циклды орындаңыз, өткізу белгісін таңдап, қажет жолдар санын тізімдегенше басқа сұрау жіберіңіз.

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

Бөлім ИД

NoSQL кестелерінің деректерін алу кезіндегі бөлік идентификаторын көрсететін опция. Қосымша ақпарат алу үшін Кесте деректеріне қатынасу кезінде сақтау бөлімдерін пайдалану арқылы өнімділікті жақсарту бөлімін қараңыз.