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

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

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

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

Концепция и назначение в архитектуре 1С

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

Например, если у вас есть документ «Реализация», в котором нужно выбрать товар, вы можете указать тип значения реквизита «Номенклатура» не как конкретный справочник, а как определяемый тип «Товары». В этот тип вы включите справочник «Номенклатура», а позже, если бизнес-процессы потребуют учитывать еще и услуги в отдельном справочнике, вы просто добавите его в состав определяемого типа.

⚠️ Внимание: Определяемый тип существует только в метаданных конфигурации. В физической базе данных (SQL) таблицы для него не создаются, поэтому напрямую хранить значения такого типа в регистрах сведений без конкретизации нельзя.

Использование таких конструкций критически важно для создания универсальных механизмов. Представьте, что вы пишете общую процедуру печати печатных форм. Она должна принимать на вход любой документ продажи. Если вы передадите в параметр конкретный тип «Документ.РеализацияТоваровУслуг», то функция не сработает для «Документ.ЗаказКлиента». Определяемый тип «ДокументыПродажи» решает эту проблему, объединяя оба документа в единый интерфейс взаимодействия.

Создание и настройка в конфигураторе

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

В поле «Имя» следует использовать понятный префикс, например, ОпрТип.НоменклатураИУслуги, чтобы сразу отличать его от стандартных типов платформы. Основное внимание уделяется вкладке «Типы», где формируется список допустимых значений. Именно здесь вы выбираете конкретные справочники, документы, планы счетов или перечисления, которые войдут в группу.

При настройке состава важно учитывать логическую связь объектов. Не стоит смешивать в одном типе справочники и документы, если они не участвуют в едином бизнес-процессе выбора значения. Также доступно ограничение количества значений: можно разрешить выбор только одного элемента или множественный выбор, что часто требуется для полей типа «Список значений».

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

Использование в свойствах реквизитов и параметров

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

Аналогичный подход применяется при описании параметров процедур и функций в модулях. Вместо громоздкой конструкции СправочникСсылка.Номенклатура, СправочникСсылка.Услуги вы указываете имя вашего типа. Компилятор 1С автоматически подставит нужный набор типов при проверке синтаксиса.

Рассмотрим пример объявления параметра в общей модуле:

Процедура ОбработатьВыбор(Знач Выборка, ТипОбъекта)

Здесь параметр ТипОбъекта может быть объявлен как определяемый тип, объединяющий несколько видов номенклатуры. Это позволяет писать универсальный код, который работает с разными объектами, не используя сложные условия «Если-Тогда» для проверки типа каждого элемента.

Особенности индексации

При использовании определяемых типов в условиях запроса (ВЫБРАТЬ.. ГДЕ Реквизит В (&Параметр)), платформа 1С корректно использует индексы только если в параметре передан конкретный тип или список конкретных типов. Передача самого определяемого типа как строкового имени в запросе требует особой обработки.

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

Программная работа и анализ типов

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

Пример кода для проверки принадлежности:

Если ТипЗнч(Объект) = Тип("СправочникСсылка.Номенклатура") Тогда
// Логика обработки
КонецЕсли;

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

Поэтому при сериализации данных или передаче через HTTP-сервисы вы будете работать с конкретными типами, а не с абстрактным именем.

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

• 📂 Получить объект метаданных по имени.
• 📂 Обратиться к свойству «Типы» этого объекта метаданных.
• 📂 Сформировать массив допустимых значений для дальнейшей логики.

Сравнение со стандартными типами данных

Понимание различий между стандартными типами платформы и определяемыми типами критично для правильного проектирования. Стандартные типы, такие как Число, Строка или Дата, являются примитивами, встроенными в ядро системы. Определяемые типы — это надстройка уровня конфигурации.

Ниже приведена таблица, иллюстрирующая ключевые отличия:

Характеристика	Стандартный тип	Определяемый тип
Уровень существования	Ядро платформы	Метаданные конфигурации
Хранение в БД	Прямое (колонки таблиц)	Отсутствует (виртуальный)
Изменяемость	Неизменяем	Редактируемый разработчиком
Использование в запросах	Напрямую	Через раскрытие в конкретные типы

Использование стандартных типов обязательно для базовых реквизитов, таких как даты документов или суммы. Определяемые же типы служат для группировки сложных объектов предметной области. Смешивать их нужно аккуратно: нельзя сделать определяемый тип, содержащий внутри себя другой определяемый тип (рекурсия запрещена).

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

Типичные ошибки и лучшие практики

Одной из распространенных ошибок является создание излишне широких определяемых типов. Разработчики иногда пытаются включить в один тип вообще все справочники системы, чтобы «не думать о типах». Это приводит к тому, что в полях выбора пользователь видит сотни ненужных элементов, что ухудшает UX.

Второй ошибкой считается игнорирование обновления состава типов. Если вы добавили новый справочник «Арендованное оборудование», но забыли включить его в определяемый тип «ОсновныеСредства», то отчеты и обработки, работающие с этим типом, не увидят новые данные. Это создает логические дыры в учете.

⚠️ Внимание: При удалении объекта метаданных (например, справочника), который входит в состав определяемого типа, система автоматически удалит его из списка. Однако, если этот тип использовался в хранилищах значений или сложных алгоритмах, возможна потеря логики работы. Всегда проверяйте зависимости перед удалением.

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

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

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

Нет, в языке запросов 1С нельзя указать имя определяемого типа в условии ВЫБРАТЬ.. ГДЕ ТипСсылки В (&Параметр). Необходимо программно раскрыть этот тип в список конкретных типов или ссылок и передать их в параметр запроса.

Влияет ли количество типов в определяемом типе на скорость работы?

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

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

Запись не удастся. Регистры требуют конкретных типов данных для своих измерений и ресурсов. Попытка записать абстрактный тип вызовет ошибку выполнения «Неверный тип значения».

Можно ли экспортировать определяемый тип в другую конфигурацию?

Да, при выгрузке и загрузке объектов метаданных (файлы.xml) определяемые типы переносятся вместе со своими настройками. Однако, если в принимающей конфигурации отсутствуют справочники, входящие в этот тип, они будут проигнорированы или вызовут ошибку при обновлении.