A4 — что это
Встраиваемый DOCX-редактор для документарных систем: что A4 добавляет вашему продукту, что остаётся на вашей стороне и как это выглядит для сотрудника.
A4 — документная часть платформы FastOffice: DOCX-совместимый редактор и процессор документов, который встраивается в ваше приложение, оставляя документную истину в ядре на Rust.
Свой продукт заменять не нужно: в него добавляется документный процессор и готовая пользовательская поверхность.
Что уже умеет ваша система
Заголовок раздела «Что уже умеет ваша система»Карточка документа, пользователи и роли, маршруты согласования, версии, электронная подпись, архив, аудит, интеграции с вашими системами — перевозок, ресурсов предприятия, работы с клиентами — и правила хранения остаются на вашей стороне.
Что добавляет A4
Заголовок раздела «Что добавляет A4»-
Открыть — получить DOCX от вашей системы и открыть управляемый сеанс документа.
-
Показать — отрисовать страницы и дать пользователю привычную поверхность редактирования.
-
Изменить — принять действия пользователя или агента как ограниченные команды, а не произвольную правку ZIP/XML.
-
Сохранить — собрать корректный DOCX и вернуть файл или подтверждённый результат обратно в вашу систему.
-
Сообщить — передать события ready, dirty, saved, error и другие согласованные состояния.
Как это выглядит для сотрудника
Заголовок раздела «Как это выглядит для сотрудника»Сотрудник открывает документ из привычной карточки. Редактор появляется внутри того же окна и под тем же брендом. Пользователь редактирует согласованные элементы, а при сохранении новая версия возвращается в существующий контур хранения и аудита — без ручной выгрузки в отдельный Word и обратной загрузки.
С какими файлами работает
Заголовок раздела «С какими файлами работает»Основной формат — DOCX: его открывает и правит сеанс, им же документ сохраняется обратно. Остальные форматы обслуживаются отдельными вызовами процессора, а не сеансом: они переводят файл в документ и обратно. PDF — единственный, который идёт только на выход: печатать в него можно, открывать из него нельзя.
| Формат | В документ | Из документа | Чем делается |
|---|---|---|---|
| DOCX | Да | Да | Основной формат: открыть, править и сохранить обратно тем же сеансом — open, mutate, save |
| — | Да | export-pdf, export-pdf-embedded |
|
| ODT | Да | Да | import-odt, export-odt; правимая копия — create-editable-odt-copy, mutate-editable-odt-copy |
| RTF | Да | Да | import-rtf, export-rtf |
| HTML | Да | Да | import-html, export-html |
| Обычный текст | Да | Да | import-txt, export-txt |
| EPUB | Да | Да | import-epub, export-epub |
| FB2 | Да | Да | import-fb2, export-fb2 |
| XODT — плоский ODT | Да | Да | import-xodt, export-xodt |
Плоский ODT — тот же OpenDocument, но одним файлом XML вместо zip-пакета: удобно, когда документ хранится в системе контроля версий или его правит внешний инструмент. У таблиц то же самое называется FODS.
Отдельно есть конвертация файла целиком — convert-doc — и каталога
разом: convert-doc-batch с указанием расширения и, при нужде, обходом
вложенных папок.
Полный перечень вызовов — в справочнике. Для таблиц то же самое собрано матрицей: что можно с каждым форматом.
Что ещё делает процессор, кроме правки
Заголовок раздела «Что ещё делает процессор, кроме правки»Документ в работе редко просто правят. Ниже — вызовы, которые закрывают остальную часть договорного оборота; все они одноразовые, как и работа с форматами, и сеанса для них не нужно.
| Задача | Что происходит | Вызов |
|---|---|---|
| Сличить две версии | Из исходного и изменённого файла собирается третий, где расхождения показаны исправлениями, с указанием автора и даты | review-compare-combine-docx --mode compare |
| Свести правки рецензентов | Правки из нескольких файлов сводятся в один документ | review-compare-combine-docx --mode combine |
| Разослать по списку | Шаблон и список получателей в CSV дают пачку готовых документов; можно взять только часть списка | mail-merge-business-docx --source … --output-dir … |
| Посмотреть макросы, не запуская | Из файла с макросами выдаётся их состав — без выполнения | inspect-vba |
| Проверить защиту файла | Показывает, чем документ защищён | inspect-protection |
| Обновить оглавление | Перестраивает оглавление или список иллюстраций, либо убирает оглавление | update-toc-docx, update-table-of-figures-docx, remove-toc-docx |
Это лишь часть: колонтитулы, разделы, водяные знаки, поля форм, библиография, печать и рассылка собраны по задачам на отдельной странице — что A4 умеет с документом.
Термины, которые встречаются во всех разделах — сеанс, ревизия, проекция, явный отказ, — собраны в глоссарии.
Word-класс внутри вашего продукта
Заголовок раздела «Word-класс внутри вашего продукта»| Слой | Ответственность | Что это даёт |
|---|---|---|
| Ваше приложение | Окно, бренд, вход, хранилище, процессы и их жизненный цикл. | Продукт остаётся вашим продуктом. |
| Адаптер на вашей стороне | Запускает процесс редактора, читает параметры подключения, передаёт события окна, корректно завершает работу. | Встраивание остаётся под вашим управлением. |
| Поверхность редактора | Полотно документа и элементы управления, ввод пользователя, вызовы к вашему приложению и события наружу. | Сотрудник работает с документом внутри вашего окна. |
| Служба поверхности | Отдаёт файлы редактора и параметры подключения, держит защищённый канал и один сеанс документа. | Работает на самой машине и слушает только локальный адрес — наружу ничего не открывается. |
| Сеанс документа | Команды, выделение, история правок, модель документа, вёрстка и сохранение. | Один документ — один сеанс, с общей историей и общими событиями. |
| Ядро и формат документа | Разбор файла, смысловая модель, сохранение частей, которые редактор не показывает, вёрстка и запись обратно. | Содержимое файла определяет формат Word, а не разметка на экране: сохранить и открыть заново можно без потерь. |
Что получает пользователь в Word-коридоре
Заголовок раздела «Что получает пользователь в Word-коридоре»-
Открытие согласованных DOCX-документов внутри вашего приложения без отдельного окна A4.
-
Правка, разбивка на страницы, сохранение, повторное открытие и проверка того, что документ остался собой.
-
В базовом наборе — события
ready,dirty,saved,errorиunmounted; для поставки под вашей маркой к ним добавляются события выделения, содержимого и состояния команд. -
Оформление под ваш бренд: тема, язык, режим только для чтения, переменные оформления и собственная оболочка вместо нашей.
-
Работа без интерфейса — для пакетной обработки, служб, конвейеров и действий агентов.
Граница честного обещания
Заголовок раздела «Граница честного обещания»-
Openability не равна fidelity: capability profile должен отдельно фиксировать чтение, отображение, редактирование, сохранение и preservation по семействам OOXML.
-
Полная совместимость с Microsoft Word, Office.js и выполнение VBA-макросов не входят без отдельного соглашения.
-
Production-поставка требует acceptance по платформам, save/reopen, lifecycle, security и packaging.