Как добавить колонку в массив 1С — пошаговая инструкция

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

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

Что такое "колонка" в контексте массивов 1С?

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

Важно понимать разницу:

📌 Обычный массив (типа Массив) — одномерная структура, где "колонки" отсутствуют. Здесь можно только добавлять/удалять элементы по индексу.
📊 Таблица значений (типа ТаблицаЗначений) — двумерная структура с колонками, каждая из которых имеет имя, тип данных и может содержать заголовок.
🔑 Соответствие (типа Соответствие) — набор пар "ключ-значение", где понятие "колонки" также не применимо.

Если вам нужно добавить "колонку" в обычный массив, на самом деле речь идет о создании массива массивов (двумерного массива) или переходе на ТаблицуЗначений. Последний вариант предпочтительнее для большинства задач в 1С, так как предоставляет встроенные методы для работы с колонками.

Способы добавления колонки в таблицу значений

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

1. Метод ДобавитьКолонку()

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

Таблица.ДобавитьКолонку( &ИмяКолонки, // Строка — внутреннее имя &ТипЗначения, // ТипЗначения (Число, Строка, Дата и т.д.) &Заголовок, // Строка — отображаемое имя (опционально) &Ширина = 0 // Число — ширина в символах (опционально)

);

Пример добавления колонки для хранения суммы скидки:

ТаблицаТоваров.ДобавитьКолонку(
"СуммаСкидки",
Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(10, 2)),
"Сумма скидки, руб.",
15
);

Обратите внимание на использование ОписаниеТипов с квалификаторами — это позволяет явно указать разрядность числа (в данном случае 10 знаков, из них 2 после запятой).

2. Добавление колонки через свойство Колонки

Альтернативный подход — работа со свойством Колонки таблицы значений как с коллекцией. Это полезно, если нужно одновременно добавить несколько колонок или настроить их свойства после создания. Пример:

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

Такой способ дает больше контроля над свойствами колонки, но требует больше кода. Например, здесь можно сразу задать:

🔢 Порядок отображения (свойство Порядок)
📏 Ширину (свойство Ширина)
🔒 Видимость (свойство Видимость)

Проверить существование колонки с таким именем|Определить тип данных колонки|Указать заголовок для отображения|Настроить ширину колонки (если нужно)-->

3. Копирование структуры из другой таблицы

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

НоваяТаблица = ТаблицаШаблон.СкопироватьКолонки();
НоваяТаблица.Очистить();

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

💡

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

Добавление "колонки" в обычный массив (двумерные массивы)

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

// Создаем двумерный массив 3x2 (3 строки, 2 колонки)
МассивДанных = Новый Массив;
МассивДанных.Добавить(Новый Массив); // Строка 1
МассивДанных[0].Добавить("Яблоки");   // Колонка 1
МассивДанных[0].Добавить(100);        // Колонка 2

МассивДанных.Добавить(Новый Массив); // Строка 2
МассивДанных[1].Добавить("Груши");
МассивДанных[1].Добавить(150);

Чтобы "добавить колонку" в такой массив, нужно пройтись по всем строкам и добавить новый элемент с нужным индексом:

// Добавляем третью колонку ("Цена со скидкой")
Для Каждого Строка Из МассивДанных Цикл
Строка.Добавить(Строка[1] * 0.9); // Умножаем цену на 0.9
КонецЦикла;

Такой подход требует аккуратности:

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

Когда стоит избегать двумерных массивов?

Использование массивов массивов оправдано только для простейших задач с небольшим объемом данных. Для всего остального предпочтительнее ТаблицаЗначений, так как она предоставляет:

- Автоматическую типизацию данных

- Методы для работы с колонками (добавление, переименование, удаление)

- Возможность привязки к элементам формы (например, табличное поле)

- Встроенные механизмы сортировки и фильтрации

Типичные ошибки и как их избежать

Даже опытные разработчики 1С иногда допускают ошибки при работе с колонками в массивах. Вот наиболее распространенные проблемы и способы их решения:

Ошибка	Причина	Решение
Ошибка при добавлении колонки с существующим именем	Повторное использование имени колонки	Предварительно проверять существование колонки через `Таблица.Колонки.Найти()`
Несовпадение типов данных	Попытка записать строку в колонку типа "Число"	Явно указывать тип при добавлении колонки или преобразовывать данные
Потеря данных при изменении структуры	Изменение типа колонки после заполнения	Создавать новую колонку, копировать данные с преобразованием, удалять старую
Некорректная сортировка	Отсутствие индексов или неверный тип данных	Использовать метод `ИндексироватьПоколонкам()` перед сортировкой

Особенно коварна ошибка с несовпадением типов. Например, если вы добавили колонку типа Число, а затем попытались записать в нее строку, 1С не выдаст ошибку сразу. Вместо этого значение будет преобразовано в Неопределено, что может привести к трудноуловимым багам в расчетах.

💡

Всегда проверяйте результат добавления колонки! После вызова ДобавитьКолонку() убедитесь, что колонка действительно появилась, и ее свойства (тип, заголовок) соответствуют ожидаемым. Это можно сделать через Таблица.Колонки.Найти(&ИмяКолонки).

Производительность: что быстрее?

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

1. Добавление колонки в пустую таблицу: Самый быстрый вариант. Время выполнения минимально, так как не требуется перестроение данных.

2. Добавление колонки в заполненную таблицу:

- Метод ДобавитьКолонку() работает быстро (доли секунды даже для 10 000 строк), так как просто расширяет структуру.

- Ручное добавление через цикл Для Каждого в обычном массиве может быть в 10-100 раз медленнее из-за поэлементной обработки.

3. Изменение типа существующей колонки: Самая ресурсоемкая операция. 1С придется конвертировать все значения, что может занять заметное время.

Для оптимизации следуйте этим рекомендациям:

🚀 Сначала структура, потом данные: Сначала формируйте все колонки, затем заполняйте таблицу.
🔄 Минимизируйте изменения структуры: Избегайте добавления колонок "на лету" в циклах.
🗃️ Используйте индексы: Если планируете поиск по колонке, индексируйте ее заранее.

💡

Для массового добавления колонок в больших таблицах (100 000+ строк) рассмотрите возможность использования временных таблиц в СУБД. В 1С:Предприятие 8.3 это реализуется через механизм Запрос с конструкцией ВТ (временная таблица).

Практические примеры

Рассмотрим несколько реальных сценариев, где добавление колонки в массив (таблицу значений) решает конкретные задачи.

Пример 1: Добавление расчетной колонки в отчет

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

// Исходная таблица с колонками: Товар, Количество, ЦенаЗакупки
ТаблицаПродаж.ДобавитьКолонку(
"НаценкаПроцент",
Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(5, 2))
);
ТаблицаПродаж.ДобавитьКолонку(
"ЦенаПродажи",
Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(10, 2))
);

// Заполняем новые колонки
Для Каждого Строка Из ТаблицаПродаж Цикл
Наценка = (Строка.ЦенаПродажи - Строка.ЦенаЗакупки) / Строка.ЦенаЗакупки * 100;
Строка.НаценкаПроцент = Окр(Наценка, 2);
КонецЦикла;

Пример 2: Импорт данных с динамической структурой

При импорте данных из Excel или JSON структура источника может меняться. Чтобы обработать новые колонки:

// Предположим, мы получили данные в формате JSON
ДанныеJSON = ПолучитьДанныеИзAPI();
ТаблицаРезультатов = Новый ТаблицаЗначений;

// Добавляем колонки динамически
Для Каждого Ключ Из ДанныеJSON[0].Ключи() Цикл
ТипЗначения = ОпределитьТипЗначения(ДанныеJSON[0][Ключ]); // Ваша функция определения типа
ТаблицаРезультатов.ДобавитьКолонку(Ключ, ТипЗначения, Ключ);
КонецЦикла;

Пример 3: Модификация типовой обработки

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

🔧 Сохранить оригинальную функциональность
📌 Добавить колонки с уникальными именами (например, с префиксом "Пользовательская_")
🔄 Учесть обновления конфигурации (лучше выносить изменения в расширения)

Пример для отчета "Ведомость по товарам":

Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка) // Добавляем колонку в основную таблицу отчета Элементы.ОсновнаяТаблица.ДобавитьКолонку( "Пользовательская_Рентабельность", Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(10, 2)), "Рентабельность, %", 15 );

КонецПроцедуры

Работа с колонками в запросах 1С

При использовании языка запросов 1С добавление колонок реализуется иначе — через конструкцию ВЫБРАТЬ с псевдонимами или вычисляемыми полями. Однако иногда требуется динамически модифицировать результат запроса, добавляя колонки уже после его выполнения.

Рассмотрим два подхода:

1. Добавление колонки к результату запроса

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

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   Товар,
|   Количество,
|   Цена
|ИЗ Документ.РеализацияТоваров";
Результат = Запрос.Выполнить();
ТаблицаРезультатов = Результат.Выгрузить();

// Добавляем расчетную колонку
ТаблицаРезультатов.ДобавитьКолонку("Сумма", Новый ОписаниеТипов("Число"));
Для Каждого Строка Из ТаблицаРезультатов Цикл
Строка.Сумма = Строка.Количество * Строка.Цена;
КонецЦикла;

2. Вычисляемые поля в самом запросе

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

Запрос.Текст =
"ВЫБРАТЬ
|   Товар,
|   Количество,
|   Цена,
|   Количество * Цена КАК Сумма  // Вычисляемое поле
|ИЗ Документ.РеализацияТоваров";

Преимущества второго подхода:

⚡ Производительность: Расчеты выполняются на уровне СУБД.
📊 Гибкость: Можно использовать агрегатные функции (СУММА, МАКСИМУМ).
🔍 Индексы: СУБД может оптимизировать выполнение.

💡

Для сложных расчетов, зависящих от данных других таблиц, используйте конструкцию ВЫРАЗИТЬ в языке запросов. Это позволит избежать пост-обработки результата на стороне 1С.

FAQ: Частые вопросы по работе с колонками в 1С

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

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

Как переименовать колонку в таблице значений?

Прямого метода переименования нет. Нужно:

Создать новую колонку с новым именем.
Скопировать данные из старой колонки в новую.
Удалить старую колонку через Таблица.Колонки.Удалить().

Почему после добавления колонки данные отображаются некорректно?

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

Как добавить колонку в таблицу значений на форме?

Для табличного поля на форме:

Добавьте колонку в источник данных (таблицу значений).
Обновите свойство Колонки табличного поля через ЭлементыФормы.ИмяТаблицы.Колонки.
Вызовите ОбновитьОтображение() для табличного поля.

Пример:

Элементы.ТаблицаТоваров.Колонки.Добавить(
Новый КолонкаТабличногоПоля("НоваяКолонка", Новый ОписаниеТипов("Строка"))
);
Элементы.ТаблицаТоваров.ОбновитьОтображение();

Можно ли добавить колонку в массив на мобильной платформе 1С?

Да, механизмы работы с таблицами значений и массивами на мобильной платформе идентичны десктопной версии. Однако учитывайте ограничения производительности мобильных устройств — избегайте добавления колонок в больших таблицах (10 000+ строк) непосредственно на устройстве.

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

Добавление колонки в массив 1С: полное руководство с примерами