В Диске коробочного Битрикс24 появляется пункт «A4». Сотрудник открывает книгу прямо из портала, правит её в браузере, а сохранение попадает в историю Диска новой версией. Администратор ставит один модуль; ядро портала не меняется, файлы остаются в Диске.
Запись с портала: книга из Диска открывается в редакторе таблиц, правка ячейки сохраняется, в истории Диска появляется новая версия.
Что умеет
в меню файла Диска есть пункт A4; книга .xlsm открывается в редакторе в браузере;
документы .docx открываются в редакторе A4, презентации .pptx — в редакторе P2; сохранение становится новой версией файла в Диске;
после правки ячейки и закрытия редактора в истории Диска появляется ровно одна новая версия;
книга с макросами сохраняется целиком: число частей файла не меняется, проект VBA остаётся байт в байт прежним;
сохранённую версию открывает Microsoft Excel без диалога восстановления;
замена предыдущего модуля переносит все настройки без повторного ввода: адрес редактора, публичный адрес портала, проверку подписи запросов и ключи организаций. Объекты Диска и их история версий остаются на месте.
Чего нет. Макросы сохраняются, но в браузере не запускаются.
Как работает
Где живут файлы. В Диске Битрикс24, как и раньше. История версий остаётся у того же объекта Диска.
Путь документа. Модуль регистрирует свой обработчик документов Диска и работает по протоколу WOPI. Сервер редакторов получает файл от портала внутри сети организации и возвращает сохранённую книгу; Диск записывает её новой версией.
Что не уходит из сети. Файл передаётся только между порталом, сервером редакторов в сети организации и браузером сотрудника. Ключи организаций хранятся в настройках портала и не попадают в архив модуля, журналы и документацию.
Чего модуль не делает. Не меняет файлы ядра портала, не назначает A4 редактором по умолчанию, не удаляет объекты Диска и их историю. Не использует и не обходит штатный платный коннектор сервера документов Битрикс24.
Требования
коробочный Битрикс24 с модулем «Диск»;
сервер редакторов A4 в сети организации и HTTPS-адрес его discovery. В комплект модуля сервер не входит;
права на запись в local/modules/ и доступ к административной части портала;
резервная копия базы и каталога портала.
Не открывайте сервер редакторов в публичный Интернет без сетевых ограничений.
Установка
До установки
сделайте резервную копию базы и каталога портала;
закройте открытые редакторы документов;
сверьте SHA-256 архива модуля с SHA256SUMS.
Шаги
Распакуйте ZIP модуля из комплекта в local/modules/. Итоговый каталог должен называться local/modules/a4.wopi.
В административной части откройте Настройки → Настройки продукта → Модули и установите A4.
В настройках модуля укажите адрес discovery сервера редакторов, публичный адрес портала и оставьте проверку подписи запросов (proof-key) включённой.
Убедитесь, что открывается маршрут /a4/open.php, а в меню файла Диска появился пункт A4.
Первая проверка
Загрузите в Диск отдельную контрольную копию книги .xlsm.
Откройте её через A4, измените одну ячейку и дождитесь сохранения.
Закройте редактор. В истории Диска должна появиться ровно одна новая версия.
Скачайте новую версию и откройте её в настольном Excel. Для точной проверки сравните SHA-256 файла xl/vbaProject.bin до и после.
Обновление и откат
Замена предыдущего модуля
У модуля сменился технический идентификатор, поэтому это управляемая замена, а не обновление того же модуля.
Сделайте резервную копию базы и каталога портала.
Закройте все редакторы и дождитесь, пока снимутся блокировки редактирования.
Распакуйте ZIP модуля в local/modules/ и установите A4.
Установщик сначала проверит, что прежние каталоги можно удалить. Если прав не хватает, он остановится с понятным сообщением и ничего не переключит.
Установщик перенесёт адрес discovery, публичный адрес, настройку подписи запросов и ключи организаций, зарегистрирует маршруты /a4/, снимет прежний обработчик и удалит его файлы и настройки.
Откройте настройки A4 — секреты вводить заново не нужно. Выполните первую проверку. История версий Диска остаётся у тех же объектов.
После замены: новый модуль зарегистрирован, прежний — нет; прежних каталогов и строк настроек не остаётся; /a4/open.php отвечает, прежний маршрут — нет; у контрольного файла сохраняются все версии.
Откат
Остановите новые сеансы редактора.
Восстановите базу и каталоги портала из резервной копии, сделанной до замены.
Верните прежний образ сервера редакторов, если он менялся.
Очистите управляемый кеш Битрикс24 и перезапустите PHP-FPM.
Проверьте прежний обработчик и откройте контрольный файл без сохранения.
Переустановка одного только старого ZIP откатом не считается: после смены идентификатора источник истины — резервная копия базы и файлов.
Безопасность
Файл хранится в Диске и передаётся редактору внутри сети организации.
Ключи организаций хранятся в настройках портала и не входят в ZIP, журналы, документацию и SHA256SUMS.
Проверка подписи запросов (proof-key) должна быть включена. Публичный адрес портала открывайте только в доверенной сети или через HTTPS-шлюз с ограничением доступа.
Перед заменой установщик требует закрыть активные сеансы редактирования и проверяет, что прежние каталоги можно удалить.
