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
Виджет для отображения комментариев к документу.
| Введенные комментарии | |
| Форма ввода комментария: | Для ввода текста используется визуальный редактор, в котором помимо форматирования текста доступно добавление таблицы (1), кода (2), ссылки (3), файла (4):
|
Для включения транслированная комментария при выполнении задачи в виджет комментариев необходимо к типу данных добавить аспект 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
Виджет служит для загрузки сопутствующих документов/ синхронизации пользователей и групп.
Настройка
|
Если корневой уровень (на скриншоте Базовый тип) один, то он раскрывается по умолчанию:
Доступно отображение только выбранных типов по соответстующему чекбоксу:
При выборе типа чекбоксом и наведении мышки на строку:
становится доступна настройка выбранного типа документа:
При поиске типа раскрываются все вложенности и подсвечиваются совпадения:
|
Настроенный вид
|
Документы:
В списке типов документов может встречаться одинаковое название, поэтому при наведении на тултип дополнительно отображается порядок вложенности:
По кнопке Скачать все документы скачивается zip-архив со всеми загруженными файлами.
Для всех типов доступен фильтр Все статусы, в котором представлены системные статусы для документа:
Синхронизация пользователей:
|
Ключ 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 %. |