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

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

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

1. Базовый метод: функция ТипЗнч()

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

Пример кода для проверки ссылки на документ:

Если ТипЗнч(Объект) = Тип("ДокументСсылка.ПоступлениеТоваровУслуг") Тогда
Сообщить("Это документ 'Поступление товаров и услуг'!");
КонецЕсли;

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

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

• ✅ Работает во всех версиях платформы (8.2, 8.3, 9.0)
• ✅ Не требует прав на изменение конфигурации
• ⚠️ Не подходит для динамических коллекций (массивов, списков значений)
• ⚠️ Требует точного указания вида документа

2. Проверка через Метаданные (для программистов)

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

Пример кода:

Метод ПроверитьЧтоЭтоДокумент(Объект)
Возврат Метаданные().Типы.Найти(ТипЗнч(Объект).ИмяТипа) = Метаданные().Типы.Документ;
КонецМетода;

Этот метод вернет Истина для:

• 📄 Ссылок на документы (ДокументСсылка.ИмяВида)
• 📄 Объектов документов (ДокументОбъект.ИмяВида)
• 📄 Коллекций документов (если передан массив)

3. Визуальная проверка (для пользователей без кода)

Если вы не программист, но нужно быстро определить тип объекта в 1С, воспользуйтесь встроенными инструментами:

1. Откройте объект в форме (двойной клик).
2. Посмотрите на заголовок окна:
   • 📋 Если начинается со слова "Документ" (например, "Документ: Поступление (Товары, Услуги, Оборудование)") — это документ.
   • 📚 Если "Справочник" или "Элемент справочника" — это справочник.
3. В 1С:Предприятие 8.3 можно использовать панель "Все функции" (Ctrl+Shift+F), где отображается полный путь к объекту.

Для управляемых форм (тонкий клиент, веб-клиент) путь к объекту виден в строке состояния при наведении на поле ввода.

📊 Как вы чаще проверяете типы объектов в 1С?
Через код (ТипЗнч, Метаданные)
Визуально (заголовки окон)
Использую отладчик
Другие способы

4. Проверка в запросах (Query)

При работе с языком запросов тип объекта можно определить через функцию ТИПЗНАЧЕНИЯ() или конструкцию ВЫБРАТЬ РАЗРЕШЕННЫЕ. Это актуально для отчетов и обработок, где данные извлекаются напрямую из базы.

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

ВЫБРАТЬ
Ссылка КАК СсылкаНаОбъект
ИЗ
Документ.ПоступлениеТоваровУслуг КАК Поступление
ГДЕ
ТИПЗНАЧЕНИЯ(Ссылка) = ТИП("ДокументСсылка.ПоступлениеТоваровУслуг")

Для динамической проверки в цикле:

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   ТИПЗНАЧЕНИЯ(&Объект) КАК ТипОбъекта";
Запрос.УстановитьПараметр("Объект", ТекущийОбъект);
Результат = Запрос.Выполнить();
Тип = Результат.Получить().ТипОбъекта.Получить(0);

Если Найти(Тип, "Документ") > 0 Тогда
// Это документ
КонецЕсли;

⚠️ Внимание: В запросах ТИПЗНАЧЕНИЯ() работает медленнее, чем прямая фильтрация по виду документа. Для больших баз данных используйте явное указание таблицы (например, Документ.РеализацияТоваровУслуг).

5. Работа с динамическими коллекциями

Если объект приходит в массиве, СпискеЗначений или ТаблицеЗначений, стандартные методы могут не сработать. В этом случае используйте комбинацию ТипЗнч() и проверку на Null.

Пример обработки массива:

Для Каждого Элемент Из МассивОбъектов Цикл
Попытка
Если ТипЗнч(Элемент) = Тип("ДокументСсылка") Тогда
Сообщить("Нашли документ: " + Элемент.Наименование);
КонецЕсли;
Исключение
// Обработка ошибок, если объект неопределен
КонецПопытки;
КонецЦикла;

Для ТаблицыЗначений с колонкой "Ссылка":

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

Тип коллекции	Метод проверки	Пример кода
Массив	ТипЗнч(Элемент) в цикле	Если ТипЗнч(Массив[0]) = Тип("ДокументОбъект")
СписокЗначений	ТипЗнч(Элемент.Значение)	Для каждого Эл Из Список Цикл
ТаблицаЗначений	Проверка колонки .Ссылка	Если ТипЗнч(Строка.Ссылка) = Тип("ДокументСсылка.АктВыполненныхРабот")
ДеревоЗначений	ТипЗнч(Узел.Значение)	Для каждого Узел Из Дерево Цикл

Проверьте, что элемент не Null|Используйте ТипЗнч() для определения типа|Учитывайте разницу между Ссылкой и Объектом|Обрабатывайте исключения (Попытка...Исключение)-->

6. Специфика типовых конфигураций

В типовых конфигурациях (1С:Бухгалтерия 3.0, 1С:УТ 11, 1С:ЗУП 3.1) есть особенности проверки документов:

• 🔹 Бухгалтерия 3.0: Документы часто имеют префикс БухгалтерскийУчет. (например, ДокументСсылка.БухгалтерскийУчет.ПлатежноеПоручение).
• 🔹 Управление Торговлей 11: Документы торговли (ПоступлениеТоваровУслуг, РеализацияТоваровУслуг) проверяются стандартными методами.
• 🔹 Зарплата и Управление Персоналом 3.1: Документы по кадровому учету (например, ПриемНаРаботу) могут требовать проверки через Метаданные().Документы.

Пример для 1С:Бухгалтерия 3.0:

Если ТипЗнч(Объект) = Тип("ДокументСсылка.БухгалтерскийУчет.СчетФактураВыданный") Тогда
// Это счет-фактура выданный
КонецЕсли;

Процедура ОбработатьОбъект(Объект)
Попытка
ТипОбъекта = ТипЗнч(Объект);
Если Найти(ТипОбъекта, "Документ") > 0 Тогда
Если ТипОбъекта = Тип("ДокументОбъект.Любой") Тогда
Сообщить("Это объект документа!");
ИначеЕсли ТипОбъекта = Тип("ДокументСсылка.Любой") Тогда
Сообщить("Это ссылка на документ!");
КонецЕсли;
КонецЕсли;
Исключение
Сообщить("Ошибка: объект не определен или пуст!");
КонецПопытки;
КонецПроцедуры;

Если Найти(ТипЗнч(Объект), "Документ") > 0 Тогда
// Это документ (ссылка или объект)
КонецЕсли;

ВЫБРАТЬ
ВЫРАЗИТЬ(ЕСТЬNULL(ТИПЗНАЧЕНИЯ(Ссылка), "") КАК СТРОКА) КАК ТипОбъекта
ИЗ
&Таблица