Открытие документов Office

В библиотеке документов Portal файл Word, Excel или PowerPoint можно скачать, открыть в браузере (Portal Office) или открыть в установленном на компьютере Office. Какой способ срабатывает по клику на имя файла, задаёт администратор в настройках библиотеки.

Эта страница — для сотрудников и для тех, кто настраивает библиотеку. Установка онлайн-редактора: Portal Office (установка).

1. Три способа открыть файл

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

Форматы: обычно DOCX, XLSX, PPTX, ODT, ODS, ODP и ряд родственных (DOC, XLS, PPT, RTF, CSV и др.). Картинки, PDF и прочие файлы эта настройка не меняет: картинки открываются в просмотрщике, остальное скачивается.

2. Что происходит по клику и что в меню

Клик по имени офисного файла следует настройке библиотеки.

В меню ⋮ у строки всегда доступны все подходящие действия, даже если клик настроен иначе:

Просмотр / Редактировать — Portal Office (если служба включена и есть право);
Открыть в приложении — клиентский Office;
Скачать — копия на диск;
Снять блокировку — если файл изъят и у вас есть право снять checkout (см. §6).

Так можно один раз открыть документ в Word, даже если библиотека по умолчанию «скачивать».

3. Настройка библиотеки (администратор портала)

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

Значение	Когда выбирать
Скачать	Нет единого корпоративного Office на рабочих местах; достаточно выгрузки файла
Portal Office (в браузере)	Сотрудники правят в браузере, без установки Office. Пункт недоступен, если служба выключена
Клиентское приложение	На компьютерах установлен Word / LibreOffice / МойОфис / Р7, нужна привычная правка «как с диска», но файл живёт на портале

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

Если выбран Portal Office, а службу позже выключили, клик снова ведёт к скачиванию, пока настройку не изменят.

4. Открыть в клиентском приложении — по шагам

Убедитесь, что на компьютере установлен Office (Microsoft Office, LibreOffice, типичные сборки МойОфис или Р7).
В библиотеке найдите файл.
Либо кликните имя (если в настройках выбран режим Клиентское приложение), либо ⋮ → Открыть в приложении.
Браузер предложит открыть ссылку вида ms-word: / ms-excel: / ms-powerpoint: или команду LibreOffice. Подтвердите запуск.
Документ откроется в приложении. Правьте как обычно.
Нажмите Сохранить (Ctrl+S / Cmd+S). Portal записывает новую версию файла (в журнале версий комментарий «Клиентское приложение»).
Закройте документ в приложении — изъятие снимется, файл снова можно править другим.

Если приложение не запустилось, портал покажет сообщение: установите Office или скачайте файл через ⋮ → Скачать.

Чтобы открыть всю библиотеку или папку в Проводнике, используйте Portal Drive — это другой клиент, не WebDAV.

Что нужно на стороне инфраструктуры

Портал открывается по HTTPS (исключение — localhost). Microsoft Office не сохраняет на WebDAV по обычному HTTP.
С компьютера должен быть доступен тот же адрес портала, что в браузере (не внутреннее docker-имя).
Прокси (nginx) пропускает методы WebDAV на /api/v1/dav/ — в поставке Portal это уже настроено.

5. Portal Office в браузере

Если служба включена:

⋮ → Просмотр или Редактировать (или клик, если так настроена библиотека).
Документ открывается в окне поверх портала.
Несколько человек могут править один и тот же файл одновременно — это умеет только Portal Office, не клиентский Word.

Подробнее: Portal Office.

Нельзя одновременно править файл в Portal Office и в клиентском приложении: кто первый изъял документ на запись, тот и держит блокировку.

6. Кто держит файл и как снять блокировку

Пока документ открыт на правку в клиентском приложении, Portal ставит checkout (изъятие):

Действие второго пользователя	Результат
Скачать, открыть свойства, смотреть	Можно
Открыть на правку в клиенте	Отказ: файл редактирует коллега
Открыть на правку в Portal Office	Отказ
Сохранить свою копию поверх	Отказ (HTTP 423), версия автора не затирается

В списке файлов у изъятого документа — бейдж «Редактирует …» (кто и с какого времени).

Checkout не снимается через 30 минут. Он живёт, пока автор не закроет документ в приложении, либо пока блокировку не снимут вручную. Человек может править договор сутки и дольше — у остальных Edit остаётся закрытым.

Если автор ушёл, ПК завис, отпуск

В строке файла откройте ⋮.
Нажмите Снять блокировку.
Подтвердите. В диалоге видно, кто держит файл и с какого времени.

Снимать checkout могут:

администратор портала;
пользователь с полным доступом к библиотеке (уровень «удаление»);
сам автор изъятия (если приложение закрылось без UNLOCK).

После снятия файл снова можно править. Если у автора Word всё ещё открыт, его следующий Сохранить на сервер уже не пройдёт — правки останутся только локально; их можно сохранить на диск и загрузить как новую версию вручную. Это ожидаемо.

Страховка от «вечного» мусора: если по изъятию не было активности 14 суток, Portal считает его брошенным. Основной способ разблокировать файл после отпуска — кнопка, не таймер.

Скачивание через Скачать checkout не ставит: два человека могут скачать копии и потом загрузить версии вручную (как раньше, без live-блокировки).

7. Совместная работа: что умеет, чего нет

Сценарий	Поведение
Двое в Portal Office	Совместная правка в браузере (как раньше)
Один в клиентском Word, второй хочет править	Второй ждёт или просит снять блокировку
Двое в клиентском Word	Нельзя: exclusive checkout, без merge
Один скачал, второй правит в клиенте	Скачанная копия устаревает; актуальная — на сервере после Save

8. Журнал версий

Save из клиентского приложения → новая версия, комментарий «Клиентское приложение».
Save из Portal Office → новая версия, комментарий «Portal Office».
В открытой библиотеке бейдж версии обновляется сразу после Save (SSE, без опроса списка).
История: ⋮ → Журнал версий. Старые копии не пропадают, даже если «текущий» файл перезаписали.

9. Если что-то не открывается

Симптом	Что проверить
Нет пункта «Открыть в приложении»	Файл не офисного формата
Нет «Просмотр» / «Редактировать»	Portal Office выключен или нет права
Клик скачивает, хотя ждали Word	В Настройках библиотеки режим не «Клиентское приложение» — используйте ⋮
Браузер не запускает Word/LibreOffice	Приложение не установлено или не зарегистрировало протокол ОС. Разрешите открытие ссылки `ms-word:` / LibreOffice
Word/Excel открыл, Save пишет «сохраните с новым именем»	Файл открыт как копия или PUT на WebDAV не прошёл. Закройте книгу, откройте снова из портала (нужен HTTPS или хост `localhost`, не `127.0.0.1`). Если сняли блокировку — сессия автора уже не пишет
«Файл редактирует Иванов»	Дождитесь закрытия или снимите блокировку, если есть право
Microsoft Office на macOS/Windows ругается на HTTP	Откройте портал по HTTPS

Администратору: логи backend при PUT/LOCK, доступность /api/v1/dav/ через тот же nginx, что отдаёт сайт, office_open_mode в ответе GET /libraries/{id}.