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

Другое · 7 мин

Получение макета внешней печатной формы в 1С:Предприятии

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

Внешняя печатная форма в 1С:Предприятии позволяет вынести оформление документа за пределы типовой конфигурации и подключить его к справочникам, документам или регистрам через регистр дополнительных отчетов и обработок. Макет такой формы — это шаблон вывода, который может быть оформлен в табличном документе, макете вывода или в коде внешней обработки. Чтобы изменить печать или использовать чужой шаблон, нужно сначала найти и получить этот макет.

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

Где зарегистрирована формаВнешняя обработка или внешний отчет

Ищите макет в ветке Обработки или Отчеты конфигурации

Способ полученияПрограммно или через конфигуратор

Программно — через Макеты.Имя.ПолучитьМакет, в конфигураторе — открытие макета на редактирование

Где искать макет внешней печатной формы

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

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

Порядок действий
  1. 1
    Найдите внешнюю обработку или отчет в дереве конфигурации
  2. 2
    Откройте ветку Макетов и укажите имя нужного макета
  3. 3
    В коде получите макет через ПолучитьМакет и проверьте, что он не равен Неопределено
  4. 4
    Подключите полученный макет к табличному документу и выполните печать

Получение макета через конфигуратор

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

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

Программное получение макета из кода

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

Обработка = Обработки.ИмяВнешнейОбработки.Создать();
Макет = Обработка.Макеты.ИмяМакет.ПолучитьМакет();

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

Типичные ошибки
01
Попытка получить несуществующий макет без проверки на Неопределено вызовет ошибку выполнения
02
Подключение макета к табличному документу без очистки предыдущего вывода приведет к наложению данных

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

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

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

Контрольные точки

Как проверить результат

Макет получен
Норма

Объект макета отличается от Неопределено

Тревожный признак

Возвращено Неопределено — макет отсутствует или указано неверное имя

Печать выполняется
Норма

Документ формируется с оформлением макета

Тревожный признак

Выводится пустой лист или стандартная форма конфигурации

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

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

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

Как проверить, что макет получен корректно

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

Альтернативы и когда обращаться к специалисту

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

Итог

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

Макет берется из коллекции макетов внешней обработки или отчета, проверяется на наличие и подключается к табличному документу перед печатью.

Можно ли получить макет без конфигуратора?

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

Что делать, если метод вернул Неопределено?

Проверьте точность имени макета, наличие ветки Макетов в выбранной обработке или отчете, а также то, что вы обращаетесь к правильному объекту. Неопределено означает, что макет с таким именем не найден.

Нужно ли право на конфигуратор для получения макета?

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

Безопасно ли править макеты в типовой конфигурации?

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