Как создать список в 1С: от интерфейса до программного кода

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

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

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

Настройка списка на управляемой форме

В современной платформе 1С основным инструментом отображения данных является таблица, привязанная к Основному набору записей (Main Data Set). Чтобы создать список на форме, необходимо перейти в конфигуратор, открыть нужную форму и найти свойство "Основной набор записей". Именно здесь определяется, откуда форма будет брать данные для отображения.

Если вы хотите отобразить данные из существующего справочника или документа, достаточно выбрать соответствующий тип в свойствах набора записей. Система автоматически создаст необходимые колонки, соответствующие полям метаданных. Однако часто требуется вывести вычисляемые поля или данные из нескольких таблиц одновременно. В таких случаях используется Конструктор запроса, который позволяет сформировать виртуальную таблицу результатов.

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

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

Работа с конструктором запросов

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

Первым шагом является выбор таблиц-источников. Вы можете добавить несколько таблиц и установить между ними связи ( joins ). Система автоматически предложит условия соединения по ключевым полям, но их можно изменить вручную. Например, если вам нужно создать список товаров с остатками, вы соедините таблицу Справочник.Номенклатура с регистром накопления ОстаткиТоваров.

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

• 📊 Используйте агрегатные функции (СУММА, КОЛИЧЕСТВО) для создания сводных списков прямо на уровне запроса.
• 🔗 Проверяйте тип соединения (ЛЕВОЕ, ВНУТРЕННЕЕ), чтобы не потерять данные из основной таблицы при отсутствии записей в связанной.
• 🏷️ Давайте понятные имена полям в секции "Заголовок", так как они по умолчанию попадут в шапку колонки таблицы на форме.

После формирования запроса не забудьте нажать кнопку "Автозаполнение выражений". Эта функция автоматически подставит выбранные поля в текстовое представление запроса. Ошибка на этом этапе — частая причина, по которой список на форме оказывается пустым или выдает ошибку выполнения при запуске.

Программное создание списков значений

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

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

Список = Новый СписокЗначений;
Список.Колонки.Добавить("Артикул", Новый ОписаниеТипов("Строка"));
Список.Колонки.Добавить("Цена", Новый ОписаниеТипов("Число"));

Элемент = Список.Добавить();
Элемент.Значение = Справочники.Номенклатура.НайтиПоНаименованию("Товар А");
Элемент.Представление = "Товар А (Арт: 123)";
Элемент.УстановитьЗначение("Цена", 1500.00);

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

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

В чем разница между СписокЗначений и Массив?

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

Тонкая настройка отображения колонок

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

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

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

Параметр настройки	Описание влияния на список	Где настраивается
Ширина колонки	Фиксированная или авто-подбор по содержимому	Свойства таблицы формы
Порядок сортировки	Определяет начальное расположение строк при открытии	Набор записей / Свойства поля
Редактирование	Разрешает или запрещает изменение данных прямо в списке	Свойства поля таблицы
Группировка	Объединяет строки по значению указанного поля	Структура таблицы формы

Не забывайте про заголовки колонок. Автоматически сгенерированные имена полей часто выглядят технически сухо (например, "КоличествоОстаток"). Замените их на понятные пользователю названия в свойстве "Заголовок" поля таблицы. Это значительно повышает юзабилити вашего интерфейса.

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

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

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

Избегайте вычислений в запросе, которые требуют обработки каждой строки программно. Функции вроде ЕСТЬNULL или сложные математические операции лучше выполнять на стороне СУБД, если это возможно. Перенос логики вычислений из запроса в код обработки списка на клиенте резко снижает производительность при большом объеме данных.

• 🚀 Включайте виртуальные таблицы для регистров, чтобы получать агрегированные данные одним запросом вместо цикла.
• 🛑 Избегайте использования ВЫБРАТЬ * в реальных конфигурациях, выбирайте только необходимые поля для уменьшения трафика.
• ⚙️ Настраивайте период по умолчанию в формах отчетов, чтобы ограничивать выборку актуальным промежутком времени.

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

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

Частые ошибки и способы их решения

При создании списков разработчики часто сталкиваются с типовыми проблемами. Одна из самых распространенных — ошибка "Неправильный тип аргумента". Она возникает, когда в запросе поле одного типа (например, Строка) сравнивается или соединяется с полем другого типа (например, Число) без явного приведения.

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

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

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

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

Как добавить кнопку "Еще" к списку на форме?

Кнопки управления списком настраиваются в палитре свойств таблицы. Найдите свойство "Командная панель" и добавьте туда необходимые команды, такие как "Найти", "Изменить", "Копировать" или пользовательские команды из модуля формы.

Можно ли экспортировать список из 1С в Excel?

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

Что делать, если колонки списка "наезжают" друг на друга?

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

Как скрыть техническую колонку "Ссылка" от пользователя?

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