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

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

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

Выбор объекта метаданных для добавления поля

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

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

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

Интерфейс Конфигуратора и дерево метаданных

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

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

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

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

Создание нового реквизита и настройка свойств

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

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

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

Выбор типа данных и длина поля

Платформа 1С поддерживает множество типов данных, от простых строк и чисел до сложных ссылочных типов и составных типов. При выборе типа Строка необходимо указать её длину. Для коротких кодов или статусов достаточно 10-20 символов, тогда как для комментариев или описаний следует устанавливать длину в 255, 500 или даже 1000 символов.

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

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

Тип данных	Описание	Пример использования
Строка	Текстовая информация фиксированной длины	Артикул товара, штрих-код
Число	Числовые значения с заданной точностью	Вес брутто, коэффициент наценки
Булево	Логическое значение (Истина/Ложь)	Флаг "Новинка", признак экспорта
Дата	Дата и время	Дата окончания гарантии
ХранилищеЗначения	Произвольные сериализуемые данные	Настройки отчета, сложные структуры

Добавление реквизитов в табличные части

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

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

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

Вывод реквизита на форму и работа с кодом

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

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

В программном коде обращение к реквизиту осуществляется через точку. Например, для присвоения значения строковому полю "Артикул" в документе используется конструкция:

ДокументОбъект.Артикул = "ART-2026-001";

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

СтрокаТовара = ДокументОбъект.Товары.Добавить();
СтрокаТовара.Номенклатура = СсылкаНаТовар;
СтрокаТовара.КомментарийПозиции = "Хрупкий груз";

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

Что делать, если поле не сохраняется?

Если после ввода данных в новое поле они не сохраняются при записи объекта, проверьте свойства реквизита. Убедитесь, что не стоит галочка "Только просмотр" и что поле не перекрывается событиями формы, которые очищают его значение перед записью.

Оптимизация и индексация новых полей

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

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

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

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

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

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

Как удалить ненужный реквизит из конфигурации?

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

В чем разница между реквизитом и свойством объекта?

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

Почему новый реквизит не виден в отчете?

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