ใช้รายการแถวข้อมูลในโฟลว์

ใช้การดำเนินการ รายการของแถว เพื่อดึงข้อมูลหลายแถวพร้อมกันจาก Microsoft Dataverse ด้วยแบบสอบถามที่มีโครงสร้าง

ดึงรายการแถวข้อมูล

ทำตามขั้นตอนเหล่านี้เพื่อเพิ่มการดำเนินการ แสดงรายการแถว ให้กับโฟลว์ของคุณเพื่อส่งคืน มากถึง 5,000 บัญชี จากตาราง บัญชี ใน Dataverse

Power Automate ช่วยให้คุณสามารถใช้ตัวออกแบบใหม่ หรือ ตัวออกแบบคลาสสิก สำหรับการกำหนดค่าโฟลว์คลาวด์ของคุณ ขั้นตอนต่างๆ ในตัวออกแบบทั้งคู่จะคล้ายกัน เรียนรู้เพิ่มเติม (พร้อมตัวอย่าง) ใน ระบุความแตกต่างระหว่างตัวออกแบบใหม่กับตัวออกแบบคลาสสิก

  1. เลือกเครื่องหมายบวก (+) >เพิ่มการดำเนินการ
  2. บนหน้าจอ เพิ่มการดําเนินการ ให้ใส่แถวรายการในเขตข้อมูล ค้นหา
  3. ภายใต้ Microsoft Dataverse เลือก แสดงรายการแถว (พรีวิว)
  4. บนแท็บ พารามิเตอร์ ทางซ้าย ให้เลือก บัญชี ในเมนูดรอปดาวน์ ชื่อตาราง
  5. ปิดหน้าจอโดยเลือก (<<)

เปิดการแบ่งหน้าเพื่อขอมากกว่า 5,000 แถว

หากต้องการรับมากกว่า 5,000 แถวจากการสอบถามโดยอัตโนมัติ ให้เปิดคุณลักษณะ การแบ่งหน้า จาก การตั้งค่า

เมื่อคุณตั้งค่าการแบ่งหน้าและจํานวนแถวเกินขีดจํากัดที่คุณกําหนดค่า การตอบสนองจะไม่รวม @odata.nextLink พารามิเตอร์เพื่อร้องขอแถวชุดถัดไป ปิดการแบ่งหน้าเพื่อให้การตอบกลับมี @odata.nextLink พารามิเตอร์ที่คุณสามารถใช้เพื่อร้องขอแถวชุดถัดไป ไปที่ ข้ามโทเค็น เพื่อเรียนรู้วิธีใช้

ขีดจำกัดปริมาณงานเนื้อหา และ ขีดจำกัดขนาดข้อความ นำไปใช้เพื่อรับประกันการรับประกันบริการทั่วไป

  1. เลือกการ์ด แสดงรายการแถว

  2. บนบานหน้าต่างด้านซ้าย ให้เลือกแท็บ การตั้งค่า>ระบบเครือข่าย

  3. เลื่อนตัวเลื่อน การแบ่งหน้า ไปยังตําแหน่ง เปิด ถ้ายังไม่ได้เปิดใช้งาน

  4. ใน ค่าเกณฑ์ ป้อนจำนวนแถวสูงสุดที่ต้องการ ค่าเกณฑ์ที่กำหนดค่าได้สูงสุดคือ 100,000

    แบบภายใน จำนวนนี้จะถูกปัดเศษตามขนาดหน้าเริ่มต้นที่เพิ่มขึ้น ตัวอย่างเช่น ถ้าขนาดหน้าคือ 5,000 และคุณป้อน 7,000 จำนวนแถวที่ส่งคืนคือ 10,000

ตัวเลือกขั้นสูง

ตัวเลือกขั้นสูงสําหรับการดําเนินการ แถวรายการ ช่วยให้คุณเรียงลําดับ กรอง จัดเรียง และขยายผลลัพธ์ของคิวรี

ตั้งค่าตัวเลือกในบานหน้าต่างการกําหนดค่าการดําเนินการ

  1. หากต้องการดูตัวเลือก ให้เลือกการ์ด แสดงรายการแถว

  2. ในแท็บ พารามิเตอร์ ให้เลือกตัวเลือกขั้นสูงในเมนูดรอปดาวน์ พารามิเตอร์ขั้นสูง

    ภาพหน้าจอของตัวเลือกขั้นสูงสำหรับการดำเนินการแสดงรายการแถวในบานหน้าต่างการดำเนินการการกำหนดค่า

ส่งกลับเมตาดาต้าแบบเต็ม

การตั้งค่านี้จะควบคุมว่าจะโหลดคอลัมน์ทั้งหมดจากตารางหรือเฉพาะคอลัมน์ที่จําเป็นเพื่อประสิทธิภาพการทํางานที่ดีขึ้น หากคุณไม่ได้ตั้งค่าการดําเนินการจะส่งคืนเมตาดาต้าแบบเต็มโดยอัตโนมัติหากโฟลว์ของคุณใช้เนื้อหาหรือนิพจน์แบบไดนามิกที่จําเป็น

เลือกคอลัมน์

ใส่รายการของคอลัมน์ที่คั่นด้วยจุลภาคเพื่อส่งกลับ เช่น name,createdon,preferredcontactmethodcode,emailaddress1,telephone1 สําหรับตาราง Account

กรองแถว

ใช้เขตข้อมูลนี้เพื่อกําหนดนิพจน์ตัวกรองสไตล์ OData เพื่อจํากัดชุดของแถวที่ Dataverse ส่งกลับให้แคบลง เช่น createdon ge 2021-01-01T00:00:00-00:00 สําหรับแถวที่มี createdon มากกว่าหรือเท่ากับปี 2021

เรียนรู้วิธีการกรองแถวเพื่อสร้างนิพจน์คิวรีตัวกรอง

แทนที่อักขระบางตัว เช่น &, #, และ +ด้วย URL ที่เข้ารหัสไว้เทียบเท่า สําหรับข้อมูลเพิ่มเติม ให้ดู อักขระพิเศษของการเข้ารหัส URL

สำคัญ

นิพจน์ตัวกรองต้องไม่มีสตริงนี้ $filter= เนื่องจากมีผลเฉพาะเมื่อคุณใช้ API โดยตรง

เรียงลำดับตาม

ใช้เขตข้อมูลนี้เพื่อกําหนดนิพจน์สไตล์ OData ที่กําหนดลําดับในการส่งคืนหน่วยข้อมูล เช่นname desc ใช้คำต่อท้าย asc หรือ desc เพื่อบ่งชี้จากน้อยไปมากหรือมากไปหาน้อยตามลำดับ ลำดับเริ่มต้นคือจากน้อยไปมาก

ขยายคิวรี

ใช้เขตข้อมูลนี้เพื่อระบุนิพจน์รูปแบบ OData ที่กําหนดข้อมูลที่ Dataverse ส่งกลับจากตารางที่เกี่ยวข้อง เช่น primarycontactid($select=contactid,fullname) เพื่อใช้ primarycontactid ของบัญชีเพื่อดึงข้อมูลคอลัมน์ ชื่อเต็ม จากผู้ติดต่อที่เกี่ยวข้องกับ ID contactid ในการตอบสนอง

มีคุณสมบัติการนำทางสองชนิดที่คุณสามารถใช้ได้ใน ขยายการสอบถาม:

  1. คุณสมบัติการนำทาง ค่าเดียว สอดคล้องกับคอลัมน์การค้นหาที่สนับสนุนความสัมพันธ์แบบกลุ่มต่อหนึ่งและอนุญาตให้คุณตั้งค่าการอ้างอิงไปยังตารางอื่น

  2. คุณสมบัติการนำทางที่มีค่าเป็นคอลเลกชันจะสอดคล้องกับความสัมพันธ์แบบหนึ่งต่อหลายหรือหลายต่อหลาย

ถ้าคุณรวมเฉพาะชื่อของคุณสมบัติการนําทาง คุณจะได้รับคุณสมบัติทั้งหมดสําหรับแถวที่เกี่ยวข้อง เรียนรู้เพิ่มเติมในตารางการรวมโดยใช้ OData

หากต้องการใช้งานในขั้นตอนโฟลว์ ให้ใส่นิพจน์ OData นี้ในเขตข้อมูล ขยายคิวรี: primarycontactid(contactid,fullname) นี่คือวิธีรับคอลัมน์ contactid และ fullname สำหรับ primarycontactid ของแต่ละ บัญชี

จำนวนแถว

ใช้การตั้งค่า จํานวนแถว เพื่อระบุจํานวนแถวที่คุณต้องการให้ Dataverse ส่งกลับ

ดึงข้อมูลคิวรี XML

ในปัจจุบัน คุณไม่สามารถใช้ คิวรีการรวม เมื่อใช้การดําเนินการ List rows กับคิวรี FetchXML ได้ อย่างไรก็ตาม คุณสามารถใช้โอเปอเรเตอร์ distinct ได้

ใช้ คิวรี FetchXML สไตล์ Dataverse ซึ่งมีความยืดหยุ่นมากขึ้นสําหรับการสร้างคิวรีแบบกําหนดเอง คิวรีเหล่านี้จะเป็นประโยชน์เมื่อคุณทํางานกับตารางที่มีตารางที่เกี่ยวข้องหลายตารางหรือเมื่อคุณจัดการกับการแบ่งหน้า ภาพหน้าจอต่อไปนี้แสดงวิธีการใช้ FetchXML

สำคัญ

การตั้งค่าการแบ่งหน้าไม่สนับสนุนคิวรี FetchXML หากต้องการร้องขอมากกว่า 5,000 แถว คุณจําเป็นต้องจัดการการแบ่งหน้าโดยตรงด้วยคิวรี 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>

ในขณะนี้ distinct ตัวดําเนินการไม่ได้รับการสนับสนุนโดยตรงในคิวรี FetchXML จากการดําเนินการ List rows แต่คุณสามารถใช้ ฟังก์ชัน union เพื่อลบแถวที่ซ้ํากันได้ ตัวอย่างเช่น คุณสามารถใช้ การดําเนินการ เลือก เพื่อแปลงการตอบสนองของการเชื่อมต่อ แถว รายการ ไปยังรูปแบบอาร์เรย์เฉพาะที่คุณต้องการ จากนั้นสร้าง ตัวแปร ด้วยนิพจน์ union(body('Select'),body('Select')) เพื่อรับอาร์เรย์ที่มีแถวที่แตกต่างกัน

โทเค็นการข้าม

Power Automate ใช้ขีดจํากัดปริมาณงานเนื้อหาและขีดจํากัดขนาดข้อความเพื่อให้แน่ใจว่าบริการทั่วไปจะรับประกัน หากต้องการทํางานภายในขีดจํากัดเหล่านี้ ให้ใช้การแบ่งหน้าเพื่อส่งคืนจํานวนแถวที่น้อยกว่าในชุดงาน แทนที่จะเป็นขีดจํากัดเริ่มต้นของจํานวนแถวตารางที่ส่งกลับ

ถ้าคุณไม่ใช้การแบ่งหน้า ขีดจํากัดหน้าเริ่มต้นคือ 5,000 แถว

หากต้องการใช้การแบ่งหน้า ให้ใช้ลูปเพื่อแยกวิเคราะห์ค่า \@odata.nextLink ในการตอบกลับ JSON ดึง โทเค็น skip ออกมา แล้วส่งคำขอถัดไปจนกว่าจะแสดงรายการครบตามจำนวนแถวที่คุณต้องการ

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

รหัสพาร์ติชัน

ระบุ partitionId ขณะดึงข้อมูลสําหรับตารางแบบยืดหยุ่น เมื่อต้องการเรียนรู้เพิ่มเติม ดูการแบ่งพาร์ติชันและการปรับมาตราส่วนแนวนอนสําหรับตารางแบบยืดหยุ่น

  • อัปเดตล่าสุดเมื่อ