Как добавить колонку в форму списка 1С: 3 рабочих способа с примерами кода

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

В этой статье разберём три основных способа добавления колонок — от простого редактирования в режиме предприятия до программного создания через конфигуратор. Особое внимание уделим типичным ошибкам (например, когда колонка появляется только после перезапуска или не сортируется) и способам их исправления. Также приведём актуальные примеры кода для 1С 8.3 с учётом последних обновлений платформы.

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

1. Добавление колонки через режим предприятия (без программирования)

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

Вот как это сделать:

• 📌 Откройте нужный справочник или документ в режиме 1С:Предприятие (не конфигуратор!).
• 🔧 Нажмите правой кнопкой мыши на заголовок любой колонки в списке и выберите Настройка списка.
• ➕ В открывшемся окне перейдите на вкладку Колонки и нажмите Добавить.
• 📝 Выберите поле из доступных (например, Артикул для справочника Номенклатура) и настройте ширину, порядок отображения.

Этот метод имеет ограничения:

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

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

2. Редактирование формы списка в конфигураторе

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

Пошаговая инструкция:

1. Откройте конфигуратор (1Cv8.exe /config) и найдите нужный объект (например, справочник Контрагенты).
2. Перейдите на вкладку Формы → откройте форму списка (обычно называется Список[ИмяОбъекта]).
3. В дереве элементов формы найдите табличное поле (обычно Список) и откройте его свойства.
4. На вкладке Колонки добавьте новую колонку, укажите Имя (например, Телефон) и свяжите её с полем объекта или напишите выражение (например, Объект.Телефон).
5. Сохраните форму (Ctrl+S) и обновите конфигурацию базы данных (Конфигурация → Обновить конфигурацию базы данных).

Пример вычисляемой колонки (например, для отображения остатка номенклатуры):

ОстаткиНоменклатуры.Остаток(Объект.Ссылка, , ТекущийСклад)

⚠️ Внимание: Если после обновления конфигурации колонка исчезла, проверьте, не перекрывает ли её расширение или дополнительная обработка. В 1С 8.3.20+ приоритет имеют настройки из расширений.

Связана ли колонка с корректным полем объекта?|

Указан ли заголовок колонки (свойство "Заголовок")?|

Проверили ли вы отображение в разных ролях?|

Сохранена ли форма и обновлена ли конфигурация базы?-->

3. Программное добавление колонки (через код)

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

• 🔄 Добавлять/удалять колонки "на лету" без изменения конфигурации.
• 🔒 Скрывать колонки для определённых ролей.
• ⚡ Оптимизировать производительность (например, не грузить тяжёлые вычисляемые поля).

Пример кода для управляемой формы (размещается в модуле формы):

Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Колонки = ЭлементыФормы.Список.Колонки;

// Добавляем новую колонку
НоваяКолонка = Колонки.Добавить("ОстатокНаСкладе");
НоваяКолонка.Заголовок = "Остаток";
НоваяКолонка.ТипЗначения = Новый ОписаниеТипов("Число");
НоваяКолонка.Выражение = "Объект.ОстаткиНоменклатуры.Остаток(Объект.Ссылка, , ТекущийСклад)";

// Настраиваем ширину и порядок
НоваяКолонка.Ширина = 100;
НоваяКолонка.Порядок = 2;
КонецПроцедуры

Для обычных форм код будет другим (используется событие ПриАктивизацииСтроки):

Процедура СписокПриАктивизацииСтроки(Элемент, Строка)
Если НЕ ЗначениеЗаполнено(Строка.Остаток) Тогда
Строка.Остаток = ПолучитьОстатокНаСкладе(Элемент.ТекущиеДанные.Ссылка);
КонецЕсли;
КонецПроцедуры

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

• Обновить форму (Форма.Обновить()).
• Очистить кэш (ОчиститьКэшКонфигурации() — требует прав администратора).
• Перезапустить сеанс пользователя.

4. Типичные ошибки и их решения

Даже при правильном выполнении инструкций колонка может не отобразиться или работать некорректно. Разберём самые распространённые проблемы:

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

НоваяКолонка.Выражение = "ОстаткиНоменклатуры.Остаток(
Объект.Ссылка,
,
Constants.ОсновнойСклад.Получить(),
Истина
)";

⚠️ Внимание: В конфигурациях на БСП 3.1+ (например, 1С:ERP или 1С:КА 2.5) некоторые колонки могут блокироваться механизмом "Управление доступом к данным". Проверьте настройки RLS (Row-Level Security) в модуле объекта.

5. Оптимизация производительности

Добавление вычисляемых колонок может значительно замедлить работу формы, особенно если:

• 📊 В списке тысячи строк.
• 🔄 Колонка использует тяжёлые запросы (например, остатки по всем складам).
• 🔄 Данные обновляются при каждом изменении строки.

Способы оптимизации:

1. Отложенная загрузка: Грузите данные в колонку только при активизации строки (событие ПриАктивизацииСтроки).
2. Кэширование: Сохраняйте результаты вычислений в временную таблицу или реквизит формы.
3. Упрощение запросов: Используйте индексированные поля в условиях отбора.

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

Перем мТЧОстатки; // Кэш остатков

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

Функция ПолучитьОстаток(Ссылка)
// Ищем в кэше
Строка = мТЧОстатки.Найти(Ссылка, "Ссылка");
Если Строка <> Неопределено Тогда
Возврат Строка.Остаток;
КонецЕсли;

// Если нет — запрашиваем и кэшируем
Остаток = ОстаткиНоменклатуры.Остаток(Ссылка, , ТекущийСклад);
НоваяСтрока = мТЧОстатки.Добавить();
НоваяСтрока.Ссылка = Ссылка;
НоваяСтрока.Остаток = Остаток;

Возврат Остаток;
КонецФункции

Для управляемых форм в 1С 8.3.18+ можно использовать механизм ОтложенноеВыполнение, чтобы не блокировать интерфейс:

Процедура ОбновитьОстатки()
Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ
|   Номенклатура КАК Ссылка,
|   СУММА(ОстаткиНоменклатуры.КоличествоОстаток) КАК Остаток
|ИЗ
|   Документ.ОприходованиеТоваров КАК Оприходование
|       ЛЕВОЕ СОЕДИНЕНИЕ РегистрНакопления.ОстаткиНоменклатуры КАК ОстаткиНоменклатуры
|       ПО Оприходование.Номенклатура = ОстаткиНоменклатуры.Номенклатура
|ГДЕ
|   Оприходование.Ссылка В (&СписокСсылок)
|СГРУППИРОВАТЬ ПО
|   Номенклатура";

Запрос.УстановитьПараметр("СписокСсылок", СписокСсылок);
Результат = Запрос.Выполнить();

Пока Результат.Следующий() Цикл
Строка = ЭлементыФормы.Список.Найти(Результат.Ссылка, "Ссылка");
Если Строка <> Неопределено Тогда
Строка.Остаток = Результат.Остаток;
КонецЕсли;
КонецЦикла;
КонецПроцедуры

// Вызов с отложенным выполнением
ОтложенноеВыполнение.ДобавитьВОчередь("ОбновитьОстатки");

6. Работа с расширениями и внешними обработками

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

• 📦 Расширения конфигурации (рекомендуемый способ для типовых решений).
• 🖥️ Внешние обработки (например, через механизм ДополнительныеОтчётыИОбработки).
• 🔧 Подписки на события (для динамического изменения форм).

Пример добавления колонки через расширение:

1. Создайте новое расширение (Файл → Новое → Расширение конфигурации).
2. В дереве расширения найдите форму списка нужного объекта и добавьте её в расширение.
3. Отредактируйте форму (добавьте колонку) — изменения применятся поверх основной конфигурации.

Для внешних обработок используйте следующий шаблон (например, для добавления колонки в справочник Номенклатура):

Процедура ДобавитьКолонкуВСписок(Форма)
Колонки = Форма.ЭлементыФормы.Список.Колонки;
НоваяКолонка = Колонки.Добавить("МояКолонка");
НоваяКолонка.Заголовок = "Моя колонка";
НоваяКолонка.ТипЗначения = Новый ОписаниеТипов("Строка");
НоваяКолонка.Выражение = "Объект.Реквизит";
КонецПроцедуры

// Вызов из модуля обработки
ДобавитьКолонкуВСписок(ПараметрыФормы.Форма);

⚠️ Внимание: В 1С:Бухгалтерии 3.0 и 1С:ERP 2.5 некоторые формы списков защищены от изменений через расширения. В этом случае придётся редактировать основную конфигурацию или использовать подписки на события.

7. Особенности для разных версий 1С

Алгоритм добавления колонок может отличаться в зависимости от версии платформы и типа формы. Ниже — ключевые различия:

Для тонкого клиента и веб-клиента учитывайте:

• 🌐 В веб-клиенте не работают некоторые визуальные эффекты (например, условное оформление с градиентами).
• ⚡ Динамическое добавление колонок может вызывать задержки из-за сетевых запросов.
• 🔒 Некоторые свойства колонок (например, ЦветТекста) игнорируются в тонком клиенте.

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

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

1. Динамические колонки по условию

Например, показывать колонку Скидка только для менеджеров отдела продаж:

Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Если Пользователь.Роли.Найти("МенеджерПоПродажам") <> Неопределено Тогда
Колонки = ЭлементыФормы.Список.Колонки;
НоваяКолонка = Колонки.Добавить("Скидка");
НоваяКолонка.Заголовок = "Скидка (%)";
НоваяКолонка.Выражение = "Объект.Скидка";
КонецЕсли;
КонецПроцедуры

2. Колонки с данными из внешних источников

Если нужно подтянуть данные из Excel, API или другой базы, используйте HTTPЗапрос или COMОбъект:

Функция ПолучитьДанныеИзAPI(Ссылка)
Запрос = Новый HTTPЗапрос("https://api.example.com/data");
Запрос.Заголовки.Вставить("Authorization", "Bearer " + ТокенAPI);
Ответ = Запрос.Выполнить();
Данные = JSON.Прочитать(Ответ.ПолучитьТекст());
Возврат Данные.Найти(Ссылка.УникальныйИдентификатор());
КонецФункции

3. Интеграция с 1С:Документооборот или 1С:CRM

// Пример получения данных из CRM
Процедура ЗаполнитьКолонкуCRM(Строка)
ДанныеCRM = ПланыОбмена.CRM.ПолучитьДанные(Строка.Ссылка);
Строка.СтатусCRM = ДанныеCRM.Статус;
КонецПроцедуры

НоваяКолонка = Колонки.Добавить("Активен");
НоваяКолонка.Заголовок = "Активен";
НоваяКолонка.ТипЗначения = Новый ОписаниеТипов("Булево");
НоваяКолонка.ЭлементУправления = Новый ЭлементУправленияФормыФлажок;

Процедура СписокМояКолонкаПриИзменении(Элемент, Строка)
Объект = Строка.Данные;
Объект.Реквизит = Элемент.Значение;
Объект.Записать();
КонецПроцедуры

НоваяКолонка.Картинка = Новый Картинка(ПолучитьФлагСтраны(Объект.Страна));

Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Если МобильноеПриложениеКлиент Тогда
Колонки.Добавить("КраткоеНаименование").Ширина = 80; // Уменьшаем ширину
Колонки.Удалить("ПолноеНаименование"); // Убираем ненужные колонки
КонецЕсли;
КонецПроцедуры