lookupObjects (препратка към API на клиент)

Отваря справочна контрола, за да изберете един или повече елементи.

Синтаксис

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

Параметри

Име	Вид	Необходимо	Описание
lookupOptions	Обект	Да	Определя опциите за отваряне на диалоговия прозорец за справка. Вижте свойствата на lookupOptions
successCallback	Function	Не	Функция за извикване, когато се извиква справочната контрола. Предава се масив от обекти със следните свойства: - entityType:Низ. тип на таблицата на записа, избран в контролата за справка. - id:Низ. ИД на записа, избран в контролата за търсене. - name:Низ. Име на записа, избран в контролата за търсене.
errorCallback	Function	Не	Функция, която да се извика, когато операцията е неуспешна. Това не се счита за грешка, ако потребителят отмени операцията.

свойства на lookupOptions

lookupOptions има следните свойства:

Име на свойство	Вид	Необходимо	Описание
allowMultiSelect	булев	Не	Показва дали справката позволява избирането на повече от един елемент.
defaultEntityType	String	Не	Типът таблица по подразбиране, който трябва да се използва.
defaultViewId	String	Не	Изгледът по подразбиране, който да се използва.
disableMru	булев	Не	Решава дали да се покаже последно използваният елемент. Налично само за унифициран интерфейс.
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