Отображение виджетов
Виджеты содержат клиентскую и серверную логику, шаблон и стили. Для реального взаимодействия необходимо разместить реализованный виджет на определенном объекте. В SimpleOne вы можете разместить виджет на форме записи или на стра нице портала.
Добавление виджета на форму
Формы обычно отображают набор полей различных типов, иногда разделенных для удобства. Они также могут включать в себя виджеты.
Прежде чем добавить виджет на форму, настройте его, выполнив следующие шаги:
- Создайте виджет. Подробнее о создании виджета читайте в статье Скрипты виджетов.
- Определите поведение и внешний вид виджета, определите его серверную и клиентскую логику.
- Укажите таблицы, на записях которых должен отображаться этот виджет. Эти таблицы можно выбрать в поле Таблицы формы создания виджета. Чтобы указать, что этот виджет должен отображаться в записях дочерних таблиц, используйте атрибут Наследуется.
- Добавьте виджет на форму используя настройку представления формы.
Например, вам необходимо создать виджет для отображения на записях всех дочерних таблиц Задачи ITSM (на инцидентах, запросах на изменение, проблемах и другое).
Для этого при создании виджета укажите в поле Таблицы таблицу Задачи ITSM и установите флажок Наследуется. Виджет будет отображаться на записях таблицы Задачи ITSM и ее дочерних таблиц.
Добавление виджета на страницу портала
Чтобы разместить виджет на странице портала, используйте таблицу Экземпляры виджета (sys_widget_instance). Эти элементы помогают определить конкретное расположение виджетов в соответствии с указанной колонкой портала и настроить параметры виджета с помощью Значений опций схемы.
Чтобы настроить отображение виджета, выполните следующие действия:
- Перейдите в Структура портала → Экземпляры виджетов.
- Нажмите Создать и заполните поля.
- Нажмите Сохранить или Сохранить и выйти, чтобы применить изменения.
Поля формы Экземпляр виджета
| Поля | Обязательно | Описание |
|---|---|---|
| Виджет | Нет | Выберите виджет, который необходимо отобразить. |
| Колонка страницы | Нет | Выберите колонку портала, в которую нужно добавить виджет. Это поле будет предварительно заполнено, если вы откроете эту форму из области связанных списков записи Колонки портала. |
| Значения опций схемы | Нет | Заполните поле переопределенными опциями виджета. |
| Активен | Нет | Установите флажок, чтобы активировать запись экземпляра виджета. |
| Публичный | Нет | Установите этот флажок, чтобы сделать этот экземпляр виджета доступным для неавторизованных пользователей. |
| Порядок | Нет | Укажите порядок расположения виджета в колонке портала. |
Новая запись экземпляра виджета находится в области связанных списков формы записи Виджета и Колонки портала.
Если у вас есть несколько экземпляров одного виджета, чтобы их различать, настройте их опции. Подробнее читайте в разделе Создание опций виджета.
Определение местоположения виджета
Чтобы определить, отображается ли виджет на форме записи, выполните следующие действия:
- Перейдите в Структура портала → Виджеты и откройте нужный виджет.
- Если поле Таблицы заполнено, то виджет отображается на формах записи указанных таблиц.
Другой способ определить, отображается ли виджет в формах записи:
- Откройте нужную запись экземпляра виджета.
- В области Связанные списки откройте вкладку Элементы формы.
- В колонке Секция формы.Форма.Таблица указана таблица.
- В колонке Секция формы.Форма указано имя макета формы.
Чтобы определить, отображается ли виджет на странице портала, выполните следующие действия:
- Перейдите в Структура портала → Виджеты и откройте нужный виджет.
- В области Связанные списки выберите вкладку Экземпляры виджета.
- Откройте необходимую запись.
- Если колонка Колонка страницы имеет значение, виджет находится на странице портала.
Чтобы перейти к настройкам страницы, на которой расположен виджет, выполните следующие действия:
- На форме записи Экземпляра виджета откройте связанную запись Колонки страницы.
- На форме записи Колонки портала откройте связанную запись Строки.
- На форме записи Строки портала откройте связанную запись Контейнера.
- На форме записи Контейнера страницы откройте связанную запись Шаблона страницы.