К статье
Практический материал

Другое · 7 мин

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

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

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

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

Ниже разобраны основные подходы к сравнению типов документов в 1С, способы их проверки и ситуации, когда одинаковое название не гарантирует одинакового типа.

Что понимать под типом документа в 1С

В терминологии 1С тип документа — это описание объекта конфигурации, которое задает структуру реквизитов, табличных частей, порядок проведения и доступные операции. Документ «Поступление товаров» и документ «Поступление услуг» могут иметь похожие названия, но принадлежать к разным типам и вести себя по-разному в отчетах и регистрах.

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

Где посмотреть тип документа

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

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

Сравнение по имени и по ссылке

Сравнение по имени объекта метаданных

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

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

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

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

Типичные ошибки
01
Сравнение документов только по наименованию без учета типа метаданных
02
Игнорирование различий между конфигурациями при одинаковых именами документов

Сравнение типов в коде 1С

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

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

1c
ТипДок1 = ТипЗнч(СсылкаНаДокумент1);
ТипДок2 = ТипЗнч(СсылкаНаДокумент2);
Если ТипДок1 = ТипДок2 Тогда
    // документы одного типа
КонецЕсли;

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

Когда типы совпадают, а документы разные

Одинаковый тип не означает, что документы идентичны по содержимому. Два приходных ордера одного типа могут иметь разные номера, даты, контрагентов и суммы. Сравнение типа отвечает только на вопрос «относится ли запись к одному классу документов», а не на вопрос «совпадают ли реквизиты».

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

Ограничения и риски самостоятельной работы

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

Контрольные точки

Как проверить результат

Документы одного класса попадают в один отчет
Норма

Отчет заполняется без пропусков

Тревожный признак

Документы одного типа отсутствуют в отчете

Обмен между базами
Норма

Документы передаются без ошибок типа

Тревожный признак

Ошибка несоответствия типа при выгрузке

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

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

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

Итог

Что важно запомнить

Типы документов сравнивают по объекту метаданных или ссылке, а не только по названию; результат проверяют в конкретной базе на копии перед вводом в эксплуатацию.

Часто задаваемые вопросы

Можно ли сравнивать типы документов по их синонимам?

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

Что делать, если документы имеют одинаковые названия, но разные типы?

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

Влияет ли тип документа на проведение?

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

Безопасно ли менять типы документов в существующей базе?

Изменение метаданных документов может нарушить проведенные записи, отчеты и обмен. Любые такие изменения требуют резервного копирования и проверки на тестовой копии базы.