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

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

תחביר

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

Parameters

שם	Type	נדרש	תיאור‬‏‫‬
lookupOptions	Object	כן	הגדרת האפשרויות לפתיחת תיבת הדו-שיח של בדיקת המידע. ראה את המאפיינים של 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
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