Другое · 5 мин
Как создать список в 1С: основные способы и проверка
Создание списков в 1С: СписокЗначений, ТаблицаЗначений и списки выбора в формах. Пошаговые действия, проверка результата, ограничения и типичные ошибки.
В терминологии 1С под «списком» могут понимать разные объекты: набор значений в памяти, таблицу значений, элемент выбора на форме или динамический список данных. Перед созданием нужно определить, где список будет использоваться: в модуле обработки, отчёта, документа или в форме пользователя.
Основные способы создания списка встроенным языком: СписокЗначений для простого набора пар «значение — представление», ТаблицаЗначений для структурированных данных с колонками, атрибут формы типа Список для выбора пользователем и динамический список для отбора по данным информационной базы.
Если вы меняете конфигурацию, работайте на копии базы или в изолированной среде. Правки в типовой конфигурации могут осложнить обновление и поддержку, поэтому самостоятельные изменения допустимы только после оценки рисков и согласования с администратором системы.
Как выбрать вид списка под задачу
СписокЗначений подходит, когда нужно временно держать в памяти простой перечень: варианты отбора, статусы, значения параметров. У него нет встроенных колонок, кроме значения и представления, поэтому для сложных данных он становится неудобным.
ТаблицаЗначений выбирайте, если нужны несколько колонок, строки с разными типами данных или последующая выгрузка в отчёт. Динамический список удобен для работы с данными из базы, но требует настройки источника и понимания режима выполнения кода.
- 1Объявите переменную типа СписокЗначений
- 2Создайте объект оператором Новый СписокЗначений
- 3Добавьте значения методом Добавить
- 4При необходимости укажите представление
- 5Проверьте содержимое в отладчике или через сообщение
Создание СписокЗначений в модуле
Создайте объект через конструктор, добавьте значения и при необходимости представления. Типичная последовательность: объявление переменной, создание экземпляра, заполнение, использование в цикле или передаче на форму.
Пример в серверном и клиентском контексте
Код на сервере и на клиенте может вести себя по-разному при доступе к формам и данным. Проверяйте, где выполняется процедура, прежде чем привязывать список к элементу управления.
Таблица = Новый ТаблицаЗначений;
Таблица.Колонки.Добавить("Код");
Таблица.Колонки.Добавить("Наименование");
Строка = Таблица.Строки.Добавить();
Строка.Код = 1;
Строка.Наименование = "Товар";Работа с ТаблицаЗначений
Сначала создайте таблицу, затем добавьте колонки методами Колонки.Добавить, указав имена и при необходимости типы. Строки добавляются методом Строки.Добавить, после чего заполняются ячейки по именам колонок.
Для чтения используйте циклы по строкам и обращение к ячейкам через индекс или имя колонки. Если структура заранее неизвестна, проверяйте наличие колонки перед обращением, чтобы избежать ошибки выполнения.
Список выбора на форме
В управляемой форме создайте атрибут с типом Список или справочник, добавьте элемент управления «Список выбора» и свяжите его с атрибутом. Заполнение может выполняться при открытии формы или по действию пользователя.
Обратите внимание на режим редактирования: список может быть доступен только для чтения или позволять ввод собственных значений. Настройка зависит от свойств элемента и типа атрибута в конкретной конфигурации.
Как проверить результат
Значения отображаются корректно
Список пуст или показывает не те данные
Выбор применяется к документу или отбору
Выбор не сохраняется или вызывает ошибку
Код работает в обоих контекстах
Ошибка только в одном из контекстов
Проверка результата и ограничения
После создания списка убедитесь, что значения отображаются в нужном порядке, пустые элементы не ломают логику отбора, а при выборе происходит ожидаемое действие. Проверьте поведение как на клиенте, так и на сервере, если код вызывается из обоих контекстов.
Ограничения связаны с объёмом данных в памяти, правами доступа и блокировками объектов. Не загружайте в СписокЗначений или ТаблицаЗначений большие массивы без необходимости: это может замедлить работу и привести к превышению ресурсов сеанса.
Частые ошибки и безопасные действия
Частая ошибка — попытка изменить типовой объект без копирования конфигурации, что затрудняет обновление. Другая — смешивание клиентского и серверного кода при работе с формами, из-за чего список не отображается или выбор не применяется.
Не вносите изменения в рабочую базу без резервной копии. Если не уверены в влиянии правки, сначала проверьте на тестовой копии и зафиксируйте ожидаемый результат перед вводом в эксплуатацию.
Что важно запомнить
Выбирайте тип списка по задаче, создавайте его в модуле, проверяйте на копии базы и учитывайте режим выполнения кода.
Чем СписокЗначений отличается от ТаблицаЗначений?
СписокЗначений хранит простые пары значения и представления без фиксированных колонок, а ТаблицаЗначений позволяет задать несколько колонок, типы и структурированные строки. Выбор зависит от того, нужна ли табличная структура или достаточно простого перечня.
Можно ли создать список прямо в форме без программирования?
В некоторых конфигурациях элементы списка настраиваются через свойства атрибута формы или справочник без кода, но заполнение и динамическое изменение обычно требуют модуля формы. Точные возможности зависят от конфигурации.
Что делать, если список не отображается на форме?
Проверьте связь элемента управления с атрибутом, режим выполнения кода и права доступа к данным. Также убедитесь, что список заполнен перед открытием формы или в нужном событии, например при открытии или при изменении другого реквизита.
Безопасно ли менять списки в рабочей базе?
Прямые изменения в рабочей базе небезопасны без резервной копии и тестирования. Сначала отработайте сценарий на копии, оцените влияние на обновление конфигурации и согласуйте правки с администратором системы.