Как вывести список значений на форму 1С

Разработка функциональных и удобных интерфейсов в системе 1С:Предприятие — это фундамент качественного взаимодействия пользователя с программным продуктом. Часто возникает задача, когда необходимо отобразить на форме не один объект, а целый перечень данных для выбора, просмотра или последующей обработки. Для этих целей идеально подходит структура данных, известная как список значений. Это универсальный контейнер, позволяющий хранить пары «Значение» и «Представление», что делает его незаменимым при создании выпадающих списков, таблиц выбора и древовидных структур.

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

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

Создание реквизита формы для хранения списка

Первым и самым важным шагом является подготовка места для хранения данных. Форма в 1С не хранит данные сама по себе, она оперирует реквизитами. Для размещения списка значений нам необходимо добавить новый реквизит непосредственно в форму, а не в объект метаданных. Откройте конструктор формы в конфигураторе и перейдите на вкладку «Реквизиты».

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

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

⚠️ Внимание: Убедитесь, что свойство «Редактирование» у таблицы установлено в нужное значение. Если список должен быть доступен только для просмотра, установите значение «Нет», иначе пользователь сможет изменять данные прямо в ячейках, что может привести к ошибкам логики.

Заполнение списка значений в модуле формы

Теперь, когда структура готова, необходимо наполнить её данными. Это делается в модуле формы, чаще всего в обработчике события ПриСозданииНаСервере или ПриОткрытии, в зависимости от того, когда именно данные должны быть загружены. Использование серверного контекста предпочтительнее для тяжелых выборок из базы данных.

Для заполнения используется метод Добавить объекта СписокЗначений. Этот метод принимает два основных параметра: само значение (которое может быть ссылкой, числом, строкой) и его строковое представление, которое увидит пользователь. Рассмотрим пример кода, демонстрирующий базовый принцип работы:

Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)

// Очищаем список перед заполнением, если нужно
Объект.СписокДанных.Очистить();

// Добавляем элементы
Объект.СписокДанных.Добавить(СсылкаНаЭлемент1, "Наименование элемента 1");
Объект.СписокДанных.Добавить(СсылкаНаЭлемент2, "Наименование элемента 2");

КонецПроцедуры

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

Настройка отображения колонок в таблице

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

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

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

Как добавить вторую колонку в СписокЗначений?

Технически тип СписокЗначений предназначен для пары Значение-Представление. Для вывода нескольких колонок разработчики часто используют хитрость: в поле «Представление» записывают конкатенацию данных (Код + Наименование), либо используют динамический список, который по сути является таблицей значений, привязанной к форме.

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

Использование динамических списков как альтернатива

В современной платформе 1С:Предприятие 8.3 и выше существует мощный механизм — Динамические списки. Они позволяют выводить данные на форму без написания кода для выборки из базы. Система сама формирует запрос на основе настроек. Это часто является более предпочтительным решением по сравнению с ручным заполнением СпискаЗначений.

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

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

Характеристика	Список Значений	Динамический Список
Источник данных	Заполняется вручную в коде	Автоматический запрос к БД
Производительность	Зависит от объема данных в памяти	Оптимизирован платформой
Гибкость	Высокая (любые вычисления)	Ограничена структурой БД
Сложность настройки	Требует написания кода	Настраивается в конструкторе

Обработка событий и взаимодействие с пользователем

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

Наиболее часто используемое событие — ПриВыборе или ТекущаяСтрокаПриИзменении. В обработчике вы получаете доступ к текущей строке списка и можете извлечь из неё значение. Поскольку в СпискеЗначений значение хранится отдельно от представления, вы можете получить ссылку на объект базы данных без дополнительного поиска по имени.

Процедура СписокДанныхПриВыборе(Элемент)

// Получаем текущую строку
ВыбраннаяСтрока = Объект.СписокДанных.ТекущаяСтрока;

Если ВыбраннаяСтрока <> Неопределено Тогда
// Извлекаем значение (например, ссылку на контрагента)
Контрагент = ВыбраннаяСтрока.Значение;

// Записываем в основной реквизит формы
Объект.Контрагент = Контрагент;
КонецЕсли;

КонецПроцедуры

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

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

Оптимизация и типичные ошибки

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

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

• 🚀 Кэширование: Если список данных редко меняется, сохраните его в переменную модуля или во временное хранилище, чтобы не формировать его при каждом открытии формы.
• 🧹 Очистка: Всегда очищайте список перед повторным заполнением, если логика работы формы подразумевает многократное обновление данных за одну сессию.
• 🔍 Поиск: Для больших списков включите стандартную панель поиска в свойствах таблицы формы, это значительно улучшит пользовательский опыт.

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

Можно ли сортировать СписокЗначений на форме?

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

Как передать СписокЗначений из формы в отчет?

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

В чем разница между Значением и Представлением?

Значение — это фактические данные (например, ссылка на документ или число), с которыми работает программа. Представление — это строковое отображение этих данных для пользователя (например, "Счет-фактура №5 от 01.01.2026"). В списке значений они хранятся парой для удобства.

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

СписокЗначений — это статическая копия данных на момент заполнения. Он не связан напрямую с базой данных в реальном времени. Чтобы обновить информацию, необходимо повторно вызвать процедуру заполнения списка, обычно это делается по кнопке «Обновить» или при изменении периодов отчета.