Виджеты
Для некоторых виджетов доступна настройка. Настройка отмечена следующей иконкой:
Примечание
При включенном конфиге restrict-access-to-edit-dashboard-widgets (true) настройка виджетов запрещена пользователю.
Настройка прав на редактирование
В системе для пользователй можно разграничить права на настройку дашборда (restrict-access-to-edit-dashboard) и настройку виджетов (restrict-access-to-edit-dashboard-widgets).
То есть у пользователя могут быть права на настройку дашборда, но запрещена настройа виджетов.
Конфиги хранятся в разделе Управление системой – Конфигурация ECOS:
Включение настройки:
Виджет «Журнал»
Ключ journal
Виджет для настройки отображения журнала.
Настройка
|
|
Настроенный вид
|
Виджет «Веб страница»
Ключ web-page
Виджет отображает любую web-страницу, заданную в его настройках.
Настройка
|
|
Настроенный вид
|
Виджет «Предпросмотр»
Ключ doc-preview
Виджет предпросмотра служит для отображения основного документа и всех связанных из атрибута «Содержимое». Позволяет осуществлять скачивание не только основного, а текущего открытого документа.
Оригиналы документов могут быть других расширений, но виджет показывает только картинки или сгенерированные pdf на базе основного.
С включённой настройкой в виджете показываются все связанные документы.
Первым отображается основной контент cm:content, затем дочерние элементы с типом idocs:doc.
Если основной отсутствует, то отобразится следующий документ.
Переход между документами осуществляется через дропдаун или скролл. Количество документов указано в дропдауне:
Содержимое виджета обновляется при изменениях основного и связанных документов.
Виджет «Комментарии»
Ключ comments
Виджет для отображения комментариев к документу.
Введенные комментарии |
|
Форма ввода комментария: |
Для ввода текста используется визуальный редактор, в котором помимо форматирования текста доступно добавление таблицы (1), кода (2), ссылки (3), файла (4):
|
Транcлирование комментариев при выполнении задачи
Для включения транслированная комментария при выполнении задачи в виджет комментариев необходимо к типу данных добавить аспект task-comments-broadcastable
.
Важно
Инпут комментария на форме задачи должен быть добавлен с id comment
.
Комментарий, добавленный из задачи помечается тегом с названием задачи.
Если необходимо выключить добавление комментария из задачи для конкретного рекорда, можно у рекорда выставить свойство task-comments-broadcastable:broadcastComments
в false
.
Виджет «Свойства»
Ключ properties
Виджет для отображения атрибутов карточки формы и их значений. Предоставляет возможность inline редактирования значений атрибутов или редактирование в режиме «формы» (с учетом статуса кейса, наличия прав у просматривающего кейс пользователя).
Список для выбора - формы из журнала форм.
Настройка
Список для выбора - формы из журнала форм.
|
|
Настроенный вид
|
Для типа дашборда Case-details реализовано 2 режима (см. настройки ниже)
- просмотр с возможностью inline редактирования значений атрибутов:
- редактирование в режиме «формы»:
Для типа дашборда Site-dashboard
При выборе свойства Электронная подпись отображаются данные о сертификате ЭЦП и времени подписания:
|
Для виджета так же доступен переход в конструктор формы для дополнительной настройки полей. См. подробную статью Формы
Настройка режима редактирования виджета для типа дашборда Case-details
Для типа дашборда Case-details доступна настройка режима просмотра с возможностью inline редактирования значений атрибутов или редактирования в режиме «формы». По умолчанию выставлен режим просмотра.
Для изменения режима необходимо в карточке нажать шестеренку- > «Настроить страницу»:
В настройке карточки перейти в раздел «Виджеты», и у виджета «Свойства» нажать:
В настройках выбрать «Режим редактирования» и нажать «Применить»:
В настройке карточки нажать «Применить».
Особенности режима редактирования
В виджете при открытии страницы дашборда доступны свойства документа в режиме редактирования, аналогично открытию документа в модальном окне редактирования:
Если пользователь вносит изменения, то в шапке виджета становятся доступны кнопки «Отмена» и «Сохранить».
Если изменений нет - кнопки в шапке виджета отсутствуют.
Если поля при редактировании не проходят валидацию - кнопка «Сохранить» становится не доступна для нажатия:
Виджет «Мои задачи»
Ключ current-tasks
Виджет для отображения задач по данному кейсу у просматривающего его пользователя и варианты их завершения.
Виджет «Все задачи»
Ключ tasks
Виджет для отображения задач по данному кейсу и их исполнителей.
Настройка
|
|
Настроенный вид
|
При нажатии на:
отображается схема выбранного бизнес-процесса с выделенной текущей задачей:
Примечание
Действие доступно только администратору.
Виджет «Статус»
Ключ doc-status
Виджет отображает текущий статус кейса (определяется системой автоматически, не доступен для редактирования пользователем).
Виджет «История событий»
Ключ events-history
Виджет служит для отображения событий таких, как создание, обновление, смена статуса кейса с фиксацией даты и времени их происшествия, участников и комментариев.
Виджет представлен в виде таблицы.
Для каждого столбца можно настроить фильтрацию и поиск событий:
Если в типе данных поля заданы как мультиязычные, то показываются мультиязычные значения:
Для bpmn-процесса:
В виджет добавлены события по сущности процесса:
Создание процесса;
Обновление версии процесса. Так же с указанием исходной версии;
Публикация версии процесса в движок.
Используя аспект Конфигурация истории можно настроить атрибуты типа данных, информация об изменении которых не будет записываться в историю и отображаться в виджете, соответственно.
Виджет «Журнал версий»
Ключ versions-journal
Виджет содержит актуальную и предшествующие версии документа.
Служит для загрузки новой версии документа, а также для сравнения файлов.
Версии документов можно сравнить - выбрать версии и нажать Сравнить. Различия будут подсвечены:
Для bpmn-процесса:
В виджете реализован функционал «тегов». Для версии процесса, которая была опубликована, будет показываться тег «Опубликовано», для процесса, сохраненного как черновик - «Черновик» (1).
Добавлена кнопка редактирования (2), при нажатии на которую, открывается bpmn-редактор процесса конкретной версии.
При нажатии на кнопку скачать (3) происходит скачивание конкретной версии процесса.
При сохранении процесса в редакторе, если есть различия, происходит сохранение инкремента версии.
Cравнение версий процесса - выберите версии и нажмите «Сравнить» (4):
Для загрузки новой версии нажмите (5):
Выберите файл, укажите вид изменений и комментарий при необходимости, нажмите «Добавить».
Добавленная версия станет актуальной.
Виджет «Связи документа»
Ключ doc-associations
Виджет используется для установки связей данного кейса с другими
и отображения установленных связей.
Настройки
Настройки производятся на вкладке Связи типа данных. Связь может быть настроена с любой ассоциацией.
Виджет «Действия»
Ключ record-actions
Виджет содержит перечень доступных действий с кейсом на данном статусе.
Настройки подтягиваются из типа данных. См. подробную статью Действия
Виджет «Штрих-код»
Ключ barcode
Виджет отображает отображает сгенерированный штрих-код документа, основанный на числовом поле документа.
По умолчанию используется поле idocs:barcode
.
Если нужно другое поле, то следует зарегистрировать это поле по типу ECOS в бине core.barcode-attribute.type-to-property.mappingRegistry
Пример:
<bean id="records.contracts.barcode-attribute.type-to-property.mapping"
class="ru.citeck.ecos.spring.registry.MappingRegistrar">
<constructor-arg ref="core.barcode-attribute.type-to-property.mappingRegistry"/>
<property name="mapping">
<map>
<entry key="contracts-cat-doctype-contract" value="contracts:barcode"/>
</map>
</property>
</bean>
Настройка
|
Условие отображения кнопки:
Если отсутствует условие, то кнопка отображается. Иначе для отображения, API по заданному условию должно возвращать true.
В текущей версии сохраняется как json строка.
Написание условия в соответствии статье Язык предикатов
|
Настроенный вид
|
Для типа дашборда Case-details
|
Виджет «Документы»
Ключ documents
Виджет служит для загрузки сопутствующих документов/ синхронизации пользователей и групп.
Настройка
|
Если корневой уровень (на скриншоте Базовый тип) один, то он раскрывается по умолчанию:
Доступно отображение только выбранных типов по соответстующему чекбоксу:
При выборе типа чекбоксом и наведении мышки на строку:
становится доступна настройка выбранного типа документа:
При поиске типа раскрываются все вложенности и подсвечиваются совпадения:
|
Настроенный вид
|
Документы:
В списке типов документов может встречаться одинаковое название, поэтому при наведении на тултип дополнительно отображается порядок вложенности:
По кнопке Скачать все документы скачивается zip-архив со всеми загруженными файлами.
Для всех типов доступен фильтр Все статусы, в котором представлены системные статусы для документа:
Синхронизация пользователей:
|
Виджет «Doc.One»
Ключ doc-constructor
Виджет для использования конструктора документов Doc.one.
Doc.one - программа по составлению документов, с помощью которой можно преобразовать любые типовые документы, в умные шаблоны Doc.one.
Настройка
|
|
Настроенный вид
|
Виджет «Статистика по задачам»
Ключ report
Виджет отображает статистику по задачам.
Виджет «День рождения»
Ключ birthdays
Виджет отображает ближайшие дни рождения .
Виджет «Профиль»
Ключ user-profile
Виджет профиля пользователя
Виджет «Статистика процесса»
Примечание
Доступно только в enterprise версии.
Просмотр данных виджета доступен пользователям с правом «Просмотр отчетности».
Ключ process-statistics
Виджет визуализирует статистику по бизнес-процессу с отображением тепловой карты (heatmap).
Тепловая карта (heat map) — инструмент, который визуализирует данные при помощи разных цветов. Данные отображаются в виде цветных пятен.
Возможные режимы представления
У виджета возможны 3 представления:
Режим KPI:
Отображается бизнес-процесс, целевые значения KPI (1), отклонения значения KPI от целевого значения (2):
См. подробно о KPI
Упрощенный режим:
Отображается только бизнес-процесс.
Расширенный режим:
При максимальных настройках по умолчанию в расширенном режиме доступны:
Процесс (1)
Тепловая карта (2) - Более активным элементам соответствуют тёплые тона, чем меньше показатели — тем холоднее цвет.
Счетчики (3) - Для каждого шага процесса отображает количество инстансов процесса, находящихся на данном шаге. Отображение счетчиков можно включить/выключить, отображение самого бизнес-процесса останется.
А – активные инстансы.
В – завершенные инстансы.
Целевое значение KPI, отклонение значения KPI от целевого в % (4).
% экземпляров, ушедших по каждой ветке после шлюза (5). Расчет % ведется от общего числа экземпляров, прошедших шлюз.
Панель тепловой карты (6) – настройка прозрачности, отображение минимального и максимального значений активных и завершенных инстансов.
Журнал (7) - В журнале для каждого столбца можно настроить фильтрацию и поиск событий. Визуализация будет перерисована в соответствии с выбранными фильтрами.
Масштабирование и перемещение
Для масштабирования используйте сочетание ctrl и скролл мыши.
Для перемещения по heatmap влево- вправо - сочетание shift и скролл мыши.
Настройки виджета
Настройка виджета доступна только пользователям из группы Администраторы ECOS.
Для режимов KPI и Упрощенный дополнительных настроек нет:
Для Расширенного режима выбираются отображаемые по умолчанию элементы виджета:
Виджет «Стадии»
Примечание
Доступно только в enterprise версии.
Ключ stages
Виджет визуализирует прохождение ECOS стадий документа:
Настройка
|
Если снять чекбокс, то будет показана только текущая стадия:
|
Настроенный вид
|
Виджет «Канбан»
Ключ kanban-board
Примечание
Доступно только в Enterprise версии.
Виджет добавляет в карточку канбан доску с настраиваемым журналом, связанным атрибутам и шаблонами для удобства пользователя и быстрым взаимодействием со статусами через карточку.
Виджет доступен только для следующего представления дашборда:
Настройка
|
Заголовок виджета.
Выбор журнала по типу.
По чекбоксу «Отображать только связанные записи» можно выбрать связанные атрибуты, которые будут использоваться для фильтрации записей на канбан доске. Виджет будет отображать только те записи, которые имеют выбранные связанные атрибуты или на них есть ссылки.
Выбор сохраненных шаблонов журнала и созданных канбан досок.
|
Настроенный вид
|
Виджет используется в модуле «Офферы». В карточке заявки, по которой уже идет подбор кандидата, доступна вкладка Канбан-доска, на которой отображены кандидаты по данной заявке в различных статусах:
|
Виджет «Графическая статистика»
Примечание
Доступно только в enterprise версии.
Ключ charts
Виджет позволяет пользователям наглядно представлять и анализировать данные, повышая эффективность принятия решений и улучшая понимание текущего состояния бизнес-процессов.
При разработке использована библиотека Chart.js
Виджет поддерживает различные типы графиков: линейные, столбчатые, круговые.
Пользователи могут выбирать источник данных для графика, включая определенные атрибуты, колонки, связанные с кейсами и справочниками платформы ECOS.
Графики конфигурируемые - пользователи могут настраивать оси, масштабирование и т.д.
По нажатию на пункт легенды данные пункта легенды убираются из представления графика:
Общая конфигурация
Для всех типов графиков:
Название виджета |
Укажите наименование представления. |
Тип графика |
Выберите тип из списка:
- Столбчатый
- Круговой
- Линейный
|
Настройки журнала |
|
Журнал |
Выберите журнал, по данным которого необходимо построить график.
В выбранном журнале должны быть заранее настроены колонки для группировки. Действие доступно для администратора.
Для разрешения группировки перейдите в журнале к необходимому столбцу, нажмите Дополнительно:
Выставите чекбокс Можно ли группировать:
|
Шаблон журнала |
Выберите шаблон журнала. |
Атрибуты группировки |
Группировка - операция объединения данных в группы таким образом, чтобы у элементов в каждой группе был общий атрибут.
Нажмите «Добавить» и выберите из списка атрибуты, по которым производить группировку данных.
В списке представлены атрибуты, у которых в настройках разрешена группировка.
|
Атрибут агрегации |
Выберите атрибут из представленых в списке, по которому возвращать сводные данные. |
Столбчатый
Столбчатый график — диаграмма, представленная прямоугольными зонами (столбцами), высоты или длины которых пропорциональны величинам, которые они отображают.
Минимальное вертикальное значение |
Минимальное значение, отображаемое на вертикальной шкале |
Максимальное вертикальное значение |
Максимальное значение, отображаемое на вертикальной шкале |
Соотношение сторон x/y |
Дробное. Масштабирования оси - отношение единицы X к единице Y. По умолчанию 2. |
Примеры различных соотношений сторон:
2:
4:
Линейный
Линейный график позволяет размещать данные в виде точек на линии. Используется для того, чтобы отразить изменение показателей с течением времени, или же для сравнения двух наборов данных.
Минимальное вертикальное значение |
Минимальное значение, отображаемое на вертикальной шкале |
Максимальное вертикальное значение |
Максимальное значение, отображаемое на вертикальной шкале |
Соотношение сторон x/y |
Дробное. Масштабирования оси - отношение единицы X к единице Y. По умолчанию 2. |
Растяжение |
Уровень плавности линии графика. По умолчанию 0. |
Круговой
Круговой график представляет данные в виде круга, разделенного на сектора. Каждый сектор — категория данных, которая составляет долю от общей суммы.
Радиус середины |
Радиус центрального круга, в процентах от радиуса основного. По умолчанию 50 %. |