lookupObjects (การอ้างอิง API ไคลเอ็นต์)

เปิดตัวควบคุมการค้นหาเพื่อเลือกอย่างน้อยหนึ่งรายการ

ไวยากรณ์

Xrm.Utility.lookupObjects(lookupOptions).then(successCallback, errorCallback)

พารามิเตอร์

ชื่อ	ประเภท	ต้องมี	คำอธิบาย
lookupOptions	วัตถุ	ใช่	กําหนดตัวเลือกสําหรับการเปิดกล่องโต้ตอบการค้นหา ดู คุณสมบัติ lookupOptions
successCallback	ฟังก์ชัน	ไม่	ฟังก์ชันที่จะเรียกใช้เมื่อมีการเรียกใช้ตัวควบคุมการค้นหา อาร์เรย์ของวัตถุที่มีคุณสมบัติต่อไปนี้ถูกส่งผ่าน: - entityType:เชือก ชนิดตารางของเรกคอร์ดที่เลือกในตัวควบคุมการค้นหา - id:เชือก รหัสของเรกคอร์ดที่เลือกในตัวควบคุมการค้นหา - name:เชือก ชื่อของเรกคอร์ดที่เลือกในตัวควบคุมการค้นหา
errorCallback	ฟังก์ชัน	ไม่	ฟังก์ชันที่จะเรียกใช้เมื่อการดําเนินการล้มเหลว ซึ่งไม่ถือว่าเป็นความล้มเหลวถ้าผู้ใช้ยกเลิกการดําเนินการ

คุณสมบัติ lookupOptions

lookupOptions มีคุณสมบัติต่อไปนี้:

ชื่อคุณสมบัติ	ประเภท	ต้องมี	คำอธิบาย
allowMultiSelect	แบบบูลีน	ไม่	ระบุว่าการค้นหาอนุญาตให้มีการเลือกมากกว่าหนึ่งรายการหรือไม่
defaultEntityType	สตริง	ไม่	ชนิดตารางเริ่มต้นที่จะใช้
defaultViewId	สตริง	ไม่	มุมมองเริ่มต้นที่จะใช้
disableMru	แบบบูลีน	ไม่	ตัดสินใจว่าจะแสดงรายการที่ใช้ล่าสุด (MRU) หรือไม่ พร้อมใช้งานสําหรับอินเทอร์เฟซแบบรวมเท่านั้น
entityTypes	อาร์เรย์	ใช่	ชนิดตารางที่จะแสดง
filters	อาร์เรย์ของวัตถุ	ไม่	ใช้เพื่อกรองผลลัพธ์ แต่ละออบเจ็กต์ในอาร์เรย์ ประกอบด้วยค่าต่อไปนี้: - filterXml:เชือก องค์ประกอบตัวกรอง FetchXML ที่จะนําไปใช้ - entityLogicalName:เชือก ชนิดตารางที่จะใช้ตัวกรองนี้
searchText	สตริง	ไม่	ระบุคําค้นหาเริ่มต้นสําหรับตัวควบคุมการค้นหา ซึ่งได้รับการสนับสนุนเฉพาะบนอินเทอร์เฟซแบบรวม
viewIds	อาร์เรย์	ไม่	มุมมองที่พร้อมใช้งานในตัวเลือกมุมมอง สนับสนุนเฉพาะมุมมองระบบเท่านั้น

ตัวอย่าง

//define data for lookupOptions
var lookupOptions = 
{
   defaultEntityType: "account",
   entityTypes: ["account"],
   allowMultiSelect: false,
   defaultViewId:"0D5D377B-5E7C-47B5-BAB1-A5CB8B4AC10",
   viewIds:["0D5D377B-5E7C-47B5-BAB1-A5CB8B4AC10","00000000-0000-0000-00AA-000010001003"],
   searchText:"Allison",
   filters: [{filterXml: "<filter type='or'><condition attribute='name' operator='like' value='A%' /></filter>",entityLogicalName: "account"}]
};

// Get account records based on the lookup Options
Xrm.Utility.lookupObjects(lookupOptions).then(
  function(success){
console.log(success);},
function(error){console.log(error);});

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

Xrm.Utility