retrieveMultipleRecords

เรียกใช้คอลเลกชันของระเบียนตาราง

พร้อมใช้งานสําหรับ

แอปแบบจําลองข้อมูลและพอร์ทัล

ไวยากรณ์

context.webAPI.retrieveMultipleRecords(entityLogicalName, options, maxPageSize).then(successCallback, errorCallback);

พารามิเตอร์

ชื่อ	ประเภท	ต้องมี	คำอธิบาย
ชื่อ entityLogicalName	สตริง	ใช่	ชื่อตรรกะตารางของระเบียนที่คุณต้องการเรียกใช้ ตัวอย่างเช่น: "บัญชี"
ตัวเลือก	สตริง	ไม่	ตัวเลือกคิวรีระบบ OData หรือคิวรี FetchXML เพื่อดึงข้อมูลของคุณ ตัวเลือกคิวรีของระบบต่อไปนี้ได้รับการสนับสนุน: $select$top$filter$expand และ$orderby หากต้องการระบุคิวรี FetchXML ให้ใช้ fetchXml คอลัมน์เพื่อระบุคิวรี หมายเหตุ: คุณต้องใช้ตัวเลือกแบบสอบถามของระบบ $select เพื่อจํากัดคุณสมบัติที่ส่งกลับสําหรับระเบียนตารางโดยการรวมรายการคุณสมบัติที่คั่นด้วยจุลภาค การจํากัดคอลัมน์ที่คุณเรียกใช้เป็นแนวทางปฏิบัติที่ดีที่สุดเพื่อประสิทธิภาพการทํางานที่สําคัญ ถ้าไม่ได้ระบุคุณสมบัติโดยใช้ $select คุณสมบัติทั้งหมดจะถูกส่งกลับ คุณระบุตัวเลือกแบบสอบถามที่ขึ้นต้นด้วย? คุณยังสามารถระบุตัวเลือกคิวรีของระบบหลายตัวได้โดยใช้ & เพื่อแยกตัวเลือกคิวรี
maxPageSize	หมายเลข	ไม่	ระบุจํานวนบวกที่ระบุจํานวนเรกคอร์ดตารางที่จะแสดงต่อหน้า ถ้าคุณไม่ได้ระบุพารามิเตอร์นี้ ค่าเริ่มต้นจะถูกส่งผ่านเป็น 5,000 ถ้าจํานวนเรคคอร์ดที่ถูกดึงมานั้นมากกว่าค่าnextLinkที่ระบุ maxPageSize คอลัมน์ในออบเจ็กต์ สัญญาที่ส่งคืน จะมีลิงก์เพื่อดึงข้อมูลตารางชุดถัดไป
successCallback	ฟังก์ชัน	ไม่	ฟังก์ชันที่จะเรียกใช้เมื่อมีการเรียกใช้ระเบียนตาราง วัตถุที่มีคอลัมน์ต่อไปนี้จะถูกส่งผ่านไปยังฟังก์ชัน: เอนทิตี: อาร์เรย์ของออบเจ็กต์ JSON ที่แต่ละวัตถุแสดงระเบียนตารางที่เรียกใช้ที่มีคอลัมน์และค่าเป็น key: value คู่ รหัสของเรกคอร์ดตารางจะถูกดึงตามค่าเริ่มต้น nextLink: สตริง ถ้าจํานวนระเบียนที่ดึงมานั้นมากกว่าค่าที่ระบุใน maxPageSize พารามิเตอร์ในคําขอ คอลัมน์นี้จะแสดง URL เพื่อส่งกลับชุดระเบียนถัดไป
errorCallback	ฟังก์ชัน	ไม่	ฟังก์ชันที่จะเรียกใช้เมื่อการดําเนินการล้มเหลว

ค่าส่งกลับ

ชนิด: สัญญา<RetrieveMultipleResponse>

คําอธิบาย: ส่งกลับ RetrieveMultipleResponse สัญญาที่มีอาร์เรย์ของออบเจ็กต์ JSON ที่ประกอบด้วยเรกคอร์ดตารางที่ดึงมาและพารามิเตอร์ nextLink ที่มี URL ชี้ไปที่ชุดระเบียนถัดไปในกรณีที่มีการระบุการแบ่งหน้า (maxPageSize) ในคําขอ และจํานวนเรกคอร์ดที่ส่งกลับเกินค่าการแบ่งหน้า มีพารามิเตอร์ต่อไปนี้:

พารามิเตอร์	ค่าส่งกลับ	คำอธิบาย
เอน ทิ ตี	Entity[]	อาร์เรย์ของออบเจ็กต์ JSON ที่แต่ละวัตถุแสดงระเบียนตารางที่เรียกใช้ที่มีคอลัมน์และค่า
nextLink	string	ถ้าจํานวนระเบียนที่ดึงมานั้นมากกว่าค่าที่ระบุในพารามิเตอร์ 'maxPageSize' ในคําขอ พารามิเตอร์นี้จะส่งกลับ URL เพื่อส่งกลับชุดระเบียนถัดไป

บทความที่เกี่ยวข้อง

API เว็บ
การอ้างอิง API ของเฟรมเวิร์กคอมโพเนนต์ Power Apps
ภาพรวมเฟรมเวิร์กคอมโพเนนต์ใน Power Apps