Как добавить реквизит в обработку 1С

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

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

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

Определите, где находится обработка

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

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

Добавьте реквизит в дерево объекта

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

Минимально нужно заполнить два свойства. «Имя» — идентификатор без пробелов и спецсимволов, по нему вы будете обращаться к реквизиту из кода, например ПериодОтчета или Организация. «Тип» — тип данных реквизита: примитивный (Строка, Число, Дата, Булево), ссылочный (СправочникСсылка.Номенклатура, ДокументСсылка.РеализацияТоваровУслуг) или составной. Для строки имеет смысл сразу задать длину в квалификаторе типа, иначе будет использоваться неограниченная строка, что не всегда удобно.

После заполнения свойств сохраните объект: Ctrl+S для внешней обработки или обновление конфигурации базы данных (F7) для встроенной. До сохранения реквизит существует только в памяти редактора.

1. 1
   Откройте обработку в Конфигураторе (файл .epf или объект конфигурации)
2. 2
   В дереве объекта раскройте ветку «Реквизиты» и нажмите «Добавить»
3. 3
   Задайте имя реквизита латиницей или кириллицей без пробелов
4. 4
   Выберите тип данных и при необходимости уточните квалификаторы (длина строки, точность числа)
5. 5
   Сохраните обработку: Ctrl+S для файла или обновление конфигурации БД
6. 6
   Проверьте доступность реквизита из модуля объекта через ЭтотОбъект.ИмяРеквизита

Выберите правильный тип данных

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

Для коллекций данных (список строк, таблица результатов) реквизит объекта не подходит — вместо него используйте табличную часть обработки (ветка «Табличные части» рядом с «Реквизитами») или реквизит формы типа «ТаблицаЗначений». Смешение этих механизмов приводит к тому, что данные теряются при серверных вызовах.

Выведите реквизит на управляемую форму

Добавленный в объект реквизит сам по себе на форме не появится. Откройте основную форму обработки двойным кликом по ветке «Формы». В редакторе формы в правой верхней панели находится список реквизитов формы — реквизиты объекта там отображаются автоматически (обычно под узлом «Объект» или «РеквизитФормыВЗначение»-подобной структурой, в зависимости от типа формы). Перетащите нужный реквизит мышью в дерево элементов формы в левой панели — платформа создаст поле ввода с подходящим видом.

Если формы у обработки нет, создайте её: правый клик по ветке «Формы» → «Добавить» → выберите тип «Форма обработки». После создания формы перетаскивание реквизитов работает так же. Для поля можно настроить свойства: заголовок, подсказку, кнопку выбора, связь параметров выбора с другими полями.

Обратитесь к реквизиту из программного кода

Из модуля объекта обработки реквизит доступен напрямую по имени или через ЭтотОбъект.ИмяРеквизита. Из модуля формы обращение зависит от типа формы: для обычной формы — просто по имени, для управляемой формы с основным реквизитом «Объект» — через Объект.ИмяРеквизита.

// Модуль объекта обработки
Процедура ЗаполнитьПоУмолчанию() Экспорт
    ЭтотОбъект.Организация = Справочники.Организации.ПустаяСсылка();
    ЭтотОбъект.Комментарий = "Создано автоматически";
КонецПроцедуры

// Модуль управляемой формы
&НаКлиенте
Процедура ПоказатьОрганизацию(Команда)
    Сообщить(Объект.Организация);
КонецПроцедуры

Помните про контекст серверных вызовов. В управляемой форме данные объекта при вызове серверной процедуры пересоздаются: если вы изменили реквизит на сервере в процедуре с директивой &НаСервере, изменения вернутся на клиент вместе с данными формы. Но если процедура объявлена как &НаСервереБезКонтекста, доступа к реквизитам объекта у неё нет — данные нужно передавать параметрами или через РеквизитФормыВЗначение("Объект").

Добавление реквизита через расширение конфигурации

Когда обработка типовая и конфигурация находится на полной поддержке, прямое изменение объекта усложнит будущие обновления. В этом случае создайте расширение: «Конфигурация → Расширения конфигурации → Создать». Затем в основной конфигурации найдите нужную обработку, через контекстное меню добавьте её форму в расширение.

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

Проверьте результат и типичные ошибки

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

Отдельно про внешние обработки, подключённые через механизм «Дополнительные отчеты и обработки» (БСП). После изменения .epf-файла недостаточно сохранить его на диске — нужно обновить версию в справочнике дополнительных обработок, иначе пользователи продолжат запускать старый вариант из информационной базы.

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