Перейти к основному содержимому
Версия: 1.21.3

Отображение виджетов

Виджеты содержат клиентскую и серверную логику, шаблон и стили. Для реального взаимодействия необходимо разместить реализованный виджет на определенном объекте. В SimpleOne вы можете разместить виджет на форме записи или на странице портала.

Добавление виджета на форму


Формы обычно отображают набор полей различных типов, иногда разделенных для удобства. Они также могут включать в себя виджеты.

Прежде чем добавить виджет на форму, настройте его, выполнив следующие шаги:

  1. Создайте виджет. Подробнее о создании виджета читайте в статье Скрипты виджетов.
    • Определите поведение и внешний вид виджета, определите его серверную и клиентскую логику.
    • Укажите таблицы, на записях которых должен отображаться этот виджет. Эти таблицы можно выбрать в поле Таблицы формы создания виджета. Чтобы указать, что этот виджет должен отображаться в записях дочерних таблиц, используйте атрибут Наследуется.
  2. Добавьте виджет на форму используя настройку представления формы.
примечание

Например, вам необходимо создать виджет для отображения на записях всех дочерних таблиц Задачи ITSM (на инцидентах, запросах на изменение, проблемах и другое).

Для этого при создании виджета укажите в поле Таблицы таблицу Задачи ITSM и установите флажок Наследуется. Виджет будет отображаться на записях таблицы Задачи ITSM и ее дочерних таблиц.

Добавление виджета на страницу портала


Чтобы разместить виджет на странице портала, используйте таблицу Экземпляры виджета (sys_widget_instance). Эти элементы помогают определить конкретное расположение виджетов в соответствии с указанной колонкой портала и настроить параметры виджета с помощью Значений опций схемы.

Чтобы настроить отображение виджета, выполните следующие действия:

  1. Перейдите в Структура портала → Экземпляры виджетов.
  2. Нажмите Создать и заполните поля.
  3. Нажмите Сохранить или Сохранить и выйти, чтобы применить изменения.

Поля формы Экземпляр виджета

ПоляОбязательноОписание
ВиджетНетВыберите виджет, который необходимо отобразить.
Колонка страницыНетВыберите колонку портала, в которую нужно добавить виджет. Это поле будет предварительно заполнено, если вы откроете эту форму из области связанных списков записи Колонки портала.
Значения опций схемыНетЗаполните поле переопределенными опциями виджета.
АктивенНетУстановите флажок, чтобы активировать запись экземпляра виджета.
ПубличныйНетУстановите этот флажок, чтобы сделать этот экземпляр виджета доступным для неавторизованных пользователей.
ПорядокНетУкажите порядок расположения виджета в колонке портала.

Новая запись экземпляра виджета находится в области связанных списков формы записи Виджета и Колонки портала.

подсказка

Если у вас есть несколько экземпляров одного виджета, чтобы их различать, настройте их опции. Подробнее читайте в разделе Создание опций виджета.

Определение местоположения виджета


Чтобы определить, отображается ли виджет на форме записи, выполните следующие действия:

  1. Перейдите в Структура портала → Виджеты и откройте нужный виджет.
  2. Если поле Таблицы заполнено, то виджет отображается на формах записи указанных таблиц.
примечание

Другой способ определить, отображается ли виджет в формах записи:

  1. Откройте нужную запись экземпляра виджета.
  2. В области Связанные списки откройте вкладку Элементы формы.
  3. В колонке Секция формы.Форма.Таблица указана таблица.
  4. В колонке Секция формы.Форма указано имя макета формы.

Чтобы определить, отображается ли виджет на странице портала, выполните следующие действия:

  1. Перейдите в Структура портала → Виджеты и откройте нужный виджет.
  2. В области Связанные списки выберите вкладку Экземпляры виджета.
  3. Откройте необходимую запись.
    • Если колонка Колонка страницы имеет значение, виджет находится на странице портала.
примечание

Чтобы перейти к настройкам страницы, на которой расположен виджет, выполните следующие действия:

  1. На форме записи Экземпляра виджета откройте связанную запись Колонки страницы.
  2. На форме записи Колонки портала откройте связанную запись Строки.
  3. На форме записи Строки портала откройте связанную запись Контейнера.
  4. На форме записи Контейнера страницы откройте связанную запись Шаблона страницы.