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

Другое · 6 мин

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

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

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

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

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

Выберите способ подключения печатной формы

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

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

Встроенная формаЕсть в конфигурации объекта

Проверьте раздел печатных форм объекта и наличие шаблона

Внешняя формаОтдельная обработка или отчет

Убедитесь, что команда зарегистрирована и доступна пользователю

Подготовьте базу и права доступа

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

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

Добавьте встроенную форму через конфигуратор

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

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

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

Подключите внешнюю печатную форму как команду

Создайте внешнюю обработку или отчет с экспортной процедурой печати. Зарегистрируйте команду в интерфейсе и добавьте её на форму объекта или в панель действий, чтобы пользователь мог запустить вывод.

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

Проверка в тонком и веб-клиенте

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

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

Проверьте результат в режиме предприятия

Откройте документ или справочник в пользовательском режиме и нажмите кнопку печати. Нормальным результатом является открытие макета с корректными данными и возможность печати или сохранения.

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

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

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

Кнопка печати видна в форме
Норма

Форма открывается с данными

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

Кнопка отсутствует или ошибка при выводе

Данные в макете соответствуют объекту
Норма

Поля заполнены верно

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

Пустые или чужеродные значения

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

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

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

Типичные ошибки
01
Правка типовой конфигурации без копии и расширения
02
Запуск проверки без обновления базы конфигурации
03
Проверка формы только в одном клиентском приложении

Не пытайтесь восстанавливать рабочую базу из неполной копии после неудачной доработки. Если изменения затронули учетные объекты, привлеките специалиста по 1C перед дальнейшей эксплуатацией.

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

Итог

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

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

Нужно ли всегда править конфигурацию для новой печатной формы?

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

Почему кнопка печати не появляется после добавления формы?

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

Можно ли использовать одну внешнюю форму для разных документов?

Да, если обработка принимает нужный объект в параметре и команда вызывается из контекста каждого документа. Нужно правильно настроить параметры вызова.

Что делать, если форма открывается, но данные пустые?

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

Безопасно ли править рабочую базу напрямую?

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