lookupObjects (חומר עזר עבור API של לקוח)

פתיחת פקד בדיקת מידע כדי לבחור פריט אחד או יותר.

תחביר

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

Parameters

שם Type נדרש תיאור‬‏‫‬
lookupOptions בדיקת מידעאפשרויות כן הגדרת האפשרויות לפתיחת תיבת הדו-שיח של בדיקת המידע.
successCallback פונקציה לא פונקציה להתקשרות כאשר פקד בדיקת המידע מופעל. הפונקציה מקבלת מערך של אובייקטים עם המאפיינים הבאים:
- entityType:מחרוזת. סוג הטבלה של הרשומה שנבחרה בפקד בדיקת המידע.
- id:מחרוזת. מזהה הרשומה שנבחרה בפקד בדיקת המידע.
- name:מחרוזת. שם הרשומה שנבחרה בפקד בדיקת המידע.
errorCallback פונקציה לא פונקציה שיש לקרוא לה כאשר הפעולה נכשלת. הוא אינו נחשב לכשל אם המשתמש מבטל את הפעולה.

בדיקת מידעמאפיינים של אפשרויות

lookupOptions כולל את המאפיינים הבאים:

שם מאפיין Type נדרש תיאור‬‏‫‬
allowMultiSelect בוליאני לא ציון אם בדיקת המידע מאפשרת בחירה של יותר מפריט אחד.
defaultEntityType String לא סוג הטבלה המשמש כברירת מחדל לשימוש.
defaultViewId String לא תצוגת ברירת המחדל לשימוש.
disableMru בוליאני לא קובע אם להציג את הפריט האחרון שהיה בשימוש (MRU).
זמין עבור ממשק מאוחד בלבד.
entityTypes מערך כן סוגי הטבלאות שיוצגו.
filters מערך אובייקטים לא משמש לסינון התוצאות. כל אובייקט במערך מכיל את הערכים הבאים:
- filterXml:מחרוזת. רכיב המסנן FetchXML להחלה.
- entityLogicalName:מחרוזת. סוג הטבלה שעליו יש להחיל מסנן זה.
searchText String לא ציון מונח החיפוש המוגדר כברירת מחדל עבור פקד בדיקת המידע. ערך זה נתמך בממשק מאוחד בלבד.
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