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
const 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(
  (success) => console.log(success),
  (error) => console.log(error)
);

Xrm.Utility

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