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

Другое · 7 мин

Проверка документа в 1С: как убедиться, что объект — документ

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

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

Проверка «это документ?» нужна в обработках, отчётах, внешних компонентах и при интеграции. От неправильного определения типа зависят корректность проведения, заполнение движений и целостность данных.

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

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

Порядок проверки объекта
  1. 1
    Убедиться, что значение заполнено с помощью ЗначениеЗаполнено
  2. 2
    Получить тип значения через ТипЗначения
  3. 3
    Сравнить тип с типом ссылки на нужный документ
  4. 4
    При совпадении работать с объектом как с документом

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

Как проверить тип объекта в коде

Наиболее распространённый способ — использовать функцию ТипЗначения и сравнить результат с типом ссылки на нужный документ. Если тип совпадает, перед кодом действительно документ данного вида. Для общей проверки «любой документ» можно сравнивать с типом «ДокументСсылка» или анализировать строку вида «ДокументСсылка.».

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

Сравнение вариантов

Документ

Подходит для отражения операций и формирования движений; требует проверки статуса проведения.

Справочник

Подходит для хранения справочных данных; не проводится и не создаёт движений.

Регистр

Хранит накопленные или справочные данные; не является документом и не подлежит проведению.

Проверка через ссылку и неопределённость

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

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

Типичные ошибки
01
Сравнение типа по текстовому имени документа без учёта переименования
02
Попытка провести документ без проверки заполнения ссылки и права на запись

Отличие документа от справочника и других объектов

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

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

Маршрут решения

Как выбрать действие

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

Типичные ошибки при проверке

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

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

Когда проверка обязательна, а когда избыточна

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

Проверка типа полезнее всего в универсальных обработках, где один алгоритм обрабатывает разные объекты метаданных.
ПЗ
Практическое замечание

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

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

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

Тип значения после вызова ТипЗначения
Норма

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

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

Не совпадает или значение не заполнено

Доступ к реквизиту документа
Норма

Ошибок нет, реквизит читается

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

Ошибка доступа или объект не является документом

Предупреждение о рисках

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

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

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

Итог

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

Проверяйте заполнение ссылки, уточняйте тип через ТипЗначения и не смешивайте документы со справочниками и регистрами.

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

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

Можно, но это не надёжно: при переименовании документа в конфигурации код перестанет работать. Лучше использовать типы метаданных или сравнение с типом ссылки.

Что делать, если ссылка пустая?

Пустая ссылка не является документом. Сначала проверьте значение на заполненность, и только потом уточняйте тип объекта.

Нужна ли проверка для объектов из формы документа?

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

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

Документ отражает операцию и при проведении создаёт движения в регистрах, а справочник хранит справочные данные и не проводится. Проверка типа помогает не подать на вход справочник там, где ожидается документ.

Может ли проверка типа гарантировать возможность записи?

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