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

Другое · 7 мин

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

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

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

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

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

Отличие таблицы значений от табличной части формы

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

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

Как получить текущую строку в форме

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

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

Получение номера при обходе таблицы значений

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

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

Проверка результата и границы безопасной работы

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

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

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

Частые ошибки при определении номера строки

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

Маршрут решения

Как выбрать действие

Нужна текущая выделенная строка в формеИспользуйте свойства текущего элемента табличного поля
Нужен стабильный порядковый номер в кодеЗаведите счётчик при обходе таблицы или табличной части
Данные получены из запросаЗадайте явную сортировку перед определением номера

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

Как выбрать подходящий способ

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

Контрольные точки

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

Границы индекса строки
Норма

Индекс в допустимом диапазоне

Тревожный признак

Индекс выходит за пределы набора

Соответствие строки ожидаемым данным
Норма

Значения ключевых полей совпадают

Тревожный признак

Получена другая строка или пустая строка

Результат после фильтрации и сортировки
Норма

Номер актуален для текущего представления

Тревожный признак

Номер не обновлён после изменения порядка

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

Контрольные точки перед завершением

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

Итог

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

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

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

Почему номер строки меняется после сортировки?

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

Начинается ли нумерация строк в 1С с нуля или с единицы?

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

Можно ли сохранить номер строки как постоянный идентификатор?

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

Что делать, если строка не найдена по номеру?

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