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

Другое · 7 мин

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

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

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

Когда разработчик объявляет переменную типа Справочник.Номенклатура или параметр типа Документ.ЗаказПокупателя, он использует определяемый тип. Это связывает прикладной код с конкретной структурой конфигурации и позволяет платформе проверять совместимость значений ещё на этапе синтаксической проверки.

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

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

Что такое определяемый тип в конфигурации 1С

Определяемый тип формируется разработчиком при создании или изменении объекта метаданных. Например, справочник «Номенклатура» порождает тип Справочник.Номенклатура, документ «ЗаказПокупателя» — тип Документ.ЗаказПокупателя, перечисление «ВидыНоменклатуры» — тип Перечисление.ВидыНоменклатуры.

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

Где определяемые типы используются в коде

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

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

Функции и возвращаемые значения

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

Табличные части и наборы записей

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

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

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

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

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

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

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

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

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

Альтернативы определяемым типам

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

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

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

Определяемый тип

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

Общий тип или идентификатор

Удобен при изменяющейся структуре и интеграции, но требует ручной проверки соответствия данных

Как выбрать и проверить тип перед изменением конфигурации

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

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

Итог

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

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

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

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

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

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

Как проверить, что значение соответствует определяемому типу?

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

Может ли определяемый тип содержать бизнес-логику?

Нет. Тип только задаёт допустимый круг ссылок или объектов. Бизнес-логика реализуется отдельно в модулях объектов, форм и общих модулях.

Когда стоит заменить определяемый тип на общий тип?

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