Другое · 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Открыть ветку «Макеты» и создать новый макет
- 2Выбрать тип Active Document и заполнить имя
- 3Указать свойства компонента в карточке макета
- 4Сохранить конфигурацию и обновить базу
- 5Проверить отображение в режиме предприятия
Настройка свойств и привязка компонента
В карточке макета заполните поля, отвечающие за класс документа, идентификатор и связанные параметры. Значения должны соответствовать зарегистрированному компоненту; опечатка в идентификаторе сделает макет нерабочим.
Если макет используется в форме, свяжите его с реквизитом или командой формы так, чтобы при открытии формы загружался нужный документ. Проверьте права доступа: пользователь должен иметь возможность открывать соответствующий раздел.
Использование макета в форме или отчёте
Активный документ может размещаться на форме как элемент управления или вызываться программно при открытии печатной формы. Выберите способ в зависимости от того, нужен ли постоянный просмотр компонента или разовое открытие по действию пользователя.
При программном вызове укажите корректный путь к макету и проверьте обработку исключений. Если компонент не найден, приложение должно выдать понятное сообщение, а не завершаться ошибкой.
В форме документа
Разместите элемент на форме и привяжите его к макету через свойства элемента. Проверьте поведение при открытии и закрытии формы.
В отчёте или печатной форме
Подключите макет к макету печати или к программе отчёта. Убедитесь, что компонент корректно печатается или экспортируется, если это требуется.
Проверка результата и безопасная отладка
После сохранения конфигурации запустите 1C в режиме предприятия и откройте объект, где используется макет. Активный документ должен отобразиться без ошибок, а его элементы — реагировать на действия пользователя.
Если документ не отображается, проверьте регистрацию компонента в системе, права пользователя и соответствие свойств макета. Не вносите экспериментальные изменения напрямую в рабочую базу: используйте копию или тестовую конфигурацию, чтобы не повредить данные.
Ограничения, альтернативы и частые ошибки
Active Document зависит от наличия и регистрации внешнего компонента. На другом компьютере или после переустановки ОС компонент может перестать быть доступен, и макет перестанет работать. Это основное ограничение по сравнению со встроенными типами макетов.
В качестве альтернативы рассмотрите табличный документ, HTML-макет или внешнюю обработку, если не требуется полноценное встраивание интерфейса компонента. Они проще переносятся между базами и реже ломаются при обновлении окружения.
| Тип макета | Когда подходит | Ограничение |
|---|---|---|
| Active Document | Встраивание внешнего компонента с собственным интерфейсом | Требует зарегистрированного компонента в системе |
| Табличный документ | Отчёты, печатные формы, структурированные данные | Не подходит для сложных внешних интерфейсов |
| HTML-макет | Форматированный текст и вёрстка без внешних компонентов | Ограниченные возможности взаимодействия с ОС |
Перед завершением работы сравните результат с ожидаемым поведением на нескольких компьютерах, если макет будет использоваться несколькими пользователями. Разница в установленном ПО может сделать компонент недоступным на некоторых рабочих местах.
Что важно запомнить
Создавайте макет в Конфигураторе, проверяйте регистрацию компонента, тестируйте на копии базы и при необходимости используйте более простые альтернативы.
Нужен ли Active Document для обычного отчёта?
Для большинства отчётов достаточно табличного документа или HTML-макета. Active Document оправдан только при необходимости встроить внешний компонент со своим интерфейсом.
Что делать, если компонент не отображается?
Проверьте регистрацию компонента в операционной системе, правильность идентификатора в свойствах макета и права доступа пользователя. Протестируйте на копии базы перед внесением изменений в рабочую.
Можно ли использовать Active Document в печатной форме?
Да, если конфигурация позволяет подключить макет к печатной форме и компонент корректно работает в контексте печати. Проверьте отображение и экспорт перед вводом в эксплуатацию.
Какое главное ограничение Active Document?
Зависимость от внешнего компонента: после переустановки системы или переноса базы на другой компьютер компонент может оказаться не зарегистрирован, и макет перестанет работать.