Другое · 7 мин
Как сформировать таблицу в 1С
Практичная инструкция по созданию таблиц в 1С: таблицы значений, формы и отчёты, порядок действий, проверка результата и типичные ошибки.
В 1С таблицей может называться несколько разных объектов: таблица значений в памяти программы, табличная часть документа или справочника, поле «Таблица» на форме и выводимый в отчёте набор данных. Перед началом работы нужно определить, где именно таблица будет использоваться: только для расчётов, для ввода пользователем или для печати.
Разница важна, потому что способы заполнения, отображения и сохранения различаются. Таблица значений создаётся программно и не попадает в базу сама по себе, табличная часть привязана к объекту конфигурации, а форма определяет, как данные видятся пользователю. Неправильный выбор объекта приводит к тому, что данные либо не сохраняются, либо не отображаются там, где ожидает пользователь.
Основные виды таблиц в 1С
Таблица значений подходит для временных данных, промежуточных расчётов и передачи информации между процедурами. Она существует только во время выполнения кода, если её не сохранить в регистр, документ или другой объект хранения. У такого объекта есть колонки, строки и методы для добавления, чтения и удаления данных.
Табличная часть используется внутри документов, справочников и регистров. Данные в ней сохраняются вместе с объектом, поэтому подходят для накладных, заказов, актов и других операций, где строки должны оставаться привязанными к основной записи. Форма таблицы на экране лишь отображает данные и не является самостоятельным хранилищем.
Отчётная таблица выводит данные в печатной форме или на вкладке отчёта. Она может быть построена на основе запроса, набора записей или таблицы значений, но пользователь обычно не редактирует такие строки напрямую. Выбор между формой и отчётом зависит от того, нужна ли интерактивная правка или только просмотр и печать.
Создание таблицы значений программно
В модуле объекта или общей процедуре сначала объявляется переменная таблицы, затем создаётся экземпляр и добавляются колонки с именами и типами. После этого строки заполняются по одной или загружаются из запроса. Важно называть колонки осмысленно, чтобы код оставался понятным при поддержке.
Пример заполнения таблицы значений в коде 1С выглядит так: создаётся таблица, добавляются колонки «Номер» и «Наименование», затем создаётся строка, заполняются её поля и строка добавляется в таблицу. После заполнения таблицу можно передать в форму, отчёт или использовать для расчётов.
Таблица = Новый ТаблицаЗначений; Таблица.Колонки.Добавить("Номер"); Таблица.Колонки.Добавить("Наименование"); Строка = Таблица.Добавить(); Строка.Номер = 1; Строка.Наименование = "Товар";Если данные нужны только в рамках одной процедуры, таблица значений может быть локальной переменной. Если таблицу нужно показать пользователю на форме, её следует присвоить значению атрибута формы или передать в параметры открытия формы. Не пытайтесь сохранить чистую таблицу значений как самостоятельную запись в базе без привязки к документу или регистру.
Вывод таблицы на форму пользователя
На форме таблица обычно отображается через поле типа «Таблица формы» или табличное поле в управляемом приложении. Нужно создать реквизит формы табличного типа, связать его с таблицей значений и настроить колонки: видимость, ширина, заголовок и доступ для редактирования. Без привязки колонок к полям таблицы пользователь увидит пустую область.
Для редактирования на форме включите возможность добавления и удаления строк, если это предусмотрено задачей. После изменений пользователя данные нужно считать обратно из табличной формы в переменную или объект, иначе правки пропадут при закрытии окна. Проверяйте, что форма открыта в нужном режиме: только просмотр или редактирование.
Если таблица выводится в отчёте, источник данных чаще всего задаётся запросом или набором записей. Настройте макет отчёта, добавьте табличный документ и выведите результат обработки. В этом случае пользователь получает готовый отчёт, а не инструмент для правки строк.
Табличная часть документа и справочника
Табличная часть описывается в конфигурации как часть объекта: например, строки товара в накладной или этапы в договоре. При записи документа строки табличной части сохраняются вместе с заголовком, поэтому данные не теряются при закрытии. Добавление строк выполняется через программу или вручную пользователем в форме документа.
При работе с табличной частью важно соблюдать последовательность: сначала заполнить реквизиты документа, затем строки таблицы, потом проверить и записать объект. Если запись отменяется, изменения в табличной части тоже не сохраняются. Это снижает риск появления «висячих» строк без основного документа.
Не добавляйте колонки в табличную часть «на лету» в рабочей базе без понимания последствий для отчётов, печатных форм и прав доступа. Изменения структуры могут повлиять на существующие обработки и требовать перекомпиляции конфигурации.
Проверка результата и типичные ошибки
После создания таблицы проверьте, что колонки имеют ожидаемые имена, строки содержат данные, а форма отображает все записи без прокрутки или обрезания. Попробуйте добавить, изменить и удалить строку, затем запишите объект и откройте его снова, чтобы убедиться в сохранении.
Частая ошибка — попытка использовать таблицу значений как базу данных. Она подходит для расчётов внутри сеанса, но не заменяет справочники, документы или регистры. Другая ошибка — забыть установить права доступа к форме с таблицей, из-за чего пользователи не видят данные или не могут вносить правки.
Границы безопасной самостоятельной работы
Создание простых таблиц значений и вывод их на стандартные формы обычно не требуют вмешательства в конфигурацию. Если задача включает изменение табличных частей типовых объектов, добавление новых колонок в документы или переработку отчётов, лучше действовать на копии базы и при возможном привлечении специалиста по 1С.
Всегда делайте резервную копию перед структурными изменениями, тестируйте на отдельной базе и фиксируйте, какие объекты были изменены. Это позволяет откатиться при ошибке и упрощает поддержку при обновлении платформы или конфигурации.
Что важно запомнить
Выбирайте тип таблицы по цели: таблица значений для расчётов, табличная часть для хранения в документе, форма или отчёт для показа пользователю, и всегда проверяйте сохранение данных.
Какая разница между таблицей значений и табличной частью?
Таблица значений существует в памяти во время работы программы и не сохраняется сама по себе, а табличная часть входит в документ или справочник и записывается в базу вместе с основным объектом.
Можно ли сохранить таблицу значений как отдельную запись?
Непрямо — таблица значений не является объектом конфигурации для хранения. Для постоянного хранения перенесите данные в табличную часть документа, справочника, регистр или другой подходящий объект.
Почему таблица на форме может быть пустой?
Скорее всего, не создано поле табличной формы, не привязан реквизит или не настроены колонки. Также проверьте, что значение таблицы присвоено реквизиту формы перед открытием.
Нужно ли программирование для простой таблицы?
Для таблицы значений и вывода на форму обычно нужен код, а для табличной части типовых документов можно настроить конфигурацию и заполнять строки в форме без программирования.
Что делать, если после записи строки пропали?
Проверьте, был ли выполнен объект записи, не отменялась ли транзакция, и привязаны ли строки к сохранённому документу. Если изменения вносились в таблицу значений без сохранения в объект, они не останутся после закрытия сеанса.