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

Другое · 8 мин

Обращение к элементу табличной части в 1С

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

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

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

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

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

Если код пишется в модуле объекта, обращение выглядит так: Объект.ТабличнаяЧасть[Индекс].НазваниеПоля. Индекс начинается с нуля, поэтому первая строка имеет индекс 0. Узнать индекс конкретной строки можно методом Индекс(Строка), который возвращает неопределенное значение, если строка не принадлежит табличной части.

Код в модуле объектаОбъект.ТабличнаяЧасть[Индекс].Поле

Подходит для серверной логики и расчетов без привязки к форме

Код в модуле формыЭлементы.ТабличноеПоле.ТекущиеДанные.Поле

Используется при работе с выделенной пользователем строкой

Пустая табличная частьКоличество() равно нулю

Любое обращение по индексу приведет к ошибке

Где находится код: модуль объекта или модуль формы

В модуле объекта табличная часть существует как часть данных документа или справочника. Обращение к ней возможно в процедурах проведения, записи, заполнения и других событиях объекта. Пример: Объект.Товары[0].Количество. Это работает независимо от того, открыт ли документ в форме.

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

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

Доступ к строке по индексу и по текущей строке

Доступ по индексу удобен, когда номер строки известен заранее, например первая или последняя. Последняя строка имеет индекс ТабличнаяЧасть.Количество() - 1. Обращение к индексу, равному количеству строк или большему, вызывает ошибку, поэтому индекс всегда нужно проверять.

Для перехода к строке по найденному элементу используется метод Индекс(Строка). Если метод возвращает неопределенное значение, строка не найдена в этой табличной части. Это полезно при проверке, принадлежит ли выбранный объект к текущему документу.

В модуле объекта

Если Объект.Товары.Количество() > 0 Тогда
Объект.Товары[0].Количество = 10;
КонецЕсли;

В модуле формы

Если Элементы.Товары.ТекущиеДанные <> Неопределено Тогда
Элементы.Товары.ТекущиеДанные.Количество = 10;
КонецЕсли;

Перебор строк и изменение значений

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

Если нужно удалить строки в цикле, лучше идти от последней к первой, иначе индексы смещаются и часть строк может быть пропущена. Метод Удалить(Индекс) принимает числовой индекс, а не саму строку, поэтому перед удалением часто используют Индекс(Строка).

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

Порядок действий
  1. 1
    Определите, где пишется код: в модуле объекта или формы
  2. 2
    Проверьте, что табличная часть не пустая через Количество()
  3. 3
    Обратитесь к строке по индексу или через ТекущиеДанные
  4. 4
    Измените нужное поле и сохраните документ
  5. 5
    Проверьте результат на форме или в отчете

Проверка количества строк и границ индекса

Перед любым обращением по индексу проверяйте ТабличнаяЧасть.Количество(). Если ноль, табличная часть пустая, и доступ к любому индексу приведет к ошибке выполнения. Допустимый диапазон индексов: от 0 до Количество() - 1.

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

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

Сохранение изменений и ограничения доступа

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

Табличная часть имеет ограниченный набор методов: Добавить, Удалить, Очистить, Индекс, Количество, Загрузить и Выгрузить. Прямое создание новой табличной части через конструктор в коде применяется редко; обычно работа идет со свойством существующего объекта.

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

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

Типичные ошибки и альтернативные способы

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

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

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

Итог

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

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

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

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

Что делать, если индекс выходит за границы?

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

Отличается ли доступ в форме от доступа в объекте?

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

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

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

Как безопасно удалять несколько строк?

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