Как получить полное имя типа в 1С

Во встроенном языке 1С «имя типа» может означать два разных значения. Первое — строковое представление типа, например «СправочникСсылка.Номенклатура», которое возвращает функция ТипЗнч() в связке со Строка() или XMLТипЗнч(). Второе — полное имя объекта метаданных, например «Справочник.Номенклатура», которое получают через объект описания метаданного. Путаница между этими двумя сущностями — самая частая причина ошибок при разработке универсальных механизмов.

Выбор способа зависит от задачи. Если нужно сравнить типы, построить описание типов для отбора или вывести тип в сообщение пользователю — достаточно ТипЗнч(). Если требуется имя для обращения к метаданным, построения запроса, динамического создания объекта или сериализации — нужен именно объект метаданных и его метод ПолноеИмя().

Ниже разобраны все рабочие способы: от простого получения типа значения до получения полного имени по ссылке, по типу и по строке, а также ограничения каждого подхода и типичные ошибки.

Что именно считается «полным именем типа» в 1С

Терминология здесь неформальная, поэтому важно зафиксировать определения. Строковое представление типа — это то, что возвращает преобразование типа в строку: «СправочникСсылка.Номенклатура», «ДокументСсылка.РеализацияТоваровУслуг», «Число», «Строка». Такое представление удобно для отладки и сообщений, но не является идентификатором объекта конфигурации.

Полное имя объекта метаданных — это идентификатор вида «Справочник.Номенклатура» или «Документ.РеализацияТоваровУслуг», который возвращает метод ПолноеИмя() объекта описания метаданных. Именно эта строка принимается методами Метаданные.НайтиПоПолномуИмени(), используется в текстах запросов и в механизмах обмена.

Для примитивных типов (Число, Строка, Дата, Булево) объекта метаданных не существует вовсе, поэтому Метаданные.НайтиПоТипу() для них вернёт Неопределено. Это принципиальное ограничение, которое нужно учитывать в универсальном коде.

Получаем строковое представление типа через ТипЗнч()

Базовый способ — функция ТипЗнч(Значение), которая возвращает объект типа «Тип». Чтобы получить читаемую строку, тип преобразуют функцией Строка():

ТипЗначения = ТипЗнч(СсылкаНаОбъект);
ИмяТипа = Строка(ТипЗначения);
// Результат: "СправочникСсылка.Номенклатура"

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

Если нужна строка, пригодная для обратного преобразования через Тип(), используют XMLТипЗнч() или формируют имя в формате, который понимает конструктор типа. Для ссылочных типов корректно работает связка с полным именем метаданных, рассмотренная ниже.

ТипЗначения = ТипЗнч(Значение);
ИмяТипаСтрокой = Строка(ТипЗначения); // "ДокументСсылка.ПриходныйОрдер"
Если ТипЗначения = Тип("ДокументСсылка.ПриходныйОрдер") Тогда
	// сравнение по объекту типа, а не по строке
КонецЕсли;

Получаем полное имя метаданных через НайтиПоТипу

Когда нужен именно идентификатор объекта конфигурации, последовательность такая: сначала получаем тип значения, затем по типу находим объект описания метаданных, затем вызываем ПолноеИмя():

ТипЗначения = ТипЗнч(Ссылка);
ОбъектМетаданных = Метаданные.НайтиПоТипу(ТипЗначения);
Если ОбъектМетаданных <> Неопределено Тогда
ПолноеИмя = ОбъектМетаданных.ПолноеИмя();
// Результат: "Справочник.Номенклатура"
КонецЕсли;

Проверка на Неопределено обязательна: для примитивных типов, типов вида «ХранилищеЗначения», «УникальныйИдентификатор» и ряда системных типов метаданных нет, и без проверки код упадёт с ошибкой обращения к методу.

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

1. 1
   Проверьте, что значение не Неопределено и не NULL
2. 2
   Получите тип: ТипЗнч(Значение)
3. 3
   Найдите метаданные: Метаданные.НайтиПоТипу(ТипЗначения)
4. 4
   Проверьте, что результат не Неопределено (для примитивных типов метаданных нет)
5. 5
   Вызовите ОбъектМетаданных.ПолноеИмя() и используйте строку
6. 6
   Для ссылок вместо шагов 2–4 можно сразу вызвать Ссылка.Метаданные().ПолноеИмя()

Полное имя по ссылке, объекту и строке: три сценария

По ссылке или объекту данных

Самый короткий и надёжный вариант для ссылочных значений — метод Метаданные():

ПолноеИмя = Ссылка.Метаданные().ПолноеИмя();
// "Документ.РеализацияТоваровУслуг"

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

По строковому имени

Обратная задача — по строке «Справочник.Номенклатура» получить метаданные и тип — решается методом Метаданные.НайтиПоПолномуИмени():

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

По типу без значения

Если значения нет, а есть только тип (например, из описания типов реквизита), Метаданные.НайтиПоТипу() работает точно так же — ему нужен именно объект типа, а не значение. Это удобно при обходе реквизитов метаданных и анализе состава типов.

Практические применения: где нужно полное имя

Наиболее частый сценарий — динамическое построение запроса. Текст запроса принимает полное имя таблицы, поэтому универсальные функции выборки строят его так: "ВЫБРАТЬ Ссылка ИЗ " + Ссылка.Метаданные().ПолноеИмя(). Это позволяет писать один код для любых справочников и документов.

Второй сценарий — сериализация и обмен. При выгрузке данных в универсальном формате полное имя метаданных сохраняют вместе со ссылкой, чтобы на стороне приёмника восстановить тип через Метаданные.НайтиПоПолномуИмени() и Тип(). Строковое представление типа для этого менее удобно: его приходится разбирать и сопоставлять с видами объектов вручную.

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

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

Главное ограничение уже упоминалось: примитивные типы не имеют метаданных. Попытка получить Метаданные.НайтиПоТипу(Тип("Число")) вернёт Неопределено, а обращение Значение.Метаданные() к числу или строке вызовет ошибку времени выполнения. В универсальном коде сначала проверяют, является ли значение ссылочным, например через ОбщегоНазначения.ЭтоСсылка() в типовых конфигурациях или через сравнение с шаблонами типов.

Вторая тонкость — различие между «СправочникСсылка.Номенклатура» и «Справочник.Номенклатура». Если строку первого вида передать в Метаданные.НайтиПоПолномуИмени(), поиск вернёт Неопределено: метод ожидает имя без суффикса «Ссылка»/«Объект». Преобразование между форматами делают заменой подстроки или через объект метаданных.

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

Проверка результата и отладка

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

При отладке удобно выводить обе формы рядом: строковое представление типа и полное имя метаданных. Совпадение «хвостов» (имени объекта) и различие префиксов наглядно показывает, какая из форм нужна в конкретном месте кода.

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