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