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