# Порталы

Портал — это настраиваемое рабочее пространство (дашборд), собранное из страниц и блоков-виджетов. Портал собирается из страниц, на которых размещаются блоки; у блоков могут быть фильтры и параметры, определяющие, какие данные показываются.

Главный портал системы — стартовая страница (открывается по клику на логотип). Помимо главного, отдельные порталы могут быть у подразделений и групп — ссылки на них обычно добавляются в боковую панель «Избранное».

## Структура, доступ, персонализация и связи портала

Портал состоит из трёх уровней:

| Уровень | Описание |
|---|---|
| **Группа** | Объединяет секции в виде вкладок |
| **Секция** | Конкретный портал, с заголовком или без |
| **Блок (виджет)** | Контент внутри секции |

**Доступ и персонализация.** Доступ к порталу определяется группами пользователей: человек видит только те порталы, которые разрешены его группам, и только те блоки, которые открыты этим группам. Изменение списка групп сразу меняет круг видимости. Фильтры блоков не открывают доступ к данным, которых у пользователя нет, — видно только то, к чему есть права.

Блок без заданных групп доступа считается публичным: его видят все, кому открыт сам портал. Если группы у блока заданы, его видит только тот, кто входит хотя бы в одну из них. Одно и то же правило действует и в списках блоков портала, и при запросе данных блока, поэтому блок, который виден в списке, всегда открывается, а чужой блок и в список не попадает, и данные по нему не отдаются.

Поверх шаблона, настроенного администратором, пользователь может сделать свой вариант компоновки страницы (персональная настройка блоков).

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

**Связи с другими доменами.** Порталы собирают данные из нескольких смежных доменов:

| Домен | Связь |
|---|---|
| Задачи | блоки «Поиск задач», «Список задач», «Диаграмма Ганта» показывают задачи |
| Отчёты | блок «График» строит сводки по данным отчётов |
| Категории | блоки «Новости» и поиска опираются на категории |
| Уведомления | счётчики и индикаторы отражают непрочитанное и события |
| Социальная сеть | блок «Лента социальной сети» показывает публикации сообществ |
| Календарь | блоки «Календарь» и «Календарь New» |

Порталы, их секции и виджеты находятся поиском: в быстром поиске результаты по ним выводятся между файлами и отчётами, в полной форме поиска для них есть вкладка «Порталы». Ищутся только порталы, свёрстанные как Board. Подробнее — [search/business.md](https://help.1forma.ru/domains/search/business.md).

Блок находится независимо от того, в какой раскладке страницы он размещён, — в том числе если оставлен только в адаптивной раскладке. Подробнее — [Поиск — бизнес-логика](https://help.1forma.ru/domains/search/business.md).

## Каталог виджетов

На портал можно добавлять разные типы блоков-виджетов — ниже показано, как выглядит каждый на портальной странице.

Часть типов показывается не во всех раскладках портала: в неподходящей раскладке вместо содержимого выводится «Виджет не поддерживается». У каждого такого виджета ниже указано, где он работает; сводка по раскладкам — [Поддержка типов по режимам вёрстки](https://help.1forma.ru/domains/portal/admin-widgets.md#поддержка-типов-по-режимам-вёрстки).

Блоки прежних версий портала — Блок статистики, Смарт-блок, Кнопки рабочего места, Дерево избранного из рабочих мест групп и другие устаревшие типы — в каталоге не описаны: они не отображаются ни в одной раскладке, вместо них выводится та же заглушка. На портале такие блоки удаляют.

У блока с настроенной фильтрацией в шапке есть кнопка «Фильтр»: она открывает окно отбора данных этого блока. Пользователь выбирает значения и нажимает «Применить» — окно закрывается, блок перезапрашивает данные под выбранный отбор, а в шапке рядом с кнопкой появляются выбранные значения; нажатие на любое из них снова открывает окно. Кнопка «Сбросить все условия» очищает условия, не закрывая окно, а если не заполнен обязательный параметр отбора, применить фильтр не удастся — окно сообщит об этом. Какие поля попадут в окно, задаёт администратор на вкладке «Настройки фильтрации»; настройка «Скрыть фильтр» прячет из шапки выбранные значения, но саму кнопку оставляет.

> Подробные настройки виджетов — [admin.md](https://help.1forma.ru/domains/portal/admin.md) и [portal-api-cookbook.md](https://help.1forma.ru/domains/portal/portal-api-cookbook.md).

### Баннер-кнопка

Баннер на главном экране портала. Нажатие открывает заданную ссылку в модальном окне, `Ctrl+клик` — в новой вкладке браузера.

![Баннер-кнопка на портальной странице](https://help.1forma.ru/help-images/portal/portal_block_edit_banner_button000.png)

### График

Сводные данные о задачах в табличном или графическом виде: линейная диаграмма, линейная (область), столбчатая, секторная (круговая), спидометр, воронка продаж, линейная с накоплением (вертикальная и горизонтальная).

У диаграмм с накоплением рядом с каждым столбцом выводится итоговая сумма по всем сериям, привязанная к краю столбца; при нулевой сумме отображается «0».

![Виды графиков на портальной странице](https://help.1forma.ru/help-images/portal/dashboards-01.png)

### Группа виджетов

Блок, в котором каждая вкладка — отдельный ранее созданный виджет со всеми его настройками (фильтры и прочие параметры). Если вкладки не помещаются в одну строку, в конце появляется кнопка «Ещё» с выпадающим списком скрытых вкладок.

![Группа виджетов на портальной странице](https://help.1forma.ru/help-images/portal/widget_group.png)

### Диаграмма Ганта

Список задач в представлении диаграммы Ганта прямо на портале.

![Диаграмма Ганта на портальной странице](https://help.1forma.ru/help-images/portal/dashboards-03.png)

### Избранное

Избранные объекты пользователя выборочно по типам: задачи, пользователи, пространства, категории, чаты, отчёты, ссылки.

![Виджет «Избранное» на портальной странице](https://help.1forma.ru/help-images/portal/portal_block_fav-02.png)

### Календарь

Данные с привязкой к дате: при выборе даты в календаре меняется список под ним. Если выбран только месяц — в списке данные за весь месяц. При количестве записей больше 20 отображаются первые 20. Обычно выводятся задачи, но могут и другие данные — например, пользователи с днями рождения.

![Виджет «Календарь» в пользовательском интерфейсе](https://help.1forma.ru/help-images/portal/portal_block_calendar_ex_n.png)

### Календарь New

Полноценный календарь событий — задачи, встречи, напоминания. В отличие от «Календаря», соответствует [календарю в профиле](https://help.1forma.ru/domains/calendar/business.md) и не используется для показа преднастроенного набора данных; дата и время соответствуют часовому поясу пользователя.

![Виджет «Календарь New» на портальной странице](https://help.1forma.ru/help-images/portal/portal_block_calendar_new-04.png)

### Контакты

Список контактов в виде списка, карусели или кругов: недавние, звонки, коллеги, избранные, сотрудники отдела оргструктуры или произвольный преднастроенный список пользователей. Для варианта «Звонки» учитываются в том числе p2p-вызовы. В карточке контакта выводится аватар, имя, индикатор присутствия и настраиваемая вторая строка: должность, подразделение, статус, тип недавнего взаимодействия, ближайший день рождения или ближайшие отсутствия сотрудника со статусом «Нет на месте» — в пределах 30 дней, с указанием времени или даты события.

![Виджет «Контакты» на портальной странице](https://help.1forma.ru/help-images/portal/portal_block_contacts-02.png)

### Лента социальной сети

Последние публикации из сообществ. Можно создать одну или несколько независимых лент — каждая отображается отдельной вкладкой. Нажатие на аватар поста ведёт в соответствующее сообщество. Доступен полный функционал: просмотр, комментирование, создание, редактирование и удаление публикаций по правам доступа. Посты, не помещающиеся в заданную высоту, плавно обрезаются градиентным затемнением под цветовую тему.

![Лента социальной сети на портальной странице](https://help.1forma.ru/help-images/portal/portal_block_edit_social_network_feed-3.png)

Внизу виджета — кнопка «Перейти ко всем постам»: ведёт к источнику публикаций (страница выбранной группы или главная лента соцсети).

![Кнопка «Перейти ко всем постам» в виджете ленты](https://help.1forma.ru/help-images/portal/portal_block_edit_social_network_feed-5.png)

### Кнопка-Тикер

Счётчик с иконкой (может быть кликабельным) или кнопка создания задачи. Нажатие открывает заданную ссылку в модальном окне, `Ctrl+клик` — в новой вкладке.

![Виджет «Кнопка-Тикер» на портальной странице](https://help.1forma.ru/help-images/portal/portal_block_edit_ticker_button00.png)

### Меню

Произвольное число кнопок, по нажатию на каждую выполняется переход на определённую страницу.

![Виджет «Меню» на портальной странице](https://help.1forma.ru/help-images/portal/dashboards-02.png)

### Мини-опрос

Пульс-опросы для быстрого сбора мнений: модераторы создают опросы в виджете, остальные пользователи голосуют. Группа модераторов и режим показа ответов — сразу в виджете или за кнопкой во всплывающем окне — задаются в настройках.

Работает только в раскладке CSS Grid: в Dashboard и в секциях Board вместо опроса выводится «Виджет не поддерживается».

### Навигация

Панель ссылок для быстрого перехода по разделам и страницам. Элементы ведут на внутренние адреса системы или на внешние ресурсы.

Работает только в раскладке CSS Grid: в Dashboard и в секциях Board вместо панели выводится «Виджет не поддерживается». Чтобы панель отображалась, страницу переводят в раскладку CSS Grid — сам блок при смене раскладки не удаляется.

![Панель навигации на портальной странице](https://help.1forma.ru/help-images/portal/portal_block_nav-3.png)

### Новости

Задачи новостных категорий в виде большого блока, списка или карусели. Количество новостей — от 1 до 6 (кроме 4). Опционально в карточке отображаются автор, рубрика, аннотация, дата публикации, счётчик реакций и счётчик просмотров. На виджете и в списке новостей счётчик реакций только отображается: поставить реакцию можно в самой новости. Новости сортируются по новым или закреплённым.

![Виджет «Новости» на портальной странице](https://help.1forma.ru/help-images/portal/dashboards-news.png)

Кнопка справа в шапке блока открывает полную ленту новостей категории в виде галереи — с фильтрацией по рубрикам и тегам. Так можно просмотреть все новости категории, а не только выведенные в виджет.

![Галерея новостей](https://help.1forma.ru/help-images/portal/dashboards-news2-.png)

Нажатие на элемент списка (в виджете или галерее) открывает карточку новости в модальном окне; набор полей карточки (обложка, автор, аннотация и т.д.) зависит от настроек новостной категории. Клик на имя автора, если это пользователь, открывает его краткую карточку профиля.

![Карточка новости в модальном окне](https://help.1forma.ru/help-images/portal/news_card_0.png)

### Поиск задач

Список задач по заданным условиям отбора. На строках могут быть настроены кнопки действий для каждой задачи — например, изменение приоритета или перевод в следующий статус.

![Виджет «Поиск задач» на портальной странице](https://help.1forma.ru/help-images/portal/dashboards-07.png)

### Список задач

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

![Виджет «Список задач» на портальной странице](https://help.1forma.ru/help-images/portal/portal_block_task_list-02.png)

### Сторис

Истории компании на портальной странице: обложки берутся из одной категории задач, страницы историй — из другой. Настройка блока — две обязательные категории и дополнительные параметры, которые связывают обложку с её страницами.

Пока категории не выбраны, вместо обложек выводится сообщение «Сторис не настроены. Откройте настройки виджета и выберите категории обложек и страниц.».

### Счётчики

Различные счётчики на портальной странице.

![Виджет «Счётчики» на портальной странице](https://help.1forma.ru/help-images/portal/portal_block_tickers-02.png)

### Таблица

Произвольная информация в табличном виде.

![Виджет «Таблица» на портальной странице](https://help.1forma.ru/help-images/portal/dashboards-08.png)

Колонки таблицы можно раскрашивать и настраивать по ним счётчики значений.

Строки таблицы можно группировать: у колонки выбирается роль «Группировка строк», и записи объединяются в сворачиваемые группы по её значениям, со счётчиком строк в заголовке группы. Групп может быть несколько уровней — по числу колонок с такой ролью.

**Выгрузка в Excel.** Число выгружаемых строк ограничено настройкой системы (по умолчанию 50 000). Если строк в блоке больше предела, выгрузка не выполняется: блок сразу сообщает «Строк в блоке: N, предел выгрузки: M. Сузьте отбор и повторите», а если превышение обнаружит сервер, открывается окно «Не удалось выгрузить в Excel» с причиной отказа. Отказ сервера при выгрузке из виджета «График» показывается тем же окном.

![Цвет и счётчики значений в колонках таблицы](https://help.1forma.ru/help-images/portal/portal_block_edit_table_color_count004.png)

### Фильтр

Управляет данными в других блоках портала. На одной странице может быть несколько независимых фильтров; дубли с одинаковым набором параметров запрещены.

Не путать с кнопкой «Фильтр» в шапке блока ([Каталог виджетов](#каталог-виджетов)): она фильтрует данные самого блока, а блок «Фильтр» — данные соседних.

![Виджет «Фильтр» на портальной странице](https://help.1forma.ru/help-images/portal/portal_block_filter-0.png)

Выпадающий список параметра фильтра при открытии портала свёрнут и раскрывается по нажатию. Иерархическим деревом значения показываются только тогда, когда в данных есть элементы со связью с родителем; подробности настройки и диагностики — в разделе «Фильтры» документации администратора.