Как сформировать список в 1С: Руководство для пользователей

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

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

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

Базовые понятия и типы списков в 1С

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

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

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

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

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

Формирование списка с помощью объекта Запрос

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

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

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

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
| Номенклатура.Ссылка КАК Товар,
| Номенклатура.Наименование КАК Название,
| Номенклатура.Цена КАК Стоимость
|ИЗ
| Справочник.Номенклатура КАК Номенклатура
|ГДЕ
| Номенклатура.ЭтоГруппа = ЛОЖЬ";

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

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

Настройка полей и колонок таблицы значений

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

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

Также на этом этапе задаются типы данных для каждой колонки. Хотя 1С часто определяет их автоматически, явное указание типов (например, Число(15, 2) для денег или Строка(50) для текста) помогает избежать ошибок при последующей записи данных или экспорте в Excel.

Имя поля в коде	Заголовок для пользователя	Тип данных	Пример значения
Товар_Ссылка	Код товара	СправочникСсылка.Номенклатура	0000-00054
Товар_Наименование	Наименование	Строка(100)	Молоко 3.2%
ОстатокНаСкладе	Остаток, шт.	Число(15, 0)	150
ЦенаЗакупки	Цена закупки, руб.	Число(15, 2)	45.50

Для изменения заголовка колонки используется свойство Заголовок объекта колонки. Например, конструкция ТаблицаСписка.Колонки.Наименование.Заголовок = "Название продукта" мгновенно изменит отображение в интерфейсе без изменения логики работы программы.

Как добавить вычисляемое поле в таблицу?

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

Применение отборов и динамическая фильтрация

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

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

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

• 🔍 Отбор в запросе: Идеален для первичной выборки больших массивов данных. Требует пересборки запроса при изменении условий.
• ⚡ Отбор таблицы значений: Мгновенная фильтрация на клиенте. Не создает нагрузки на СУБД, но требует, чтобы все данные уже были загружены.
• 🛠 Динамические параметры: Позволяют передавать значения переменных (например, дату начала периода) внутрь запроса через объект Запрос.Параметры.

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

⚠️ Внимание: Если вы используете отбор по дате, всегда проверяйте часовой пояс и время. Часто пользователи забывают, что дата "01.01.2026" в 1С может трактоваться как "01.01.2026 00:00:00", и записи, созданные в течение этого дня, могут не попасть в выборку, если условие строгое. Используйте функцию КонецДня() или диапазон дат.

Визуализация списка на форме и взаимодействие

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

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

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

&НаКлиенте
Процедура ТаблицаСпискаПриВыборе(Элемент)
Перем ФормаОбъекта;

Если ТаблицаСписка.ТекущиеДанные.Товар.ЭтоГруппа() Тогда
Возврат;
КонецЕсли;

Параметры = Новый Структура;
Параметры.Вставить("Ключ", ТаблицаСписка.ТекущиеДанные.Товар);
ОткрытьФорму("Справочник.Номенклатура.ФормаОбъекта", Параметры, Элемент);
КонецПроцедуры

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

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

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

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

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

• 🚀 Виртуальные таблицы: Для остатков, движений и регистров всегда используйте виртуальные таблицы срезов. Они оптимизированы платформой 1С и работают быстрее ручных запросов к таблицам движений.
• 📉 Ограничение выборки: Реализуйте механизм "ленивой загрузки" или ограничьте количество строк по умолчанию (например, первые 500 записей), предлагая пользователю уточнить отбор для просмотра остальных.
• 💾 Кэширование: Если данные списка меняются редко (справочники городов, валют), используйте кэширование на клиенте или в общих модулях, чтобы не делать запрос к базе при каждом открытии формы.

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

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

Как добавить новую колонку в уже сформированный список без изменения запроса?

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

Почему список загружается очень долго, хотя записей немного?

Чаще всего проблема кроется в отсутствии индексов по полям, участвующим в отборе (ГДЕ) или соединении таблиц (СОЕДИНЕНИЕ). Также причиной может быть выборка больших текстовых полей или полей типа "ХранениеДанных". Проверьте текст запроса через консоль запросов и проанализируйте план выполнения.

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

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

Как экспортировать сформированный список в Excel?

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

В чем разница между ТаблицейЗначений и РегистромСведений для хранения списков?

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