Пространства

Обзор

Пространства — это базы знаний (вики) внутри 1Формы: статьи, организованные в дерево разделов. Пользователи читают и редактируют статьи прямо в браузере. Технически пространство — это категория особого типа, а статья — задача с контентом в блочном редакторе; для пользователя эти детали скрыты.

Основные сущности

Пространство

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

Статья пространства

Статья — контентная запись в пространстве. У статьи есть:

Поле	Описание
Содержимое страницы	Основной контент статьи (текст, таблицы, изображения и др.)
Дополнительная информация	Дополнительный текст без форматирования
Обложка	Изображение в шапке статьи
Превью обложки	Уменьшенное изображение обложки
Родительский элемент	Статья, которой подчинена текущая (для построения дерева)
Спецраздел	Архив, Корзина или Вне меню

Иерархия статей

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

• Корневая статья
  • Дочерняя статья
    • Ещё глубже вложенная
  • Другая дочерняя статья

Спецразделы

Статью можно пометить одним из спецразделов:

• Архив — не отображается в основном дереве, но доступна по прямой ссылке.
• Корзина — «удалённые» статьи (мягкое удаление, можно восстановить).
• Вне меню — доступна по ссылке, но не показывается в навигации.

Ключевые правила

Работа пространств подчиняется нескольким правилам:

1. Видимость блока «Пространства» в интерфейсе зависит от настроек рабочего места группы.
2. Глобально пространства включает или отключает администратор.
3. Доступ к конкретному пространству определяется правами на соответствующую категорию.
4. Контент статьи состоит из блоков: абзац, заголовок, код, список, таблица, изображение и др.
5. Открытие и редактирование статьи фиксируются в журнале (для аудита).
6. В пространства можно переходить из других разделов: из соцсети, из избранного, из оргструктуры, через портальные блоки.

Пользовательские сценарии

Типичные действия пользователя с пространствами:

1. Открыть список пространств из меню сервисов.
2. Перейти в конкретное пространство, увидеть дерево статей.
3. Открыть статью (в полном или коротком режиме).
4. Редактировать статью в блочном редакторе.
5. Создать новую статью в пространстве.
6. Перейти по ссылке на статью из избранного/портала/соцсети.
7. Посмотреть историю просмотренных/отредактированных статей.

Интерфейс пространств

Переход к пространствам — из меню сервисов в панели навигации. В разделе показываются только категории, настроенные как пространства (видимость зависит от прав пользователя).

Экран пространства состоит из двух областей:

• Слева — дерево разделов и статей. Уровень вложенности не ограничен, одна статья не может находиться сразу в нескольких разделах. При открытии статьи дерево подсвечивает её положение.
• Справа — рабочая область с вкладками:

Вкладка	Что отображается
Избранные	Статьи, добавленные в избранное (в порядке добавления)
Автор	Статьи, где пользователь — автор (заказчик); сортировка по дате последнего изменения
Ответственный	Статьи, где пользователь отмечен как «Ответственный» в поле «Контакты»
Подписка	Статьи, где пользователь добавлен в контакты (подписчик)

Внутри раздела статьи отсортированы по дате создания. По умолчанию статьи пространства не попадают в блок избранного «Мои задачи».

Поиск и номер статьи

Кнопка лупы в правом верхнем углу раскрывает поисковую строку. Поиск идёт по содержанию доступных пользователю статей без учёта вкладок. Поиск по названиям пространств выполняется через главный поиск.

В шапке открытой статьи рядом с хлебными крошками отображается её номер (формат #1777172). При наведении появляется иконка копирования: номер копируется с символом #, но в главном поиске находится и без него.

Для возврата к списку всех пространств используется кнопка «Все пространства» в верхней части экрана.

Создание статьи

Кнопка «Добавить» доступна пользователю только при наличии права на создание статей в текущем пространстве. Если в пространстве уже есть статьи, новая страница создаётся как подстраница через действие в дереве при наведении на пространство.

Форма создания статьи содержит поля:

Поле страницы	Бизнес-смысл
Название страницы	Заголовок статьи в дереве и на странице
Автор	По умолчанию пользователь, создавший статью; может быть изменён
Контакты	Пользователи, отвечающие за статью
Содержание	Текст статьи в блочном редакторе

Обложка статьи загружается отдельным файлом в формате JPG или PNG и отображается в шапке статьи. Удаление обложки выполняется в режиме редактирования через контекстное меню по обложке.

Содержание статьи

Содержание статьи собирается из блоков. Пользователь может добавлять:

Блок	Правило поведения
Параграф	Основной текст; выбран по умолчанию, можно сразу вводить текст
Заголовок	Поддерживает 6 уровней, где 1 — самый крупный
Таблица	Поддерживает добавление и удаление строк и колонок, выбор ширины (обычная, увеличенная или максимальная), необязательный заголовок
Разделитель	Использует символы ***
Список	По умолчанию маркированный; может переключаться в нумерованный. Нажатие Enter создаёт новый маркер, повторное нажатие завершает редактирование блока
Изображение	Поддерживает подпись, рамку, растяжение и фон
Вложения	Файлы из текста статьи также отображаются в файловом блоке статьи
Чеклист	Список пунктов с отметками
Цитата	Основной текст цитаты и отдельное поле автора
Код	Блок для программного кода
Виджет	Встраивает настроенный портальный блок; размер — автоматический, маленький, средний или большой

Элемент добавляется по кнопке «+» слева от рабочей области: в выпадающем списке выбирается нужный тип. После добавления у элемента появляется «значок перетаскивания», нажатие на который раскрывает настройки элемента; у каждого типа свой набор настроек (например, уровень заголовка, ширина и заголовок таблицы, рамка/растяжение/фон изображения, тип списка).

Общие для всех типов настройки:

Пункт	Действие
Переместить вверх	Переместить элемент на уровень выше
Переместить вниз	Переместить элемент на уровень ниже
Удалить	Удалить элемент. После одиночного нажатия пункт загорится красным — защита от удаления по ошибке; для подтверждения пункт нажимают ещё раз

Форматирование доступно для текста внутри большинства блоков: ссылка, жирный, курсив, зачёркивание, подчёркивание, код, цвет текста и фон. Для ссылки поддерживаются горячие клавиши cmd + K / Ctrl + K, для жирного — cmd + B / Ctrl + B, для курсива — cmd + I / Ctrl + I. Панель форматирования также содержит пункт >> для конвертации элемента в другой доступный тип.

⚠️ На одном фрагменте текста применяется либо цвет текста, либо цвет фона. При установке одного оформления ранее заданное альтернативное оформление снимается.

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

В таблице строка или колонка добавляется в конец по кнопке «+» после существующих строк/колонок. Чтобы вставить строку в середину, наводят курсор на строку — рядом появляется кнопка редактирования; по ней выбирают «Добавить строку выше» или «Добавить строку ниже» (для колонок — «Добавить столбец слева» / «Добавить столбец справа»). Удаление строки выполняется через ту же кнопку редактирования: после первого нажатия пункт удаления загорается красным, для подтверждения его нажимают ещё раз; удаление колонки выполняется аналогично.

Ссылки на видеоконференции и видео автоматически преобразуются в интерактивный блок предпросмотра или встроенный видеоблок.

Редактирование и аудит изменений

Кнопка «Редактировать» доступна только пользователю с правом «Администратор задач» в текущем пространстве. В режиме редактирования можно менять содержание, автора, контакты, обложку, полезные ссылки и раздел статьи.

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

⚠️ Для отображения автора последнего изменения у параметра категории «Пространство - Содержимое страницы» должна быть включена настройка сохранения истории изменений ДП. Административные настройки пространств описаны в admin.md.

Навигация, полезные ссылки и избранное

В статье доступны кнопки перехода к предыдущей и следующей странице пространства. На первой странице показывается только переход к следующей статье, на последней — только переход к предыдущей.

Полезные ссылки используются для второстепенных ссылок, связанных с контекстом статьи: страницы портала, задачи, внешние URL. Важные ссылки рекомендуется размещать в основном содержании статьи, а не только в блоке полезных ссылок.

Статью можно добавить в избранное по кнопке «Избранное» в правой верхней части страницы. Открывается окно с полями:

Поле	Назначение
Выберите цвет	Цвет, которым статья будет помечена в блоке «Избранное»
Выберите папку	Папка избранного для ссылки на статью. Если папок несколько, статью можно поместить сразу в несколько: в выпадающем списке выбирают папку, нажимают кнопку «+» справа от поля, затем выбирают следующую. Выбранные папки появляются в нижней части окна

Кнопка «Добавить» сохраняет статью в блок «Избранное», кнопка «Отмена» закрывает окно без добавления. После добавления статья отображается во вкладке «Избранное» внутри пространства и в общем блоке избранного бокового меню. Настройка видимости блоков рабочего места относится к разделу пользователи и группы.

Действия со статьёй

Стандартные действия доступны в меню «Больше действий». Набор действий зависит от прав пользователя:

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

⚠️ Действия «Переместить», «Дублировать», «Архивировать» и «Удалить» доступны только пользователю с правом «Администратор задач» в текущем пространстве.

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

Архив и корзина являются мягкими спецразделами. Чтобы окончательно убрать статью из корзины, её открывают как задачу из дерева категорий и завершают; возврат задачи в активный статус снова делает статью доступной из корзины.

Служебные разделы и дополнительные действия

Служебные разделы «Вне меню», «Архив» и «Корзина» видны в списке пространств администраторам и пользователям с правом создавать задачи в категории. В режиме редактирования пользователь может изменить раздел статьи, включая служебные разделы.

Для отдельных пространств администратор может настроить дополнительные действия над статьёй. Они отображаются ниже стандартных действий, отделяются горизонтальной чертой и могут быть сгруппированы в пункт «Другие действия».

Файлы в статье

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

Если в файловом блоке нет файлов, блок не отображается при просмотре статьи. В режиме редактирования блок «Файлы» становится видимым, чтобы пользователь мог добавить вложение.

Связи с другими доменами

Пространства связаны с несколькими смежными доменами:

Домен	Зависимость
Категории	тип категории «Пространство», права, системные ДП
Дополнительные параметры	хранение содержимого и других полей статьи
Файлы	вложения, изображения и файловый блок внутри статьи
Социальная сеть	создание статей из формы публикации
Портал	переходы и отображение контента через блоки
Пользователи и группы	видимость блока пространств, права групп
Задачи	статья реализована как задача