Обновление таблицы формы в 1С: 5 проверенных методов с примерами кода

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

В этой статье мы разберём 5 основных способов обновления таблиц в формах 1С 8.3 (актуально для версий 8.3.20+), включая нюансы работы с управляемыми и обычными формами. Особое внимание уделим типичным ошибкам, которые приводят к зависанию интерфейса или потере данных при массовом обновлении, и покажем, как их избежать. Материал будет полезен как начинающим программистам 1С, так и опытным специалистам, ищущим оптимальные решения для крупных баз.

1. Когда требуется обновление таблицы формы?

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

• 📄 Изменение данных в источнике: пользователь отредактировал справочник или документ, а таблица в форме отображает устаревшие сведения (например, цены в прайс-листе).
• 🔄 Программная модификация: скрипт изменил значения в регистре сведений, но форма не отреагировала автоматически.
• 🖥️ Смена контекста: переход между записями в журнале документов, когда табличная часть должна показать данные текущего объекта.
• 🚀 Динамические фильтры: пользователь применил фильтр в форме, и таблица должна перестроиться с учётом новых условий.

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

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

2. Способ 1: Метод «Обновить» — базовый подход

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

Пример кода для управляемой формы:

Процедура ОбновитьТаблицуТоваров(Команда)
ЭлементыФормы.ТаблицаТоваров.Обновить;
КонецПроцедуры

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

Процедура ОбновитьТаблицу(Команда)
ЭлементыФормы.ТабличнаяЧасть.Обновить(Истина); // Параметр"Истина" принудительно сбрасывает кэш
КонецПроцедуры

Преимущества метода:

• ✅ Простота реализации — одна строка кода.
• ✅ Работает как в управляемых, так и в обычных формах.
• ✅ Автоматически учитывает текущие фильтры и настройки таблицы.

Однако есть и ограничения:

• ⚠️ Полная перерисовка: если таблица содержит тысячи строк, обновление может занять заметное время.
• ⚠️ Потеря выделения: текущая выделенная строка сбрасывается.
• ⚠️ Нет контроля за данными: нельзя выбрать, какие именно строки обновить.

Для оптимизации производительности в больших таблицах можно комбинировать Обновить с ОтключитьОбработкуСобытий:

ЭлементыФормы.Таблица.ОтключитьОбработкуСобытий(Истина);
ЭлементыФормы.Таблица.Обновить;
ЭлементыФормы.Таблица.ВключитьОбработкуСобытий(Истина);

3. Способ 2: Перезаполнение таблицы через запрос

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

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

Пример реализации:

Процедура ОбновитьОстатки(Команда)
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
| Товар.Наименование КАК Товар,
| Склад.Наименование КАК Склад,
| РегистрыНакопления.ОстаткиТоваров.КоличествоОстаток КАК Остаток
|ИЗ
| РегистрНакопления.ОстаткиТоваров.Остатки(&ДатаОтчета, ) КАК РегистрыНакопления.ОстаткиТоваров
| ЛЕВОЕ СОЕДИНЕНИЕ Справочник.Товары КАК Товар
| ПО РегистрыНакопления.ОстаткиТоваров.Товар = Товар.Ссылка
| ЛЕВОЕ СОЕДИНЕНИЕ Справочник.Склады КАК Склад
| ПО РегистрыНакопления.ОстаткиТоваров.Склад = Склад.Ссылка";

Запрос.УстановитьПараметр("ДатаОтчета", ЭлементыФормы.ДатаОтчета.Значение);
РезультатЗапроса = Запрос.Выполнить;

ЭлементыФормы.ТаблицаОстатков.Очистить;
Выборка = РезультатЗапроса.Выбрать;

Пока Выборка.Следующий Цикл
НоваяСтрока = ЭлементыФормы.ТаблицаОстатков.Добавить;
НоваяСтрока.Товар = Выборка.Товар;
НоваяСтрока.Склад = Выборка.Склад;
НоваяСтрока.Остаток = Выборка.Остаток;
КонецЦикла;
КонецПроцедуры

Ключевые моменты:

• 🔹 Очистка таблицы: перед заполнением удаляем старые данные методом Очистить.
• 🔹 Параметры запроса: обязательно обновляем параметры (в примере — &ДатаОтчета).
• 🔹 Производительность: для больших выборок используйте ПакетныйРежим.

Использовать индексированные поля в условиях|Ограничивать количество возвращаемых колонок|Применять РАЗЛИЧНЫЕ для устранения дублей|Настраивать пакетную обработку для больших данных-->

Этот метод даёт максимальный контроль над данными, но требует больше кода. Он незаменим, когда:

• 📊 Таблица формируется из нескольких источников (например, объединение данных из справочников и регистров).
• 🔧 Нужно применить сложную логику фильтрации, которую нельзя задать в свойствах таблицы.
• 🔄 Данные зависят от динамических параметров (например, текущего пользователя или ролей).

⚠️ Внимание: При частом обновлении таблиц через запросы в клиент-серверном режиме следите за нагрузкой на сервер. Чрезмерное количество запросов может привести к блокировке сеансов других пользователей. Используйте НачатьТранзакцию и ЗафиксироватьТранзакцию для группировки операций.

4. Способ 3: Обновление отдельных строк (частичное)

Если в таблице изменились только некоторые строки (например, пользователь отредактировал цену одного товара), нет смысла перечитывать все данные. В этом случае эффективнее обновить только.

Для этого можно использовать:

1. Прямое изменение значений через свойства строки.
2. Метод ОбновитьСтроку (для управляемых форм).
3. Перезагрузку данных для конкретной строки через источник.

Пример 1: Изменение значения в ячейке

// Предположим, что в таблице изменилась цена товара в строке с индексом 3
ТекущаяСтрока = ЭлементыФормы.ТаблицаТоваров.Получить(3);
ТекущаяСтрока.Цена = НоваяЦена;

Пример 2: Обновление строки через источник (если данные привязаны к объекту)

Процедура ОбновитьСтрокуТовара(СтрокаТаблицы)
Товар = СтрокаТаблицы.Товар; // Получаем ссылку на товар
ДанныеТовара = Товар.ПолучитьОбъект; // Перечитываем актуальные данные
СтрокаТаблицы.Цена = ДанныеТовара.Цена;
СтрокаТаблицы.Остаток = ДанныеТовара.Остаток;
КонецПроцедуры

Преимущества частичного обновления:

Когда использовать частичное обновление:

• 🔍 Таблица содержит более 100 строк, и изменяется только 1-2 из них.
• 🎯 Нужно сохранить текущее положение курсора или выделение.
• ⚡ Требуется максимальная производительность (например, в высоконагруженных системах).

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

5. Способ 4: Использование событий формы

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

Основные события, которые можно использовать:

• 📥 ПриИзменении — срабатывает при изменении реквизита, связанного с таблицей.
• 🔄 ПередОбновлением / ПриОбновлении — для контроля процесса обновления.
• 🖱️ ПриАктивизацииСтроки — полезно для динамической подгрузки данных при выборе строки.

Пример: Автоматическое обновление таблицы при изменении даты

Процедура ДатаОтчетаПриИзменении(Элемент)
ЭлементыФормы.ТаблицаОстатков.Обновить;
КонецПроцедуры

Пример с дополнительной логикой (проверка изменений):

Процедура ТаблицаТоваровПередОбновлением(Элемент, Отказ)
Если НЕ ЗначениеЗаполнено(ЭлементыФормы.Склад.Значение) Тогда
Отказ = Истина;
ПоказатьПредупреждение("Сначала выберите склад!");
КонецЕсли;
КонецПроцедуры

Преимущества подхода:

• 🤖 Автоматизация: пользователю не нужно нажимать кнопку «Обновить».
• 🎯 Контекстная реакция: таблица обновляется только когда это необходимо.
• 🛡️ Контроль: можно добавить проверки перед обновлением (например, валидацию данных).

Однако есть и риски:

• 🔄 Рекурсивные вызовы: если в обработчике ПриИзменении меняется другой реквизит, связанный с таблицей, может возникнуть зацикливание.
• ⚡ Производительность: частые автоматические обновления могут тормозить форму.

6. Способ 5: Программное управление источником данных

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

• 🔧 Динамически менять структуру таблицы (добавлять/удалять колонки).
• 📊 Применять сложные фильтры или группировки.
• 🔄 Обновлять данные без потери текущего состояния (выделения, сортировки).

Пример работы с динамическим списком:

Процедура ОбновитьФильтрПоСкладу(Склад)
ДинамическийСписок = ЭлементыФормы.ТаблицаТоваров.ИсточникДанных;
ДинамическийСписок.Параметры.УстановитьЗначениеПараметра("Склад", Склад);
ДинамическийСписок.Обновить;
КонецПроцедуры

Для объектных списков (например, список документов):

Процедура ОбновитьСписокДокументов
ОбъектныйСписок = ЭлементыФормы.СписокДокументов.ИсточникДанных;
ОбъектныйСписок.ПараметрыОтбора.Очистить;
ОбъектныйСписок.ПараметрыОтбора.Добавить("Дата", Тип("Булево"), ЭлементыФормы.ДатаНачала.Значение, ЭлементыФормы.ДатаОкончания.Значение);
ОбъектныйСписок.Прочитать;
КонецПроцедуры

Особенности метода:

• 🔹 Подходит для управляемых форм (в обычных формах работа с источниками данных ограничена).
• 🔹 Позволяет сохранять состояние таблицы (сортировку, группировку) при обновлении.
• 🔹 Требует понимания структуры источника данных (динамический список, объектный список, запрос).

Типичные ошибки при работе с источниками:

• ❌ Забывают очистить старые параметры отбора перед установкой новых.
• ❌ Не учитывают, что Прочитать может вернуть пустой результат (нужна обработка исключений).
• ❌ Пытаются обновить источник данных в неудачный момент (например, во время транзакции).

⚠️ Внимание: При работе с динамическими списками в 1С:Предприятие 8.3.20+ учитывайте, что изменение параметров списка может сбросить текущую позицию. Чтобы сохранить выделенную строку, используйте метод ПолучитьТекущиеДанные перед обновлением и восстанавливайте позицию после.

7. Оптимизация и типичные ошибки

Даже правильно реализованное обновление таблицы может работать медленно или вызывать ошибки. Вот ключевые рекомендации по оптимизации:

1. Минимизируйте объём данных:

• 📌 Отображайте только необходимые колонки (скройте служебные поля).
• 📌 Используйте отбор на сервере (в запросе или параметрах динамического списка).
• 📌 Для больших таблиц применяйте постраничную загрузку (ПакетныйРежим).

2. Управляйте событиями:

• 🔔 Отключайте обработку событий (ОтключитьОбработкуСобытий) при массовых операциях.
• 🔔 Избегайте рекурсивных вызовов (например, когда ПриИзменении триггерит само себя).

3. Контролируйте блокировки:

• 🔒 В клиент-серверном режиме используйте БлокировкаДанных для критичных операций.
• 🔒 Не держите транзакции открытыми дольше необходимого.

Типичные ошибки и их решения:

Для диагностики проблем используйте:

• 🔍 Отладчик 1С: поставьте точку останова на процедуре обновления.
• 📊 Журнал регистрации: проверьте ошибки выполнения запросов.
• 🛠️ Тестовый режим: протестируйте обновление на копии базы.

Перем ТекущаяСтрокаТаблицы; // Для сохранения позиции

Процедура ОбновитьОстатки
// Сохраняем текущую строку
ТекущаяСтрокаТаблицы = ЭлементыФормы.ТаблицаТоваров.ТекущиеДанные;

// Обновляем данные через запрос
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
| ТоварыОстатки.Товар КАК Товар,
| ТоварыОстатки.КоличествоОстаток КАК Остаток
|ИЗ
| РегистрНакопления.ТоварыНаСкладах.Остатки(&Дата, Склад = &Склад) КАК ТоварыОстатки";

Запрос.УстановитьПараметр("Дата", Объект.Дата);
Запрос.УстановитьПараметр("Склад", Объект.Склад);

Результат = Запрос.Выполнить;
ЭлементыФормы.ТаблицаТоваров.Очистить;

Выборка = Результат.Выбрать;
Пока Выборка.Следующий Цикл
НоваяСтрока = ЭлементыФормы.ТаблицаТоваров.Добавить;
НоваяСтрока.Товар = Выборка.Товар;
НоваяСтрока.Остаток = Выборка.Остаток;
КонецЦикла;

// Восстанавливаем позицию
Если ТекущаяСтрокаТаблицы <> Неопределено Тогда
ЭлементыФормы.ТаблицаТоваров.ТекущиеДанные = ТекущаяСтрокаТаблицы;
КонецЕсли;
КонецПроцедуры

// Вызываем обновление при изменении склада или даты
Процедура СкладПриИзменении(Элемент)
ОбновитьОстатки;
КонецПроцедуры

Процедура ДатаПриИзменении(Элемент)
ОбновитьОстатки;
КонецПроцедуры

ФоновоеЗадание = ФоновыеЗадания.Выполнить("ОбновитьТаблицуФоново", Структура, Новый ОписаниеОповещения("ПослеОбновленияТаблицы"));

ЗапуститьОбновлениеТаблицы;
Подождать(1); // Даём время на выполнение в фоновом потоке