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

Другое · 6 мин

Заполнение табличного документа на форме в 1С: инструкция

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

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

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

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

Отличие табличного документа от табличной части и таблицы значений

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

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

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

Подготовка формы и атрибута табличного документа

Создайте в модуле формы атрибут типа ТабличныйДокумент, например ТабличныйДокументОбъекта или ОтчётТабличныйДокумент. В редакторе формы перетащите этот атрибут на форму, чтобы появился соответствующий элемент управления.

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

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

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

Заполнение через области вывода

Создание области и вывод данных

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

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

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

Заполнение из таблицы значений

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

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

Способы заполнения

Области вывода

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

Таблица значений

Быстрый вывод готовых данных, ограниченное форматирование ячеек.

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

Проверка результата и частые ошибки

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

Частые ошибки: забыли очистить документ перед повторным заполнением, перепутали имена элемента и атрибута, пытались сохранить табличный документ как табличную часть, не проверили права доступа к форме.

Типичные ошибки
01
Забыли вызвать Вывести после заполнения области — данные не появляются на форме
02
Повторное заполнение без очистки — старые строки остаются вместе с новыми

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

Также полезно проверить поведение формы при больших объёмах данных: при слишком большом количестве строк отображение может замедляться.

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

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

Отображение строк
Норма

Все ожидаемые строки видны в правильном порядке

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

Таблица пуста или показываются старые данные

Целостность данных
Норма

Значения соответствуют источнику

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

Ячейки пусты или содержат некорректные типы

Ограничения и безопасная самостоятельная работа

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

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

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

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

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

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

Что делать, если данные не появляются после заполнения?

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

Можно ли использовать таблицу значений вместо областей?

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

Нужны ли права администратора для настройки формы?

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