Как передать и сформировать макет печатной формы Word в управляемых формах 1С

При разработке внешних печатных форм и обработок в среде управляемого приложения разработчики часто сталкиваются с задачей заполнения шаблонов в формате Microsoft Word (DOC/DOCX). Традиционный для обычных форм подход с использованием макета типа ActiveDocument на управляемых формах приводит к системным ошибкам клиент-серверного взаимодействия.

Проанализируем причины возникновения этой проблемы и подробно рассмотрим рабочие варианты правильной реализации печати Word-документов в 1С:Предприятии 8.3.

Причина ошибки «Отсутствует отображение для типа "ОболочкаActiveDocument"»

Разберем типичную попытку получения макета на сервере с последующей передачей на клиент:

&НаСервере
Функция ПолучитьМакетДокумента()
    ОбъектОбработки = РеквизитФормыВЗначение("Объект");
    Возврат ОбъектОбработки.ПолучитьМакет("Макет");
КонецФункции

&НаКлиенте
Процедура СформироватьДокумент()
    МакетНаКлиенте = ПолучитьМакетДокумента();
КонецПроцедуры

При выполнении этого кода платформа выдает исключение: Ошибка отображения типов: Отсутствует отображение для типа "ОболочкаActiveDocument".

Выясним причину такого поведения платформы. Объект ОболочкаActiveDocument представляет собой клиентскую OLE/COM-обертку операционной системы Windows. Данный тип данных не является сериализуемым, поэтому платформа 1С принципиально не может передать его через контекстную границу вызова между сервером и клиентом.

Попытка вызвать метод Макет.Получить() непосредственно на сервере также приводит к ошибке, если служба сервера 1С запущена в неинтерактивной сессии (Session 0) без прав на запуск COM-серверов или если сервер функционирует под управлением ОС Linux, где Microsoft Office отсутствует.

Рассмотрим надежные и проверенные способы реализации печати.

Способ 1. Хранение макета в виде двоичных данных и обработка на клиенте

Наиболее простое и стабильное решение для вывода печатной формы через установленный у пользователя Microsoft Word — изменить тип макета в конфигураторе с ActiveDocument на Двоичные данные.

Разберем пошаговый алгоритм реализации:

1. Открываем внешнюю обработку или печатную форму в конфигураторе.
2. Создаем макет с типом Двоичные данные и загружаем в него шаблон документа (.doc или .docx).
3. На сервере получаем макет как двоичные данные и помещаем их во временное хранилище.
4. На клиенте извлекаем данные из хранилища, сохраняем во временный файл и открываем через COM-объект Word.

Посмотрим на пример программного кода:

&НаСервере
Функция ПолучитьАдресМакетаВоВременномХранилище()
    ЭтотОбъект = РеквизитФормыВЗначение("Объект");
    МакетДвоичныеДанные = ЭтотОбъект.ПолучитьМакет("МакетДвоичныеДанные");
    Возврат ПоместитьВоВременноеХранилище(МакетДвоичныеДанные, УникальныйИдентификатор);
КонецФункции

&НаКлиенте
Процедура СформироватьИОткрытьДокументWord()
    АдресХранилища = ПолучитьАдресМакетаВоВременномХранилище();
    ДвоичныеДанные = ПолучитьИзВременногоХранилища(АдресХранилища);
    
    // Формируем имя временного файла
    ИмяВременногоФайла = ПолучитьИмяВременногоФайла("docx");
    ДвоичныеДанные.Записать(ИмяВременногоФайла);
    
    // Работаем с COM-объектом Word на стороне клиента
    Попытка
        MSWord = Новый COMОбъект("Word.Application");
        MSWord.Visible = Истина;
        Документ = MSWord.Documents.Open(ИмяВременногоФайла);
        
        // Выполняем заполнение параметров или замену закладок
        // ...
        
        MSWord.Activate();
    Исключение
        Предупреждение("Не удалось запустить Microsoft Word. Проверьте, установлена ли программа.");
    КонецПопытки;
КонецПроцедуры

Способ 2. Открытие файла без явной инициализации COM-объектов

Если в макет не требуется подставлять параметры программно через COM, а нужно только выгрузить и открыть готовый сформированный файл во внешней программе, используем процедуру запуска приложений операционной системы:

&НаКлиенте
Процедура ОткрытьШаблонВWord()
    АдресХранилища = ПолучитьАдресМакетаВоВременномХранилище();
    ДвоичныеДанные = ПолучитьИзВременногоХранилища(АдресХранилища);
    
    ИмяФайла = ПолучитьИмяВременногоФайла("docx");
    ДвоичныеДанные.Записать(ИмяФайла);
    
    // Запуск стандартного приложения, ассоциированного с расширением .docx
    ЗапуститьПриложение(ИмяФайла);
КонецПроцедуры

Этот подход избавляет от жесткой привязки к COM-модели конкретной версии Microsoft Office и корректно открывает документ в любом офисном пакете, установленном в операционной системе пользователя по умолчанию.

Способ 3. Использование стандартного табличного документа

Если печатная форма разрабатывается для стандартной подсистемы печати БСП или не требует специфических возможностей форматирования MS Word, рассмотрим альтернативу на основе объекта ТабличныйДокумент.

1. Макет создается как обычный табличный документ 1С.
2. Заполнение областей и параметров выполняется полностью на стороне сервера без создания внешних файлов и COM-объектов.
3. При необходимости сохранения в формате Word или PDF на сервере вызывается встроенный метод:

ТабличныйДокумент.Записать(ПутьКФайлу, ТипФайлаТабличногоДокумента.DOCX);

Такой подход обеспечивает максимальную производительность, кроссплатформенность серверной части и независимость от стороннего программного обеспечения.