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

Другое · 8 мин

1С: как получить идентификатор перечисления

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

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

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

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

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

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

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

В built-in языке обращение к элементу перечисления обычно имеет вид: Перечисление.ИмяПеречисления.ИмяЭлемента. Далее к результату можно применить свойство или метод, возвращающий идентификатор, если такая возможность предусмотрена версией платформы. Точное название элемента языка уточняйте в синтакс-помощнике, так как оно может различаться между управляемым и обычным приложением.

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

Не пишите условия вида «если идентификатор равен строке X» напрямую в отчётах и обработках без проверки базы. Лучше сравнивать элементы перечисления по ссылке или по наименованию, а идентификатор использовать только для обмена и сопоставления с внешними системами. Это снижает риск поломки после изменения конфигурации.

Порядок действий
  1. 1
    Откройте перечисление в конфигураторе и найдите нужный элемент
  2. 2
    Уточните в синтакс-помощнике способ получения идентификатора для своей версии платформы
  3. 3
    Получите значение в встроенном языке или запросе
  4. 4
    Проверьте, что идентификатор не пуст и соответствует ожидаемому элементу
  5. 5
    Сверьте идентификатор после переноса конфигурации в другую базу

Получение идентификатора через запрос

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

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

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

Идентификатор, наименование и код: в чём разница

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

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

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

Идентификатор доступен в конфигуратореВидно в свойствах элемента перечисления

Проверьте редактор перечисления и настройки отображения колонок

Свойство или метод в языкеЕсть в синтакс-помощнике для вашей платформы

Уточните точное имя перед написанием кода

Поле в запросеПрисутствует в таблице перечисления

Выполните тестовый запрос и проверьте уникальность результатов

Ограничения и риски при работе с идентификаторами

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

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

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

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

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

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

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

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

Итог

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

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

Частые вопросы

Нужен ли идентификатор для обычной работы в 1С?

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

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

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

Что делать, если в запросе нет поля идентификатора?

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

Безопасно ли хранить идентификаторы в настройках пользователя?

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

Как проверить, что полученный идентификатор верный?

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