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