Порталы¶
Портал — это настраиваемое рабочее пространство (дашборд), собранное из страниц и блоков-виджетов. Портал собирается из страниц, на которых размещаются блоки; у блоков могут быть фильтры и параметры, определяющие, какие данные показываются.
Главный портал системы — стартовая страница (открывается по клику на логотип). Помимо главного, отдельные порталы могут быть у подразделений и групп — ссылки на них обычно добавляются в боковую панель «Избранное».
Структура, доступ, персонализация и связи портала¶
Портал состоит из трёх уровней:
| Уровень | Описание |
|---|---|
| Группа | Объединяет секции в виде вкладок |
| Секция | Конкретный портал, с заголовком или без |
| Блок (виджет) | Контент внутри секции |
Доступ и персонализация. Доступ к порталу определяется группами пользователей: человек видит только те порталы, которые разрешены его группам, и только те блоки, которые открыты этим группам. Изменение списка групп сразу меняет круг видимости. Фильтры блоков не открывают доступ к данным, которых у пользователя нет, — видно только то, к чему есть права.
Блок без заданных групп доступа считается публичным: его видят все, кому открыт сам портал. Если группы у блока заданы, его видит только тот, кто входит хотя бы в одну из них. Одно и то же правило действует и в списках блоков портала, и при запросе данных блока, поэтому блок, который виден в списке, всегда открывается, а чужой блок и в список не попадает, и данные по нему не отдаются.
Поверх шаблона, настроенного администратором, пользователь может сделать свой вариант компоновки страницы (персональная настройка блоков).
Отказ отдельного блока. Если один блок не смог отобразиться, на его месте показывается «Ошибка загрузки», а остальные блоки страницы отрисовываются как обычно — отказ одного блока не затрагивает остальные. Пустая страница портала означает, что дело не в отдельном блоке, а в загрузке самой страницы или её данных.
Связи с другими доменами. Порталы собирают данные из нескольких смежных доменов:
| Домен | Связь |
|---|---|
| Задачи | блоки «Поиск задач», «Список задач», «Диаграмма Ганта» показывают задачи |
| Отчёты | блок «График» строит сводки по данным отчётов |
| Категории | блоки «Новости» и поиска опираются на категории |
| Уведомления | счётчики и индикаторы отражают непрочитанное и события |
| Социальная сеть | блок «Лента социальной сети» показывает публикации сообществ |
| Календарь | блоки «Календарь» и «Календарь New» |
Порталы, их секции и виджеты находятся поиском: в быстром поиске результаты по ним выводятся между файлами и отчётами, в полной форме поиска для них есть вкладка «Порталы». Ищутся только порталы, свёрстанные как Board. Подробнее — search/business.md.
Блок находится независимо от того, в какой раскладке страницы он размещён, — в том числе если оставлен только в адаптивной раскладке. Подробнее — Поиск — бизнес-логика.
Каталог виджетов¶
На портал можно добавлять разные типы блоков-виджетов — ниже показано, как выглядит каждый на портальной странице.
Часть типов показывается не во всех раскладках портала: в неподходящей раскладке вместо содержимого выводится «Виджет не поддерживается». У каждого такого виджета ниже указано, где он работает; сводка по раскладкам — Поддержка типов по режимам вёрстки.
Блоки прежних версий портала — Блок статистики, Смарт-блок, Кнопки рабочего места, Дерево избранного из рабочих мест групп и другие устаревшие типы — в каталоге не описаны: они не отображаются ни в одной раскладке, вместо них выводится та же заглушка. На портале такие блоки удаляют.
У блока с настроенной фильтрацией в шапке есть кнопка «Фильтр»: она открывает окно отбора данных этого блока. Пользователь выбирает значения и нажимает «Применить» — окно закрывается, блок перезапрашивает данные под выбранный отбор, а в шапке рядом с кнопкой появляются выбранные значения; нажатие на любое из них снова открывает окно. Кнопка «Сбросить все условия» очищает условия, не закрывая окно, а если не заполнен обязательный параметр отбора, применить фильтр не удастся — окно сообщит об этом. Какие поля попадут в окно, задаёт администратор на вкладке «Настройки фильтрации»; настройка «Скрыть фильтр» прячет из шапки выбранные значения, но саму кнопку оставляет.
Подробные настройки виджетов — admin.md и portal-api-cookbook.md.
Баннер-кнопка¶
Баннер на главном экране портала. Нажатие открывает заданную ссылку в модальном окне, Ctrl+клик — в новой вкладке браузера.
График¶
Сводные данные о задачах в табличном или графическом виде: линейная диаграмма, линейная (область), столбчатая, секторная (круговая), спидометр, воронка продаж, линейная с накоплением (вертикальная и горизонтальная).
У диаграмм с накоплением рядом с каждым столбцом выводится итоговая сумма по всем сериям, привязанная к краю столбца; при нулевой сумме отображается «0».
Группа виджетов¶
Блок, в котором каждая вкладка — отдельный ранее созданный виджет со всеми его настройками (фильтры и прочие параметры). Если вкладки не помещаются в одну строку, в конце появляется кнопка «Ещё» с выпадающим списком скрытых вкладок.
Диаграмма Ганта¶
Список задач в представлении диаграммы Ганта прямо на портале.
Избранное¶
Избранные объекты пользователя выборочно по типам: задачи, пользователи, пространства, категории, чаты, отчёты, ссылки.
Календарь¶
Данные с привязкой к дате: при выборе даты в календаре меняется список под ним. Если выбран только месяц — в списке данные за весь месяц. При количестве записей больше 20 отображаются первые 20. Обычно выводятся задачи, но могут и другие данные — например, пользователи с днями рождения.
Календарь New¶
Полноценный календарь событий — задачи, встречи, напоминания. В отличие от «Календаря», соответствует календарю в профиле и не используется для показа преднастроенного набора данных; дата и время соответствуют часовому поясу пользователя.
Контакты¶
Список контактов в виде списка, карусели или кругов: недавние, звонки, коллеги, избранные, сотрудники отдела оргструктуры или произвольный преднастроенный список пользователей. Для варианта «Звонки» учитываются в том числе p2p-вызовы. В карточке контакта выводится аватар, имя, индикатор присутствия и настраиваемая вторая строка: должность, подразделение, статус, тип недавнего взаимодействия, ближайший день рождения или ближайшие отсутствия сотрудника со статусом «Нет на месте» — в пределах 30 дней, с указанием времени или даты события.
Лента социальной сети¶
Последние публикации из сообществ. Можно создать одну или несколько независимых лент — каждая отображается отдельной вкладкой. Нажатие на аватар поста ведёт в соответствующее сообщество. Доступен полный функционал: просмотр, комментирование, создание, редактирование и удаление публикаций по правам доступа. Посты, не помещающиеся в заданную высоту, плавно обрезаются градиентным затемнением под цветовую тему.
Внизу виджета — кнопка «Перейти ко всем постам»: ведёт к источнику публикаций (страница выбранной группы или главная лента соцсети).
Кнопка-Тикер¶
Счётчик с иконкой (может быть кликабельным) или кнопка создания задачи. Нажатие открывает заданную ссылку в модальном окне, Ctrl+клик — в новой вкладке.
Меню¶
Произвольное число кнопок, по нажатию на каждую выполняется переход на определённую страницу.
Мини-опрос¶
Пульс-опросы для быстрого сбора мнений: модераторы создают опросы в виджете, остальные пользователи голосуют. Группа модераторов и режим показа ответов — сразу в виджете или за кнопкой во всплывающем окне — задаются в настройках.
Работает только в раскладке CSS Grid: в Dashboard и в секциях Board вместо опроса выводится «Виджет не поддерживается».
Навигация¶
Панель ссылок для быстрого перехода по разделам и страницам. Элементы ведут на внутренние адреса системы или на внешние ресурсы.
Работает только в раскладке CSS Grid: в Dashboard и в секциях Board вместо панели выводится «Виджет не поддерживается». Чтобы панель отображалась, страницу переводят в раскладку CSS Grid — сам блок при смене раскладки не удаляется.
Новости¶
Задачи новостных категорий в виде большого блока, списка или карусели. Количество новостей — от 1 до 6 (кроме 4). Опционально в карточке отображаются автор, рубрика, аннотация, дата публикации, счётчик реакций и счётчик просмотров. На виджете и в списке новостей счётчик реакций только отображается: поставить реакцию можно в самой новости. Новости сортируются по новым или закреплённым.
Кнопка справа в шапке блока открывает полную ленту новостей категории в виде галереи — с фильтрацией по рубрикам и тегам. Так можно просмотреть все новости категории, а не только выведенные в виджет.
Нажатие на элемент списка (в виджете или галерее) открывает карточку новости в модальном окне; набор полей карточки (обложка, автор, аннотация и т.д.) зависит от настроек новостной категории. Клик на имя автора, если это пользователь, открывает его краткую карточку профиля.
Поиск задач¶
Список задач по заданным условиям отбора. На строках могут быть настроены кнопки действий для каждой задачи — например, изменение приоритета или перевод в следующий статус.
Список задач¶
Задачи текущего пользователя: на сегодня, активные, недавние, новые из выбранной категории, просроченные, на подписи, избранные. Данные обновляются динамически при изменении параметров задачи, без перезагрузки страницы.
Сторис¶
Истории компании на портальной странице: обложки берутся из одной категории задач, страницы историй — из другой. Настройка блока — две обязательные категории и дополнительные параметры, которые связывают обложку с её страницами.
Пока категории не выбраны, вместо обложек выводится сообщение «Сторис не настроены. Откройте настройки виджета и выберите категории обложек и страниц.».
Счётчики¶
Различные счётчики на портальной странице.
Таблица¶
Произвольная информация в табличном виде.
Колонки таблицы можно раскрашивать и настраивать по ним счётчики значений.
Строки таблицы можно группировать: у колонки выбирается роль «Группировка строк», и записи объединяются в сворачиваемые группы по её значениям, со счётчиком строк в заголовке группы. Групп может быть несколько уровней — по числу колонок с такой ролью.
Выгрузка в Excel. Число выгружаемых строк ограничено настройкой системы (по умолчанию 50 000). Если строк в блоке больше предела, выгрузка не выполняется: блок сразу сообщает «Строк в блоке: N, предел выгрузки: M. Сузьте отбор и повторите», а если превышение обнаружит сервер, открывается окно «Не удалось выгрузить в Excel» с причиной отказа. Отказ сервера при выгрузке из виджета «График» показывается тем же окном.
Фильтр¶
Управляет данными в других блоках портала. На одной странице может быть несколько независимых фильтров; дубли с одинаковым набором параметров запрещены.
Не путать с кнопкой «Фильтр» в шапке блока (Каталог виджетов): она фильтрует данные самого блока, а блок «Фильтр» — данные соседних.
Выпадающий список параметра фильтра при открытии портала свёрнут и раскрывается по нажатию. Иерархическим деревом значения показываются только тогда, когда в данных есть элементы со связью с родителем; подробности настройки и диагностики — в разделе «Фильтры» документации администратора.