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