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