Группа компаний БИТ

bit PDF Writer

Автоматическое заполнение PDF: подставляет текст и изображения по якорной фразе. Настройка и запуск из 1С или командной строки.

1.1.0 PdfWriterNF47
1.0.1 bit_pdfWriter
Windows .NET 4.8

О продукте

Связка утилиты Windows и обработки 1С

Программный продукт CodeLab: утилита PdfWriterNF47.exe и внешняя обработка bit_pdfWriter.epf «(bit) Редактор Pdf»

Задача

Ручное дополнение PDF в графических редакторах — трудоёмко, плохо масштабируется и не встраивается в процессы 1С.

Состав

Компоненты решения

PdfWriterNF47.exe

Движок: чтение PDF, поиск текста, вставка текста и изображений.

v1.1.0

config.json

Файл правил заполнения (UTF-8), создаётся и читается обработкой.

Схема работы

┌─────────────────────────┐     config.json      ┌──────────────────────┐
│  1С: bit_pdfWriter.epf  │ ───────────────────► │  PdfWriterNF47.exe   │
│  (форма настроек)       │     + пути к PDF     │                      │
└─────────────────────────┘                      └──────────┬───────────┘
                                                            │
                                                            ▼
                                                   output.pdf (результат)
  1. Пользователь настраивает правила на форме 1С (или готовит config.json вручную).
  2. Обработка сохраняет конфиг в каталоге утилиты (рядом с exe).
  3. Запускается PdfWriterNF47.exe "путь\config.json" silent.
  4. Утилита обрабатывает все страницы входного PDF и сохраняет результат.

Утилита также работает без 1С — только с файлом конфигурации и командной строки.

Возможности

Поиск, координаты, слои и правила

Поиск по тексту

Режим search: одна или несколько якорных фраз, вставка текста и/или изображения справа, слева, выше или ниже якоря.

Абсолютные координаты

Режим absolute: размещение по фиксированным координатам (левый нижний угол, ось Y вверх, пункты).

Слои отрисовки

over — поверх содержимого; under — под потоком (водяной знак). На PDF из 1С результат может быть непредсказуемым.

checkIfEmpty

Проверка области рядом с якорем: если поле уже заполнено, вставка пропускается — удобно для повторных прогонов.

Цепочка правил

Несколько правил в одном config.json: подпись, печать, штамп — выполняются последовательно на каждой странице.

Кириллица

Русский текст через системные шрифты Windows: Arial, Times New Roman, Calibri.

1С:Предприятие

Форма, команды и API

Форма обработки

  • Путь к утилите PdfWriterNF47.exe
  • Входной и выходной PDF
  • Глобальные настройки: шрифт, цвет, параметры поиска
  • Таблица правил replacements с диалогом выбора изображений

Команды

  • Выполнить — сохранить конфиг, запустить утилиту, открыть результат
  • Выполнить на сервере — запуск через API (если exe доступен с сервера)
  • Сохранить конфиг — только запись config.json

Программный API

  • ВыполнитьКоманду("ЗаписатьВPdf", Параметры)
  • ПолучитьСтруктуруКонфига()
  • ПолучитьСтруктуруНастроекДляОбработки()
  • ДобавитьНастройкуОбработкиВКонфиг()
  • СведенияОВнешнейОбработке() — регистрация в БСП

CLI

Запуск из командной строки

PdfWriterNF47.exe [путь_к_config.json] [режим]

PdfWriterNF47.exe
PdfWriterNF47.exe C:\Temp\my_config.json
PdfWriterNF47.exe C:\Temp\my_config.json silent

Аргумент silent отключает ожидание клавиши в конце — для вызова из 1С и скриптов. Утилита выводит в консоль номер страницы, найденные совпадения, координаты вставки и ошибки.

Сценарии

Примеры использования

Подпись справа от «Подпись:»

ФИО или скан подписи справа от метки на каждом вхождении фразы.

Печать под «М.П.»

Изображение печати ниже якоря с заданными размерами.

Только пустое поле

Подстановка у «ФИО:» только если область ещё не занята (checkIfEmpty).

Отметка по координатам

«Копия верна» или логотип в фиксированной точке без привязки к якорю.

Кейс

ООО «ЦМС» — документы о поверке средств измерений

Метрологическая компания получает PDF из внешних систем — свидетельства о поверке и извещения о непригодности СИ

Раньше в каждый документ вручную добавляли штамп, ФИО подписанта, подпись и печать: печать PDF, проставление реквизитов на бумаге, сканирование и только потом отправка заказчику. Настроили правила в bit PDF Writer — документ сразу готов к электронной отправке, без цикла «распечатать → подписать → отсканировать».

Для кого

Целевая аудитория

  • Компании, которым нужно автоматизировать дополнение PDF подписью, печатью или текстом
  • Организации на 1С:Предприятие — настройка через форму обработки, не через сторонние редакторы
  • Внедренцы и администраторы 1С — JSON-конфиг и программный API
  • Сценарии локальной обработки на Windows без отправки документов в облако
  • Компании, готовые к пилотному тестированию на своих шаблонах

Требования

Системные требования и ограничения

Текущий статус: ограничения для PDF из печатных форм 1С

Важно: текущий статус продукта

На PDF, сформированных в 1С из табличного документа, выявлен дефект наложения содержимого: в режиме «под содержимым» (under) подстановка может уходить за объекты страницы; в режиме «поверх» (over) текст и изображение могут некорректно перекрывать макет.

До выхода обновления с режимом маскирования (cover) мы не рекомендуем использовать продукт как готовое решение для автозаполнения PDF из печатных форм 1С. Для таких сценариев возможен пилотный тест на ваших файлах и доработка по ТЗ.

Стабильнее работает на PDF стороннего происхождения, после предварительного теста на вашем файле и при абсолютном позиционировании по координатам.

Требования

  • Windows 7 / 10 / 11 или Windows Server
  • .NET Framework 4.8
  • 1С:Предприятие 8.3 (для внешней обработки)
  • Шрифты Arial, Times New Roman или Calibri
  • Доступ к exe, PDF и изображениям с машины запуска

Ограничения текущей версии

  • PDF из табличного документа 1С — дефект наложения (исправление в разработке)
  • Поиск только по извлекаемому тексту
  • Один PDF за запуск; один config.json на путь к exe
  • Несколько фраз в searchPhrases — через JSON или доработку формы
  • Успех на клиенте определяется наличием выходного файла, не exit code

Roadmap

Планируемые доработки

Профили и пакетная обработка

Именованные наборы правил с картинками; обход всех PDF в папке.

QR-код

Генерация QR из текста якоря и вставка в PDF.

Электронная подпись

Интеграция с КриптоПро, визуальный штамп — отдельный этап.

FAQ

Частые вопросы

Можно ли использовать без 1С?

Да. Достаточно config.json и командной строки. Обработка 1С — удобный интерфейс, не обязательное условие.

Подходит ли для PDF из печатных форм 1С?

В текущей версии — с ограничениями. Для PDF из табличного документа 1С возможны ошибки наложения. Рекомендуем тест на ваших файлах или ожидание обновления.

Поддерживаются ли многостраничные PDF?

Да. Каждое правило применяется на каждой странице документа.

Можно ли вставить и текст, и картинку в одном правиле?

Да.

Работает ли на сервере 1С?

Да, если exe и файлы доступны с сервера приложений (команда «Выполнить на сервере»).

Что делать, если фраза не находится?

Упростить якорь; отключить searchWholeWords; проверить извлекаемость текста; посмотреть вывод консоли; использовать режим absolute.

Старт

Как начать

1

Опишите задачу

Какие PDF, какие поля заполнять, откуда берутся файлы.

2

Образцы PDF

Проверим поиск якорей и корректность наложения на ваших файлах.

3

Пилот

Настройка правил и тест на ваших документах.

4

Внедрение

После успешного теста; для PDF из 1С — после подтверждения на ваших шаблонах.

bit PDF Writer разработан в CodeLab — направлении группы БИТ. О CodeLab · REST API для 1С.

Запросите пилотный тест на ваших PDF

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

Связаться с CodeLab