Документация
Вся документация

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. Коротко:

  1. Скачайте комплект и сверьте суммы: sha256sum -c SHA256SUMS. Загрузите три образа: docker load -i ….
  2. Рядом с docker-compose-wopi.yml создайте файл .env:
    PORTAL_URL=https://portal.example.ru
    EDITORS_URL=https://office.example.ru
  3. Запустите: docker compose -f docker-compose-wopi.yml up -d.
  4. Поставьте nginx из nginx-wopi.conf с доверенным сертификатом для office.example.ru. Модуль скачивает discovery с проверкой сертификата: если сертификат выпущен внутренним центром организации, добавьте его корневой сертификат в доверенные на сервере портала.
  5. Проверьте с сервера портала: curl -s https://office.example.ru/hosting/discovery — в ответе есть docx и xlsx.

Установка из Маркетплейса

До установки

  • установите и настройте сервер A4;
  • сделайте резервную копию базы и каталога портала.

Шаги

  1. В административной части портала откройте Маркетплейс, найдите A4 — решение «A4: документы, таблицы и презентации в Диске» — или откройте его страницу в Маркетплейсе.
  2. Нажмите Установить и подтвердите установку. Решение бесплатное.
  3. Откройте настройки модуля (Настройки → Настройки продукта → Настройки модулей → 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).
  4. Проверьте настройки модуля «Диск» (Настройки → Настройки продукта → Настройки модулей → Диск): флажок «Включить работу с документами через внешние службы» должен быть включён — без него Диск не показывает A4 в меню «Редактировать». Если флажок выключен, страница настроек A4 предупреждает об этом (с версии 0.3.12).
  5. Откройте любой файл в Диске: в меню «…» → «Редактировать» появился пункт A4.

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

  1. Загрузите в Диск контрольные копии .xlsx, .docx и .pptx.
  2. Откройте каждую через «…» → «Редактировать» → A4, внесите правку и дождитесь надписи о сохранении.
  3. Закройте редактор. В истории Диска должна появиться новая версия файла, а после повторного открытия правка на месте.
  4. Новый файл — Диск → «Добавить» → «A4» → «Документ», «Таблица» или «Презентация» (с версии модуля 0.3.9).
  5. Для книги с макросами скачайте новую версию и откройте её в настольном Excel; для точной проверки сравните SHA-256 файла xl/vbaProject.bin до и после.

Ручная установка

Для порталов, где Маркетплейс недоступен, — тот же модуль архивом с dl.plantype.ru.

  1. Скачайте a4office.wopi.zip из блока «Скачать» и сверьте сумму с указанной там: shasum -a 256 a4office.wopi.zip.
  2. Распакуйте архив в local/modules/: unzip a4office.wopi.zip -d local/modules/. Итоговый каталог — local/modules/a4office.wopi.
  3. Откройте Настройки → Настройки продукта → Модули и установите «A4: документы, таблицы и презентации в Диске».
  4. Заполните настройки модуля и выполните первую проверку, как описано выше.

Переход с модуля a4.wopi 0.2.1. Новый модуль a4office.wopi при установке переносит адреса discovery, публичный адрес, проверку подписи, ключи организаций и замки; после проверки удалите a4.wopi штатной страницей модулей — объекты Диска и их история версий остаются на месте.

Откат

  1. Остановите новые сеансы редактора.
  2. Восстановите базу и каталоги портала из резервной копии, сделанной до установки.
  3. Очистите управляемый кеш Битрикс24 и перезапустите PHP-FPM.
  4. Откройте контрольный файл без сохранения.

Безопасность

  • Файл хранится в Диске и передаётся редактору внутри сети организации.
  • Ключи организаций хранятся в настройках портала и не входят в 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.

Скачать

A4: документы, таблицы и презентации в ДискеМаркетплейс 1С-Битрикс · модуль 0.3.12 · бесплатно
Открыть в Маркетплейсе

Ручной комплект 0.3.12

ФайлРазмерНазначение
a4office.wopi.zip254 195 байтмодуль 0.3.12 для local/modules/ (каталог a4office.wopi)
a4office.wopi.last_version.zip254 129 байттот же модуль в формате пакета Маркетплейса (.last_version)
SHA256SUMS195 байтконтрольные суммы (полные имена файлов версии)
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коробочная версия с модулем «Диск»
PHP8.2 и новее
Изменения 0.3.8–0.3.12«Добавить → A4» создаёт новый файл; проверки прав при создании и открытии файла; доступ сессии отзывается при закрытии редактора, истёкшая сессия показывает предупреждение; настройка «Показывать в меню Диска только A4»; предупреждение, если в Диске выключена работа с документами через внешние службы

Помощник по документации A4

Ответы собираются из документации и могут быть неточны — сверяйтесь с разделами по ссылкам.