Настроювання обробників подій форми у програмі на основі моделі

Обробники подій форми Power Apps можуть бути налаштовані для таких областей у формі:

Елемент	Захід	Опис
Форма	OnLoad	Виникає, коли форма завантажується.
	OnSave	Виникає, якщо дані зберігаються.
Табуляція	TabStateChange	Виникає, коли вкладку розгортають або згортають.
Стовпчик	OnChange	Виникає, коли дані в стовпці змінюються і елемент керування втрачає фокус.
IFRAME	OnReadyStateComplete	Виникає під час завантаження вмісту IFRAME.

Обробник події містить посилання на веб-ресурс JavaScript і в цьому веб-ресурсі визначено функцію, яка буде виконуватися, коли подія відбувається. Для кожного елемента може бути сконфігуровано до окремих 50 обробників подій.

Важливо

Неправильне настроювання обробника подій може призвести до помилок сценарію, які можуть спричинити те, що форму не вдасться завантажити або вона працюватиме неправильно. Якщо ви не розробник сценарію, переконайтеся, що ви розумієте, які саме параметри конфігурації сценарій вимагає.

Не налаштовуйте сценарій обробника подій за допомогою бібліотеки не з джерела, якому ви довіряєте. Сценарії можуть використовуватися для виконання будь-яких дій, які користувач може виконувати і погано написаний сценарій може значно зашкодити швидкодії форми.

Після настроювання обробника подій завжди перевіряйте, чи він працює належним чином.

Налаштуйте обробника подій

У наведеній далі процедурі описано настроювання обробника подій для форми. Для настроювання обробника подій для вкладки, стовпця або IFrame використовуйте подібні кроки.

1. Виконайте вхід до Power Apps, відкрийте потрібну вам таблицю, потім відкрийте форму в конструкторі форм, для якої ви бажаєте налаштувати обробника подій.

2. Залежно від стану бібліотеки виконайте вибір одного з наведених далі варіантів.

   • Якщо вже доступна бібліотека, що містить функцію, яку ви бажаєте задати в якості обробника подій, у області властивостей справа в розділі Основна форма бізнес-партнера виберіть вкладку Події, потім перейдіть до кроку 3.
   • Якщо бібліотека, що містить потрібну функцію, ще недоступна, на панелі переходів ліворуч виберіть Бібліотеки форм, потім виберіть пункт Додати бібліотеку.
     1. На сторінці Додати бібліотеку JavaScript виберіть Створити.
     2. На новій вкладці браузера заповніть властивості, щоб створити веб-ресурс JScript, потім натисніть кнопку Зберегти, потім виберіть пункт Опублікувати. Докладніше див. у розділі: Створіть веб-ресурс JavaScript
     3. Закрийте вкладку браузера й поверніться до списку Додати бібліотеку JavaScript.
     4. Виберіть у списку веб-ресурс JavaScript, натисніть кнопку Додати, потім виберіть вкладку Події.

     Примітка

     Щоб оновити список, може знадобитися вибрати Скасувати, а потім вибрати пункт Додати бібліотеку.

3. На вкладці Події виберіть Обробника подій, заповніть наведену далі інформацію для налаштування події форми, потім виберіть Готово.

   • Тип події:

     • При збереженні: коли запис після змінення поля форми зберігається.
     • При завантаженні: коли форма відкривається.

   • Бібліотека: веб-ресурс JavaScript.

   • Функція: ім'я функції у веб-ресурсі JavaScript, яка має бути виконана для події.

   • Увімкнуто: обробника подій за замовчуванням увімкнуто. Зніміть прапорець Увімкнуто, якщо ви не бажаєте вмикати цю подію.

   • Передавати контекст виконання як перший параметр: для деяких функцій потрібно передавати функції контекст виконання. Виберіть Передавати контекст виконання як перший параметр, якщо потрібно.

   • Список параметрів із роздільниками-комами, який буде передано до функції: деякі функції можуть приймати набір параметрів для керування поведінкою функції. Якщо це вимагається, введіть їх у Список параметрів із роздільниками-комами, який буде передано до функції.

   • Залежності стовпців таблиці: для подій При збереженні вибирайте стовпці, в яких ви хочете, щоб запускалася подія після збереження запису.

     

4. Збережіть, потім Опублікуйте форму.

Налаштуйте обробника подій класичним способом

1. У класичному редакторі форм виберіть елемент із подією, для якої слід налаштувати обробника.

2. На вкладці Домашня сторінка, у групі Редагувати, натисніть Змінити властивості або двічі натисніть на елемент.

3. У діалоговому вікні властивостей елемента виберіть вкладку Події.

4. Розгорніть область Бібліотеки форм. Якщо бібліотеку, що містить функцію, яку потрібно встановити як обробник події, не зазначено, додайте цю бібліотеку.

5. Додавання бібліотеки форм до обробника подій:

   1. У розділі Бібліотеки форм у Списку подій виберіть Додати.

   2. Знайдіть веб-ресурс JavaScript у списку доступних веб-ресурсів. Виберіть, потім натисніть Додати.

      Якщо веб-ресурс JavaScript, який вам потрібний, не існує, натисніть кнопку Створити, щоб відкрити нову форму веб-ресурсу і створити його.

   3. Для створення веб-ресурсу JavaScript див. розділ Створіть веб-ресурс JavaScript.

   4. У діалоговому вікні Пошук рядка буде вибрано новий веб-ресурс, що ви створили. Виберіть кнопку Додати, щоб закрити діалогове вікно.

6. У розділі Обробники подій, виберіть подію, для якої потрібно встановити обробник подій.

7. Виберіть кнопку Додати, щоб відкрити діалогове вікно Властивості обробника.

8. На вкладці Деталі виберіть відповідну бібліотеку та введіть ім'я функції, яка повинна виконуватися для події.

9. За промовчанням обробник події увімкнуто. Зніміть прапорець Увімкнуто, якщо ви не хочете вмикати цю подію.

   Деякі функції вимагають, щоб до них передавався контекст виконання. Виберіть Передавати контекст виконання як перший параметр, якщо потрібно.

   Деякі функції можуть прийняти набір параметрів для керування поведінкою функції. Якщо потрібно, введіть їх у розділі Список параметрів із роздільниками-комами, який буде передано до функції.

10. На вкладці Залежності додайте стовпці, від яких залежить сценарій, в область Залежні стовпці.

11. Виберіть кнопку ОК, щоб закрити діалогове вікно Властивості обробника.

12. Коли обробник події введено, ви можете задати порядок, у якому функції виконуватиметься, використовуючи зелені стрілки для переміщення вгору або вниз.

13. Виберіть кнопку ОК, щоб закрити діалогове вікно властивостей елемента.

14. Натисніть кнопку Зберегти, щоб застосувати зміни. Щоб опублікувати форму, виберіть кнопку Опублікувати.

Примітка

Хоча інтерфейс користувача дає змогу настроїти порядок, в якому сценарії завантажуються за допомогою зелених стрілок угору та вниз, сценарії фактично не завантажуються послідовно.

Створіть веб-ресурс JavaScript

1. Введіть таку інформацію у форму веб-ресурсу:

   Властивість	Значення
   Назва	Обов’язково Ім'я веб-ресурсу.
   Коротке ім'я	Обов’язково Введіть ім'я, що відображатиметься у списку веб-ресурсів.
   Опис	Необов'язково. Опис веб-ресурсу.
   Тип	Обов’язково Виберіть Сценарій (JScript).
   Мова	Необов'язково. Виберіть одну з мов, які доступні для вашої організації.

2. Якщо ви користуєтеся сценарієм, ми настійно рекомендуємо вам використовувати кнопку Огляд, щоб знайти файл та завантажити його.

Крім того, можна вибрати кнопку Текстовий редактор та вставити або ввести вміст сценарію у діалоговому вікні Редагування вмісту.

Примітка

Оскільки цей простий текстовий редактор не надає яких-небудь функцій, щоб перевірити правильність роботи сценарію, зазвичай ви повинні завжди намагатися використовувати окрему програму, таку як Visual Studio, щоб редагувати сценарії, а потім завантажувати їх.

3. Виберіть кнопку Зберегти та закрийте сторінку веб-ресурсу.

Наступні кроки

Покрокові інструкції: написання першого клієнтського сценарію
Використання основної форми і її компонентів

Примітка

Розкажіть нам про свої уподобання щодо мови документації? Візьміть участь в короткому опитуванні. (зверніть увагу, що це опитування англійською мовою)

Проходження опитування займе близько семи хвилин. Персональні дані не збиратимуться (декларація про конфіденційність).