К статье
Практический материал

Другое · 7 мин

Как создать макет Active Document в 1С

Как создать макет Active Document в 1C: порядок действий в Конфигураторе, настройка свойств, проверка работы и типичные ошибки при разработке.

Макет Active Document в 1C предназначен для встраивания документов, поддерживающих технологию ActiveX, в отчёты, формы и печатные формы. Такой макет позволяет отображать содержимое внешнего компонента прямо внутри конфигурации, не вынося его в отдельное приложение.

Перед началом работы определите, нужен ли именно активный документ, или достаточно обычного табличного или HTML-макета. Active Document оправдан, когда требуется взаимодействие с зарегистрированным в системе компонентом и отображение его интерфейса внутри 1C.

Разработка ведётся в Конфигураторе: создаётся новый макет, выбирается тип, заполняются свойства компонента, после чего конфигурация сохраняется и проверяется в режиме предприятия. Ошибки на этапе настройки могут привести к тому, что документ не откроется или будет отображаться некорректно.

Ниже описан порядок создания, условия применения, способы проверки и границы безопасной самостоятельной работы. Все действия носят общий характер; точные имена свойств зависят от используемой конфигурации и установленного компонента.

Когда макет Active Document подходит

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

Если достаточно вывести данные в виде таблицы, диаграммы или форматированного текста, предпочтительнее использовать табличный документ или HTML-макет. Они проще в поддержке и реже требуют регистрации компонентов в операционной системе.

Нужен внешний интерфейсДа

Рассмотрите Active Document, если компонент должен отображать своё окно внутри 1C.

Достаточно таблицы или текстаДа

Используйте табличный или HTML-макет вместо Active Document.

Компонент зарегистрирован в ОСНе уверены

Проверьте регистрацию компонента перед созданием макета.

Создание макета в Конфигураторе

Откройте конфигурацию в режиме редактирования и перейдите в ветку «Макеты». Создайте новый макет, укажите имя и синоним, затем выберите тип, соответствующий активному документу. Точное наименование типа может отличаться в зависимости от конфигурации.

После выбора типа сохраните макет и проверьте, что он появился в списке объектов конфигурации. Не закрывайте Конфигуратор без сохранения, иначе изменения будут потеряны.

Если компонент уже зарегистрирован

Убедитесь, что имя класса или идентификатор компонента известен и совпадает с тем, который будет указан в свойствах макета. Несоответствие идентификатора — частая причина отказа при запуске.

Порядок действий
  1. 1
    Открыть ветку «Макеты» и создать новый макет
  2. 2
    Выбрать тип Active Document и заполнить имя
  3. 3
    Указать свойства компонента в карточке макета
  4. 4
    Сохранить конфигурацию и обновить базу
  5. 5
    Проверить отображение в режиме предприятия

Настройка свойств и привязка компонента

В карточке макета заполните поля, отвечающие за класс документа, идентификатор и связанные параметры. Значения должны соответствовать зарегистрированному компоненту; опечатка в идентификаторе сделает макет нерабочим.

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

Использование макета в форме или отчёте

Активный документ может размещаться на форме как элемент управления или вызываться программно при открытии печатной формы. Выберите способ в зависимости от того, нужен ли постоянный просмотр компонента или разовое открытие по действию пользователя.

При программном вызове укажите корректный путь к макету и проверьте обработку исключений. Если компонент не найден, приложение должно выдать понятное сообщение, а не завершаться ошибкой.

В форме документа

Разместите элемент на форме и привяжите его к макету через свойства элемента. Проверьте поведение при открытии и закрытии формы.

В отчёте или печатной форме

Подключите макет к макету печати или к программе отчёта. Убедитесь, что компонент корректно печатается или экспортируется, если это требуется.

Проверка результата и безопасная отладка

После сохранения конфигурации запустите 1C в режиме предприятия и откройте объект, где используется макет. Активный документ должен отобразиться без ошибок, а его элементы — реагировать на действия пользователя.

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

Ограничения, альтернативы и частые ошибки

Active Document зависит от наличия и регистрации внешнего компонента. На другом компьютере или после переустановки ОС компонент может перестать быть доступен, и макет перестанет работать. Это основное ограничение по сравнению со встроенными типами макетов.

Типичные ошибки
01
Опечатка в идентификаторе компонента приводит к отсутствию отображения макета.
02
Изменение рабочей базы без резервной копии создаёт риск потери данных.

В качестве альтернативы рассмотрите табличный документ, HTML-макет или внешнюю обработку, если не требуется полноценное встраивание интерфейса компонента. Они проще переносятся между базами и реже ломаются при обновлении окружения.

Тип макетаКогда подходитОграничение
Active DocumentВстраивание внешнего компонента с собственным интерфейсомТребует зарегистрированного компонента в системе
Табличный документОтчёты, печатные формы, структурированные данныеНе подходит для сложных внешних интерфейсов
HTML-макетФорматированный текст и вёрстка без внешних компонентовОграниченные возможности взаимодействия с ОС

Перед завершением работы сравните результат с ожидаемым поведением на нескольких компьютерах, если макет будет использоваться несколькими пользователями. Разница в установленном ПО может сделать компонент недоступным на некоторых рабочих местах.

Итог

Что важно запомнить

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

Нужен ли Active Document для обычного отчёта?

Для большинства отчётов достаточно табличного документа или HTML-макета. Active Document оправдан только при необходимости встроить внешний компонент со своим интерфейсом.

Что делать, если компонент не отображается?

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

Можно ли использовать Active Document в печатной форме?

Да, если конфигурация позволяет подключить макет к печатной форме и компонент корректно работает в контексте печати. Проверьте отображение и экспорт перед вводом в эксплуатацию.

Какое главное ограничение Active Document?

Зависимость от внешнего компонента: после переустановки системы или переноса базы на другой компьютер компонент может оказаться не зарегистрирован, и макет перестанет работать.