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

Другое · 7 мин

Идентификатор строки в 1С: способы получения и проверка

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

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

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

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

Что понимать под идентификатором строки в 1С

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

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

Идентификатор строки табличной части документа

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

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

Идентификатор записи справочника или документа в базе

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

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

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

Получение ссылки на объект
Норма

Объект открывается по ссылке и содержит ожидаемые реквизиты

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

Ссылка пустая или ведёт на удалённый объект

Уникальное поле строки табличной части
Норма

Значение заполнено при создании и не меняется при редактировании документа

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

Поле пустое или повторяется у разных строк

Номер строки после вставки
Норма

Номера пересчитываются в соответствии с текущим порядком

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

Номер используется как постоянный ключ после изменения таблицы

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

Номер строки в значении таблицы и временной таблице запроса

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

Порядок действий для постоянного идентификатора строки
  1. 1
    Определите, где находится строка: табличная часть, справочник, значение таблицы или форма списка
  2. 2
    Для табличной части добавьте реквизит типа УникальныйИдентификатор и заполняйте его при создании строки
  3. 3
    Для постоянных объектов используйте ссылку на объект или УникальныйИдентификатор, если он доступен
  4. 4
    Проверьте результат после записи, удаления и повторного открытия объекта

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

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

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

Типичные ошибки
01
Использование номера строки табличной части как постоянного идентификатора
02
Применение ссылки на объект между разными информационными базами
03
Правка конфигурации без резервной копии и тестирования

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

Ограничения, риски и типичные ошибки

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

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

Сравнение способов идентификации строки

Источник идентификатораЧто получаетсяОбласть действия
Ссылка на объект базыПостоянная ссылка на записьОдна информационная база
Поле УникальныйИдентификаторУникальное значение, если предусмотреноЗависит от конфигурации
Номер строки табличной частиПорядковый номерТолько текущее состояние таблицы
Собственное поле строки табличной частиЗаданное разработчиком значениеВ пределах родительского объекта
Текущая строка формы спискаВыбранная запись или ссылкаТекущая сессия и форма

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

Итог

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

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

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

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

Отличается ли идентификатор в разных информационных базах?

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

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

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

Нужно ли менять конфигурацию для добавления идентификатора строки?

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