dashboards.rst

Дашборды

Contents

• Виды дашбордов
• Кэширование
• Настройка прав на редактирование
• Конфигурация дашборда
  • Разделы дашборда
    • «Принадлежность»
    • «Представление»
    • «Виджеты»
• Настройки виджетов на дашбордах
• Журнал "Дашборды"

Для отображения домашней страницы пользователя или информации по кейсу в ECOS предусмотрены дашборды.

Дашборд позволяет добавлять и убирать виджеты, конфигурировать каждый виджет индивидуально. См. отдельную статью :ref:`виджеты<widgets>`

Все настройки хранятся в том же json, что и конфигурация дашборда.

Виды дашбордов

На момент написания статьи существует 4 вида дашборда:

Тип/Ключ	Описание
Case-details	Дашборд карточки кейса - информация по документу (задачи, свойства, действия, история и др.). Ключ dashboard'а берется из RecordRef в URL страницы и как правило он связан с типом/видом ECOS. Формирование ключа построено по следующему правилу: type_uuid/kind_ type_uuid То есть для договоров это будет: 1. contracts-cat-doctype-contract/contracts-cat-contract-rent 2. contracts-cat-doctype-contract Порядок - от более приоритетного к менее приоритетному Например: localhost/v2/dashboard?activeTab=0&recordRef=emodel/type-id@local-id
Site-details	Страница раздела, которая позволяет отображать общие данные по разделу. Ключ dashboard'а берется из RecordRef в URL страницы. На момент написания ключ формируется по правилу "site" + siteId. Если идентификатор сайта contracts, то его приоритетный dashboardKey будет site_contracts.
User-dashboard	Домашняя страница пользователя. Открывается если в URL не указано никакого recordRef. Например: localhost/v2/dashboard Ключ dashboard'а всегда DEFAULT, если явно не задано обратного (возможно указание dashboardKey в URL)
profile-details	Страница профиля пользователя, которая доступна из меню действий с учетной записью пользователя, пункт «Мой профиль» (см. :ref:`Панель управления<control_panel>`) Например: localhost/v2/dashboard?activeTab=0&recordRef=emodel/person@username

В ссылках для user-base-type-dashboard, user-dashboard (самостоятельно и из оргструктуры) используется параметр activeTab,

например, https://host/v2/dashboard?activeTab=0&recordRef=emodel/person@admin

activeTab=N - активная вкладка дашборда. Вкладки нумеруются с 0, где 0 - первая вкладка.

Алгоритм поиска dashboard следующий:

1. Смотрим наличие recordRef в URL,
2. Если recordRef отсутствует - отправляется запрос на конфигурацию домашней страницы пользователя,
3. Если recordRef присутствует, то запрашиваем аттрибуты _dashboardKey[] (массив) и _dashboardType (одно значение),
4. Дальше перебираем каждый полученный dashboardKey и запрашиваем у сервера конфигурацию для ключа + типа,
5. Если на сервере конфигурации не нашлось, то пробуем следующий dashboardKey,
6. Если ни по одному ключу не нашелся dashboard, то запрашиваем конфигурацию по ключу DEFAULT.

Кэширование

Кеширование возможно в пределах открытой вкладки браузера:

1. _dashboardKey[] и _dashboardType по recordRef (они достаточно редко меняются),
2. Конфигурация dashboard (или её отсутствие) по dashboardKey + dashboardType.

Настройка прав на редактирование

В системе для пользователей можно разграничить права на настройку дашборда (restrict-access-to-edit-dashboard) и настройку виджетов (restrict-access-to-edit-dashboard-widgets).

То есть у пользователя могут быть права на настройку дашборда, но запрещена настройа виджетов.

Конфиги хранятся в разделе Управление системой – Конфигурация ECOS:

Включение настройки:

Конфигурация дашборда

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

Конфигурация дашборда происходит непосредственно из выбранного типа данных.

Чтобы дополнительно конфигурировать дашборд – изменить настройки, убрать или добавить виджеты, необходимо перейти в карточку кейса, профиль пользователя или домашнюю страницу и нажать шестеренку- > «Настроить страницу»:

Общая форма настройки имеет следующий вид:

Разделы дашборда

«Принадлежность»

В верхней части указан id дашборда и тип данных, для которого он настраивается.

Тип данных может быть изменен из доступного выпадающего списка. Например:

Отдельный дашборд может быть настроен для определенного документа (если на примере выбрать тип «Договор№512», то при открытии карточки данного договора будет отображаться дашборд, сконфигурированный именно для данного документа).

При выставленном чекбоксе «Применить для всех пользователей» настроенный дашборд будет применен для всех пользователей, состоящих в первой назначенной группе по организационной структуре, открывших указанный тип данных.

«Представление»

Доступен выбор настройки для десктопной или мобильной версии ECOS.

Укажите количество и содержимое вкладок, выберите расположение и количество колонок для каждой вкладки.

Только для типа дашборда Site-dashboard доступно следующее расположение (Количество колонок подстраивается под размер окна браузера):

Для типа дашборда Case-details доступна поддержка мультиязычного имени для вкладок:

Important

Для мобильной версии отображаются только те виджеты, которые уже были настроены для десктопной версии и несут в себе те же настройки:

«Виджеты»

Созданные колонки можно заполнить доступными виджетами – перетащите виджет в необходимую колонку:

Набор доступных виджетов зависит от вида дашборда.

Настройки виджетов на дашбордах

Настройка виджета осуществляется в карточке каждого виджета. См. отдельную статью :ref:`Виджеты<widgets>`

Информация по доступности виджета хранится в самом виджете (без участия сервера).

В конфигурации виджета в поле config.widgetDisplayCondition задается условие как json-строка. Написание условия в соответствии статье :ref:`Язык предикатов<ecos-predicate_main>`

Если отсутствует условие, то виджет отображается.

Журнал "Дашборды"

Журнал расположен в разделе администратора -> Конфигурация UI - > Дашборды:

Дашборд можно отредактировать, удалить, внести изменения через конфиг:

	Скачать
	Удалить
	Редактировать в форме
	Редактировать json
	Копировать