Общие реквизиты в 1С: полное руководство по настройке

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

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

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

Сущность и архитектурное значение общих реквизитов

Общий реквизит представляет собой поле данных, которое автоматически добавляется ко всем объектам метаданных, входящим в заданный набор. В отличие от обычных реквизитов, которые описываются внутри конкретного объекта (например, внутри справочника «Номенклатура»), общие реквизиты объявляются в отдельном списке метаданных.

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

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

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

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

Типы адресации и наборы объектов

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

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

• 📂 Ко всем справочникам: идеально подходит для добавления служебной информации, такой как код интегрированной системы, статус синхронизации или внешний идентификатор.
• 📄 Ко всем документам: используется для сквозных полей, например, номера внешней заявки, имени пользователя-создателя или флага проведения сложной проверки.
• 📊 Ко всем планам счетов: необходимо при расширении аналитического учета, когда требуется добавить дополнительное измерение для всех счетов бухгалтерского учета.
• 🔄 Ко всем планам видов характеристик: позволяет унифицировать дополнительные свойства для различных видов номенклатуры или контрагентов.

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

Настройка свойств и типов данных

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

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

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

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

Параметр настройки	Описание влияния	Рекомендация
Длина строки	Определяет размер колонки в СУБД	Устанавливать с запасом, но без фанатизма
Индексирование	Ускоряет поиск по полю	Включать только для часто используемых в отчетах полей
Тег XML	Влияет на обмен данными	Заполнять для обеспечения совместимости с внешними системами
Комментарий	Описание для разработчиков	Всегда заполнять для документирования назначения поля

Программный доступ и работа с данными

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

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

СправочникОбъект = Справочники.Номенклатура.СоздатьЭлемент();
КодИзВнешнейСистемы = СправочникОбъект.ВнешнийКод;
СправочникОбъект.ВнешнийКод = "ART-12345";
СправочникОбъект.Записать();

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

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

Особенности работы в расширенном режиме

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

Сценарии использования в реальных задачах

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

Первый и самый распространенный сценарий — интеграция с внешними системами. При настройке обмена с сайтом, CRM или маркетплейсом необходимо хранить уникальный идентификатор объекта во внешней системе. Вместо добавления реквизита «ID_Сайта» в каждый справочник (Номенклатура, Контрагенты, Склады), создается один общий реквизит, который покрывает все необходимые объекты.

Второй сценарий — аудит и безопасность. Для контроля действий пользователей часто требуется фиксировать, кто именно создал или изменил запись. Общий реквизит «АвторСоздания» или «ДатаМодификации» позволяет реализовать эту логику централизованно, не загромождая структуру каждого отдельного документа.

• 🏷️ Маркировка товаров: Добавление поля для хранения кода маркировки «Честный ЗНАК» ко всем товарным справочникам и документам движения товаров.
• ✈️ Командировочные расходы: Включение поля «Город назначения» во все документы, связанные с подотчетными лицами, для упрощения формирования авансовых отчетов.
• 🔒 Блокировка изменений: Булевский флаг «ЗапретРедактирования», позволяющий гибко управлять правами на изменение конкретных записей без настройки сложных прав доступа RLS.

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

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

Ограничения и технические нюансы

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

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

Также стоит учитывать влияние на производительность запросов. Если общий реквизит не индексируется, а используется в условиях отбора (ГДЕ) в больших выборках, это может приводить к полному сканированию таблиц (Table Scan). Для полей, по которым планируется частый поиск, рекомендуется явно включать индексирование в свойствах реквизита.

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

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

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

Влияют ли общие реквизиты на скорость обновления конфигурации?

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

Как удалить общий реквизит без потери данных в других полях?

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

Доступны ли общие реквизиты в СКД (Система Компоновки Данных)?

Безусловно. Общие реквизиты отображаются в настройках набора данных СКД наравне с обычными реквизитами. Их можно использовать в полях группировки, отборах и вычисляемых полях отчетов без каких-либо дополнительных настроек.