Библиотека документов

Библиотека — хранилище файлов внутри узла: договоры, шаблоны, PDF, изображения. Это не список и не «вложения к заявке» — отдельный объект со своими папками и файлами.

Чтобы создать библиотеку, нужно право Редактирование на узел (или роль администратора портала).

0. Что будет после успеха

В Контенте сайта появится библиотека.
Можно создавать папки, загружать и скачивать файлы.
При настроенном Portal Office — открывать документы прямо в браузере.
По желанию — открывать Word/Excel в установленном на компьютере Office с записью Save сразу на сервер.

1. Создать библиотеку

Откройте нужный узел.
Нажмите Контент сайта (внизу боковой панели).
Найдите панель Библиотеки.
Нажмите + Библиотека.
Укажите Название (и описание при необходимости).
Сохраните.

Библиотека появится в списке и откроется для работы.

2. Загрузить файл

Откройте библиотеку.
При необходимости зайдите в нужную папку (или создайте папку кнопкой создания папки).
Нажмите кнопку загрузки (часто Загрузить / область drag-and-drop).
Выберите файл(ы) на компьютере.
Дождитесь окончания загрузки — файл появится в таблице.

Что ожидать

В строке файла — имя, дата, автор (в зависимости от колонок представления).
Меню ⋮ у строки даёт действия: открыть, скачать, Свойства, права, удалить и др.

Настраиваемые поля

Администратор: Настройки библиотеки → вкладка Поля. Типы — как у списков, включая выражение: оно пересчитывается при сохранении свойств. Добавьте поле в колонки представления (Представления). У файла/папки: ⋮ → Свойства. Загрузка файла не требует заполнить обязательные поля — их спрашивают при сохранении свойств.

3. Скачать файл

В строке файла откройте меню ⋮.
Нажмите Скачать.

Файл сохранится на компьютер.
(Превью в браузере для некоторых типов доступно при открытии / просмотре — зависит от формата и настроек Portal Office.)

4. Папки

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

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

5. Права на библиотеку

По умолчанию библиотека наследует права узла.
Отдельные права на библиотеку или файл назначает администратор портала:

библиотека: Настройки библиотеки → вкладка Права;
файл/папка: кнопка Права (щит) в списке файлов.

Подробнее: Права на список (логика та же) и Права доступа.

6. Как открываются документы Office

Настройка на одну библиотеку. Новая библиотека по умолчанию — Скачать (как раньше: клик по имени качает файл).

6.1. Где включить

Откройте библиотеку.
Настройки (шестерёнка) → вкладка Общие.
Блок Как открывать документы Office.
Выберите режим и Сохранить.

Нужно право Редактирование на библиотеку (или роль администратора портала). Пункт Portal Office недоступен, если служба выключена (office.enabled / PORTAL_OFFICE_ENABLED).

Режим	Клик по имени офисного файла	Save на сервер
Скачать	Браузер сохраняет копию	Нет: правки только локально, потом загрузка версии вручную
Portal Office	Редактор в браузере	Да
Клиентское приложение	Word / Excel / LibreOffice / МойОфис / Р7 на компьютере	Да: «Сохранить» в приложении сразу пишет новую версию

Картинки, PDF и прочие файлы эта настройка не меняет.

6.2. Меню строки

В ⋮ всегда остаются все подходящие действия, даже если клик настроен иначе: Скачать, при включённом Portal Office — Просмотр / Редактировать, для офисных файлов — Открыть в приложении.

6.3. Checkout (изъятие) при правке в клиенте

Пока документ открыт на правку в клиентском Office, Portal держит exclusive checkout. Срок не 30 минут: файл может быть открыт сутки и дольше.

Скачать и смотреть можно.
Править в клиенте или в Portal Office — нельзя (бейдж «Редактирует …»).
Снять: автор, сотрудник с полным доступом к документу (уровень Delete на файле) или администратор портала — ⋮ → Снять блокировку.
Через 8 часов блокировка не снимается. Если клиентский документ открыт 14 суток, автору приходит одно уведомление. Без активности 14 суток checkout считается брошенным. Portal Drive держит свою блокировку 15 минут и только на время сохранения.
После снятия следующий Save у автора, у которого Word ещё открыт, на сервер не пройдёт (HTTP 423).

Совместного редактирования в двух Word нет. Одновременно править один файл в Portal Office и в клиенте тоже нельзя.

Клиентскому Office нужен HTTPS (кроме хоста localhost, не 127.0.0.1) и доступ к адресу портала с компьютера пользователя. Прокси должен пропускать /api/v1/dav/ (в поставке nginx/Helm уже настроено: до 4 ГБ, без буферизации).

После Save из клиентского приложения или Portal Office номер версии в таблице обновляется сразу по SSE (GET /files/live) — без периодического опроса. Для закрытия Word/Excel браузер не получает событие; достаточно открытой вкладки библиотеки. Если поток SSE недоступен, список обновится при возврате на вкладку или закрытии модалки Portal Office.

Полная инструкция: Открытие документов Office.
Portal Office в браузере: для пользователей, установка.

Кнопка Диск в шапке библиотеки открывает окно Portal Drive: один раз ставится приложение, дальше — Подключить диск (без команд в терминале). Это не WebDAV. См. Portal Drive.