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