|
|---|
Каждый виджет изначально принадлежит какому-то одному порталу, но может быть использован (размещен) и на других порталах.
Порталы используют одинаковые, общие портальные виджеты.
Вы можете создавать новые виджеты или использовать готовые, настроенные ранее. Чтобы получить доступ к уже настроенным виджетам, надо раскрыть список виджетов каждого портала (кликнув левой кнопкой мыши на названии портала в левой части экрана).

Интерфейс редактирования портала
Для добавления существующего виджета на портал нажмите на кнопку
в правом верхнем углу сетки. Откроется окно добавления виджета. Если блок уже добавлен в текущий портал, он будет отмечен галочкой.

Добавление виджетов на портал в режиме Dashboard
После добавления виджета на портал можно открыть его настройки по кнопке
или удалить его с портала по кнопке
в правом нижнем углу внутри блока.
Размеры отображаемых на портале виджетов можно регулировать, растягивая их границы, — для этого надо потянуть мышью правый нижний угол виджета с маркером. Если включен флажок фиксированного режима, виджеты будут изначально добавляться в минимально возможном размере.
Создание виджета
Создать новый виджет можно нажатием на кнопку
в панели инструментов конструктора порталов. Откроется форма создания нового виджета. При создании доступны для ввода опции во вкладке Основные настройки. После сохранения становится доступна вкладка Дополнительные настройки с соответствующим выбранному типу набором параметров.

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

Окно настроек виджета (разные варианты, в зависимости от типа виджета)
Параметр |
Описание |
|
|---|---|---|
Доступен для групп |
Виджет могут видеть только участники указанных групп |
|
Название виджета |
Наименование виджета (в свободной форме). Справа от поля доступна кнопка локализации, нажатие на нее откроет модальное окно с возможностью задать локализованное значение названию виджета. ![]() Локализация названия виджета |
|
Модуль |
Выбор модуля, к которому относится данный виджет. Если модуль не выбран, виджет находится в глобальном модуле |
|
Название виджета по смарт-выражению |
Смарт-выражение, возвращающее заголовок виджета. Если не указано, то используется поле Название виджета В смарт-выражениях вы можете обращаться к значениям фильтра и к ID виджета — они находятся в папке Параметры события Показ формы. Значения параметров поля Фильтр передаются в параметре @eventParam1 в формате JSON, а идентификатор виджета — в параметре @eventParam2. В параметре @eventParam1 дата передается как строка в формате '30.11.2019', а период — как JSON вида {"from":"01.11.2019","to":"30.11.2019 23:59"} |
|
Тип виджета |
Тип информации, которая будет отображаться в виджете.
|
|
Контекст |
•Портал — виджет будет размещен на портале, •Задача — виджет будет размещен в карточке задачи, в смарт-выражениях в настройках виджета доступен контекст задачи (параметры события "Во время открытия задачи"), •Профиль — виджет будет размещен в профиле пользователя, в смарт-выражениях в настройках виджета доступен контекст пользователя (параметры события "Во время открытия профиля пользователя"). В рамках приложения для всех пользователей в профиле отображается один и тот же виджет или один и тот же портал, который указывается в Общих настройках приложения |
|
Разделы |
Параметр "Разделы" используется для более удобной организации виджетов и распределения их по тематическим разделам. Используется только для конструктора порталов.
|
|
Виджет включен |
Если флажок включен, его можно добавлять на портал в режиме администрирования. Флажок можно отключать на время настройки, тестирования или исправления ошибок. Используется только для конструктора Flex |
|
Скрыть фильтр |
Если настройка активна, то выбранные значения фильтров не будут отображаться в портальном блоке, при этом иконка фильтра останется доступной Фильтр не скрыт: ![]() Фильтр не скрыт Фильтр скрыт: ![]() Фильтр скрыт |
|
Скрываемо пользователем |
Если настройка активна, то пользователь сможет управлять отображением виджета на портале (скрывать и отображать его по желанию). Используется для конструктора Flex |
|
Скрыть шапку |
Полностью отключает функционал шапки: фильтр, кнопку "Назад" в детализации (DrillDown) и т.п. Используется только для конструктора портала |
|
Можно разворачивать |
Если настройка активна, в пользовательском режиме виджет может быть развернут на весь экран — в правом верхнем углу виджета будет доступна кнопка |
|
Режим цвета |
Выбор режима цвета для виджета. Доступные значения: •По умолчанию — применяется к блокам с белым цветом виджета ('#FFF', '#fff', '#FFFFFF', '#ffffff') •Прозрачный •Цвет — после выбора данного значения станет доступен параметр Цвет виджета, в котором можно выбрать или указать значение цвета шапки. |
|
Цвет виджета |
Выбор цвета виджета из доступных в списке значений. Опция отображается, если в параметре Режим цвета выбрано значение Цвет |
|
Легенда из смарт-выражения |
Позволяет задавать и отображать в нижней части графиков легенду — текстовый блок с поддержкой форматирования, иконок, изображений и других элементов. Значение для легенды можно установить как фиксированным текстом, так и через смарт-выражение. При активации поля Легенда из смарт-выражения” опция Легенда из текстового поля становится полем для указания смарта |
|
Легенда |
||
Создать новый виджет |
Ссылка для перехода в окно настроек (отображается только после выбора типа виджета при пустом значении поля "Привязать к виджету") |
|
Открыть настройки |
Ссылка для перехода в окно настроек (отображается только после выбора значения в поле "Привязать к виджету"). Параметр доступен только для отдельных типов виджетов и после выбора типа виджета |
|
Открыть дополнительные настройки |
Ссылка для перехода к настройкам виджета определенного типа |
|
Открыть настройки фильтрации |
Ссылка для перехода к настройкам фильтра |
|
Настроить вставки (js и css) |
Ссылка для перехода к настройкам вставок |
После внесения информации нажмите кнопку Сохранить.
Блоки некоторых типов имеют только перечисленные выше параметры настройки (блоки типов "Задача", "Задачи из Избранного", "Дерево Избранного", "Почтовая папка"). Другие блоки имеют дополнительные параметры настройки, которые описываются в подразделах данного раздела.
Для удаления виджета нажмите кнопку Удалить. Если виджет добавлен в портал, его нельзя удалить. При попытке удаления такого виджета, администратор увидит предупреждение с указанием названий и ID порталов, в которых находится блок.
Хранимые процедуры для виджетов
|
|---|
|
|---|
Для некоторых видов виджетов источниками данных являются хранимые процедуры SQL. К таким процедурам предъявляются следующие требования:
Хранимая процедура для виджета должна иметь следующие входные параметры:
oXmlParam (тип XML) — параметры, необходимые для фильтрации контента, в виде XML-массива;
oDrilldownField (тип Текст) — колонка с описанием данных для детализации;
oDrillDownParams (тип Текст) — параметры детализации;
oUserID (тип Число) – текущий пользователь.
|
|---|
Хранимая процедура может возвращать произвольные данные и произвольный набор колонок. Названия колонок должны быть на латинице без пробелов.
Примеры хранимых процедур для виджетов
Для некоторых видов портальных блоков источниками данных являются хранимые процедуры SQL.
Виджет Рекламации

Отображение блока на портале

Фильтр

Настройки блока
Виджет Объем продаж с детализацией
Отображение виджета на портале

Настройки блока
Пример основной и детальной процедур (см. скриншоты)
|
|---|
Если параметры фильтрации настроены, то в пользовательском интерфейсе у такого виджета в правом верхнем углу отображается кнопка фильтра
, по нажатию на которую открывается окно для отбора данных.

Вызов фильтра виджета в пользовательском режиме
Для настройки фильтров в интерфейсе администратора перейдите во вкладку Настройки фильтрации:

Настройки фильтрации
Пример настройки фильтрации для виджетов:
Фильтры для виджетов (9:30 мин.)
|
|---|
Переход к настройкам из пользовательского интерфейса
Перейти в дополнительные настройки виджета можно из пользовательского интерфейса. Администраторам доступен пункт Настроить виджет в контекстном меню при клике правой кнопкой мыши на виджет в портале. Выбор пункта откроет соответствующий раздел режима администрирования.

Переход к настройкам из пользовательского режима
Вызов виджета вне портала
Блок может отображаться как на портале, так и на отдельной странице. Строка вызова блока имеет вид:
~/spa/portal/block/{BlockID}
Пример:
~/spa/portal/block/123
где 123 — это ID блока.