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