Проверка ссылочного типа в 1С: 5 рабочих способов с примерами

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

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

Мы рассмотрим не только стандартные методы вроде ТипЗнч(), но и менее очевидные приемы, включая работу с метаданными, рефлексией и даже анализом структуры хранения данных в базе. А в конце статьи вы найдете FAQ с ответами на самые частые вопросы по этой теме.

1. Что такое ссылочный тип в 1С и зачем его проверять

Ссылочный тип (Reference Type) в 1С:Предприятие — это особый вид данных, который представляет собой ссылку на объект метаданных, а не само значение. Например, когда вы получаете элемент справочника Номенклатура.НайтиПоНаименованию("Молоко"), результат будет не строкой "Молоко", а ссылкой на этот элемент. Это позволяет:

• 🔗 Сохранять связность данных — при изменении наименования объекта ссылка останется валидной.
• 📊 Работать с метаданными — через ссылку можно получить доступ к реквизитам, табличным частям и методам объекта.
• 🔄 Обеспечивать целостность — система автоматически контролирует удаление ссылок (если не отключены соответствующие настройки).

Проверка ссылочного типа необходима в следующих случаях:

1. При написании универсальных процедур, которые должны обрабатывать разные типы данных (например, рекурсивный обход структуры).
2. При сериализации/десериализации данных (например, при обмене с внешними системами через JSON или XML).
3. При отладке кода, когда нужно понять, почему функция возвращает неожиданный результат.
4. При работе с динамическими списками или запросами, где типы полей могут варьироваться.

Важно понимать, что ссылочные типы не являются примитивными — их нельзя сравнивать напрямую со строками или числами. Например, код Если СсылкаНаДокумент = "Документ 123" Тогда... приведет к ошибке, потому что сравниваются несовместимые типы. Поэтому проверка типа становится критичной для корректной работы алгоритмов.

2. Способы проверки ссылочного типа в конфигураторе

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

2.1. Просмотр свойств в палитре свойств

Самый простой способ — посмотреть тип поля или переменной в палитре свойств:

1. Выделите переменную, реквизит или параметр в модуле.
2. Откройте палитру свойств (Alt+Enter).
3. Найдите свойство Тип — если там указано что-то вроде СправочникСсылка.Номенклатура или ДокументСсылка.ЗаказПокупателя, это ссылочный тип.

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

2.2. Использование функции "ТипЗнч()" в отладчике

Если вы работаете в режиме отладки, можно быстро проверить тип значения с помощью функции ТипЗнч():

Сообщить(ТипЗнч(МояПеременная));

Для ссылочных типов результат будет выглядеть так:

• СправочникСсылка.Контрагенты
• ДокументСсылка.РеализацияТоваровУслуг
• ПланВидовХарактеристикСсылка.Номенклатура

Если же переменная содержит значение (не ссылку), результат будет другим:

• Число
• Строка
• Дата

2.3. Анализ метаданных через "МетодМетаданных()"

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

Метаданные = Метаданные.Справочники.Номенклатура;
Если Метаданные.ЭтоГруппа Тогда
// Это группа справочника (не ссылочный тип в привычном смысле)
Иначе
// Это элемент справочника (ссылочный тип)
КонецЕсли;

Этот подход полезен, когда нужно отличать группы справочников от элементов, так как группы не являются ссылочными типами в полном смысле (они не хранят данные, а только структурируют их).

3. Проверка ссылочного типа во встроенном языке (1С:Предприятие)

На этапе выполнения (в режиме 1С:Предприятие) проверка ссылочного типа осуществляется с помощью встроенных функций и операторов. Рассмотрим основные методы.

3.1. Функция "ТипЗнч()" — универсальный инструмент

Как и в конфигураторе, во встроенном языке можно использовать ТипЗнч(), но с некоторыми нюансами:

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

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

3.2. Оператор "Тип" — альтернатива для новых версий платформы

В последних версиях 1С:Предприятие 8.3

(начиная с 8.3.10) появился оператор Тип, который упрощает проверку:

Если Тип(МояПеременная) = Тип("СправочникСсылка.Контрагенты") Тогда
// Это ссылка на справочник "Контрагенты"
КонецЕсли;

Преимущества этого подхода:

• 🔍 Безопасность — нет риска опечаток в строковых сравнениях.
• 🚀 Производительность — оператор работает быстрее, чем анализ строки.
• 📌 Поддержка автодополнения — в конфигураторе подскажет доступные типы.

3.3. Проверка через методы объектов

Если переменная содержит ссылку на объект, можно воспользоваться его методами. Например, для справочников и документов доступны методы ЭтоГруппа() и Ссылка.Пустая():

Если МояПеременная.ЭтоГруппа() Тогда
// Это группа справочника (не ссылочный тип в полном смысле)
ИначеЕсли МояПеременная.Ссылка.Пустая() Тогда
// Это пустая ссылка
Иначе
// Это валидная ссылка на объект
КонецЕсли;

Этот способ полезен, когда нужно не только определить ссылочность, но и проверить состояние ссылки (пустая, группа, элемент).

3.4. Работа с динамическими типами (рефлексия)

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

Попытка
Если МояПеременная.Ссылка.Метаданные() <> Неопределено Тогда
// Это ссылочный тип (имеет метод "Ссылка")
Иначе
// Это не ссылочный тип
КонецЕсли;
Исключение
// Обработка ошибки, если переменная не поддерживает метод "Ссылка"
КонецПопытки;

Этот метод требует осторожности, так как может вызывать исключения, если переменная не является объектом 1С. Всегда оборачивайте такой код в Попытка...Исключение.

// НЕПРАВИЛЬНО!
Если СсылкаНаДокумент = "Документ №123" Тогда
// Ошибка: нельзя сравнивать ссылку со строкой
КонецЕсли;

Если СсылкаНаДокумент.Наименование = "Документ №123" Тогда
// Сравниваем свойство ссылки (Наименование) со строкой
КонецЕсли;

// ОПАСНО!
Наименование = СсылкаНаДокумент.Наименование; // Вызовет ошибку, если ссылка пустая

// ПРАВИЛЬНО
Если НЕ СсылкаНаДокумент.Пустая() Тогда
Наименование = СсылкаНаДокумент.Наименование;
КонецЕсли;

Если ТипЗнч(МояПеременная) = "СправочникСсылка.Номенклатура" Тогда
// Это может быть как элемент, так и группа!
Если МояПеременная.ЭтоГруппа() Тогда
// Обработка группы
Иначе
// Обработка элемента
КонецЕсли;
КонецЕсли;

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

Функция ОбработатьДанные(Значение)
ТипДанных = ТипЗнч(Значение);

Если СтрНачинаетсяС(ТипДанных, "СправочникСсылка.") Тогда
Возврат "Это ссылка на справочник: " + Значение.Наименование;
ИначеЕсли СтрНачинаетсяС(ТипДанных, "ДокументСсылка.") Тогда
Возврат "Это ссылка на документ: " + Значение.Номер;
ИначеЕсли ТипДанных = "Число" Тогда
Возврат "Это число: " + Значение;
Иначе
Возврат "Неопознанный тип: " + ТипДанных;
КонецЕсли;
КонецФункции

Функция СсылкаВJSON(Ссылка)
Если НЕ Ссылка.Пустая() Тогда
Возврат JSONЗначение(Ссылка.УникальныйИдентификатор());
Иначе
Возврат JSONЗначение(Неопределено);
КонецЕсли;
КонецФункции

Процедура ЗагрузитьДанные(Источник)
Если Тип(Источник) <> Тип("СправочникСсылка.Контрагенты") И
Тип(Источник) <> Тип("ДокументСсылка.ЗаказПокупателя") Тогда
ВызватьИсключение "Неверный тип параметра 'Источник'!";
КонецЕсли;
// Далее работаем со ссылочным типом
КонецПроцедуры

• 🛠️ Для отладки удобнее ТипЗнч() или палитра свойств.
• ⚡ Для производительности в новых версиях лучше оператор Тип.
• 🔄 Для динамических типов подходит рефлексия.

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

Если МояПеременная = Неопределено Или МояПеременная.Пустая() Тогда
// Ссылка пустая или не определена
Иначе
ТипДанных = ТипЗнч(МояПеременная);
КонецЕсли;

НоваяСсылка = Справочники.Контрагенты.СоздатьЭлемент();
НоваяСсылка.Наименование = "Новый контрагент";
НоваяСсылка.Записать();

ВЫБРАТЬ
ТИП(СсылкаНаДокумент) КАК ТипСсылки
ИЗ
Документ.ЗаказПокупателя КАК ЗаказПокупателя