Форма списка в 1С: как создать, настроить и избежать ошибок

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

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

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

1. Выбор объекта метаданных для формы списка

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

• 📋 Справочникам (например, "Номенклатура", "Контрагенты") — самый распространенный вариант;
• 📄 Документам (например, "Заказ покупателя", "Поступление товаров") — для просмотра списка проведенных документов;
• 🗃️ Регистрам сведений/накопления — если требуется анализировать движения или остатки;
• 🔍 Отчетам — когда нужно вывести результаты отчета в интерактивном виде.

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

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

2. Создание формы списка через конструктор

Самый простой способ создать форму списка — воспользоваться встроенным конструктором форм. Для этого:

1. Откройте конфигуратор 1С:Предприятие в режиме редактирования;
2. В дереве метаданных найдите нужный объект (например, справочник "Контрагенты");
3. Кликните правой кнопкой и выберите Добавить → Форма списка;
4. В открывшемся окне конструктора укажите основные параметры:
   • 🔹 Имя формы (например, "СписокКонтрагентовРасширенный");
   • 🔹 Синоним (отображаемое название для пользователей);
   • 🔹 Основная табличная часть (если применимо).

Сгенерированная форма будет содержать:

• 📊 Табличное поле с колонками, соответствующими реквизитам объекта;
• 🔍 Панель фильтра (скрыта по умолчанию, но доступна через настройки);
• ⚙️ Стандартные команды: "Добавить", "Изменить", "Удалить", "Обновить".

Однако автоматически созданная форма редко удовлетворяет всем требованиям. Чаще всего требуется:

• 🔄 Изменить порядок и ширину колонок;
• 👁️ Скрыть ненужные поля;
• 🛠️ Добавить пользовательские команды;
• 🔍 Настроить фильтрацию по дополнительным полям.

3. Ручное редактирование формы: ключевые элементы

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

Для редактирования элементов:

1. Дважды кликните на форму в дереве метаданных;
2. В открывшемся окне редактора перейдите на вкладку Элементы;
3. Выберите нужный элемент (например, ТабличноеПоле1) и настройте его свойства в правой панели.

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

4. Программное формирование списка: когда без кода не обойтись

В некоторых случаях стандартных возможностей конструктора недостаточно. Например, когда нужно:

• 🔗 Объединить данные из нескольких справочников;
• 📊 Отобразить агрегированную информацию (суммы, средние значения);
• 🔍 Реализовать сложную фильтрацию по нескольким критериям;
• 🔄 Динамически изменять состав колонок в зависимости от прав пользователя.

В таких ситуациях требуется программно формировать источник данных для таблицы. Рассмотрим базовый пример для справочника "Номенклатура" с дополнительным полем "Остаток":

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

Запрос.УстановитьПараметр("ДатаОстатков", ТекущаяДата());

Результат = Запрос.Выполнить();
Выборка = Результат.Выбрать();

// Очищаем текущий список
Объект.Список.Очистить();

// Заполняем список данными из запроса
Пока Выборка.Следующий() Цикл
НоваяСтрока = Объект.Список.Добавить();
НоваяСтрока.Ссылка = Выборка.Ссылка;
НоваяСтрока.Наименование = Выборка.Наименование;
НоваяСтрока.Артикул = Выборка.Артикул;
НоваяСтрока.Остаток = Выборка.Остаток;
КонецЦикла;
КонецПроцедуры

Этот код выполняется при открытии формы и формирует список номенклатуры с актуальными остатками. Обратите внимание на:

• 🔹 Использование &НаКлиенте и Процедура ПриСозданииНаСервере — это обеспечивает корректную работу в тонком клиенте;
• 🔹 Параметр &ДатаОстатков — позволяет гибко управлять датой, на которую считаются остатки;
• 🔹 Очистку списка перед заполнением — предотвращает дублирование данных при повторном открытии формы.

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

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

• 🚀 Ограничивайте количество загружаемых данных:
  • Используйте постраничный вывод (свойство РазмерСтраницы табличного поля);
  • Настройте динамическое чтение данных (если поддерживается объектом).
• 🔍 Оптимизируйте запросы:
  • Избегайте выборки ненужных полей (указывайте только те, что отображаются в форме);
  • Используйте индексированные поля в условиях ГДЕ.
• 🎨 Упрощайте интерфейс:
  • Скрывайте редко используемые колонки;
  • Отключайте условное оформление, если оно не критично.

Для форм с особенно большими данными (десятки тысяч строк) рассмотрите возможность:

• 📌 Использования виртуальных таблиц вместо прямых запросов к регистрам;
• 🔄 Реализации ленточной загрузки (подгрузка данных при прокрутке);
• 📊 Перехода на отчеты с СКД, если требуется только просмотр без редактирования.

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

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

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

Отдельного внимания заслуживает проблема с дублированием данных при повторном открытии формы. Это происходит, когда:

1. В процедуре ПриСозданииНаСервере не очищается текущий список;
2. Используется кэширование данных без проверки актуальности;
3. Неправильно настроено свойство АвтоОчистка табличного поля.

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

⚠️ Внимание: Если форма списка используется в веб-клиенте, избегайте сложных клиентских обработчиков событий (например, ПриИзменении для каждой колонки). Это может привести к значительным задержкам из-за сетевых задержек между клиентом и сервером.

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

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

• 🔄 Менять состав колонок в зависимости от ролей пользователей;
• 📊 Группировать данные по произвольным критериям (например, по категориям номенклатуры);
• 🔍 Добавлять вычисляемые поля "на лету".

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

&НаКлиенте
Процедура ПриОткрытии(Отказ)
// Получаем список колонок из настроек пользователя
КолонкиПользователя = ПолучитьНастройкиКолонок(ТекущийПользователь());

// Очищаем текущие колонки
Элементы.ТабличноеПоле1.Колонки.Очистить();

// Добавляем колонки динамически
Для Каждого Колонка Из КолонкиПользователя Цикл
НоваяКолонка = Элементы.ТабличноеПоле1.Колонки.Добавить();
НоваяКолонка.Имя = Колонка.Идентификатор;
НоваяКолонка.Заголовок = Колонка.Наименование;
НоваяКолонка.Ширина = Колонка.Ширина;
НоваяКолонка.Видимость = Колонка.Видимая;
КонецЦикла;
КонецПроцедуры

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

Элементы.ТабличноеПоле1.Группировки.Очистить();
Группировка = Элементы.ТабличноеПоле1.Группировки.Добавить();
Группировка.Поле = "ВидНоменклатуры";
Группировка.Развернута = Истина;

Динамические колонки и группировки особенно полезны для:

• 📈 Аналитических отчетов, где пользователь должен сам выбирать критерии анализа;
• 🔧 Административных панелей с большим количеством параметров;
• 👥 Систем с гибкими ролевыми настройками доступа к данным.

8. Сохранение пользовательских настроек формы

Чтобы пользователи могли настраивать форму списка "под себя" (менять ширину колонок, порядок, видимость), необходимо реализовать механизм сохранения и восстановления настроек. В 1С:Предприятие для этого есть несколько подходов:

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

&НаКлиенте
Процедура ПередЗакрытием(Отказ, СтандартнаяОбработка)
Настройки = Новый Структура;
Для Каждого Колонка Из Элементы.ТабличноеПоле1.Колонки Цикл
Настройки.Вставить(Колонка.Имя, Колонка.Ширина);
КонецЦикла;

СохранитьНастройкиПользователя(ТекущийПользователь(), "ШиринаКолонок", Настройки);
КонецПроцедуры

&НаКлиенте
Процедура ПриОткрытии(Отказ)
Настройки = ВосстановитьНастройкиПользователя(ТекущийПользователь(), "ШиринаКолонок");
Если Не Настройки = Неопределено Тогда
Для Каждого Колонка Из Элементы.ТабличноеПоле1.Колонки Цикл
Если Настройки.Свойство(Колонка.Имя) Тогда
Колонка.Ширина = Настройки[Колонка.Имя];
КонецЕсли;
КонецЦикла;
КонецЕсли;
КонецПроцедуры

ВЫБРАТЬ
Номенклатура.Ссылка КАК Объект,
Номенклатура.Наименование КАК Наименование,
"Номенклатура" КАК ТипОбъекта
ИЗ
Справочник.Номенклатура КАК Номенклатура

ОБЪЕДИНИТЬ ВСЕ

ВЫБРАТЬ
Контрагенты.Ссылка КАК Объект,
Контрагенты.Наименование КАК Наименование,
"Контрагент" КАК ТипОбъекта
ИЗ
Справочник.Контрагенты КАК Контрагенты

&НаКлиенте
Процедура ЭкспортВExcel(Команда)
Excel = Новый ExcelДокумент;
Таблица = Элементы.ТабличноеПоле1;

// Создаем лист
Лист = Excel.Листы.Добавить("Экспорт");
Лист.Ячейка(1,1).Значение = "Экспорт данных из " + ЭтотОбъект.Заголовок;

// Заполняем заголовки
НомерКолонки = 1;
Для Каждого Колонка Из Таблица.Колонки Цикл
Лист.Ячейка(2, НомерКолонки).Значение = Колонка.Заголовок;
НомерКолонки = НомерКолонки + 1;
КонецЦикла;

// Заполняем данные
НомерСтроки = 3;
Для Каждого Строка Из Таблица.Список Цикл
НомерКолонки = 1;
Для Каждого Колонка Из Таблица.Колонки Цикл
Лист.Ячейка(НомерСтроки, НомерКолонки).Значение = Строка[Колонка.Имя];
НомерКолонки = НомерКолонки + 1;
КонецЦикла;
НомерСтроки = НомерСтроки + 1;
КонецЦикла;

// Сохраняем файл
ИмяФайла = КаталогВременныхФайлов() + "Экспорт.xlsx";
Excel.Записать(ИмяФайла);

// Открываем файл
ОткрытьФайл(ИмяФайла);
КонецПроцедуры

Если Не Пользователь.ПроверитьПрава("РедактированиеНоменклатуры") Тогда
Элементы.КоманднаяПанель1.Элементы.Изменить.Видимость = Ложь;
Элементы.КоманднаяПанель1.Элементы.Удалить.Видимость = Ложь;
КонецЕсли;