lookupObjects (مرجع واجهة برمجة تطبيقات العميل)

فتح عنصر تحكم بحث لتحديد عنصر واحد أو أكثر.

بناء الجملة

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

المعلمات

Name	نوع	المطلوب	‏‏الوصف
lookupOptions	Object	‏‏نعم‬	يحدد خيارات فتح مربع حوار البحث. راجع خصائص lookupOptions
successCallback	الدالة	لا	دالة لاستدعاء عند استدعاء عنصر تحكم البحث. يتم تمرير صفيف من الكائنات ذات الخصائص التالية: - entityType:خيط. نوع جدول السجل المحدد في عنصر تحكم البحث. - id:خيط. معرف السجل المحدد في عنصر تحكم البحث. - name:خيط. اسم السجل المحدد في عنصر تحكم البحث.
errorCallback	الدالة	لا	وظيفة للاتصال عند فشل العملية. لا يعتبر فشلا إذا ألغى المستخدم العملية.

خصائص عمليات البحث

lookupOptions يحتوي على الخصائص التالية:

اسم الخاصية	نوع	المطلوب	‏‏الوصف
allowMultiSelect	قيمة منطقية	لا	يشير إلى ما إذا كان البحث يسمح بتحديد أكثر من عنصر واحد.
defaultEntityType	سلسلة	لا	نوع الجدول الافتراضي المراد استخدامه.
defaultViewId	سلسلة	لا	طريقة العرض الافتراضية لاستخدامها.
disableMru	قيمة منطقية	لا	يقرر ما إذا كان سيعرض أحدث عنصر مستخدم (MRU). متوفر فقط للواجهة الموحدة.
entityTypes	Array	‏‏نعم‬	أنواع الجداول المراد عرضها.
filters	مصفوفة الكائنات	لا	يستخدم لتصفية النتائج. يحتوي كل كائن في الصفيف على القيم التالية: - filterXml:خيط. عنصر عامل تصفية FetchXML لتطبيقه. - entityLogicalName:خيط. نوع الجدول الذي سيتم تطبيق عامل التصفية هذا عليه.
searchText	سلسلة	لا	يشير إلى مصطلح البحث الافتراضي لعنصر تحكم البحث. يتم دعم هذا فقط على الواجهة الموحدة.
viewIds	Array	لا	طرق العرض التي ستتوفر في منتقي العرض. يتم دعم طرق عرض النظام فقط.

مثال

//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