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

Другое · 6 мин

Обращение к табличной части объекта в 1С: порядок и примеры

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

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

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

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

Что такое табличная часть и где она используется

Табличная часть привязана к конкретному объекту и существует в составе его реквизитов. Имя табличной части задаётся в конфигурации и используется для программного доступа.

Частые примеры: строки товаров в документе реализации, строки оплат в платёжном документе, показатели в элементе справочника. В каждом случае доступ идёт через свойство объекта с именем табличной части.

Табличная часть естьСвойство объекта с заданным именем

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

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

Проверяйте, открыт ли объект на запись и есть ли строки

Работа в формеТекущая строка и текущие данные

Уточняйте, используется ли управляемая или обычная форма

Как обратиться к табличной части в модуле объекта

В модуле объекта обращение выполняется через имя свойства табличной части, например Объект.ТабличнаяЧасть.Имя. Для перебора строк используется коллекция Строки, а для обращения к ячейке — реквизит строки.

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

Чтение значений из строк

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

Разница между табличной частью и таблицей значений

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

Доступ к табличной части в форме

В форме табличная часть отображается элементом управления. В управляемой форме текущая строка доступна через Элементы.ИмяТабличнойЧасти.ТекущиеДанные, в обычной форме — через ТекущаяСтрока или объект формы.

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

Добавление, изменение и удаление строк

Новая строка добавляется методом Добавить коллекции строк табличной части. После добавления заполняются реквизиты новой строки. Удаление выполняется методом Удалить с указанием строки или индекса.

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

Порядок действий
  1. 1
    Откройте объект на редактирование и получите табличную часть по имени
  2. 2
    Проверьте наличие строк перед обращением к текущей записи
  3. 3
    Внесите изменения в ячейки строк и сохраните объект
  4. 4
    Убедитесь, что данные сохранились после записи

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

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

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

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

Типичные ошибки: обращение к несуществующей строке, изменение текущей строки без сохранения объекта, использование имени табличной части с опечаткой, попытка записать таблицу значений вместо табличной части.

Как отличить корректное заполнение от ошибки

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

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

Типичные ошибки
01
Обращение к строке в пустой табличной части вызывает ошибку
02
Изменение в форме без записи объекта не сохраняется в базе

Ограничения и альтернативы

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

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

Итог

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

Обращайтесь к табличной части по имени объекта, проверяйте наличие строк, сохраняйте изменения через запись объекта и не смешивайте табличную часть с таблицей значений

Часто задаваемые вопросы

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

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

Что делать, если обращение к текущей строке вызывает ошибку?

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

В чем разница между доступом в модуле объекта и в форме?

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

Можно ли скопировать строки из одной табличной части в другую?

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

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

Да, особенно для проведённых документов и закрытых периодов. Без прав на редактирование запись может быть отклонена или привести к нарушению учёта.