Как программно добавить реквизит в табличную часть 1С

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

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

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

Основы работы с табличными значениями

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

Для создания новой колонки используется метод ДобавитьКолонку. Он требует указания имени колонки и типа данных. Если тип не указан явно, система попытается определить его автоматически при первой записи, что не является лучшей практикой. Явное определение типа, например Число или Строка, предотвращает ошибки приведения типов в дальнейшем коде.

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

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

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

Синтаксис метода позволяет передавать тип данных как строковое представление или объект описания типов. Использование объекта ОписаниеТипов дает более тонкий контроль, позволяя задать длину строки, точность числа или допустимые значения Null. Для простых задач достаточно указать тип в виде строки, например, "Число(15,2)".

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

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

• 📊 Используйте тип Число для денежных сумм и количественных показателей с указанной точностью.
• 📝 Для текстовых данных выбирайте тип Строка с запасом по длине (например, 255 или 500 символов).
• 📅 Даты и время храните в колонках с типом Дата, указывая часть даты (Дата, Время или ДатаВремя).
• 🔗 Для ссылок на объекты используйте тип СправочникСсылка.ИмяСправочника или универсальный СправочникСсылка.

Заполнение строк данными

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

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

НоваяСтрока = Таблица.ДобавитьСтроку();
НоваяСтрока.Наименование = "Товар А";
НоваяСтрока.Количество = 10;
НоваяСтрока.Цена = 150.50;
НоваяСтрока.Сумма = НоваяСтрока.Количество * НоваяСтрока.Цена;

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

Модификация существующей структуры

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

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

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

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

Как безопасно изменить тип колонки?

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

Работа в режиме Предприятия и Конфигуратора

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

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

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

Не изменяет физическую структуру таблиц БД

Характеристика	Режим Предприятия (Код)	Режим Конфигуратора (Метаданные)
Срок жизни	До конца сессии или работы объекта	Постоянно, до изменения конфигурации
Доступность	Только в текущем алгоритме	Во всей конфигурации для всех пользователей
Изменение структуры	Динамическое, гибкое	Требует обновления конфигурации БД
Влияние на БД	Изменяет схему базы данных
Пример использования	Временный отчет, печатная форма	Хранение доп. характеристик товара

Типичные ошибки и оптимизация

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

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

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

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

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

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

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

Как скопировать структуру одной таблицы в другую?

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

Что делать, если нужно добавить реквизит с типом "Любой"?

Для этого используйте тип данных Строка с большой длиной или специализированный тип ХранилищеЗначения, если требуется сохранять объекты разных типов без потери их структуры. Тип "Любой" в явном виде в табличных значениях обычно заменяется на универсальные типы.

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

Нет, табличные значения существуют в памяти клиента или сервера приложений и не участвуют в формировании SQL-запросов к СУБД напрямую. Они влияют только на скорость выполнения кода 1С и потребление оперативной памяти.

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

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