Как добавить поле в 1С: Полная инструкция для разработчиков

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

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

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

Подготовка к модификации конфигурации

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

⚠️ Внимание: Перед внесением изменений в промышленную базу данных обязательно создайте резервную копию (архив). Откатить добавление реквизита без потери данных бывает крайне сложно, особенно если поле уже заполнено.

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

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

Создание нового реквизита в объекте

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

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

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

Параметр	Назначение	Ограничения
Имя	Идентификатор для кода	Латиница, без пробелов
Синоним	Отображение в интерфейсе	Любые символы
Тип	Формат хранимых данных	Зависит от задачи

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

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

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

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

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

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

Что такое составные типы?

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

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

Размещение поля в форме документа

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

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

// Пример программного добавления поля в форму
Элементы.Добавить("НовоеПоле", Тип("ПолеФормы"));
Элементы.НовоеПоле.Вид = ВидПоляФормы.ПолеВвода;
Элементы.НовоеПоле.ПутьКДанным = "Объект.НовыйРеквизит";

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

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

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

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

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

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

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

После обновления запустите базу в обычном режиме (F5) и проверьте, что новое поле отображается, сохраняет данные и корректно участвует в проведении документов. Тестирование лучше проводить на копии базы, чтобы исключить риски для реальных данных.

Использование поля в отчетах и запросах

Чтобы добавленное поле приносило пользу, его данные должны использоваться в аналитике. В конструкторе запросов или в коде обработок новый реквизит будет доступен по пути Справочник.ИмяСправочника.ИмяРеквизита. Его можно добавлять в выборку, условия отбора и группировки.

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

• 📊 Для вывода в печатные формы используйте макеты табуляционных документов, обращаясь к реквизиту через точку.
• 🔍 Для поиска по новому полю убедитесь, что оно включено в список полей, участвующих в полнотекстовом поиске, если это необходимо.
• ⚙️ При настройке прав доступа добавьте новое поле в роли пользователей, иначе они не смогут видеть или редактировать его.

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

Индексация новых полей

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

Частые вопросы по добавлению полей в 1С

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

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

Что делать, если при обновлении базы вылетает ошибка «Таблица заблокирована»?

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

Как удалить добавленное поле, если оно больше не нужно?

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

Влияет ли добавление поля на скорость работы программы?

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

Нужно ли нумеровать версии конфигурации при добавлении поля?

Да, это хорошая практика. Изменение версии конфигурации (например, с 1.0.1 на 1.0.2) помогает отслеживать историю изменений и упрощает сравнение двух конфигураций через инструмент «Сравнение конфигураций».