Другое · 6 мин
Как проверить тип документа в 1С 8.3: способы и нюансы
Практические способы определить тип документа в 1С 8.3: через интерфейс, конфигуратор и программный код, отличие от вида документа и признаков проведения, проверка результата.
Тип документа в 1С 8.3 — это имя объекта метаданных из раздела «Документы» конфигурации, например заказ покупателя, реализация или платежное поручение. Он нужен, когда программа должна выбрать форму, печатный шаблон, права доступа или правило обмена в зависимости от того, с каким документом ведется работа.
Проверка требуется как в обычной работе пользователя, так и при настройке обработок, отчетов и обмена данными. Неправильное определение типа может привести к выбору не той формы, ошибке заполнения или попытке применить к документу правило, предназначенное для другого вида движения.
Где посмотреть тип документа в интерфейсе
В рабочем режиме тип чаще всего проще всего увидеть в заголовке открытой формы документа: там отображается имя документа, которое соответствует объекту метаданных. Если форма открыта из списка, строка состояния или заголовок окна показывает, какой документ выбран.
В конфигураторе тип задается явно: откройте дерево конфигурации, раздел «Документы», и найдите нужный объект. Его имя и есть тип документа. У каждого документа есть объектный модуль, модули форм и набор реквизитов, но имя объекта остается основным идентификатором типа.
Если пользователю нужно только убедиться, что открыт нужный документ, достаточно сравнить название в заголовке с перечнем документов в конфигурации. Для программной проверки потребуется уже ссылка на документ или сам документ в коде.
Как определить тип документа в коде 1С
В встроенном языке тип значения ссылки на документ обычно представляется строкой вида «ДокументСсылка.ИмяОбъекта». Можно использовать выражение ТипЗначения(Ссылка) и сравнить его с ожидаемым типом, например с Тип(«ДокументСсылка.ЗаказПокупателя»). Для универсальной проверки удобно убрать префикс «ДокументСсылка.» и получить имя документа.
- 1Получить ссылку на документ или документ в коде
- 2Применить ТипЗначения к ссылке или метод Вид к ссылке
- 3Сравнить результат с нужным типом документа из метаданных
- 4Убедиться, что проверка выполнена перед использованием документа в алгоритме
Ссылка также имеет метод Вид(), который возвращает объект метаданных документа. Его можно сравнить с соответствующим элементом Метаданные.Документы.Имя. Этот подход подходит, когда нужно работать с метаданными напрямую, а не с текстовым представлением типа.
Если проверяется не ссылка, а объект документа, тип будет иметь вид «ДокументОбъект.Имя». При написании общих обработок уточняйте, с каким именно значением вы работаете: ссылкой, объектом или выгрузкой в формат обмена.
Тип документа, вид документа и проведение
Тип документа не совпадает с реквизитом «Вид документа», если такой реквизит есть в конфигурации. Вид может уточнять назначение документа внутри одного типа, например приход или расход, а тип остается именем метаданных. Путаница между ними ведет к ошибкам в отборах и правилах обмена.
Признак проведения тоже не определяет тип. Непроведенный документ остается документом того же типа, просто его движения не созданы. Перед проверкой типа уточняйте, важно ли вам состояние проведения, или достаточно самого типа.
Сравнение вариантов
Подходит для ручной проверки, не подходит для кода
Показывает точный список документов, требует доступа к конфигурации
Подходит для автоматизации, требует корректной работы со ссылками и объектами
Сравнение способов определения типа
Просмотр заголовка формы подходит для разовой проверки пользователем, но не подходит для автоматизации. Конфигуратор дает точный список документов, но требует доступа к настройке и понимания структуры метаданных. Программная проверка подходит для обработок и отчетов, но требует осторожности при работе со ссылками и объектами.
Выбирайте способ по задаче: если нужно показать пользователю, какой документ открыт, достаточно интерфейса; если обработка должна реагировать на тип документа, используйте программную проверку с сравнением результата.
Как проверить результат
Заголовок и код соответствуют имени объекта метаданных
Тип определен неверно или применяется к документам других видов
Срабатывает только для целевого типа
Срабатывает для всех документов или не срабатывает для целевого
Проверка результата и границы самостоятельной работы
После программной проверки убедитесь, что условие срабатывает для нескольких документов разных типов, включая нестандартные ситуации: непроведенные документы, документы с одинаковыми именами в разных подсистемах и выгрузки из других баз. Результат считается корректным, если выбранная логика применяется только к нужному типу.
Самостоятельная настройка допустима для чтения метаданных и составления условий в обработках. Изменение конфигурации, прав доступа или правил обмена лучше выполнять при наличии резервной копии и согласовании с администратором системы. Ошибки в метаданных могут затрагивать многих пользователей сразу.
Типичные ошибки при проверке типа документа
Основная ошибка — сравнивать тип документа со строковым названием из пользовательского интерфейса вместо имени объекта метаданных. Название в списке может отличаться от системного имени, особенно если конфигурация адаптирована под отрасль.
Вторая ошибка — полагаться на признак проведения или движение по регистрам вместо проверки типа. Движения могут отсутствовать у непроведенного документа, но тип остается прежним. Третья ошибка — использовать тип документа для определения документа по номеру или дате без привязки к конкретному объекту метаданных.
Что важно запомнить
Тип документа — имя объекта метаданных раздела «Документы»; проверяйте его через интерфейс, конфигуратор или код, не путая с видом документа и признаком проведения.
Можно ли узнать тип документа без конфигуратора?
Да, в рабочем режиме тип виден в заголовке открытой формы документа и в списке документов. Для точного сравнения в коде все равно нужно знать системное имя объекта метаданных.
В чем разница между типом документа и видом документа?
Тип — это имя документа в конфигурации, например «ЗаказПокупателя». Вид — это дополнительное уточнение внутри типа, если такое предусмотрено конфигурацией, например приход или расход.
Зависит ли тип документа от проведения?
Непроводящий документ остается документом того же типа. Проведение влияет на создание движений, но не меняет имя объекта метаданных.
Безопасно ли менять тип документа самостоятельно?
Самостоятельно можно только проверять тип в коде или обработках. Изменение объектов конфигурации, прав и правил обмена требует тестирования на копии базы и согласования с администратором.