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