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

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

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

Как устроена нумерация строк в таблице значений

Таблица значений — это несохраняемая в базе коллекция строк, которая существует только в оперативной памяти во время выполнения кода. Каждая строка доступна по индексу: первая строка имеет индекс 0, вторая — 1 и так далее. Метод Количество() возвращает общее число строк, поэтому индекс последней строки всегда равен ТЗ.Количество() - 1.

У объекта СтрокаТаблицыЗначений нет встроенного свойства с номером. Это принципиальное отличие от строк табличных частей документов и справочников, где свойство НомерСтроки поддерживается платформой автоматически. Поэтому любой «номер» для таблицы значений — это либо индекс, либо значение, которое разработчик хранит в отдельной колонке самостоятельно.

Способ 1. Метод Индекс() — когда строка уже известна

Если у вас уже есть переменная, содержащая конкретную строку таблицы значений (например, она получена из цикла, поиска или передана в процедуру), самый короткий путь — метод Индекс(). Он возвращает позицию переданной строки в коллекции или -1, если такой строки в таблице нет.

НомерСтроки = ТаблицаТоваров.Индекс(ТекущаяСтрока) + 1;
Сообщить("Товар найден в строке № " + НомерСтроки);

Проверка на -1 обязательна, если строка могла быть получена из другой таблицы или удалена. Частая ошибка — передать в Индекс() строку из копии таблицы: метод вернёт -1, а код без проверки покажет «строку № 0», что введёт в заблуждение.

Способ 2. Перебор в цикле с вычислением номера

Когда номер нужен прямо в процессе обхода таблицы, удобнее не вызывать Индекс() для каждой строки, а считать позицию в самом цикле. Есть два рабочих варианта: классический цикл со счётчиком и цикл «Для Каждого» с ручным накоплением номера.

Для Сч = 0 По ТаблицаТоваров.Количество() - 1 Цикл
СтрокаТЗ = ТаблицаТоваров[Сч];
НомерСтроки = Сч + 1;
// работа со строкой
КонецЦикла;

НомерСтроки = 0;
Для Каждого СтрокаТЗ Из ТаблицаТоваров Цикл
НомерСтроки = НомерСтроки + 1;
// работа со строкой
КонецЦикла;

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

НомерСтроки = 0;
Для Каждого СтрокаТЗ Из ТаблицаТоваров Цикл
    НомерСтроки = НомерСтроки + 1;
    Если Не ЗначениеЗаполнено(СтрокаТЗ.Цена) Тогда
        Сообщить("Не заполнена цена в строке " + НомерСтроки);
    КонецЕсли;
КонецЦикла;

Способ 3. Получить номер строки, найденной по условию

На практике чаще всего задача звучит так: найти строку с нужным товаром и узнать её номер. Здесь методы Найти() и НайтиСтроки() комбинируются с Индекс(). Найти() возвращает первую подходящую строку или Неопределено, НайтиСтроки() — массив всех подходящих строк.

НайденнаяСтрока = ТаблицаТоваров.Найти(Артикул, "Артикул");
Если НайденнаяСтрока <> Неопределено Тогда
НомерСтроки = ТаблицаТоваров.Индекс(НайденнаяСтрока) + 1;
КонецЕсли;

Если совпадений несколько, обходите массив из НайтиСтроки() и для каждого элемента вызывайте Индекс(). Учтите, что это решение работает за линейное время на каждую строку: на больших таблицах (десятки тысяч строк) многократный вызов Индекс() заметно тормозит выполнение. В таких случаях эффективнее один перебор со счётчиком, где номер фиксируется в момент совпадения условия.

Как сохранить номер строки при сортировке и свёртке

Индекс — это текущая позиция, а не постоянный признак строки. После Сортировать(), Свернуть() или удаления строк позиции пересчитываются, и ранее полученный номер теряет смысл. Если логика требует «привязать» номер к данным, добавьте в таблицу собственную колонку и заполните её один раз сразу после формирования таблицы.

ТаблицаТоваров.Колонки.Добавить("НомерСтроки", Новый ОписаниеТипов("Число"));
Для Сч = 0 По ТаблицаТоваров.Количество() - 1 Цикл
ТаблицаТоваров[Сч].НомерСтроки = Сч + 1;
КонецЦикла;

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

Номер строки на управляемой форме: ДанныеФормыКоллекция

Когда таблица значений выведена на управляемую форму как реквизит, в коде формы вы работаете не с ТаблицаЗначений, а с объектом ДанныеФормыКоллекция. У него тоже есть метод Индекс(), а у текущей строки элемента формы можно получить идентификатор через Элементы.ИмяТаблицы.ТекущаяСтрока.

ТекущиеДанные = Элементы.ТаблицаТоваров.ТекущиеДанные;
Если ТекущиеДанные <> Неопределено Тогда
НомерСтроки = ТаблицаТоваров.Индекс(ТекущиеДанные) + 1;
КонецЕсли;

На форме у строки есть ещё одно свойство — НомерСтроки, которое платформа ведёт автоматически и показывает в строке нумерации табличного поля. Оно совпадает с Индекс() + 1 при отсутствии отбора, но при включённом отборе в табличном поле отображаемый номер и индекс в коллекции могут расходиться. Для программной логики всегда используйте Индекс(), а для сообщений пользователю — тот номер, который он видит на экране.

Проверка результата и отладка

Убедиться, что номер получен правильно, проще всего в отладчике: поставьте точку останова после вычисления, откройте таблицу значений через «Вычислить выражение» (F9 → ТЗ → «Показать значение») и сверьте, что строка с нужными данными действительно стоит на позиции НомерСтроки - 1 по индексу.

Второй контроль — обратное обращение: выражение ТЗ[НомерСтроки - 1] должно вернуть ту же самую строку, с которой вы начинали. Если возвращается другая строка, значит между получением номера и проверкой таблица изменилась. Для сообщений пользователю дополнительно выводите ключевые данные строки (например, наименование товара) рядом с номером — это исключает двойное толкование.

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