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

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

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

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

Назначение и преимущества механизма общих реквизитов

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

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

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

Пошаговая инструкция: создание общего реквизита в конфигураторе

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

В открывшемся окне свойств задайте имя реквизита. Рекомендуется использовать префикс, указывающий на принадлежность к общему хранилищу, например Общ_СтатусОплаты или UR_КомментарийМенеджера. Это упростит навигацию в коде и позволит сразу отличить стандартные поля от пользовательских расширений. Далее необходимо определить тип значения.

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

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

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

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

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

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

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

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

Работа с общими реквизитами в коде и запросах

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

ДокументОбъект.Общ_ДатаСогласования = ТекущаяДата();
ДокументОбъект.Записать();

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

Если вы используете конструктор запросов, убедитесь, что галочка "Общие реквизиты" активна. В тексте запроса это отразится как обращение к таблице с суффиксом КАК ОбщийРеквизит или через явное указание поля в списке выбора. Игнорирование этого момента приведет к ошибке "Поле не найдено".

Особенности хранения данных и производительность

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

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

Параметр	Обычный реквизит	Общий реквизит
Место хранения	Таблица объекта	Системная таблица общих сведений
Скорость чтения	Высокая (прямой доступ)	Средняя (требуется JOIN)
Гибкость добавления	Требует изменения структуры	Без изменения структуры объекта
Влияние на обновление	Может потребовать конвертации	Минимальное влияние

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

Технические детали таблицы хранения

Данные общих реквизитов хранятся в таблице _IBRg (для конфигураций на базе стандартных библиотек) или в специализированных таблицах типа _ExtRg. Структура таблицы включает ссылку на объект (вид, тип, ID) и набор полей для значений разных типов.

Ограничения и типичные ошибки разработчиков

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

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

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

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

Часто задаваемые вопросы (FAQ)

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

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

Влияет ли использование общих реквизитов на скорость проведения документов?

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

Как перенести данные из обычного реквизита в общий?

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

Доступны ли общие реквизиты в внешних источниках данных (ODBC, COM)?

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

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

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