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

Другое · 6 мин

Как показать табличный документ в 1С:Предприятии

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

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

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

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

Когда табличный документ отображается автоматически

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

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

Как показать табличный документ отдельным окном

Для вызова в отдельном окне используется метод Показать() у объекта ТабличныйДокумент. Типичная последовательность: создать документ, заполнить области и строки, затем вызвать Показать(). Окно открывается поверх текущего интерфейса и позволяет пользователю просмотреть, напечатать или сохранить результат.

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

Вывод на форму через реквизит

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

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

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

Печать и сохранение вместо показа

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

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

Порядок действий
  1. 1
    Создать объект ТабличныйДокумент и заполнить его содержимое
  2. 2
    Выбрать способ отображения: реквизит формы или метод Показать()
  3. 3
    Выполнить показ или присвоение реквизиту
  4. 4
    Проверить, что содержимое отображается корректно

Частые ошибки и ограничения

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

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

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

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

Открылось ли окно или обновилось поле формы
Норма

Видны строки и колонки документа

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

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

Доступность формы после показа
Норма

Пользователь продолжает работу

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

Интерфейс заблокирован до закрытия окна

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

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

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

Альтернативы прямому показу

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

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

Итог

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

Табличный документ показывается через реквизит формы или метод Показать(); перед показом проверьте заполнение и видимость элемента.

Частые вопросы

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

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

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

Да, метод Показать() открывает документ в собственном окне платформы, не требуя предварительно созданной формы пользователя.

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

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

Чем отличается показ от печати?

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

Блокирует ли показ работу в форме?

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