Добавление колонки в список значений 1С: от теории к практике

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

Эта статья покрывает все актуальные способы добавления колонок — от ручного программирования до визуальных инструментов платформы. Мы разберём не только базовые методы, но и нюансы работы с ДинамическимиСписками, УправляемымиФормами, а также типичные ошибки, которые ведут к падению производительности или некорректному отображению данных. Если вы когда-либо сталкивались с тем, что добавленная колонка "не хочет" показываться или обновляться — здесь вы найдёте решение.

Что такое список значений в 1С и зачем добавлять колонки

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

Основные сценарии, когда требуется добавить колонку:

• 📊 Отчёты и аналитика: вывод дополнительных показателей (например, процент выполнения плана рядом с суммой продаж).
• 🔧 Настройка интерфейса: адаптация формы под специфические бизнес-процессы компании.
• 🔄 Интеграция данных: отображение информации из связанных справочников или регистров.
• 🖥️ Управляемые формы: динамическое изменение табличной части в зависимости от прав пользователя.

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

Способ 1: Добавление колонки программно (в коде)

Самый универсальный метод — использование встроенного языка 1С. Он подходит для всех версий платформы (8.3, 8.2) и позволяет максимально гибко настраивать колонки, включая их форматирование, условия видимости и обработчики событий. Рассмотрим базовый пример:

// Создаём новый список значений
Список = Новый СписокЗначений;

// Добавляем колонку "Наименование" (по умолчанию она будет первой)
Список.Колонки.Добавить("Наименование");

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

// Добавляем колонку "ДатаПоступления" с форматированием
КолонкаДата = Список.Колонки.Добавить("ДатаПоступления");
КолонкаДата.Формат = "ДФ=dd.MM.yyyy";

Ключевые свойства колонок, которые можно настроить программно:

Обратите внимание: если вы добавляете колонку после заполнения списка данными, её значения по умолчанию будут пустыми. Чтобы избежать этого, используйте метод ЗаполнитьЗначения() или вручную пройдитесь по элементам списка циклом.

Способ 2: Использование конструктора списка значений

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

1. Откройте форму, содержащую список значений (например, отчёт или обработку).
2. Щёлкните правой кнопкой мыши по заголовку любой колонки и выберите Настройка списка....
3. В открывшемся окне перейдите на вкладку Колонки.
4. Нажмите кнопку Добавить и заполните свойства новой колонки:
   • 📌 Имя — внутренний идентификатор (латиницей, без пробелов).
   • 🏷️ Заголовок — отображаемое имя (может содержать пробелы).
   • 📏 Тип данных — выберите из выпадающего списка.

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

• ✅ Не требует знания кода.
• ✅ Изменения применяются мгновенно (без перезапуска системы).
• ✅ Подходит для разовых задач или тестирования.

Однако у конструктора есть ограничения:

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

Способ 3: Динамическое добавление колонок через расширения

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

1. Откройте конфигуратор и создайте новое расширение (Файл → Новый → Расширение конфигурации).
2. В дереве объектов найдите форму, в которой требуется добавить колонку (например, Отчет.Продажи).
3. Щёлкните правой кнопкой по форме и выберите Переопределить.
4. В переопределённой форме найдите табличное поле с списком значений и добавьте колонку через свойства или программно в модуле формы:

Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
// Получаем список значений из реквизита формы
Список = ЭлементыФормы.ТаблицаРезультатов.Значение;

// Добавляем новую колонку
НоваяКолонка = Список.Колонки.Добавить("ПроцентВыполнения");
НоваяКолонка.ТипЗначения = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(5, 2));
НоваяКолонка.Заголовок = "Выполнение, %";
НоваяКолонка.Ширина = 100;

// Заполняем колонку данными (пример)
Для Каждого Строка Из Список Цикл
Строка.ПроцентВыполнения = Строка.Факт / Строка.План * 100;
КонецЦикла;
КонецПроцедуры

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

Создать резервную копию конфигурации|Проверить совместимость версии платформы|Определить уникальное имя колонки|Протестировать изменения на копии базы|Документировать внесённые правки-->

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

Даже опытные разработчики сталкиваются с проблемами при работе со списками значений. Вот наиболее распространённые ошибки и способы их решения:

⚠️ Внимание: Если после добавления колонки список перестал отображаться или выдаёт ошибку "Недопустимый тип данных", проверьте соответствие типов значений в колонке и фактических данных. Например, попытка поместить строку в колонку с типом Число приведёт к сбою.

Ошибка 1: Колонка не отображается в интерфейсе

• 🔍 Причина: Ширина колонки установлена в 0 или свойство Видимость = Ложь.
• 🛠️ Решение: Явно задайте ширину (например, Колонка.Ширина = 120) и проверьте видимость.

Ошибка 2: Данные в колонке не обновляются

• 🔍 Причина: Список значений не привязан к источнику данных или обновление интерфейса заблокировано.
• 🛠️ Решение: Используйте метод Обновить() для табличного поля или проверьте привязку к реквизиту формы.

Ошибка 3: Падение производительности при добавлении колонок

• 🔍 Причина: Массовое добавление колонок в цикле без оптимизации.
• 🛠️ Решение: Отключите обновление интерфейса (ОтключитьОжидание()) и используйте пакетную обработку.

Расширенные возможности: условное оформление и динамические колонки

Стандартные колонки — это только начало. Платформа 1С:Предприятие позволяет настраивать условное оформление (например, подсветку ячеек по условию) и создавать динамические колонки, значения которых вычисляются на лету. Рассмотрим оба варианта.

Условное оформление настраивается через свойство УсловноеОформление колонки. Пример кода:

Колонка = Список.Колонки.Добавить("Статус");
УсловноеОформление = Колонка.УсловноеОформление.Добавить();
УсловноеОформление.Условие = Новый Условие("Значение = ""Выполнено""");
УсловноеОформление.ЦветФона = WebЦвета.Зеленый;

Динамические колонки полезны, когда значение зависит от других данных строки. Например, можно добавить колонку "ИтоговаяСумма", которая будет рассчитываться как Цена * Количество:

Процедура ПриИзмененииСтроки(Элемент)
ТекущаяСтрока = ЭлементыФормы.Таблица.ТекущаяСтрока;
ТекущаяСтрока.ИтоговаяСумма = ТекущаяСтрока.Цена * ТекущаяСтрока.Количество;
КонецПроцедуры

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

Практические примеры: добавление колонок в типовых конфигурациях

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

Пример 1: Колонка "ДниПросрочки" в отчёте по дебиторской задолженности

Задача: в отчёт ДебиторскаяЗадолженность нужно добавить колонку, показывающую количество дней просрочки платежа.

// В модуле отчёта
Процедура ПриФормированииРезультата(Результат)
Результат.Колонки.Добавить("ДниПросрочки");
Для Каждого Строка Из Результат Цикл
Если Строка.ДатаОплаты < ТекущаяДата() Тогда
Строка.ДниПросрочки = ТекущаяДата() - Строка.ДатаОплаты;
Иначе
Строка.ДниПросрочки = 0;
КонецЕсли;
КонецЦикла;
КонецПроцедуры

Пример 2: Колонка "Прибыльность" в списке номенклатуры

Задача: в справочник Номенклатура добавить колонку, отображающую разницу между ценой продажи и себестоимостью.

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

Для Каждого Строка Из Список Цикл
Себестоимость = ПолучитьСебестоимость(Строка.Ссылка);
Строка.Прибыльность = Строка.ЦенаПродажи - Себестоимость;
КонецЦикла;
КонецПроцедуры

⚠️ Внимание: В типовых конфигурациях (1С:Бухгалтерия, 1С:УТ, 1С:ЗУП) перед внесением изменений всегда проверяйте, не перекрывает ли ваша доработка стандартную функциональность. Например, в 1С:Управление Торговлей 11 колонка "Прибыльность" уже может существовать в некоторых отчётах, но быть скрытой.

FAQ: Частые вопросы по работе со списками значений

Колонка.Редактируемая = Истина;

Колонка = Список.Колонки.Добавить("Изображение");
Колонка.ТипЗначения = Новый ОписаниеТипов("Картинка");
Колонка.Ширина = 50;