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

Пространства — базы знаний (вики) внутри 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. Важные ссылки рекомендуется размещать в основном содержании статьи, а не только в блоке полезных ссылок.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Пространства как домен 1Формы связаны с несколькими смежными доменами через общие сущности и права:

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