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