Відображення настроюваних піктограм разом із значеннями у вигляді списку
Адміністратори й настроювачі середовища Power Apps можуть додавати графіку до подання та встановлювати логіку, що використовується для вибору графіки залежно від значень стовпців, за допомогою JavaScript. Ця можливість дає змогу настроїти подання списку, які відображають піктограми разом із текстом або числовими значеннями.
Цей зразок відображає настроювані піктограми у поданні для таблиці потенційної угоди, яка доступна з певними програмами, наприклад, Dynamics 365 Sales. Ви можете відображати настроювані піктограми в поданнях з іншими стандартними таблицями, наприклад таблицями «Бізнес-партнер» і «Контактні особи», а також настроюваними таблицями.
![Подання «Усі потенційні угоди» у стовпці «Оцінка» з відображенням піктограм і текстових значень.](media/icon-in-opportunity-view.png "Подання "Усі потенційні угоди" у стовпці "Оцінка" з відображенням піктограм і текстових значень")
Настроювані піктограми в поданнях списків можуть відображатися в єдиному інтерфейсі, застарілому веб-клієнті, програмі для мобільних пристроїв і App for Outlook.
Примітка
Користувацькі значки недоступні, коли додаток працює в мобільному режимі офлайн.
Додайте настроювану графіку та JavaScript як веб-ресурси
Створіть нові графічні файли, необхідні для настроювання. Рекомендуємо розмір піктограми 16x16 пікселів (великі зображення будуть стиснені).
Напишіть одну або кілька функцій JavaScript, які визначають, які піктограми показувати для яких значень (зазвичай потрібно одну функцію для кожного стовпця, який потрібно настроїти). Кожна функція має прийняти об'єкт рядок даних і код мови (LCID) якості вхідних даних і повертають масив, що містить зображення ім'я та текст підказки. Щоб побачити приклад функції, див. Приклад функції JavaScript нижче в цій статті.
Увійдіть до середовища як адміністратор і відкрийте провідник рішень.
Відкриється спливне вікно Рішення за промовчанням. Перейдіть до Компоненти > Веб-ресурси тут.
Зараз ви будете завантажувати власну графіку по одній як веб-ресурси. Щоб створити новий веб-ресурс, натисніть Створити на панелі інструментів. Інше спливаюче вікно відкривається, щоб допомогти вам створити ресурс. Виконайте такі кроки.
Укажіть зрозуміле Ім'я для нового ресурсу. Це ім'я, яке ви будете використовувати для посилання на кожне графічне зображення з коду JavaScript.
Встановіть Тип для графічного форматі, який ви використовували, щоб зберегти графічний файл (PNG, JPEG або GIF).
Виберіть Вибрати файл, щоб відкрити вікно браузера файл. Використовуйте, щоб знайти і вибрати графічний файл.
Додайте Коротке ім'я та/або Опис при бажанні.
Натисніть Зберегти, а потім закрийте вікно Веб-ресурс.
Повторіть попередній крок для кожного графічного файлу, що у вас є.
Тепер додається JavaScript як кінцевий веб-ресурс. Щоб створити новий веб-ресурс, виберіть Створити на панелі інструментів. Інше спливаюче вікно відкривається, щоб допомогти вам створити ресурс. Виконайте такі дії:
Укажіть зрозуміле Ім'я для нового ресурсу.
Встановіть Тип у значення Сценарій (JScript).
Натисніть Текстовий редактор (поруч із параметром Тип ), щоб відкрити вікно текстового редактора. Вставте код Javascript тут і натисніть ОК, щоб зберегти його.
Додайте Коротке ім'я та/або Опис при бажанні.
Натисніть Зберегти, а потім закрийте вікно Веб-ресурс.
Поки спливаюче вікно Стандартне рішення ще відкрито, розгорніть гілку Компоненти > Таблиці і знайдіть таблиці, які потребують настроювання.
Розгорніть ваші таблиці та виберіть піктограму Подання.
Тепер відображається список подань для вибраної таблиці. Виберіть перегляд у списку. Потім відкрийте спадний список Додаткові дії на панелі інструментів і виберіть Редагувати.
Спливаюче вікно відкривається з елементами керування для редагування вибраного вигляду. Воно показує кожен стовпець, який є частиною перегляду. Натисніть потрібний стовпець та натисніть кнопку Змінити властивості у полі Поширені завдання. Відкриється діалогове вікно Змінити властивості стовпця; зробіть тут такі настройки:
Веб-ресурс: Укажіть ім'я веб-ресурсу, створеного вами для утримання функцій Javascript (натисніть кнопку перегляду, щоб вибрати зі списку).
Ім'я функції: введіть ім'я функції, яке ви написали для зміни вибраного стовпця та вигляду.
Натисніть ОК, щоб закрити діалогове вікно Змінити властивості стовпця.
Щоб зберегти вигляд, натисніть кнопку Зберегти й закрити.
Повторіть ці дії для кожної таблиці, подання та стовпця, якщо необхідно.
Коли ви будете готові, натисніть Опублікувати всі настроювання, щоб опублікувати зміни. Тоді ви можете закрити вікно Рішення за замовчуванням.
Приклад функції JavaScript
Функції JavaScript для відображення нестандартних піктограм та підказок очікують такі два аргументи: весь об'єкт рядка, вказаний у layoutxml, та ідентифікатор локалізації (LCID), користувача, який подав запит. Параметр LCID дозволяє вказати текст підказки різними мовами. Додаткові відомості про мови, що підтримуються середовищем, див. в розділах Увімкнення мов та Інсталяція або оновлення мовних пакетів. Щоб переглянути список значень ідентифікаторів локалізації (LCID), які можна використовувати у вашому коді, див. Ідентифікатори локалізації, присвоєні Microsoft.
Припускаючи, що ви будете додавати користувацькі піктограми для типу атрибуту зі встановленими опціями, який має обмежений набір попередньо визначених опцій, радимо використовувати ціле значення опцій замість етикетки, щоб уникнути проблем локалізації.
Примітка: якщо для отримання даних необхідно визначити піктограму, єдиний інтерфейс підтримує повернення об'єкта JavaScript Promise, який вирішується до логічного значення (аналогічно правилам стрічки). Не використовуйте синхронний XMLHttpRequest (XHR) у настроюваній функції.
На зразку коду нижче відображені піктограми та підказки, що базуються на одному з трьох значень (1: гаряче, 2: тепло, 3: холодно) в атрибуті (рейтинг). Зразок коду також показує, як відобразити локалізований текст підказки. Щоб цей зразок працював, ви повинні створити три веб-ресурси із зображеннями 16х16 з такими іменами: new_Hot, new_Warm, І new_Cold.
Важливо
Цей зразок вимагає таблиці потенційної угоди, яка доступна з програмою Dynamics 365 Sales.
function displayIconTooltip(rowData, userLCID) {
var str = JSON.parse(rowData);
var coldata = str.opportunityratingcode_Value;
var imgName = "";
var tooltip = "";
switch (parseInt(coldata,10)) {
case 1:
imgName = "new_Hot";
switch (userLCID) {
case 1036:
tooltip = "French: Opportunity is Hot";
break;
default:
tooltip = "Opportunity is Hot";
break;
}
break;
case 2:
imgName = "new_Warm";
switch (userLCID) {
case 1036:
tooltip = "French: Opportunity is Warm";
break;
default:
tooltip = "Opportunity is Warm";
break;
}
break;
case 3:
imgName = "new_Cold";
switch (userLCID) {
case 1036:
tooltip = "French: Opportunity is Cold";
break;
default:
tooltip = "Opportunity is Cold";
break;
}
break;
default:
imgName = "";
tooltip = "";
break;
}
var resultarray = [imgName, tooltip];
return resultarray;
}
Принцип відображення подання настроюваних піктограм
Основні стовпці
У поданні списку сітки настроювані піктограми, що застосовуються до основного стовпця таблиці, заміняють піктограму за замовчуванням, створену системою.
Інші стовпці
У поданні списку сітки настроювані піктограми, що застосовуються до стовпця, що не є основним стовпцем таблиці, відображаються як додаткова піктограма до піктограми за замовчуванням, створеної системою.
Форма картки
Настроювані піктограми замінюють піктограму, створену системою за замовчуванням, коли подання настроєно на використання форми картки.
Статті за темою
Ознайомлення з поданнями програми на основі моделі
Примітка
Розкажіть нам про свої уподобання щодо мови документації? Візьміть участь в короткому опитуванні. (зверніть увагу, що це опитування англійською мовою)
Проходження опитування займе близько семи хвилин. Персональні дані не збиратимуться (декларація про конфіденційність).