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