Как добавить колонку с «галочками» в Динамический список на управляемой форме?

При работе с ДинамическимСписком на управляемых формах разработчики часто сталкиваются с задачей добавления интерактивных элементов, например, «галочек» для выбора строк. На первый взгляд кажется, что достаточно просто добавить реквизит в форму, но архитектура ДинамическогоСписка имеет свои особенности, которые мы сейчас подробно разберем.

Почему не получается просто добавить реквизит?

Важно понимать, что ДинамическийСписок — это не ТаблицаЗначений. Это объект, который получает данные напрямую из базы данных с помощью Запроса. Он работает в режиме «ленивой подгрузки», то есть выгружает данные порциями по мере их прокрутки пользователем. По этой причине:

• Вы не можете просто добавить «виртуальную» колонку в список, так как у ДинамическогоСписка нет локального хранилища для изменений, внесенных пользователем.
• Любые данные, которые отображаются в списке, должны быть описаны в Запросе самого списка.
• Если добавить реквизит формы, не связанный с запросом, он не станет частью строк списка, так как он существует отдельно от процесса выборки данных.

Метод первый: Использование вспомогательной таблицы для хранения состояний

Если вам нужно реализовать механизм выбора (отметки строк галочками), мы рекомендуем использовать следующий подход:

1. Создайте на форме ТаблицуЗначений, в которой будут храниться ссылки на выбранные строки (ключи).
2. При нажатии на «галочку» в списке, вы программно записываете или удаляете ключ выбранной записи в эту ТаблицуЗначений.
3. При необходимости сохранения результата, вы просто обращаетесь к этой таблице и выполняете нужные действия (например, запись в регистр или проведение документов).

Метод второй: Хранение состояний в базе данных (оптимальный для больших объемов)

Для профессиональной реализации, где требуется сохранение состояния отметок даже при перелистывании страниц, мы разберем использование промежуточного хранения:

Рассмотрим вариант с использованием временного регистра или специализированной таблицы. Логика работы следующая:

1. Создаем непериодический РегистрСведений, который служит «буфером» для отметок текущего пользователя.
2. В Запросе ДинамическогоСписка используем ЛЕВОЕ СОЕДИНЕНИЕ (LEFT JOIN) с этим регистром по ключу строки.
3. В запросе создаем вычисляемое поле, например:

ВЫБРАТЬ
    РС.Ссылка КАК Ссылка,
    ВЫБОР
        КОГДА ВыбранныеЗаписи.Ссылка ЕСТЬ NULL ТОГДА ЛОЖЬ
        ИНАЧЕ ИСТИНА
    КОНЕЦ КАК Отметка
ИЗ
    РегистрСведений.НашРегистр КАК РС
    ЛЕВОЕ СОЕДИНЕНИЕ РегистрСведений.ВременныеОтметки КАК ВыбранныеЗаписи
    ПО РС.Ссылка = ВыбранныеЗаписи.Ссылка

При таком подходе при установке галочки вы просто добавляете или удаляете запись из ВременныеОтметки и вызываете метод Список.Обновить(). Это гарантирует корректную работу с постраничным выводом данных.

Основные рекомендации по реализации

Разберем, на что стоит обратить внимание при внесении правок в готовый функционал:

• Не модифицируйте основные данные. Если галочка нужна только на время сеанса, используйте временные таблицы или коллекции на стороне клиента, чтобы не «мусорить» в основной базе.
• Правильно выбирайте источник данных. Если объем данных в вашем регистре невелик (до нескольких сотен записей), возможно, стоит отказаться от ДинамическогоСписка в пользу ТаблицыЗначений. Это позволит вам работать с данными как с обычной коллекцией объектов.
• Анализируйте структуру запроса. Если список основан на сложном ПроизвольномЗапросе, обязательно проверьте, не собирается ли он в общих модулях, чтобы ваши изменения не были затерты при обновлении конфигурации.

Таким образом, для решения задачи добавления «галочки» мы рекомендуем начать с анализа объема данных. Если данных много — используйте ЛЕВОЕ СОЕДИНЕНИЕ с временной таблицей, если мало — используйте ТаблицуЗначений на форме. Это избавит вас от множества «костылей» и обеспечит стабильную работу интерфейса.