Программное обновление динамического списка в 1С 8.3

Работа со списками в современных версиях платформы 1С:Предприятие 8.3 претерпела значительные изменения с переходом на управляемые формы и систему компоновки данных. Раньше разработчики часто обращались к реквизитам табличной части напрямую, но сегодня основным инструментом управления отображением стал объект ДинамическийСписок. Понимание его внутренней структуры и методов манипуляции необходимо для создания гибких интерфейсов, реагирующих на действия пользователя в реальном времени.

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

Архитектура динамического списка и связь с СКД

В основе любого динамического списка лежит объект КомпоновкаНастроек, который определяет, какие именно данные будут выбраны из базы. Это не просто визуальное представление, а полноценный слой абстракции между запросом к базе данных и табличным документом на экране. Когда вы создаете форму списка, платформа автоматически генерирует макет компоновки, который связывает поля макета с полями запроса.

Ключевым элементом здесь является свойство ИсточникДанных формы. Именно через него система понимает, откуда брать информацию для отрисовки строк. Если вы попытаетесь изменить список, не затрагивая настройки компоновки, результат будет нулевым, так как визуальная часть будет ждать данных в старом формате. Важно осознавать, что ДинамическийСписок — это, по сути, исполняемый запрос, параметры которого можно менять на лету.

Изменение структуры списка программно подразумевает работу с коллекцией настроек. Вы можете добавлять новые поля, скрывать существующие или менять порядок их следования. Однако, просто добавить поле в настройки недостаточно — необходимо убедиться, что это поле существует в исходном запросе или может быть к нему присоединено. Платформа строго следит за соответствием полей макета и полей результата запроса.

⚠️ Внимание: Прямое изменение свойства Запрос динамического списка без использования объекта КомпоновкаНастроек может привести к потере связей с элементами формы. Всегда используйте метод КомпоновщикНастроек для безопасной модификации.

Изменение состава полей через КомпоновщикНастроек

Для добавления или удаления колонок в списке используется объект КомпоновщикНастроек. Этот объект предоставляет удобный интерфейс для работы с настройками СКД. Сначала необходимо получить текущие настройки из динамического списка, загрузить их в компоновщик, внести изменения и затем применить обновленную конфигурацию обратно к списку.

Процесс начинается с получения объекта настроек. Обычно он хранится в свойстве формы НастройкиДинамическогоСписка. После загрузки в компоновщик вы получаете доступ к коллекции Настройки.ПоляВыбора. Именно здесь определяются поля, которые попадут в результат. Добавление нового поля требует указания имени поля в запросе и его заголовка для отображения.

Рассмотрим пример кода, который добавляет новое поле в список. Обратите внимание на использование метода Добавить и необходимость указания источника данных. Если поле берется из основного набора данных, источник указывать не обязательно, но для полей из присоединенных таблиц это критически важно. После изменения коллекции настроек необходимо вызвать метод ПрименитьНастройки.

Компоновщик = Новый КомпоновщикНастроек;
Компоновщик.Инициализировать(ЭлементыФормы.Список.КомпоновкаНастроек);
НовоеПоле = Компоновщик.Настройки.ПоляВыбора.Добавить;
НовоеПоле.Поле = Новый ПолеКомпоновкиДанных("Номенклатура.Артикул");
НовоеПоле.Заголовок ="Артикул товара";
ЭлементыФормы.Список.КомпоновкаНастроек = Компоновщик.ПолучитьНастройки;
ЭлементыФормы.Список.Обновить;

Платформа перестроит запрос и выполнит его заново. Поэтому подобные операции лучше выполнять по событию, а не в цикле или при каждом движении курсора. Оптимизация запроса на стороне СКД также играет важную роль в производительности.

Фильтрация данных и работа с отборами

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

Добавление отбора программно аналогично добавлению поля выбора. Вы обращаетесь к коллекции Настройки.Отборы и создаете новый элемент отбора. В нем необходимо указать поле, тип сравнения (равно, больше, содержит) и значение. Значение может быть константой, ссылкой на параметр или результатом вычисления. Гибкость этого механизма позволяет строить сложные сценарии фильтрации.

При работе с отборами стоит учитывать приоритет условий. Если отборы задаются и в запросе, и в настройках компоновки, они объединяются по логическому «И». Это может привести к тому, что список окажется пустым, если условия противоречат друг другу. Всегда проверяйте итоговый текст запроса через отладчик или вывод в консоль, чтобы убедиться в корректности сформированной конструкции.

Параметр отбора	Тип значения	Описание
Поле	ПолеКомпоновкиДанных	Имя поля, по которому фильтруем
ВидСравнения	ВидСравненияКомпоновкиДанных	Равно, НеРавно, Больше, Меньше и т.д.
Значение	Произвольный	Конкретное значение или параметр
Использование	Булево	Активен ли данный отбор

⚠️ Внимание: При установке отбора по дате убедитесь, что тип значения совпадает с типом поля в базе данных. Попытка сравнить дату со строкой вызовет ошибку выполнения запроса.

Управление параметрами запроса списка

Динамические списки часто используют параметры для передачи контекста. Например, список товаров может зависеть от выбранного склада, который передается как параметр запроса. Программное изменение значения такого параметра — еще один способ обновить содержимое списка без перестройки его структуры. Это наиболее производительный метод фильтрации.

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

Использование параметров предпочтительнее отборов в тех случаях, когда логика выборки заложена в тексте запроса. Это позволяет оптимизировать выполнение запроса на стороне СУБД. Параметры могут быть обязательными или необязательными. Если обязательный параметр не заполнен, запрос не выполнится, и список останется пустым или выдаст ошибку.

Как найти имя параметра в запросе?

Откройте макет компоновки данных в конфигураторе или через объект КомпоновщикНастроек. Перейдите на вкладку"Параметры". Имя, указанное там (например,"ПараметрСклада"), и нужно использовать в коде.

При изменении параметров стоит учитывать типы данных. Если параметр ожидает ссылку на документ, а вы передадите строку, возникнет ошибка преобразования типов. Строгая типизация в 1С 8.3 защищает от многих ошибок, но требует внимательности при программном формировании значений. Используйте конструкторы объектов, такие как Новый УникальныйИдентификатор или Новый ХранилищеЗначения, если это необходимо.

Принудительное обновление и перерисовка формы

После внесения всех необходимых изменений в настройки, отборы или параметры, критически важно вызвать метод Обновить у объекта динамического списка. Без этого вызова визуальная часть формы не узнает о том, что данные изменились, и пользователь видеть старую картину. Этот метод инициирует повторное выполнение запроса и перерисовку таблицы.

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

Если список находится внутри контейнера, например, в Странице или Группе, убедитесь, что видимость этого контейнера не блокирует отображение обновленных данных. Также стоит проверить, не отключено ли обновление формы глобально (свойство БлокировкаВизуализации), что иногда используется для пакетного обновления нескольких элементов.

Типичные ошибки и способы их устранения

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

Другая распространенная ошибка — рассинхронизация имен полей. Если вы переименовали поле в запросе, но забыли обновить имя в настройках компоновки, список перестанет работать. Платформа выдаст сообщение о том, что поле не найдено. Всегда используйте автоподстановку имен в редакторе кода или проверяйте имена через объект метаданных, чтобы избежать опечаток.

Также стоит упомянуть проблему с производительностью при частом обновлении. Если пользователь быстро переключает фильтры, а вы вызываете обновление списка при каждом изменении, интерфейс может стать неотзывчивым. Используйте механизмы отложенного обновления или таймеры, чтобы группировать запросы и выполнять их только когда пользователь закончил ввод данных.

⚠️ Внимание: Интерфейс и методы работы с динамическими списками могут незначительно отличаться в разных версиях платформы 1С и в разных режимах работы (тонкий/веб-клиент). Всегда тестируйте изменения в том клиенте, где будет работать пользователь.

Часто задаваемые вопросы (FAQ)

Как очистить все отборы в списке программно?

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

Можно ли изменить заголовок колонки без изменения имени поля?

Да, это стандартная функция СКД. В настройках поля выбора есть свойство Заголовок. Изменив его в объекте КомпоновщикНастроек, вы поменяете отображаемое имя колонки, при этом внутреннее имя поля для запроса останется прежним.

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

Скорее всего, вы забыли вызвать метод Обновить у объекта динамического списка. Изменение параметра меняет только внутреннее состояние настроек, но не запускает выполнение запроса. Метод Обновить обязателен для применения изменений.

Как добавить поле из присоединенной таблицы?

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

Влияет ли обновление списка на сохраненные варианты отчетов?

Программное изменение настроек в рамках сессии обычно не затрагивает сохраненные варианты отчетов, если вы не вызываете метод сохранения явно. Однако, если пользователь сохранит текущий вид после ваших изменений, новый вариант сохранится с учетом программных правок.