lookupObjects (довідник із API клієнта)

Відкриває елемент керування підстановкою, щоб вибрати один або кілька елементів.

Синтаксис

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

Параметри

Ім'я	Тип	Обов'язковий	Опис
lookupOptions	Об'єкт	Так	Визначає параметри відкриття діалогового вікна підстановки. Переглянути властивості lookupOptions
successCallback	Function	Ні	Функція, яка викликається, коли викликається елемент керування підстановкою. Передано масив об'єктів із такими властивостями: - entityType:Рядок. тип таблиці запису, вибраного в елементі керування підстановки. - id:Рядок. Ідентифікатор запису, вибраного в елементі керування підстановки. - name:Рядок. Ім'я запису, вибраного в елементі керування підстановки.
errorCallback	Function	Ні	Функція для виклику, коли операція не вдається. Помилка не вважається невдалою, якщо користувач скасує операцію.

властивості lookupOptions

lookupOptions має такі властивості:

Ім'я властивості	Тип	Обов'язковий	Опис
allowMultiSelect	логічний	Ні	Указує, чи дозволяє підстановка вибрати кілька елементів.
defaultEntityType	Рядок	Ні	Тип таблиці за промовчанням.
defaultViewId	Рядок	Ні	Стандартне подання.
disableMru	логічний	Ні	Визначає, чи відображати останній використаний елемент (MRU). Доступно лише для уніфікованого інтерфейсу.
entityTypes	Масив	Так	Типи таблиць для відображення.
filters	Масив об'єктів	Ні	Використовується для фільтрування результатів. Кожен об'єкт у масиві містить такі значення: - filterXml:Рядок. Елемент фільтра FetchXML, який потрібно застосувати. - entityLogicalName:Рядок. Тип таблиці, до якої потрібно застосувати цей фільтр.
searchText	Рядок	Ні	Указує термін пошуку за промовчанням для елемента керування підстановки. Ця функція підтримується лише в єдиному інтерфейсі.
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