Настройка обработчиков событий для формы
Эта тема относится к Dynamics 365 Customer Engagement (on-premises). Версию этой темы для Power Apps см. по адресу: Настройка обработчиков событий форм приложений на основе модели
Обработчики событий форм для форм Dynamics 365 Customer Engagement (on-premises) можно настроить для следующих областей в форме:
| Элемент | Мероприятие | Описание |
|---|---|---|
| Форма | OnLoad |
Возникает при загрузке формы. |
OnSave |
Возникает при сохранении данных. | |
| Вкладка | TabStateChange |
Возникает при развертывании или сворачивании вкладки. |
| Поле | OnChange |
Возникает, когда данные в поле меняются и элемент управления теряет фокус. |
| Интернет-кадр | OnReadyStateComplete |
Возникает при загрузке содержимого интернет-кадра. |
Обработчик событий состоит из ссылки на веб-ресурс JavaScript и функции, определенной в веб-ресурсе, который будет выполняться при возникновении события. Для каждого элемента может быть настроено до 50 отдельных обработчиков событий.
Внимание
Неправильная настройка обработчика событий может привести к ошибках в скриптах, которые могут стать причиной того, что форма не будет загружаться или будет работать неправильно. Если вы не являетесь разработчиком скрипта, убедитесь, что вы точно знаете, какие параметры конфигурации требуются для скрипта.
Не настраивайте обработчик событий скрипта с помощью библиотеки, которая не поступает из доверенного источника. Скрипты можно использовать для выполнения любого действия пользователя, и плохо написанный скрипт может существенно снизить быстродействие формы.
После настройки обработчика событий всегда тестируйте его, чтобы убедиться, что он работает правильно.
Настройка обработчика событий
В редакторе форм выберите элемент с событием, обработчик которого требуется настроить.
На вкладке "Домашняя страница" в группе Правка выберите Изменить свойства или просто дважды щелкните элемент.
В диалоговом окне свойств элемента перейдите на вкладку События.
Разверните область Библиотеки форм. Если библиотеки, содержащей функцию, которую требуется установить в качестве обработчика событий, еще нет в списке, добавьте библиотеку.
Добавление библиотеки форм в обработчик событий:
В разделе Библиотеки форм группы Список событий выберите Добавить.
Найдите веб-ресурс JavaScript в списке доступных веб-ресурсов. Выберите его, затем выберите Добавить.
Если требуемый веб-ресурс JavaScript не существует, выберите Создать, чтобы открыть форму создания веб-ресурса, и создайте веб-ресурс.
Создание веб-ресурса JavaScript:
В форме веб-ресурса задайте следующие свойства.
Свойство Значение Полное имя Необходимые. Введите имя веб-ресурса. Отображаемое имя Необходимые. Введите имя для отображения в списке веб-ресурсов. Описание Необязательно. Введите описание веб-ресурса. Тип Необходимые. Выберите Скрипт (JScript). Язык Необязательно. Выберите один из языков, доступных для организации. Если скрипт был предоставлен, настоятельно рекомендуется нажать кнопку Обзор, чтобы найти файл и отправить его.
Также можно выбрать кнопку Текстовый редактор и вставить или ввести содержимое скрипта в диалоговом окне Изменить контент.
Заметка
Поскольку этот простой текстовый редактор не предоставляет никаких функций для проверки правильности скрипта, обычно всегда рекомендуется использовать отдельное приложение, такое как Visual Studio, чтобы изменить скрипты, а затем отправить их.
Выберите Сохранить и закройте диалог веб-ресурса.
Созданный веб-ресурс теперь выбран в диалоговом окне Поиск записи. Выберите Добавить, чтобы закрыть диалог.
В разделе Обработчики событий выберите событие, для которого требуется задать обработчик событий.
Выберите Добавить, чтобы открыть диалог Свойства обработчика.
На вкладке Сведения выберите соответствующий библиотеку и введите имя функции, которая должна выполняться для события.
Обработчик событий включен по умолчанию. Снимите флажок Включено, если не требуется включать это событие.
Для некоторых функций требуется передать контекст выполнения в функцию. Установите флажок Передача контекста выполнения в качестве первого параметра, если это необходимо.
Некоторые функции могут принимать набор параметров для управления поведением функции. Если они необходимы, введите их в раздел Список параметров, разделенных запятыми, который будет передан функции.
На вкладке Зависимости добавьте все поля, от которых зависит скрипт, в область Зависимые поля.
Выберите ОК, чтобы закрыть диалог Свойства обработчика.
При вводе обработчика событий можно изменить порядок выполнения функции по отношению к любым другим функциям с помощью зеленых стрелок для перемещения вверх или вниз.
Выберите OK, чтобы закрыть диалог свойств элемента.
Выберите Сохранить, чтобы сохранить изменения. Выберите Опубликовать, чтобы опубликовать форму.
Заметка
Хотя пользовательский интерфейс позволяет откорректировать порядок загрузки скриптов с помощью зеленых стрелок вверх и вниз, на самом деле скрипты загружаются не последовательно.