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

Другое · 8 мин

Определяемый тип в 1С: практическое руководство

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

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

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

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

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

Что представляет собой определяемый тип

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

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

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

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

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

Где в 1С применяются определяемые типы

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

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

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

Порядок работы с определяемым типом
  1. 1
    Уточните, поддерживает ли целевой объект изменяемый состав типов
  2. 2
    Опишите допустимые варианты в соответствии с правилами платформы
  3. 3
    Проверьте значение перед присваиванием или передачей в процедуру
  4. 4
    Убедитесь, что код обрабатывает каждый возможный вариант из состава

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

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

Как описывается состав типов

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

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

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

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

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

Отличие от обычного типа и типа значения

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

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

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

Типичные ошибки
01
Предполагать, что значение всегда имеет один и тот же тип из состава, что ведет к ошибкам при выполнении
02
Указывать в составе типы, которые недоступны в текущей конфигурации или не поддерживаются объектом

Проверка совместимости и работа со значениями

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

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

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

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

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

Соответствие значения хотя бы одному типу из состава
Норма

Значение принимается без ошибки

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

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

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

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

Ограничения и риски

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

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

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

Итог

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

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

Можно ли использовать определяемый тип в любой колонке табличной части?

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

Чем отличается определяемый тип от обычного?

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

Что делать, если возникает ошибка несоответствия типа?

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

Нужно ли проверять значение перед присваиванием?

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

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

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