Добавление реквизита в расширение 1С: полное руководство с примерами

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

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

Что такое расширение конфигурации и зачем добавлять реквизиты через него

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

• 🔄 Совместимость с обновлениями: при выпуске новой версии типовой конфигурации ваши доработки не будут затёрты, так как хранятся отдельно.
• 🛠️ Изоляция изменений: ошибки в расширении не повлияют на стабильность основной конфигурации.
• 🔒 Контроль версий: расширения можно выгружать, сравнивать и объединять с помощью стандартных инструментов 1С.
• 📊 Гибкость: можно добавлять не только реквизиты, но и новые формы, отчёты, обработки и даже изменять алгоритмы существующих процедур.

Добавление реквизита через расширение актуально в случаях, когда:

• 📝 Нужно хранить дополнительную информацию о справочниках, документах или регистрах (например, комментарий к заказу или флаг "Проверено").
• 🔄 Требуется временная доработка, которую потом можно будет легко отключить.
• 🤝 Необходимо интегрировать конфигурацию с внешними системами, добавив поля для синхронизации (например, ID_в_CRM).

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

Подготовка к добавлению реквизита: проверка совместимости и прав

Прежде чем приступить к созданию реквизита, необходимо убедиться, что:

1. Ваша версия платформы 1С:Предприятие поддерживает расширения (минимальная версия — 8.3.6).
2. У вас есть права на изменение конфигурации (режим Конфигуратор с полными правами).
3. Типовая конфигурация не блокирует модификации через расширения (некоторые отраслевые решения могут накладывать ограничения).

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

1. Откройте конфигуратор и перейдите в ветку Объекты конфигурации → [ВашОбъект] → Реквизиты.
2. Проверьте список реквизитов в основном объекте и во всех подключённых расширениях (вкладка Расширения).

Проверена версия платформы (8.3.6+)

Есть права на изменение конфигурации

Нет дублирующих реквизитов в основной конфигурации

Нет конфликтов с другими расширениями

Создана резервная копия базы данных-->

Важно! Если вы работаете с облачной версией 1С (например, 1С:Fresh), возможности по модификации конфигурации через расширения могут быть ограничены. Уточните это у вашего провайдера или в документации к тарифу.

⚠️ Внимание: Реквизиты, добавленные через расширение, не отображаются в Консоли запросов как стандартные поля таблиц. Для работы с ними нужно использовать специальные функции или псевдонимы.

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

Рассмотрим процесс на примере добавления реквизита ДатаПроверки (тип Дата) к справочнику Номенклатура. Этот реквизит будет хранить дату последней проверки товара на складе.

Шаг 1. Создание или открытие расширения

Если расширение ещё не создано:

1. В конфигураторе выберите Файл → Открыть и укажите путь к вашей базе.
2. Перейдите в Объекты конфигурации → Расширения.
3. Нажмите Добавить и укажите имя (например, ДоработкиСклада).
4. Сохраните конфигурацию (Ctrl+S).

Если расширение уже существует, просто откройте его двойным кликом.

Шаг 2. Добавление реквизита

В окне расширения:

1. Раскройте ветку Объекты → Справочники → Номенклатура.
2. Щёлкните правой кнопкой по Реквизиты и выберите Добавить.
3. Заполните свойства реквизита:
   • Имя: ДатаПроверки
   • Тип: Дата
   • Синоним: "Дата последней проверки"
   • Длина: оставьте по умолчанию (для типа Дата не требуется).

Шаг 3. Настройка формы

Чтобы реквизит отображался в форме справочника:

1. В дереве расширения найдите Формы → ФормаЭлемента → Номенклатура.
2. Щёлкните правой кнопкой и выберите Редактировать.
3. В дизайнере формы добавьте новое поле (например, ПолеДатаПроверки) и свяжите его с реквизитом ДатаПроверки.
4. Настройте расположение и внешний вид поля (например, добавьте подсказку "Укажите дату проверки товара").
💡

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

Шаг 4. Обновление конфигурации базы данных

После добавления реквизита необходимо обновить структуру базы данных:

1. В конфигураторе выберите Администрирование → Обновление конфигурации базы данных.
2. Нажмите Продолжить и дождитесь завершения процесса.
3. Перезапустите 1С:Предприятие в пользовательском режиме и проверьте отображение нового реквизита.

⚠️ Внимание: Если при обновлении конфигурации возникла ошибка типа "Не найден объект метаданных", проверьте, правильно ли указано имя расширения и объекта, к которому добавляется реквизит. Частая ошибка — опечатка в имени справочника или документа.

Работа с реквизитом в коде: примеры и нюансы

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

Чтение и запись значения

Пример кода для работы с реквизитом ДатаПроверки в модуле объекта Номенклатура:

Процедура ПриЗаписи(Отказ)
// Установим текущую дату при создании нового элемента
Если ЭтотОбъект.ЭтоНовый() Тогда
ЭтотОбъект.ДатаПроверки = ТекущаяДата();
КонецЕсли;
КонецПроцедуры

Функция ПолучитьДатаПроверки()
Возврат ЭтотОбъект.ДатаПроверки;
КонецФункции

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

Процедура ПриЗаписи(Отказ)
// Вызов стандартной процедуры
Результат = РеквизитРасширения.Оригинал.ПриЗаписи(Отказ);
Если Не Отказ Тогда
// Ваш код
Если ЭтотОбъект.ДатаПроверки = '00010101' Тогда
ЭтотОбъект.ДатаПроверки = ТекущаяДата();
КонецЕсли;
КонецЕсли;
КонецПроцедуры

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

В Консоли запросов или программно реквизиты расширений доступны через псевдонимы. Пример запроса:

ВЫБРАТЬ
Номенклатура.Ссылка КАК Ссылка,
Номенклатура.Наименование КАК Наименование,
Номенклатура.ДатаПроверки КАК ДатаПроверки // Псевдоним автоматически создаётся по имени реквизита
ИЗ
Справочник.Номенклатура КАК Номенклатура

Если псевдоним не формируется автоматически (например, в сложных запросах), используйте функцию РеквизитРасширения():

ВЫБРАТЬ
Номенклатура.Ссылка КАК Ссылка,
РеквизитРасширения("ДоработкиСклада.ДатаПроверки", Номенклатура.Ссылка) КАК ДатаПроверки
ИЗ
Справочник.Номенклатура КАК Номенклатура

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

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

• 🐢 Массовое обновление значений через запрос (используйте Для Изменения в цикле).
• 🔍 Поиск по реквизиту расширения в отчётах (может требовать дополнительных индексов).
• 📤 Экспорт/импорт данных через Универсальный обмен (нужно настраивать правила обмена отдельно).

Настройка прав доступа к реквизиту расширения

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

Шаг 1. Открытие ролей в расширении

В дереве расширения найдите ветку Роли. Если её нет, создайте новую роль:

1. Щёлкните правой кнопкой по Расширения → [ВашеРасширение] → Роли.
2. Выберите Добавить и укажите имя (например, ПросмотрДатПроверки).

Шаг 2. Настройка прав

В открывшейся форме роли:

1. Перейдите на вкладку Права.
2. Найдите объект Справочник.Номенклатура и раскройте его свойства.
3. В разделе Реквизиты найдите ДатаПроверки и установите нужные флажки:
   • Чтение — разрешить просмотр.
   • Модификация — разрешить изменение.

Шаг 3. Назначение роли пользователям

Чтобы применить роль:

1. В пользовательском режиме откройте Администрирование → Пользователи.
2. Выберите пользователя и нажмите Изменить.
3. На вкладке Прочие добавьте созданную роль в список Дополнительные роли.

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

⚠️ Внимание: Если реквизит расширения используется в отчётах или обработках, убедитесь, что у пользователей есть права на чтение не только самого реквизита, но и на объект, к которому он относится (например, справочник Номенклатура).

Типичные ошибки и их решение

При работе с реквизитами расширений разработчики часто сталкиваются с следующими проблемами:

1. Реквизит не отображается в форме

Причины и решения:

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

2. Ошибка "Не найден объект метаданных"

Причины:

• 🔹 Опечатка в имени расширения или реквизита.
• 🔹 Расширение не подключено к базе (проверьте в Администрирование → Подключаемые расширения).
• 🔹 Версия конфигурации не совместима с расширением (обновите платформу).

3. Запрос не видит реквизит расширения

Решения:

• 🔹 Используйте функцию РеквизитРасширения() вместо прямого обращения.
• 🔹 Проверьте, что запрос выполняется в контексте, где расширение активно (например, не в внешней обработке без подключения к базе).

4. Медленная работа с реквизитом

Оптимизация:

• 🔹 Добавьте индекс на реквизит (свойство Индексировать = Истина).
• 🔹 Избегайте массовых операций в транзакциях — разбивайте на пакеты по 100-200 записей.
• 🔹 Для отчётов используйте временные таблицы с предварительной выборкой данных.

1. Версию платформы (должна быть не ниже 8.3.6).

2. Подключено ли расширение к базе (вкладка "Администрирование").

3. Обновлена ли конфигурация после изменений.-->

Проверка работоспособности и отладка

После добавления реквизита необходимо протестировать его работу в разных сценариях:

1. Тестирование в пользовательском режиме

Проверьте:

• 📝 Отображение реквизита в форме (виден ли он, корректно ли работает ввод).
• 💾 Сохранение значения (не сбрасывается ли оно после записи).
• 🔍 Поиск и фильтрация по реквизиту в списках.
• 📊 Корректное отображение в отчётах и обработках.

2. Отладка в конфигураторе

Используйте следующие инструменты:

• 🐞 Отладчик: Установите точку останова в модуле объекта и проверьте, как заполняется реквизит.
• 📜 Журнал регистрации: Включите запись событий для отслеживания ошибок (Администрирование → Журнал регистрации).
• 🔎 Консоль запросов: Проверьте, возвращает ли запрос ожидаемые значения.

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

Процедура ТестДатаПроверки()
Элемент = Справочники.Номенклатура.НайтиПоНаименованию("Товар 1");
Если Элемент.Пустая() Тогда
Сообщить("Элемент не найден!");
Возврат;
КонецЕсли;

// Проверяем значение реквизита
Дата = Элемент.ДатаПроверки;
Если Дата = '00010101' Тогда
Сообщить("Дата проверки не установлена!");
Иначе
Сообщить("Дата проверки: " + Формат(Дата, "ДФ=dd.MM.yyyy"));
КонецЕсли;
КонецПроцедуры

3. Проверка производительности

Если реквизит используется в массовых операциях, оцените его влияние на скорость:

• 📈 Замерьте время выполнения запросов с использованием реквизита (инструмент Измеритель производительности в конфигураторе).
• 🗃️ Проверьте размер таблиц хранения расширений (в SQL Server или PostgreSQL посмотрите таблицы с префиксом _Ext*).
Как включить журнал регистрации для отладки?

1. В пользовательском режиме перейдите в Администрирование → Журнал регистрации.

2. Нажмите Настройка и установите флажки для событий:

- "Ошибки"

- "Предупреждения"

- "Информация" (опционально)

3. Укажите путь для сохранения лога (например, C:\Logs\1C\).

4. Включите запись и воспроизведите ошибку. Логи будут сохранены в указанной папке.

FAQ: Частые вопросы по работе с реквизитами в расширениях

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

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

Пример:

ВЫБРАТЬ
Регистр.Период КАК Период,
Регистр.Регистратор КАК Регистратор,
РеквизитРасширения("Доработки.Комментарий", Регистр.Регистратор) КАК Комментарий
ИЗ
РегистрНакопления.ОстаткиТоваров КАК Регистр

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

   Для Каждого Элемент Из Справочник.Номенклатура Цикл
   Элемент.НовыйРеквизит = Элемент.ДатаПроверки; // Старый реквизит из расширения
   Элемент.Записать();
   КонецЦикла;

3. Удалите реквизит из расширения и обновите конфигурацию.

Важно! Перед массовым обновлением сделайте резервную копию базы.

Для Каждого Строка Из Документ.Товары Цикл
Серия = Строка.СерийныйНомер; // Реквизит расширения
КонецЦикла;

Контрагент = Документ.ОтветственныйКонтрагент; // Реквизит расширения
Если Не Контрагент.Пустая() Тогда
Сообщить("Выбран контрагент: " + Контрагент.Наименование);
КонецЕсли;