Как добавить объект и реквизиты в расширение 1С

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

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

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

Архитектура объектов в расширениях конфигурации

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

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

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

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

Добавление новых реквизитов к существующим объектам

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

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

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

Создание новых объектов метаданных с нуля

Если ваша задача требует создания принципиально нового объекта, например, специального журнала или регистра сведений, процесс начинается с добавления объекта в ветку метаданных расширения. Вы выбираете тип объекта (Справочник, Документ, Регистр) и задаете его имя. Ключевое требование здесь — соблюдение именования: имя не должно пересекаться с именами объектов основной конфигурации и других подключенных расширений.

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

Тип объекта	Основное назначение	Особенность в расширении
Справочник	Хранение условно-постоянной информации	Может использоваться как тип данных для реквизитов основных объектов
Документ	Регистрация хозяйственных операций	Требует осторожности при проведении, чтобы не нарушить логику основной конфигурации
Регистр сведений	Хранение накопленных данных	Часто используется для хранения настроек расширения или кэширования
План видов характеристик	Описание дополнительных свойств	Идеален для реализации гибкой системы дополнительных реквизитов

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

Работа с табличными частями и составными типами

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

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

⚠️ Внимание: Изменение состава табличной части (добавление или удаление колонок) в расширении требует перестроения таблиц базы данных. На больших объемах данных эта операция может быть долгой и вызвать временную недоступность системы.

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

Настройка форм и интерфейса для новых реквизитов

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

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

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

Программная обработка и события новых объектов

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

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

Особенность событий проведения документов

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

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

Типичные ошибки и ограничения платформы

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

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

⚠️ Внимание: Интерфейс и функциональность платформы 1С постоянно обновляются. Детали работы с конкретными версиями релизов могут отличаться. Всегда сверяйтесь с официальным руководством разработчика для вашей версии платформы перед внедрением сложных архитектурных решений.

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

Можно ли изменить тип данных существующего реквизита через расширение?

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

Как удалить реквизит, добавленный через расширение?

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

Влияют ли расширения на скорость обновления типовой конфигурации?

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

Можно ли создать новый вид субконто в расширении?

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