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