Добавление реквизитов в табличную часть 1С: Руководство для разработчика

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

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

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

Подготовка к модификации метаданных

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

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

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

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

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

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

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

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

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

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

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

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

Рассмотрим основные варианты типов, которые чаще всего используются при расширении табличных частей:

• 📏 Число — используется для количественных показателей, сумм, коэффициентов. Требует настройки длины и точности.
• 📝 Строка — универсальный тип для текста. Важно ограничить длину, чтобы не раздувать базу данных.
• 📂 СправочникСсылка — позволяет выбирать значения из существующих списков номенклатуры, контрагентов или других сущностей.
• 📅 Дата — применяется для фиксации временных меток, сроков годности или дат операций.

Для числовых типов критически важно задать длину и точность. Например, для цены обычно устанавливают длину 15 и точность 4 знака после запятой. Для количества товаров часто достаточно точности 3 знака.

Если реквизит должен хранить ссылку на объект, в свойствах типа данных необходимо выбрать конкретный вид справочника. Это обеспечит контроль целостности данных: пользователь не сможет ввести несуществующий элемент.

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

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

Откройте основную форму документа. В конструкторе форм найдите элемент таблицы, соответствующий вашей табличной части. Обычно это элемент с типом ПолеТаблицы или динамический список.

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

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

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

Заполнение данных программным способом

Часто новые реквизиты должны заполняться автоматически. Для этого используется встроенный язык 1С:Предприятие. Логика прописывается в модуле объекта или в модуле формы.

Наиболее частый сценарий — заполнение по умолчанию при добавлении новой строки. Код размещается в обработчике события ОбработкаЗаполнения или непосредственно в цикле создания строки.

НоваяСтрока = Документ.Товары.Добавить();
НоваяСтрока.НашРеквизит = ЗначениеПоУмолчанию;
НоваяСтрока.Количество = 1;

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

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

Если вы хотите заполнять реквизит на основе выбранной номенклатуры, используйте следующий код в модуле формы: Процедура ТоварыНомЕнКлАтуРАПриИзменении(Элемент) ЭлементФормы = Элементы.Товары.Колонки.НашРеквизит; // Логика получения данных из справочника КонецПроцедуры

Пользователь всегда должен иметь возможность скорректировать данные при необходимости.

Таблица свойств реквизитов

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

Параметр	Описание	Влияние на работу
Имя	Технический идентификатор (латиница)	Используется в коде и запросах
Синоним	Название для пользователя	Отображается в интерфейсе и отчетах
Тип	Формат хранимых данных	Определяет доступные операции
Использование	Ввод, вывод, выбор	Управляет поведением в форме
Индексирование	Создание индекса в БД	Ускоряет поиск по полю

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

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

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

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

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

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

В ходе обновления платформа перестроит таблицы в базе данных (SQL). Для новых реквизитов будут созданы новые колонки. Старые данные сохранятся, если вы не удаляли поля.

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

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

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

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

Что делать, если новый реквизит не виден в печатной форме?

Печатные формы часто настраиваются отдельно через макеты или СКД. Вам нужно открыть макет печати или схему компоновки данных и добавить туда новое поле из списка доступных полей документа.

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

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

Как удалить добавленный реквизит, если он больше не нужен?

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

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

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