Show/Hide Toolbars

Руководство администратора

Виджеты (портальные блоки)

Ссылки Назад Вверх Вперед

term_icon Виджет — портальный блок, который размещается на портале или портальной странице. В зависимости от типа виджета в нем отображается различная информация и меняются настройки виджета. При этом виджеты всех типов имеют общие настройки, такие как права доступа, цвет шапки, иконка и др.

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

Порталы используют одинаковые, общие портальные виджеты.

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

portals-editor-1

Интерфейс редактирования портала

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

portal_page_edit_dashboard-1

Добавление виджетов на портал в режиме Dashboard

После добавления виджета на портал можно открыть его настройки по кнопке portal_page_edit_dashboard-icon-4 или удалить его с портала по кнопке portal_page_edit_dashboard-4 в правом нижнем углу внутри блока.

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

Создание виджета

Создать новый виджет можно нажатием на кнопку portal-new-icon-2 в панели инструментов конструктора порталов. Откроется форма создания нового виджета. При создании доступны для ввода опции во вкладке Основные настройки. После сохранения становится доступна вкладка Дополнительные настройки с соответствующим выбранному типу набором параметров.

new-widget-form-create

Форма создания нового виджета

Основные настройки виджетов

Чтобы открыть окно настройки виджета, нажмите иконку portal_page_edit_dashboard-icon-4 в правом нижнем углу блока. При этом появится окно настроек виджета.

portal_blocks-1

Окно настроек виджета (разные варианты, в зависимости от типа виджета)

Параметр

Описание

Доступен для групп

Виджет могут видеть только участники указанных групп

Название виджета

Наименование виджета (в свободной форме). Справа от поля доступна кнопка локализации, нажатие на нее откроет модальное окно с возможностью задать локализованное значение названию виджета.

portal_blocks-2

Локализация названия виджета

Модуль

Выбор модуля, к которому относится данный виджет. Если модуль не выбран, виджет находится в глобальном модуле

Название виджета по смарт-выражению

Смарт-выражение, возвращающее заголовок виджета. Если не указано, то используется поле Название виджета

В смарт-выражениях вы можете обращаться к значениям фильтра и к ID виджета — они находятся в папке Параметры события Показ формы.

Значения параметров поля Фильтр передаются в параметре @eventParam1 в формате JSON, а идентификатор виджета — в параметре @eventParam2.

В параметре @eventParam1 дата передается как строка в формате '30.11.2019', а период — как JSON вида {"from":"01.11.2019","to":"30.11.2019 23:59"}

Тип виджета

Тип информации, которая будет отображаться в виджете.

warning_icon Типы: Блок кнопок, Блок HTML, Блок статистики, Смарт-блок, На подпись, Задачи из избранного, Дерево избранного, Задача, Почтовая папка, Лента комментариев, Отчет, Сводная таблица, Информация о пользователях являются устаревшими и в настоящее время не поддерживаются

Контекст

Портал — виджет будет размещен на портале,

Задача — виджет будет размещен в карточке задачи, в смарт-выражениях в настройках виджета доступен контекст задачи (параметры события "Во время открытия задачи"),

Профиль — виджет будет размещен в профиле пользователя, в смарт-выражениях в настройках виджета доступен контекст пользователя (параметры события "Во время открытия профиля пользователя").

В рамках приложения для всех пользователей в профиле отображается один и тот же виджет или один и тот же портал, который указывается в Общих настройках приложения

Разделы

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

Используется только для конструктора порталов.

warning_icon Виджеты без указания раздела не доступны для самостоятельного добавления пользователями на дашборды в пользовательском режиме

Виджет включен

Если флажок включен, его можно добавлять на портал в режиме администрирования. Флажок можно отключать на время настройки, тестирования или исправления ошибок.

Используется только для конструктора Flex

Скрыть фильтр

Если настройка активна, то выбранные значения фильтров не будут отображаться в портальном блоке, при этом иконка фильтра останется доступной

Фильтр не скрыт:

portal_blocks_filter_ishidden_false

Фильтр не скрыт

Фильтр скрыт:

portal_blocks_filter_ishidden_true

Фильтр скрыт

Скрываемо пользователем

Если настройка активна, то пользователь сможет управлять отображением виджета на портале (скрывать и отображать его по желанию).

Используется для конструктора Flex

Скрыть шапку

Полностью отключает функционал шапки: фильтр, кнопку "Назад" в детализации (DrillDown) и т.п.

Используется только для конструктора портала

Можно разворачивать

Если настройка активна, в пользовательском режиме виджет может быть развернут на весь экран — в правом верхнем углу виджета будет доступна кнопка binded-06

Режим цвета

Выбор режима цвета для виджета. Доступные значения:

По умолчанию — применяется к блокам с белым цветом виджета ('#FFF', '#fff', '#FFFFFF', '#ffffff')

Прозрачный

Цвет — после выбора данного значения станет доступен параметр Цвет виджета, в котором можно выбрать или указать значение цвета шапки.

Цвет виджета

Выбор цвета виджета из доступных в списке значений. Опция отображается, если в параметре Режим цвета выбрано значение Цвет

Легенда из смарт-выражения

Позволяет задавать и отображать в нижней части графиков легенду — текстовый блок с поддержкой форматирования, иконок, изображений и других элементов. Значение для легенды можно установить как фиксированным текстом, так и через смарт-выражение. При активации поля Легенда из смарт-выражения” опция Легенда из текстового поля становится полем для указания смарта

Легенда

Создать новый виджет

Ссылка для перехода в окно настроек (отображается только после выбора типа виджета при пустом значении поля "Привязать к виджету")

Открыть настройки

Ссылка для перехода в окно настроек (отображается только после выбора значения в поле "Привязать к виджету").

Параметр доступен только для отдельных типов виджетов и после выбора типа виджета

Открыть дополнительные настройки

Ссылка для перехода к настройкам виджета определенного типа

Открыть настройки фильтрации

Ссылка для перехода к настройкам фильтра

Настроить вставки (js и css)

Ссылка для перехода к настройкам вставок

После внесения информации нажмите кнопку Сохранить.

Блоки некоторых типов имеют только перечисленные выше параметры настройки (блоки типов "Задача", "Задачи из Избранного", "Дерево Избранного", "Почтовая папка"). Другие блоки имеют дополнительные параметры настройки, которые описываются в подразделах данного раздела.

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

Хранимые процедуры для виджетов

warning_icon Обратите внимание: данный раздел актуален для MSSQL. У PostgreSQL имеется своя специфика работы с хранимыми процедурами — как правило они используются для выполнения обновления данных. Для получения значений рекомендуется использовать пользовательские функции или представления

warning_icon Обязательно ознакомьтесь с рекомендациями для работы с PostgreSQL при создании функций, таблиц и представлений

Для некоторых видов виджетов источниками данных являются хранимые процедуры SQL. К таким процедурам предъявляются следующие требования:

Хранимая процедура для виджета должна иметь следующие входные параметры:

oXmlParam (тип XML) — параметры, необходимые для фильтрации контента, в виде XML-массива;

oDrilldownField (тип Текст) — колонка с описанием данных для детализации;

oDrillDownParams (тип Текст) — параметры детализации;

oUserID (тип Число) – текущий пользователь.

warning_icon Работоспособность виджетов с использованием хранимых процедур с иным набором параметров (состав, названия) не гарантируется.

Хранимая процедура может возвращать произвольные данные и произвольный набор колонок. Названия колонок должны быть на латинице без пробелов.

Примеры хранимых процедур для виджетов

Для некоторых видов портальных блоков источниками данных являются хранимые процедуры SQL.

Виджет Рекламации

reclamation_view

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

reclamation_filter

Фильтр

reclamation_settings

Настройки блока

Пример процедуры

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

sales_total      

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

sales_total_settings

Настройки блока

Пример основной и детальной процедур (см. скриншоты)

Пример общей процедуры

Фильтры для виджетов

warning_icon Настройки фильтрации работают только для следующих типов виджетов: Smart Html, График, Таблица, Блок поиска задач. Для остальных типов вкладка неактивна

Если параметры фильтрации настроены, то в пользовательском интерфейсе у такого виджета в правом верхнем углу отображается кнопка фильтраbinded-04, по нажатию на которую открывается окно для отбора данных.

portal_blocks-0-1

Вызов фильтра виджета в пользовательском режиме

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

widget_filter

Настройки фильтрации

Описание настроек фильтрации

Пример настройки фильтрации для виджетов:

Фильтры для виджетов (9:30 мин.)

warning_icon Если для виджета настроены фильтры, то при открытии виджета из файлов-cookie подгружаются последние значения параметров фильтра, выбранные пользователем в предыдущем сеансе работы с данным виджетом. Если файлов-cookie нет, то используются значения по умолчанию, заданные для параметров фильтра.

Переход к настройкам из пользовательского интерфейса

Перейти в дополнительные настройки виджета можно из пользовательского интерфейса. Администраторам доступен пункт Настроить виджет в контекстном меню при клике правой кнопкой мыши на виджет в портале. Выбор пункта откроет соответствующий раздел режима администрирования.

admin-settings-mtf-009

Переход к настройкам из пользовательского режима

Вызов виджета вне портала

Блок может отображаться как на портале, так и на отдельной странице. Строка вызова блока имеет вид:

~/spa/portal/block/{BlockID}

Пример:

~/spa/portal/block/123

где 123 — это ID блока.