Как программно обновить динамический список в 1С 8

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

Основной инструмент — метод Обновить() таблицы формы, связанной с динамическим списком, либо переустановка параметров или текста запроса самого списка. Выбор способа зависит от того, где выполняется код: в модуле той же формы, в другой форме или во внешнем контексте без интерфейса.

Ниже разобраны рабочие приёмы с примерами кода, условия их применения, ограничения платформы и типичные ошибки, из-за которых список «не обновляется», хотя код выполняется без сообщений об ошибках.

Как обновить динамический список из модуля формы

Самый простой случай — код находится в модуле той же управляемой формы, где расположен список. У элемента формы типа «Таблица», связанного с динамическим списком, есть метод Обновить(), который заставляет платформу перечитать данные:

&НаКлиенте
Процедура ОбновитьСписок(Команда)
Элементы.Список.Обновить();
КонецПроцедуры

Здесь Список — имя элемента формы (таблицы), а не реквизита. Если таблица на форме названа иначе, например СписокДокументов, обращаться нужно по этому имени: Элементы.СписокДокументов.Обновить(). Метод доступен и на клиенте, и на сервере, но чаще вызывается в клиентском контексте — после интерактивных действий пользователя.

Тот же приём работает после программной записи объекта. Например, если в форме списка выполняется массовая установка пометки удаления, после цикла записи достаточно одного вызова Элементы.Список.Обновить(), чтобы пользователь увидел актуальное состояние.

&НаКлиенте
Процедура ОбновитьСписок(Команда)
	Элементы.Список.Обновить();
КонецПроцедуры

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

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

&НаСервере
Процедура УстановитьПериодНаСервере()
Список.Параметры.УстановитьЗначениеПараметра("НачалоПериода", НачалоДня(ТекущаяДатаСеанса()));
Список.Параметры.УстановитьЗначениеПараметра("КонецПериода", КонецДня(ТекущаяДатаСеанса()));
КонецПроцедуры

Здесь Список — реквизит формы типа «ДинамическийСписок». Само по себе изменение параметра заставляет платформу перевыполнить запрос, отдельный вызов Обновить() обычно не требуется. Это важное отличие: при смене параметра список перечитывается автоматически.

Аналогично можно изменить сам текст запроса через свойство Список.ТекстЗапроса, если включён режим произвольного запроса. После присвоения нового текста список также перестраивается сам. Однако злоупотреблять этим не стоит: смена текста запроса сбрасывает динамическое считывание и может заметно нагрузить базу при больших таблицах.

Как обновить список из другой формы через оповещения

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

&НаКлиенте
Процедура ПослеЗаписиДокумента()
ОповеститьОбИзменении(Тип("ДокументСсылка.РеализацияТоваровУслуг"));
КонецПроцедуры

Все открытые динамические списки, основная таблица которых соответствует указанному типу, получат оповещение и перечитают данные. Это штатный механизм платформы: именно так формы объектов уведомляют списки при интерактивной записи.

Второй вариант — метод Оповестить() с произвольным именем события. Форма списка подписывается на событие в обработчике ОбработкаОповещения и выполняет обновление:

// В форме, инициирующей обновление:
Оповестить("ИзмененыДанныеРегистраОстатков");

// В форме списка:
&НаКлиенте
Процедура ОбработкаОповещения(ИмяСобытия, Параметр, Источник)
Если ИмяСобытия = "ИзмененыДанныеРегистраОстатков" Тогда
Элементы.Список.Обновить();
КонецЕсли;
КонецПроцедуры

Этот подход нужен, когда список построен на произвольном запросе по нескольким таблицам или на виртуальной таблице регистра: ОповеститьОбИзменении() для таких списков может не сработать, потому что платформа не всегда может связать тип изменённых данных с источником списка.

1. 1
   Определите, какие данные изменил ваш код: конкретный объект, тип объектов или таблицу произвольного запроса.
2. 2
   Если изменён объект известного типа — вызовите ОповеститьОбИзменении() с типом или ссылкой.
3. 3
   Если список построен на произвольном запросе — вызовите Оповестить() с уникальным именем события.
4. 4
   В форме списка добавьте ОбработкаОповещения и вызовите Элементы.Список.Обновить() по нужному событию.
5. 5
   Проверьте: откройте список, выполните изменение, убедитесь, что строки перечитались без переоткрытия формы.

Обновление после фонового задания и длительной операции

Отдельный сценарий — данные меняются в фоновом задании или на сервере в длительной операции, а форма списка в это время открыта у пользователя. Фоновое задание не имеет доступа к клиентскому контексту и не может ни вызвать Обновить(), ни отправить оповещение напрямую.

Решение — вернуть из фонового задания признак завершения (в типовых механизмах БСП это длительные операции с обработчиком ожидания) и в клиентском обработчике завершения вызвать обновление списка:

&НаКлиенте
Процедура ОбработатьЗавершениеФоновогоЗадания(Результат, ДополнительныеПараметры) Экспорт
Если Результат <> Неопределено Тогда
Элементы.Список.Обновить();
КонецЕсли;
КонецПроцедуры

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

Почему список не обновляется: типичные причины

Наиболее частая причина «неработающего» обновления — обращение не к тому имени. Элементы.Список — это элемент формы, а Список без Элементы — реквизит формы. У реквизита нет метода Обновить(); попытка вызвать Список.Обновить() приведёт к ошибке. Проверьте в конфигураторе фактическое имя таблицы формы.

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

Третья причина — список с произвольным запросом и собственной настройкой отбора, который перекрывает новые строки. Данные в базе есть, запрос перечитывается, но новая строка не попадает под условия отбора. Проверяйте Список.Отбор и пользовательские настройки, прежде чем искать ошибку в коде обновления.

Сравнение способов обновления

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

На практике эти приёмы комбинируются: например, после записи объекта вызывается ОповеститьОбИзменении(), а форма списка с произвольным запросом дополнительно подписана на пользовательское событие.

Как проверить, что обновление сработало

Простой тест: откройте форму списка, в соседнем сеансе или через обработку измените данные одной строки, затем выполните ваш код обновления. Строка должна отразить новое значение без закрытия и повторного открытия формы. Если значение не изменилось — проверьте имя элемента формы и отборы списка.

Для оповещений полезно временно добавить в обработчик ОбработкаОповещения вывод сообщения с именем события: так видно, доходит ли оповещение до формы вообще. Если событие приходит, а список не меняется — проблема в отборе или в тексте запроса, а не в механизме обновления.

Частые вопросы