Справочник описывает соответствие между методами P7 Документ Конструктора, командами адаптера r7_builder_helper.exe и экспортными процедурами общего модуля R7BuilderHelperAdapter.bsl.
Модель вызова
Из 1С не создаются СОМ-объекты Документ Конструктора напрямую. Код 1С собирает структуру задачи:
Задача = Р7НоваяЗадача(ПутьРезультата); Р7ДобавитьЛист(Задача, "Отчет"); Р7УстановитьЗначение(Задача, "Отчет", "A1", "Пример"); Р7ВыполнитьЗадачу(Задача, ПутьHelper, ПутьRuntime);
Адаптер получает JSON, формирует временный сценарий .docbuilder, выполняет его через docbuilder.exe и сохраняет файл.
Уточнение
DLL-бэкенд не используется.
Управление файлом
| Документ Конструктор | Команда адаптера | 1С-обертка | Комментарий |
|---|---|---|---|
builder.OpenFile() | input в задаче | P7НоваяЗадачаИзФайла(ПутьИсходногоФайла, ПутьРезультата, Формат) | Открывает существующий файл как основу отчета |
builder.OpenFile() с результатами | input, resultOutput | P7НоваяЗадачаИзФайлаСРезультатами(...) | Открывает существующий файл и возвращает JSON результатов |
| Новый файл | без input | P7НоваяЗадача(ПутьРезультата, Формат) | Адаптер создает новый документ |
| Новый файл с результатами | resultOutput | P7НоваяЗадачаСРезультатами(ПутьРезультата, ПутьРезультатов, Формат) | Используется для команд чтения |
builder.SaveFile() | format, output | P7ВыполнитьЗадачу(Задача, ПутьHelper, ПутьRuntime) | Сохраняет результат в Задача.output |
builder.SaveFile() + чтение результатов | resultOutput | P7ВыполнитьЗадачуСРезультатами(...) | Возвращает структуру результатов из JSON |
builder.CloseFile | автоматическое действие | отдельной обертки нет | Адаптер закрывает файл после сохранения |
Чтение данных и JSON-результаты
Если задача содержит команды чтения с полем result, адаптер дополнительно создает JSON результатов и возвращает его в 1С. Для команд чтения используйте:
Р7НоваяЗадачаСРезультатами(...)— создание задачи;Р7Получить...(...)— команды чтения;Р7ВыполнитьЗадачуСРезультатами(...)— выполнение задачи.
Адаптер сохранит основной XLSX и отдельно вернет JSON-результаты.
