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

Другое · 6 мин

Как обратиться к реквизиту табличной части в 1С

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

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

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

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

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

В модуле объекта обращение имеет вид Объект.ИмяТабличнойЧасти[НомерСтроки].ИмяРеквизита. Номер строки начинается с нуля, поэтому первая строка имеет индекс 0. Если обратиться к несуществующему индексу, платформа выдаст ошибку при выполнении.

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

Работа с табличной частью в форме

В управляемой форме текущая выделенная строка часто доступна через свойство ТекущиеДанные элемента управления табличной частью. Обращение выглядит как Элементы.ИмяТаблицы.ТекущиеДанные.ИмяРеквизита. Это удобно при обработке действий пользователя над выделенной строкой.

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

Табличная часть пустаКоличество строк равно нулю

Проверьте количество строк перед обращением по индексу

Реквизит отсутствует в строкеИмя реквизита опечатано или не существует

Сверьте имя с конфигуратором

Текущая строка не выбранаТекущиеДанные не определено

Убедитесь, что пользователь выделил строку

Перебор строк и выборка по условию

Для обработки всех строк используется цикл Для каждого Строка Из Объект.ТабличнаяЧасть Цикл. Внутри цикла значение реквизита читается как Строка.ИмяРеквизита. Такой подход безопаснее обращения по фиксированному индексу, потому что не требует проверки границ вручную.

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

Запись значений и защита от изменений

Изменение реквизита строки выполняется присваиванием: Строка.ИмяРеквизита = НовоеЗначение. После изменения строки в табличной части объекта изменения сохраняются при записи самого объекта, если не установлены ограничения на редактирование.

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

Ограничения сервера и клиента

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

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

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

Частые ошибки при обращении к реквизитам

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

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

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

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

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

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

Итог

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

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

Можно ли обратиться к реквизиту табличной части без цикла?

Да, если известен индекс нужной строки, можно обратиться напрямую через Объект.ТабличнаяЧасть[Индекс].Реквизит. При этом нужно убедиться, что строка с таким индексом существует, иначе возникнет ошибка выполнения.

Что использовать в форме: ТекущиеДанные или индекс?

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

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

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

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

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