A4 · документация
Предварительно

A4 для Битрикс24 (коробка)

Модуль добавляет в Диск портала обработчик «A4»: книга открывается в редакторе таблиц F1, документ — в редакторе A4; после сохранения в истории Диска появляется новая версия от имени пользователя.

Статус. Открытие и сохранение книги .xlsm проверены: файл и макросы после круга совпадают байт в байт. Документы .docx, совместная правка и сценарии отказов ещё проверяются. Не ставьте модуль в рабочий портал — только на тестовый.

Проверено: Битрикс24 «Энтерпрайз», главный модуль 26.800.0, Диск 26.1175.0.

Два способа подключения — не путайте

  1. Штатный экран «Настройки модулей → Диск → Собственный сервер документов». В проверенной редакции он доступен только с отдельным платным расширением лицензии Битрикс24. Модуль A4 этот экран не использует и не обходит.
  2. Модуль A4 регистрирует отдельный обработчик документов Диска и работает по протоколу WOPI. Ядро Битрикс24 не меняется. Дальше описан этот способ.

Что понадобится

Установка

  1. Скопируйте каталог модуля из комплекта в <document-root>/local/modules/.
  2. В административной части откройте «Настройки → Настройки продукта → Модули» и установите модуль A4.
  3. Установщик создаст таблицу блокировок, зарегистрирует обработчик Диска и публичные адреса модуля для редактора.
  4. В настройках модуля укажите адрес /hosting/discovery сервера A4, публичный адрес портала и оставьте проверку подписи запросов (proof-key) включённой.
  5. Убедитесь, что сервер редакторов открывает публичный адрес портала, а браузер — адрес сервера A4. В рабочем контуре оба направления — только HTTPS с доверенным сертификатом.

Первая проверка

  1. Загрузите в Диск отдельную контрольную копию книги.
  2. В меню файла выберите обработчик A4.
  3. Измените одну ячейку, дождитесь сохранения и закройте редактор.
  4. В истории Диска должна появиться новая версия от вашего имени.
  5. Скачайте её и откройте в Excel: без диалога восстановления, макросы на месте.

Типовые ошибки

СимптомЧто проверить
A4 нет в меню ДискаМодуль установлен, обработчик зарегистрирован
Пустое окно, редактор не загрузилсяАдрес discovery открывается из браузера; HTTPS; тип файла есть в discovery
Редактор открылся, но файла нетПубличный адрес портала доступен из сети редактора; ссылка не устарела; подпись запросов совпадает
Ответ 409 при сохраненииФайл изменился в Диске после открытия: закройте старую сессию и откройте файл заново. Более новую версию молча не затираем
Нет новой версииПраво пользователя на изменение файла, блокировка, журнал редактора
Штатная кнопка «Собственный сервер документов» неактивнаЭто другой способ и отдельная лицензия; на модуль A4 не влияет