A4 для Битрикс24
Решение «A4: документы, таблицы и презентации в Диске» добавляет в Диск коробочного портала команду «A4». Таблицы открываются в A4 Таблице, документы — в A4 Документе, презентации — в A4 Презентации на сервере вашей организации; сохранённая правка возвращается новой версией того же файла. Решение опубликовано в Маркетплейсе 1С-Битрикс и ставится оттуда в несколько щелчков.
Откроется в редакторе A4 Документ прямо в браузере. Скачать документ можно там же: «Файл → Скачать».
Что умеет
- в Диске при просмотре файла: «…» → «Редактировать» → A4. Таблицы
.xlsxи.xlsmоткрываются в A4 Таблице, документы.docx— в A4 Документе, презентации.pptx— в A4 Презентации; - несколько сотрудников правят один файл одновременно и видят курсоры друг друга;
- сохранённая правка становится новой версией того же файла; история версий и права доступа остаются в портале;
- после правки и закрытия редактора в истории Диска появляется ровно одна новая версия;
- книга с макросами сохраняется целиком: проект VBA остаётся байт в байт прежним, сохранённую версию Microsoft Excel открывает без диалога восстановления.
Как работает
- Где живут файлы. В Диске портала, как и раньше. История версий остаётся у того же объекта Диска.
- Путь документа. Модуль регистрирует свой обработчик документов Диска и работает по протоколу WOPI. Сервер редакторов получает файл от портала внутри сети организации и возвращает сохранённый файл; Диск записывает его новой версией от имени того, кто правил.
- Что не уходит из сети. Документы обрабатываются сервером A4 вашей организации и не передаются в облако разработчика. Ключи организаций хранятся в настройках портала и не попадают в архив модуля, журналы и документацию.
- Ядро портала. Модуль не меняет файлы ядра: он добавляет обработчик Диска, таблицу замков WOPI и маршруты
/a4office/open.phpи/a4office/wopi/files/<id>.
Требования
- коробочная версия Битрикс24 с модулем «Диск»;
- PHP 8.2 или новее;
- MySQL либо PostgreSQL;
- сервер A4 с редакторами A4 Таблица, A4 Документ и A4 Презентация в режиме WOPI — комплект «Сервер A4», файл
docker-compose-wopi.yml(раздел «Сервер редакторов» ниже); - HTTPS и WebSocket между браузером, порталом и сервером редакторов; публичный адрес портала, доступный серверу редакторов.
Сервер редакторов держите в сети организации или за HTTPS-шлюзом, открытым только для сети организации.
Сервер редакторов
Редакторы ставятся на отдельную машину Linux x86-64 с Docker из комплекта «Сервер A4».
Текущий комплект — 2026-10-17, постоянный адрес dl.plantype.ru/a4-server/release/current/. Изменена только A4 Таблица (F1 2026.4.0.20261017) — исправление безопасности веб-режима: гостевым каналам закрыто чтение файлов сервера, WOPI — только к разрешённому хосту. Обновиться всем.
Интернет при установке не нужен. Пошаговая инструкция с проверками лежит в комплекте — файл BITRIX24.md. Коротко:
- Скачайте комплект и сверьте суммы:
sha256sum -c SHA256SUMS. Загрузите три образа:docker load -i …. - Рядом с
docker-compose-wopi.ymlсоздайте файл.env:PORTAL_URL=https://portal.example.ru EDITORS_URL=https://office.example.ru - Запустите:
docker compose -f docker-compose-wopi.yml up -d. - Поставьте nginx из
nginx-wopi.confс доверенным сертификатом дляoffice.example.ru. Модуль скачивает discovery с проверкой сертификата: если сертификат выпущен внутренним центром организации, добавьте его корневой сертификат в доверенные на сервере портала. - Проверьте с сервера портала:
curl -s https://office.example.ru/hosting/discovery— в ответе естьdocxиxlsx.
Установка из Маркетплейса
До установки
- установите и настройте сервер A4;
- сделайте резервную копию базы и каталога портала.
Шаги
- В административной части портала откройте Маркетплейс, найдите A4 — решение «A4: документы, таблицы и презентации в Диске» — или откройте его страницу в Маркетплейсе.
- Нажмите Установить и подтвердите установку. Решение бесплатное.
- Откройте настройки модуля (Настройки → Настройки продукта → Настройки модулей → A4: документы, таблицы и презентации в Диске) и заполните:
- Адрес описания редакторов (discovery) —
https://office.example.ru/hosting/discovery; - Адрес сервера презентаций A4 Презентация (discovery) —
https://office.example.ru/p2/hosting/discovery; - Публичный адрес портала — со схемой, например
https://portal.example.ru; он должен открываться и из браузера, и с сервера редакторов; - Проверять подписи запросов редакторов — оставьте включённым;
- Показывать в меню Диска только A4 — по желанию: убирает из меню «Редактировать» и «Создать» Google Docs, MS Office Online и Office365 (с версии 0.3.12).
- Адрес описания редакторов (discovery) —
- Проверьте настройки модуля «Диск» (Настройки → Настройки продукта → Настройки модулей → Диск): флажок «Включить работу с документами через внешние службы» должен быть включён — без него Диск не показывает A4 в меню «Редактировать». Если флажок выключен, страница настроек A4 предупреждает об этом (с версии 0.3.12).
- Откройте любой файл в Диске: в меню «…» → «Редактировать» появился пункт A4.
Первая проверка
- Загрузите в Диск контрольные копии
.xlsx,.docxи.pptx. - Откройте каждую через «…» → «Редактировать» → A4, внесите правку и дождитесь надписи о сохранении.
- Закройте редактор. В истории Диска должна появиться новая версия файла, а после повторного открытия правка на месте.
- Новый файл — Диск → «Добавить» → «A4» → «Документ», «Таблица» или «Презентация» (с версии модуля 0.3.9).
- Для книги с макросами скачайте новую версию и откройте её в настольном Excel; для точной проверки сравните SHA-256 файла
xl/vbaProject.binдо и после.
Ручная установка
Для порталов, где Маркетплейс недоступен, — тот же модуль архивом с dl.plantype.ru.
- Скачайте
a4office.wopi.zipиз блока «Скачать» и сверьте сумму с указанной там:shasum -a 256 a4office.wopi.zip. - Распакуйте архив в
local/modules/:unzip a4office.wopi.zip -d local/modules/. Итоговый каталог —local/modules/a4office.wopi. - Откройте Настройки → Настройки продукта → Модули и установите «A4: документы, таблицы и презентации в Диске».
- Заполните настройки модуля и выполните первую проверку, как описано выше.
Переход с модуля a4.wopi 0.2.1. Новый модуль a4office.wopi при установке переносит адреса discovery, публичный адрес, проверку подписи, ключи организаций и замки; после проверки удалите a4.wopi штатной страницей модулей — объекты Диска и их история версий остаются на месте.
Откат
- Остановите новые сеансы редактора.
- Восстановите базу и каталоги портала из резервной копии, сделанной до установки.
- Очистите управляемый кеш Битрикс24 и перезапустите PHP-FPM.
- Откройте контрольный файл без сохранения.
Безопасность
- Файл хранится в Диске и передаётся редактору внутри сети организации.
- Ключи организаций хранятся в настройках портала и не входят в ZIP, журналы, документацию и
SHA256SUMS. - Проверка подписи запросов редакторов A4 Документ, A4 Таблица и A4 Презентация включена по умолчанию — держите её включённой.
- Если сервер редакторов недоступен, сотрудник видит понятное сообщение и подтверждение, что файл в Диске не изменён; внутренний адрес и причина остаются в журнале администратора.
Типовые ошибки
| Что видно | Что проверить |
|---|---|
| Команды A4 нет в меню Диска | Модуль установлен, обработчик Диска зарегистрирован; в настройках модуля «Диск» включён флажок «Включить работу с документами через внешние службы» |
| Редактор не открылся | Адрес discovery открывается из браузера; тип файла есть в discovery |
| Редактор открылся, но файла нет | Публичный адрес портала доступен из сети сервера редакторов |
| Ответ 401 | Срок и подпись ссылки, ключ организации |
| Ответ 409 при сохранении | Файл или его блокировку изменила другая сессия. Закройте старую сессию и откройте свежую версию |
| Ответ 502 | Сервер редакторов доступен с портала; файл в Диске при этом не изменён |
| Новая версия не появилась | Право пользователя на запись, активная блокировка, журнал редактора |
Техническая поддержка
- техническая поддержка ООО «Миктера»;
- понедельник — пятница, 9:00–18:00 по московскому времени, кроме праздничных дней;
- реакция на обращение — в течение 1 рабочего дня, ответ по существу — в течение 3 рабочих дней;
- e-mail: partner@a4-office.ru;
- форма обращения: plantype.ru/support.
Скачать
Ручной комплект 0.3.12
| Файл | Размер | Назначение |
|---|---|---|
a4office.wopi.zip | 254 195 байт | модуль 0.3.12 для local/modules/ (каталог a4office.wopi) |
a4office.wopi.last_version.zip | 254 129 байт | тот же модуль в формате пакета Маркетплейса (.last_version) |
SHA256SUMS | 195 байт | контрольные суммы (полные имена файлов версии) |
ad126dadfbcb4763015c166257b30c537881939a05c34bb34a60e7cf65b83ee9 a4office.wopi.zip
5f3be0bab7e5c6b36cea9a497e47b723ca74ed7969fafb0403abf96786ab8ded a4office.wopi.last_version.zip
Адреса постоянные: по ним всегда лежит текущая версия модуля. Все версии — dl.plantype.ru/a4-bitrix24/release/.
Сведения о выпуске
| Что | Значение |
|---|---|
| Решение | «A4: документы, таблицы и презентации в Диске» |
| Версия модуля | 0.3.12 (идентификатор a4office.wopi) |
| Маркетплейс 1С-Битрикс | опубликовано 10.10.2026, версия 0.3.12 — с 16.10.2026, страница решения |
| Битрикс24 | коробочная версия с модулем «Диск» |
| PHP | 8.2 и новее |
| Изменения 0.3.8–0.3.12 | «Добавить → A4» создаёт новый файл; проверки прав при создании и открытии файла; доступ сессии отзывается при закрытии редактора, истёкшая сессия показывает предупреждение; настройка «Показывать в меню Диска только A4»; предупреждение, если в Диске выключена работа с документами через внешние службы |