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