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