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

Другое · 7 мин

Обновление данных формы 1С 8.3 программно

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

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

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

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

Реквизит формы и атрибут объекта: в чем разница

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

Атрибут объекта — это поле конфигурируемого объекта, например «Контрагент» в документе или «Номенклатура» в справочнике. Программное изменение атрибута в форме подготавливает данные к записи, но фактическая запись происходит отдельно. Если запись не выполнена, после переоткрытия формы старые значения восстановятся из базы.

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

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

Сценарий с документом или справочником

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

Порядок действий
  1. 1
    Определить, меняется реквизит формы или атрибут объекта
  2. 2
    Внести изменения в реквизит или строки табличной части
  3. 3
    Выполнить запись объекта, если данные должны остаться в базе
  4. 4
    Проверить отображение на форме после закрытия или повторного открытия

Когда нужно записывать объект в базу

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

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

Обновление отображения и модальные формы

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

Модальное и не модальное окно

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

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

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

Значение на форме после изменения
Норма

Отображается новое значение и сохраняется после записи

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

Старое значение возвращается после переоткрытия

Данные в базе у других пользователей
Норма

Обновленные значения доступны после записи

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

Изменения видны только в текущей форме

Проверка результата и ограничения

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

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

Типичные ошибки
01
Считать обновление формы сохранением в базе без вызова записи
02
Изменять табличную часть, но не управлять строками и не записывать объект
03
Редактировать объект в модальной форме и ожидать мгновенного обновления в вызывающей форме

Безопасная работа и альтернативы

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

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

Итог

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

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

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

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

Что делать, если изменения не сохраняются после закрытия формы?

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

Можно ли программно менять табличную часть без записи объекта?

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

Почему изменения в модальной форме не видны в основной форме?

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

Какие риски при массовом программном обновлении?

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