К статье
Практический материал

Другое · 8 мин

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

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

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

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

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

Когда программное обновление требуется

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

Отдельные сценарии

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

Объекты и свойства динамического списка

Для работы с динамическим списком используют элемент формы и его свойства: отбор, параметры отбора, сортировка, текущая строка, количество строк и выделенные строки. Отбор задаёт условия выборки, параметры передают значения в запрос или компоновку данных, сортировка определяет порядок строк. Текущая строка показывает, какая запись активна после обновления.

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

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

На клиенте порядок обычно следующий: получить элемент формы по имени, заполнить значения параметров отбора, при необходимости задать сортировку, вызвать метод обновления списка, затем проверить количество строк и установить нужную текущую строку. Если список привязан к данным формы, изменения в источниках должны быть сохранены перед обновлением, иначе новая версия не попадёт в выборку.

Порядок действий на клиенте
  1. 1
    Получить элемент динамического списка по имени формы
  2. 2
    Задать значения отбора и параметров отбора
  3. 3
    Вызвать метод обновления списка
  4. 4
    Проверить количество строк и наличие данных
  5. 5
    Установить текущую строку при необходимости

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

Обновление из серверного модуля

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

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

Проверка результата и границы безопасной работы

Признак успешного обновления: количество строк изменилось в соответствии с отбором, текущая строка указывает на существующую запись, а пользователь видит актуальные данные без сообщений об ошибках. Если количество строк равно нулю при ожидаемых данных, проверьте значения параметров отбора, права доступа и фильтры на уровне источника. Не полагайтесь только на отсутствие исключения: код может выполниться без ошибки, но список не обновиться из-за неверного контекста.

Типичные ошибки
01
Вызов обновления до заполнения параметров отбора: список не меняется или показывает все строки
02
Ожидание, что серверный код сам обновит клиентский список без клиентской процедуры
03
Удаление текущей строки сразу после обновления: текущая запись становится недействительной
04
Обновление списка в цикле при каждом изменении данных: существенное замедление работы формы

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

Типичные ошибки и ограничения

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

Контрольные точки

Как проверить результат

Количество строк после обновления
Норма

Соответствует ожидаемому отбору

Тревожный признак

Ноль строк или прежнее значение при ожидаемых данных

Текущая строка
Норма

Указывает на существующую запись

Тревожный признак

Пустая или удалённая запись

Отображение данных
Норма

Актуальные значения без ошибок

Тревожный признак

Устаревшие остатки или сообщения о доступе

Альтернативы и когда обновлять не нужно

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

Выбирайте способ обновления в зависимости от объёма данных, частоты изменений и места выполнения кода. Маленькие справочники удобно обновлять на клиенте, большие регистры — через серверную выборку с последующим применением на клиенте. Всегда проверяйте результат на копии базы перед вводом в эксплуатацию.

Итог

Что важно запомнить

Обновляйте динамический список на клиенте после задания отбора, выполняйте тяжёлую выборку на сервере, проверяйте количество строк и текущую запись, а критические изменения проверяйте на копии базы.

Нужно ли обновлять список после каждого изменения поля фильтра?

Не обязательно. Лучше обновить по кнопке или после небольшой задержки, чтобы не нагружать сервер частыми запросами при каждом нажатии клавиши.

Может ли серверный модуль напрямую обновить список на клиентской форме?

Непрямо нет. Сервер может подготовить данные и вернуть их клиенту, а клиентская процедура применяет результат к элементу формы и вызывает обновление.

Что проверить, если список не обновился без ошибки?

Проверьте значения параметров отбора, права на источник данных, контекст выполнения клиент/сервер и то, что форма не модальна и не блокирует редактирование.

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

Не рекомендуется. Возможны проблемы согласованности данных и отображение устаревших остатков; обновляйте после завершения проведения на тестовой копии базы.