К статье
Практический материал

Другое · 5 мин

Как создать список в 1С: основные способы и проверка

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

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

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

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

Как выбрать вид списка под задачу

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

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

Порядок создания СписокЗначений
  1. 1
    Объявите переменную типа СписокЗначений
  2. 2
    Создайте объект оператором Новый СписокЗначений
  3. 3
    Добавьте значения методом Добавить
  4. 4
    При необходимости укажите представление
  5. 5
    Проверьте содержимое в отладчике или через сообщение

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

Создайте объект через конструктор, добавьте значения и при необходимости представления. Типичная последовательность: объявление переменной, создание экземпляра, заполнение, использование в цикле или передаче на форму.

Пример в серверном и клиентском контексте

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

bsl
Таблица = Новый ТаблицаЗначений;
Таблица.Колонки.Добавить("Код");
Таблица.Колонки.Добавить("Наименование");
Строка = Таблица.Строки.Добавить();
Строка.Код = 1;
Строка.Наименование = "Товар";

Работа с ТаблицаЗначений

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

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

Список выбора на форме

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

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

Контрольные точки

Как проверить результат

Отображение значений в списке
Норма

Значения отображаются корректно

Тревожный признак

Список пуст или показывает не те данные

Работа выбора на форме
Норма

Выбор применяется к документу или отбору

Тревожный признак

Выбор не сохраняется или вызывает ошибку

Выполнение на клиенте и сервере
Норма

Код работает в обоих контекстах

Тревожный признак

Ошибка только в одном из контекстов

Проверка результата и ограничения

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

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

Типичные ошибки
01
Изменение типовой конфигурации без копирования усложняет обновление
02
Смешивание клиентского и серверного кода при работе с формами
03
Загрузка слишком большого объёма данных в СписокЗначений

Частые ошибки и безопасные действия

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

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

Итог

Что важно запомнить

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

Чем СписокЗначений отличается от ТаблицаЗначений?

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

Можно ли создать список прямо в форме без программирования?

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

Что делать, если список не отображается на форме?

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

Безопасно ли менять списки в рабочей базе?

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