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

Работа с платформой 1С:Предприятие 8 требует глубокого понимания внутренней структуры метаданных. Программистам и администраторам часто приходится сталкиваться с задачей идентификации объектов конфигурации. Имя справочника является ключевым идентификатором, который используется в коде, запросах и при администрировании системы. Однако новички часто путают синоним, имя объекта и его внутренний идентификатор (UUID).

В этой статье мы подробно разберем, как программно получить точное имя справочника в режиме предприятия и в режиме конфигуратора. Мы рассмотрим использование метода Метаданные(), работу с полными именами объектов, а также способы поиска нужного справочника по его уникальному идентификатору. Понимание этих механизмов критически важно для написания устойчивого кода и правильной настройки обмена данными.

Основы именования объектов метаданных в 1С

Каждый объект конфигурации, будь то справочник, документ или регистр сведений, имеет уникальное имя. Это имя задается разработчиком в конфигураторе и не может содержать пробелов, специальных символов (кроме подчеркивания) и не должно начинаться с цифры. Именно это имя вы используете в коде при обращении к объектам, например, Справочники.Номенклатура.

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

Также существует понятие полного имени (Full Name). Оно включает в себя имя типа метаданных и имя самого объекта, разделенные точкой. Например, для справочника "Клиенты" полное имя будет выглядеть как Catalog.Клиенты (в английской локали платформы) или Справочник.Клиенты (в русской). Знание полного имени необходимо при работе с динамическими типами и универсальными коллекциями значений.

💡

При создании новых объектов старайтесь давать им имена на английском языке или транслите. Это упрощает поддержку кода и снижает риск проблем с кодировкой при выгрузке в файлы сравнения и слияния (xcf).

Получение имени через объект Метаданные в режиме предприятия

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

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

МД = Метаданные();
Для каждого ОписаниеСправочника Из МД.Справочники Цикл
// Вывод имени и синонима
Сообщить("Имя: " + ОписаниеСправочника.Имя);
Сообщить("Синоним: " + ОписаниеСправочника.Синоним);
КонецЦикла;

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

☑️ Алгоритм поиска имени справочника

Подключиться к базе в режиме 1С:ПредприятиеОткрыть консоль кода или обработкуВызвать метод Метаданные().СправочникиВыбрать нужное свойство .Имя

Выполнено: 0 / 4

Работа с полными именами и типами объектов

Часто в задачах интеграции или при написании универсальных обработок требуется оперировать полными именами объектов. Полное имя состоит из префикса типа и имени объекта. В платформе 1С:Предприятие 8 эти префиксы стандартизированы.

Для справочников префиксом служит слово Catalog (в английской версии платформы) или Справочник. Таким образом, полное имя справочника "Контрагенты" будет равно Catalog.Контрагенты. Это значение можно получить программно, вызвав метод ПолноеИмя() у объекта описания метаданных.

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

Тип объекта	Префикс (EN)	Префикс (RU)	Пример полного имени
Справочник	Catalog	Справочник	Catalog.Номенклатура
Документ	Document	Документ	Document.РеализацияТоваровУслуг
Регистр сведений	InformationRegister	РегистрСведений	InformationRegister.КурсыВалют
План счетов	ChartOfAccounts	ПланСчетов	ChartOfAccounts.Хозрасчетный

Использование полных имен позволяет писать код, который менее зависим от локали платформы. Однако стоит помнить, что в разных версиях платформы или в разных конфигурациях (БП, УТ, ЗУП) имена объектов могут отличаться, хотя префиксы остаются неизменными.

Поиск справочника по уникальному идентификатору (UUID)

Иногда имя справочника неизвестно, но есть его уникальный идентификатор — UUID (Universally Unique Identifier). Это 16-байтное значение, которое присваивается объекту метаданных при создании и никогда не меняется, даже если вы переименуете справочник в конфигураторе.

Для поиска имени по UUID используется метод Метаданные().НайтиПоID(). Этот метод принимает строковое представление UUID и возвращает объект описания метаданных, если такой объект найден в конфигурации. Это мощный инструмент для рефлексии и анализа конфигурации.

Идентификатор = "{39F5C0C8-1234-4567-89AB-CDEF01234567}"; // Пример UUID
ОбъектМД = Метаданные().НайтиПоID(Идентификатор);

Если ОбъектМД <> Неопределено Тогда
ИмяСправочника = ОбъектМД.Имя;
Сообщить("Найден справочник: " + ИмяСправочника);
Иначе
Сообщить("Объект с таким ID не найден");
КонецЕсли;

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

⚠️ Внимание: UUID объекта метаданных не следует путать с UUID конкретной записи в базе данных (ссылки на элемент справочника). Метод НайтиПоID ищет именно объект конфигурации (справочник как тип), а не конкретный элемент ("Товар А").

Получение имени справочника в режиме Конфигуратора

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

Чтобы увидеть имя справочника, найдите его в дереве метаданных, кликните правой кнопкой мыши и выберите Свойства (или нажмите Alt+Enter). В открывшемся окне в поле Имя будет указано программное имя объекта. Это имя используется в коде.

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

Как увидеть внутреннее имя в дереве конфигурации?

По умолчанию в дереве конфигурации отображаются синонимы объектов. Чтобы увидеть программные имена, можно включить специальный режим отображения или просто навести курсор на объект — во всплывающей подсказке часто отображается имя в скобках после синонима. Также можно использовать поиск по конфигурации (Ctrl+F), вводя часть имени.

При разработке сложных систем важно следить за уникальностью имен. Платформа не позволит создать два справочника с одинаковым именем в рамках одной конфигурации. Однако имена могут пересекаться с именами объектов других типов (например, справочник "Тест" и документ "Тест" могут сосуществовать), так как они находятся в разных коллекциях метаданных.

Частые ошибки и нюансы при работе с именами

Одной из самых частых ошибок является попытка использовать синоним в коде. Например, написание Справочники.НаименованиеКлиента, когда реальное имя объекта — Клиенты, а "Наименование клиента" — это лишь синоним. Это приведет к ошибке компиляции или выполнения.

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

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

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

💡

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

Использование конструктора запросов для анализа структуры

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

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

ВЫБРАТЬ Справочники.Наименование КАК Синоним, Справочники.ИмяСсылки КАК ИмяОбъекта ИЗ

Справочник.Справочники КАК Справочники

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

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

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

В чем разница между Имя и ПолноеИмя?

Свойство Имя возвращает только имя объекта (например, "Номенклатура"). Свойство или метод ПолноеИмя возвращает имя с указанием типа (например, "Catalog.Номенклатура"). Полное имя необходимо для однозначной идентификации типа в универсальных алгоритмах.

Как найти имя справочника, если я знаю только его UUID из лога ошибки?

Используйте метод Метаданные().НайтиПоID("Ваш_UUID"). Этот метод вернет объект описания метаданных, у которого можно запросить свойство Имя. Это самый надежный способ связать UUID из лога с конкретным объектом конфигурации.

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

Нет, программное имя объекта (Имя) не зависит от языка интерфейса. Оно едино для всей конфигурации. Зависит от языка только Синоним, который может иметь несколько вариантов перевода для разных языковых версий платформы.