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

Другое · 8 мин

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

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

Определяемые типы в 1С — это описания данных, которые создаёт разработчик для работы с реквизитами, параметрами, табличными частями, результатами функций и другими элементами конфигурации. В отличие от встроенных языковых типов, таких как число, строка, дата или булево, они задаются логикой прикладного решения и отражают структуру конкретной информационной базы. Использование таких типов позволяет платформе и встроенному языку контролировать совместимость значений ещё на этапе написания кода и компиляции конфигурации.

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

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

Чем определяемые типы отличаются от встроенных

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

Например, поле «Контрагент» в документе может иметь тип «СправочникСсылка.Контрагенты», а не общий тип «Ссылка». Это сужает круг допустимых значений только до элементов одного справочника и позволяет платформе предлагать подходящие варианты при вводе. Если бы использовался слишком общий тип, возникла бы возможность присвоить полю ссылку на документ или другой справочник, что не соответствует бизнес-логике.

Где определяемые типы используются в конфигурации

Реквизиты и табличные части объектов

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

Параметры процедур и функции

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

Запросы, отчеты и обработки

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

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

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

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

Запись сохраняется без ошибок

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

Система отклоняет корректное значение или не показывает его в форме

Присвоение значения неверного типа
Норма

Платформа выдает ошибку или не позволяет сохранить

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

Несоответствие проходит незаметно и приводит к искажению данных

Отчеты и обработки с измененным реквизитом
Норма

Данные отображаются и обрабатываются корректно

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

Пустые результаты, ошибки выполнения или некорректные расчеты

Как создать и проверить определяемый тип

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

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

Ограничения и риски при работе с типами

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

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

Типичные ошибки
01
Слишком широкий тип реквизита допускает запись неподходящих объектов и затрудняет поиск ошибок.
02
Изменение типа без проверки зависимостей ломает отчеты, обработки и обмен данными.

Частые ошибки при определении типов

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

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

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

Конкретный определяемый тип

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

Общий тип с проверкой в коде

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

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

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

Альтернативы и выбор подхода

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

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

Итог

Итог

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

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

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

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

Можно ли изменить тип реквизита в уже работающей базе?

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

Что делать, если после смены типа отчет перестал показывать данные?

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

В чем разница между определяемым типом и перечислением?

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