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

В этой статье мы разберём все доступные способы получения типа значения: от стандартных функций ТипЗнч() и ТипЗнчСтр() до малоизвестных приёмов с использованием метаданных и рефлексии. Особое внимание уделим нюансам работы с универсальными коллекциями, NULL-значениями и динамически создаваемыми объектами. Материал актуален для платформы 1С:Предприятие 8.3 (включая последние релизы), но большинство методов применимы и к более ранним версиям.

1. Стандартные функции: ТипЗнч() и ТипЗнчСтр()

Базовые инструменты для определения типа — встроенные функции ТипЗнч() и ТипЗнчСтр(). Они возвращают тип значения в виде объекта Тип или его строкового представления соответственно. Разберём их особенности и ограничения.

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

  • 🔹 ТипЗнч(10) → вернёт объект типа Число
  • 🔹 ТипЗнч("Привет") → объект типа Строка
  • 🔹 ТипЗнч(Справочники.Номенклатура.НайтиПоНаименованию("Товар1")) → объект типа СправочникСсылка.Номенклатура

Функция ТипЗнчСтр() упрощает задачу, возвращая строковое представление типа. Это удобно для быстрой проверки или логирования, но лишает возможности анализировать структуру объекта. Например, для справочника она вернёт просто строку "СправочникСсылка.Номенклатура", без дополнительных свойств.

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

2. Проверка типа с использованием конструкции Тип()

Конструктор Тип() позволяет создавать объекты типов для сравнения. Это полезно, когда нужно явным образом указать ожидаемый тип в коде. Например, чтобы проверить, является ли переменная ссылкой на документ "РеализацияТоваровУслуг", можно написать:

Если ТипЗнч(Переменная) = Тип("ДокументСсылка.РеализацияТоваровУслуг") Тогда

// Обработка документа реализации


КонецЕсли;

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

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

  • 📌 Тип("СправочникСсылка") — любой справочник
  • 📌 Тип("ДокументСсылка") — любой документ
  • 📌 Тип("Число") — любое число (включая Число(10,2))
⚠️ Внимание: При сравнении типов учитывайте, что Тип("Число") не эквивалентен Тип("Число(10,2)"). Для проверки числовых типов с заданной точностью используйте явное указание параметров.
📊 Какой метод проверки типа вы используете чаще?
ТипЗнч()
ТипЗнчСтр()
Конструктор Тип()
Собственные функции
Не проверяю тип

3. Работа с универсальными коллекциями: Массив, Структура, Соответствие

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

Для проверки, является ли переменная массивом, структурой или соответствием, используйте сравнение с базовыми типами:

Если ТипЗнч(Переменная) = Тип("Массив") Тогда

// Обработка массива


ИначеЕсли ТипЗнч(Переменная) = Тип("Структура") Тогда


// Обработка структуры


КонецЕсли;

Однако для анализа содержимого коллекции потребуется рекурсивная проверка каждого элемента. Например, чтобы убедиться, что все элементы массива — числа, можно написать:

Функция ВсеЭлементыЧисла(Массив)

Для Каждого Элемент Из Массив Цикл


Если ТипЗнч(Элемент) <> Тип("Число") Тогда


Возврат Ложь;


КонецЕсли;


КонецЦикла;


Возврат Истина;


КонецФункции

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

Убедиться, что переменная — коллекция (Массив/Структура/Соответствие)|Проверить тип каждого элемента рекурсивно|Учесть возможность вложенных коллекций|Обработать случай пустой коллекции-->

4. Определение типа NULL и Неопределён

Значения NULL и Неопределён в 1С часто становятся источником ошибок. Они не имеют типа в традиционном понимании, и стандартные функции возвращают для них Неопределён. Разберёмся, как их отличить друг от друга и от "нормальных" значений.

Для проверки на NULL используйте функцию ЗначениеЗаполнено():

Если НЕ ЗначениеЗаполнено(Переменная) Тогда

// Переменная содержит NULL


КонецЕсли;

Для проверки на Неопределён сравнивайте напрямую:

Если Переменная = Неопределён Тогда

// Переменная не инициализирована


КонецЕсли;

Ключевое отличие: NULL — это отсутствие значения (например, в необязательном поле базы данных), а Неопределён — неинициализированная переменная. В некоторых случаях (например, при работе с запросами) 1С автоматически преобразует NULL в Неопределён, но это не всегда так.

Значение ТипЗнч() ЗначениеЗаполнено() Когда возникает
NULL Неопределён Ложь Необязательные поля в базе, параметры запросов
Неопределён Неопределён Истина (но сравнение с Неопределён даст Истина) Неинициализированные переменные, отсутствие возврата в функции
0 (ноль) Тип("Число") Истина Инициализированная числовая переменная
💡

Чтобы избежать ошибок при работе с NULL, всегда инициализируйте необязательные параметры функций значением по умолчанию, например: Функция МояФункция(Параметр = Неопределён)

5. Работа с динамическими типами и рефлексией

В некоторых случаях тип значения заранее неизвестен или определяется динамически (например, при обработке данных из внешних источников или универсальных обработок). Здесь на помощь приходят механизмы рефлексии и анализ метаданных.

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

Если ТипЗнч(Объект) = Тип("СправочникСсылка") Тогда

Сообщить("Это справочник: " + Объект.Метаданные().Имя);


КонецЕсли;

Для динамического создания типов (например, при работе с XDTO или HTTP-сервисами) используйте конструктор Новый ОписаниеТипов:

Описание = Новый ОписаниеТипов("Тип1, Тип2, ...");

Для Каждого Тип Из Описание.Типы Цикл


Сообщить(Тип.Имя);


КонецЦикла;

Особенно полезен этот подход при работе с JSON или XML, где структура данных заранее неизвестна. Например, при парсинге JSON-ответа от API можно динамически определять типы полей и конвертировать их в объекты 1С.

Как определить тип поля в запросе?

В результатах запроса поля всегда возвращаются как Тип("Число"), Тип("Строка") и т.д., даже если в базе они имеют другой тип (например, ссылка на справочник преобразуется в строку или число). Чтобы получить оригинальный тип, используйте конструкцию ВЫБРАТЬ ... ПОМЕСТИТЬ ВО ВРЕМЕННУЮ ТАБЛИЦУ с явным указанием типов полей.

6. Практический пример: универсальная функция определения типа

Чтобы упростить работу с типами, можно создать универсальную функцию, которая будет возвращать развёрнутую информацию о переменной, включая обработку NULL и Неопределён. Вот пример такой функции:

Функция ПолучитьИнформациюОТипе(Значение) Экспорт

Если Значение = Неопределён Тогда


Возврат "Неопределён";


ИначеЕсли НЕ ЗначениеЗаполнено(Значение) Тогда


Возврат "NULL";


Иначе


Тип = ТипЗнч(Значение);


Если Тип = Тип("Массив") Тогда


Возврат "Массив (" + Строка(Значение.ВГраница()) + " элементов)";


ИначеЕсли Тип = Тип("Структура") Тогда


Возврат "Структура (" + Строка(Значение.Количество()) + " ключей)";


ИначеЕсли Тип = Тип("СправочникСсылка") Тогда


Возврат "СправочникСсылка." + Тип.ИмяТипа;


ИначеЕсли Тип = Тип("ДокументСсылка") Тогда


Возврат "ДокументСсылка." + Тип.ИмяТипа;


Иначе


Возврат ТипЗнчСтр(Значение);


КонецЕсли;


КонецЕсли;


КонецФункции

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

Пример использования:

Сообщить(ПолучитьИнформациюОТипе(Справочники.Номенклатура.ПустаяСсылка()));

// Вернёт: "СправочникСсылка.Номенклатура"



Сообщить(ПолучитьИнформациюОТипе(Неопределён));


// Вернёт: "Неопределён"

💡

Всегда проверяйте переменные на NULL и Неопределён ДО попытки определения их типа. Это предотвратит ошибки выполнения и упростит отладку.

7. Нюансы работы с типами в разных версиях платформы

Хотя большинство методов определения типа универсальны, в разных версиях 1С:Предприятие 8.3 есть особенности, которые стоит учитывать:

  • 🔧 В версиях 8.3.10 и ниже функция ТипЗнч() для управляемых форм могла возвращать неполную информацию о динамических списках.
  • 🔧 Начиная с 8.3.12, появилась поддержка NULL-значений в коллекциях (ранее они автоматически преобразулись в Неопределён).
  • 🔧 В 8.3.18+ добавлены новые типы для работы с географическими данными (например, Тип("ГеографическаяСсылка")).

Если вы работаете с устаревшими конфигурациями (например, на платформе 8.2), учитывайте, что там отсутствуют некоторые современные типы (например, Соответствие или ФиксированнаяСтруктура). В таких случаях может потребоваться эмуляция проверок через строковые сравнения.

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

FAQ: Частые вопросы по определению типа в 1С

Как отличить пустую ссылку на справочник от NULL?

Пустая ссылка (например, Справочники.Номенклатура.ПустаяСсылка()) имеет тип СправочникСсылка.Номенклатура, тогда как NULL возвращает Неопределён при вызове ТипЗнч(). Используйте явную проверку:

Если Значение = Справочники.Номенклатура.ПустаяСсылка() Тогда

// Это пустая ссылка


ИначеЕсли НЕ ЗначениеЗаполнено(Значение) Тогда


// Это NULL


КонецЕсли;

Почему ТипЗнч() возвращает ошибочный тип для результатов запроса?

Поля в результатах запроса всегда возвращаются как базовые типы (Число, Строка, Дата). Чтобы получить оригинальный тип (например, ссылку на справочник), используйте конструкцию ВЫБРАТЬ РАЗРЕШЕННЫЕ ... или анализируйте метаданные полей таблицы.

Как проверить тип элемента в массиве, если он может быть любым?

Используйте рекурсивную функцию с проверкой базовых типов и коллекций. Пример:

Функция ОпределитьТипЭлемента(Элемент)

Если Элемент = Неопределён Тогда


Возврат "Неопределён";


ИначеЕсли НЕ ЗначениеЗаполнено(Элемент) Тогда


Возврат "NULL";


Иначе


Тип = ТипЗнч(Элемент);


Если Тип = Тип("Массив") Тогда


Возврат "Массив";


ИначеЕсли Тип = Тип("Структура") Тогда


Возврат "Структура";


Иначе


Возврат ТипЗнчСтр(Элемент);


КонецЕсли;


КонецЕсли;


КонецФункции

Можно ли получить тип поля формы динамически?

Да, через свойство ТипЗначения элемента формы. Например:

ТипПоля = ЭлементыФормы.МоёПоле.ТипЗначения;

Сообщить(ТипЗнчСтр(ТипПоля));

Для динамических списков используйте Колонки[ИмяКолонки].ТипЗначения.

Как узнать, является ли переменная объектом XDTO?

Проверьте принадлежность к типу XDTOОбъект:

Если ТипЗнч(Переменная) = Тип("XDTOОбъект") Тогда

Сообщить("Это XDTO-объект: " + Переменная.Тип().Имя);


КонецЕсли;