Contents
- Настройка прав на редактирование
- Виджет «Журнал»
- Виджет «Веб страница»
- Виджет «Предпросмотр»
- Виджет «Комментарии»
- Виджет «Свойства»
- Виджет «Мои задачи»
- Виджет «Все задачи»
- Виджет «Статус»
- Виджет «История событий»
- Виджет «Журнал версий»
- Виджет «Связи документа»
- Виджет «Действия»
- Виджет «Штрих-код»
- Виджет «Документы»
- Виджет «Doc.One»
- Виджет «Статистика процесса»
- Виджет «Стадии»
- Виджет «Статистика по задачам»
- Виджет «День рождения»
- Виджет «Профиль»
- Виджет «Канбан»
- Виджет «Графическая статистика»
Для некоторых виджетов доступна настройка. Настройка отмечена следующей иконкой:
Note
При включенном конфиге 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
Виджет для отображения комментариев к документу.
Для включения транслированная комментария при выполнении задачи в виджет комментариев необходимо к типу данных добавить аспект task-comments-broadcastable
.
Important
Инпут комментария на форме задачи должен быть добавлен с id comment
.
Комментарий, добавленный из задачи помечается тегом с названием задачи.
Если необходимо выключить добавление комментария из задачи для конкретного рекорда, можно у рекорда выставить свойство task-comments-broadcastable:broadcastComments
в false
.
Ключ properties
Виджет для отображения атрибутов карточки формы и их значений. Предоставляет возможность inline редактирования значений атрибутов или редактирование в режиме "формы" (с учетом статуса кейса, наличия прав у просматривающего кейс пользователя).
Список для выбора - формы из журнала форм.
Настройка
Список для выбора - формы из журнала форм.
|
|
Настроенный вид
|
Для типа дашборда :ref:`Case-details<dashboard_types>` реализовано 2 режима (см. настройки ниже)
- просмотр с возможностью inline редактирования значений атрибутов:
- редактирование в режиме "формы":
Для типа дашборда :ref:`Site-dashboard<dashboard_types>`
При выборе свойства Электронная подпись отображаются данные о сертификате ЭЦП и времени подписания:
|
Для виджета так же доступен переход в конструктор формы для дополнительной настройки полей. См. подробную статью :ref:`Формы<forms>`
Для типа дашборда Case-details доступна настройка режима просмотра с возможностью inline редактирования значений атрибутов или редактирования в режиме "формы". По умолчанию выставлен режим просмотра.
Для изменения режима необходимо в карточке нажать шестеренку- > «Настроить страницу»:
В настройке карточки перейти в раздел "Виджеты", и у виджета "Свойства" нажать:
В настройках выбрать "Режим редактирования" и нажать "Применить":
В настройке карточки нажать "Применить".
В виджете при открытии страницы дашборда доступны свойства документа в режиме редактирования, аналогично открытию документа в модальном окне редактирования:
Если пользователь вносит изменения, то в шапке виджета становятся доступны кнопки "Отмена" и "Сохранить".
Если изменений нет - кнопки в шапке виджета отсутствуют.
Если поля при редактировании не проходят валидацию - кнопка "Сохранить" становится не доступна для нажатия:
Ключ current-tasks
Виджет для отображения задач по данному кейсу у просматривающего его пользователя и варианты их завершения.
Ключ tasks
Виджет для отображения задач по данному кейсу и их исполнителей.
Настройка
|
|
Настроенный вид
|
При нажатии на:
отображается схема выбранного бизнес-процесса с выделенной текущей задачей:
Note
Действие доступно только администратору.
Ключ doc-status
Виджет отображает текущий статус кейса (определяется системой автоматически, не доступен для редактирования пользователем).
Ключ events-history
Виджет служит для отображения событий таких, как создание, обновление, смена статуса кейса с фиксацией даты и времени их происшествия, участников и комментариев.
Виджет представлен в виде таблицы.
Для каждого столбца можно настроить фильтрацию и поиск событий:
Если в типе данных поля заданы как мультиязычные, то показываются мультиязычные значения:
Для bpmn-процесса:
В виджет добавлены события по сущности процесса:
- Создании процесса
- Обновлении версии. Так же с указанием исходной версии.
- Публикации версии в движок
Ключ versions-journal
Виджет содержит актуальную и предшествующие версии документа.
Служит для загрузки новой версии документа, а также для сравнения файлов.
Версии документов можно сравнить - выбрать версии и нажать Сравнить. Различия будут подсвечены:
Для bpmn-процесса:
В виджете реализован функционал "тегов". Для версии процесса, которая была опубликована, будет показываться тег "Опубликовано", для процесса, сохраненного как черновик - "Черновик" (1).
Добавлена кнопка редактирования (2), при нажатии на которую, открывается bpmn-редактор процесса конкретной версии.
При нажатии на кнопку скачать (3) происходит скачивание конкретной версии процесса.
При сохранении процесса в редакторе, если есть различия, происходит сохранение инкремента версии.
Cравнение версий процесса - выберите версии и нажмите "Сравнить" (4):
Для загрузки новой версии нажмите (5):
Выберите файл, укажите вид изменений и комментарий при необходимости, нажмите "Добавить".
Добавленная версия станет актуальной.
Ключ doc-associations
Виджет используется для установки связей данного кейса с другими
и отображения установленных связей.
Настройки производятся на вкладке :ref:`Связи<datatypes_associations>` типа данных. Связь может быть настроена с любой ассоциацией.
Ключ record-actions
Виджет содержит перечень доступных действий с кейсом на данном статусе.
Настройки подтягиваются из :ref:`типа данных<data_types_main>`. См. подробную статью :ref:`Действия<ui_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 строка.
Написание условия в соответствии статье :ref:`Язык предикатов <ecos-predicate_main>`
|
Настроенный вид
|
Для типа дашборда Case-details
|
Ключ documents
Виджет служит для загрузки сопутствующих документов/ синхронизации пользователей и групп.
Ключ doc-constructor
Виджет для использования конструктора документов Doc.one.
Doc.one - программа по составлению документов, с помощью которой можно преобразовать любые типовые документы, в умные шаблоны Doc.one.
Настройка
|
|
Настроенный вид
|
Note
Доступно только в enterprise версии.
Просмотр данных виджета доступен пользователям с правом «Просмотр отчетности».
Ключ process-statistics
Виджет визуализирует статистику по бизнес-процессу с отображением тепловой карты (heatmap).
Тепловая карта (heat map) — инструмент, который визуализирует данные при помощи разных цветов. Данные отображаются в виде цветных пятен.
У виджета возможны 2 представления:
Упрощенный режим – отображается только бизнес-процесс:
Расширенный режим:
При максимальных настройках по умолчанию в расширенном режиме доступны:
Процесс (1)
Тепловая карта (2) - Более активным элементам соответствуют тёплые тона, чем меньше показатели — тем холоднее цвет.
Счетчики (3) - Для каждого шага процесса отображает количество инстансов процесса, находящихся на данном шаге. Отображение счетчиков можно включить/выключить, отображение самого бизнес-процесса останется.
- А – активные инстансы
- В – завершенные инстансы
Панель тепловой карты (4) – настройка прозрачности, отображение активных и завершенных инстансов
Журнал (5) - В журнале для каждого столбца можно настроить фильтрацию и поиск событий. Визуализация будет перерисована в соответствии с выбранными фильтрами.
Для масштабирования используйте сочетание ctrl и скролл мыши.
Для перемещения по heatmap влево- вправо - сочетание shift и скролл мыши.
Настройка виджета доступна только пользователям из группы администраторы ECOS.
В настройках виджета выбираются:
режим отображения;
отображаемые по умолчанию элементы виджета, и отображение цветовой панели тепловой карты.
Note
Доступно только в enterprise версии.
Ключ stages
Виджет визуализирует прохождение :ref:`ECOS стадий<stages>` документа:
Настройка
|
Если снять чекбокс, то будет показана только текущая стадия:
|
Настроенный вид
|
Ключ report
Виджет отображает статистику по задачам.
Ключ birthdays
Виджет отображает ближайшие дни рождения .
Ключ user-profile
Виджет профиля пользователя
Ключ kanban-board
Note
Доступно только в Enterprise версии.
Виджет добавляет в карточку :ref:`канбан доску<kanban_board>` с настраиваемым журналом, связанным атрибутам и шаблонами для удобства пользователя и быстрым взаимодействием со статусами через карточку.
Виджет доступен только для следующего :ref:`представления дашборда<dashboard_view>`:
Note
Доступно только в enterprise версии.
Ключ charts
Виджет позволяет пользователям наглядно представлять и анализировать данные, повышая эффективность принятия решений и улучшая понимание текущего состояния бизнес-процессов.
При разработке использована библиотека Chart.js
Виджет поддерживает различные типы графиков: линейные, столбчатые, круговые.
Пользователи могут выбирать источник данных для графика, включая определенные атрибуты, колонки, связанные с кейсами и справочниками платформы ECOS.
Графики конфигурируемые - пользователи могут настраивать оси, масштабирование и т.д.
По нажатию на пункт легенды данные пункта легенды убираются из представления графика:
Для всех типов графиков:
Столбчатый график — диаграмма, представленная прямоугольными зонами (столбцами), высоты или длины которых пропорциональны величинам, которые они отображают.
Минимальное вертикальное значение | Минимальное значение, отображаемое на вертикальной шкале |
Максимальное вертикальное значение | Максимальное значение, отображаемое на вертикальной шкале |
Соотношение сторон x/y | Дробное. Масштабирования оси - отношение единицы X к единице Y. По умолчанию 2. |
Примеры различных соотношений сторон:
2:
4:
Линейный график позволяет размещать данные в виде точек на линии. Используется для того, чтобы отразить изменение показателей с течением времени, или же для сравнения двух наборов данных.
Минимальное вертикальное значение | Минимальное значение, отображаемое на вертикальной шкале |
Максимальное вертикальное значение | Максимальное значение, отображаемое на вертикальной шкале |
Соотношение сторон x/y | Дробное. Масштабирования оси - отношение единицы X к единице Y. По умолчанию 2. |
Растяжение | Уровень плавности линии графика. По умолчанию 0. |
Круговой график представляет данные в виде круга, разделенного на сектора. Каждый сектор — категория данных, которая составляет долю от общей суммы.
Радиус середины | Радиус центрального круга, в процентах от радиуса основного. По умолчанию 50 %. |