Другое · 8 мин
Передача таблицы значений в управляемую форму 1С
Как передать таблицу значений в управляемую форму 1С: параметры открытия, атрибуты, табличная часть, хранилище значений и проверка результата без потери данных.
Таблица значений в управляемых формах 1С чаще всего нужна, когда в форму нужно принести набор строк, который ещё не привязан к объекту базы данных: отбор из справочника, результаты расчёта, временный список документов или данные из внешнего источника. Главное отличие от табличной части в том, что таблица значений существует в памяти и не сохраняется сама по себе, пока разработчик явно не перенесёт её строки в реквизит, табличную часть или объект.
Передачу можно организовать несколькими способами: через параметры открытия формы, через атрибуты формы, через табличную часть формы или через временное хранилище. Выбор зависит от того, где создаётся таблица значений — на клиенте или на сервере — и нужно ли пользователю видеть её сразу в виде редактируемого списка.
Ниже рассмотрены практические сценарии, условия применения, способы проверки результата и типичные ошибки. Материал относится к управляемым формам в целом, без привязки к конкретному номеру релиза, поэтому перед внедрением рекомендуется проверить поведение на копии информационной базы.
Когда передача таблицы значений оправдана
Использование таблицы значений уместно, если форма открывается не для редактирования одного объекта, а для работы с произвольным набором строк. Примеры: выбор нескольких контрагентов из отчёта, передача результата внешнего импорта, временное хранение промежуточных расчётов перед записью, отображение данных из регистров без привязки к документу.
Если же данные уже хранятся в табличной части документа или справочника, передавать отдельную таблицу значений обычно не нужно. Достаточно открыть форму на объект, и управляемая форма сама подгрузит связанные строки. Лишнее дублирование данных усложняет поддержку и увеличивает риск расхождения между временным набором и базой.
Способы передачи: параметры открытия и атрибуты формы
Один из простейших способов — открыть форму с параметром, содержащим ссылку на объект или набор данных, а в модуле формы получить таблицу значений на сервере. Параметры открытия передаются при вызове метода ОткрытьФорму и доступны в обработчике ПриОткрытии. Это подходит, когда таблица значений формируется на сервере и не требует интерактивного редактирования пользователем до сохранения.
- 1Создать или открыть табличную часть формы с нужными колонками
- 2Пройти по строкам таблицы значений в цикле
- 3Добавить строку в табличную часть и скопировать значения
- 4Проверить соответствие имён и типов реквизитов
- 5Сохранить объект, если изменения нужно зафиксировать в базе
Атрибуты формы могут использоваться для передачи данных внутри одной сессии, но не все типы атрибутов удобно связывать с таблицей значений для редактирования. Если таблица значений передаётся как атрибут, важно уточнить, где она создана: на клиенте или на сервере. При передаче через клиент-серверную границу большие таблицы могут замедлить открытие формы и увеличить сетевой трафик.
| Способ | Когда подходит | Ограничение |
|---|---|---|
| Параметры открытия формы | Данные готовы на сервере, форма открывается на объект или отчёт | Требует серверного получения и обработки параметра |
| Атрибуты формы | Передача внутри одной формы или сессии | Не всегда удобно для редактируемого списка строк |
| Табличная часть формы | Пользователь должен видеть и редактировать строки в форме | Нужно явно перенести строки из таблицы значений в табличную часть |
| Временное хранилище | Передача между клиентом и сервером или между формами | Данные временные, требуют явного получения и очистки |
Перенос таблицы значений в табличную часть формы
Если пользователь должен видеть строки в управляемой форме, надёжнее создать табличную часть формы и заполнить её из таблицы значений перед отображением. Алгоритм обычно такой: создать пустую табличную часть с нужными колонками, пройти по строкам таблицы значений в цикле, добавить строку в табличную часть и скопировать значения реквизитов. После этого форма отображает данные, а изменения можно записать в объект при сохранении.
&НаКлиенте
Процедура ПередатьТаблицу(Команда)
Хранилище = Новый ВременноеХранилище;
Ключ = Хранилище.Положить(ТаблицаЗначений);
ОткрытьФорму("ФормаСписка", Новый Структура("Ключ", Ключ));
КонецПроцедурыВажно следить за соответствием типов и имён колонок. Если в таблице значений есть реквизит, которого нет в табличной части, копирование вызовет ошибку или данные будут потеряны. Обратное тоже верно: пустые колонки табличной части остаются без данных, если в источнике нет соответствующих значений.
Хранилище значений и временное хранилище
Когда таблица значений создаётся на клиенте, а нужна на сервере, или наоборот, прямая передача через обычный параметр может быть неудобной. В таких случаях используется временное хранилище или хранилище значений: данные кладутся в хранилище с ключом, а другая форма или серверная процедура извлекает их по тому же ключу. Это полезно для передачи между формами, между клиентом и сервером, а также для хранения промежуточных результатов в рамках сессии.
Временные данные не являются постоянными записями базы. Если сессия завершится или хранилище будет очищено, таблица значений исчезнет. Поэтому перед закрытием формы нужно либо записать изменения в объект базы, либо явно сохранить временные данные в другом месте. Не полагайтесь на временное хранилище как на резервную копию важных документов.
Проверка результата и ограничения
После передачи таблицы значений нужно проверять три признака: форма открылась без ошибок, строки отображаются в ожидаемом порядке и количестве, изменения сохраняются при записи объекта. Если строки не появляются, вероятная причина — несоответствие колонок, пустой источник или ошибка в цикле переноса. Если изменения не сохраняются, скорее всего, данные остались только в таблице значений и не были перенесены в табличную часть или объект.
Ограничения касаются объёма данных и производительности. Большие таблицы значений, передаваемые через клиент, могут замедлить открытие формы и увеличить нагрузку на сеть. Для больших объёмов лучше формировать данные на сервере и открывать форму уже на готовый объект или отчёт, а не передавать весь массив через интерфейс.
Типичные ошибки и способы их избежать
Частая ошибка — попытка изменить таблицу значений на клиенте и ожидать, что изменения автоматически попадут в базу данных. Таблица значений — это временная структура, и запись происходит только после явного переноса данных в объект и вызова метода записи. Другая ошибка — передача ссылки на таблицу значений между формами без учёта того, что одна форма может изменить данные, а другая увидит уже изменённую версию.
Как выбрать действие
Ещё одна проблема — копирование реквизитов по имени без проверки типов. Если в таблице значений дата, а в табличной части строка, запись может завершиться ошибкой или привести к некорректным значениям. Перед массовым переносом рекомендуется протестировать сценарий на ограниченной выборке и проверить журнал регистрации на наличие ошибок записи.
Как выбрать подходящий способ передачи
Если таблица значений формируется на сервере и форма открывается на объект, используйте параметры открытия или атрибуты формы. Если пользователь должен редактировать строки, переносите данные в табличную часть формы. Если данные нужно передать между клиентом и сервером или между разными формами, применяйте временное хранилище. В сложных случаях комбинируйте подходы: сервер готовит данные, клиент отображает их в табличной части, а при записи переносит результат в объект.
Что важно запомнить
Таблицу значений передают через параметры, атрибуты, табличную часть или временное хранилище; изменения сохраняются только после явной записи в объект.
Можно ли редактировать таблицу значений напрямую в форме?
Таблица значений сама по себе не является табличной частью формы. Для редактирования пользователем её строки нужно перенести в табличную часть формы, а после изменений — вернуть в объект и записать.
Что делать, если строки не отображаются после передачи?
Проверьте, что таблица значений не пуста, имена колонок совпадают с табличной частью, цикл переноса выполнен и форма открыта после заполнения. Также убедитесь, что данные не были очищены временным хранилищем до отображения.
Нужно ли сохранять таблицу значений отдельно от объекта?
Нет, таблица значений не является самостоятельной записью базы. Её содержимое теряется при завершении сессии, если не перенести данные в объект и не записать его.
Как проверить, что данные записаны в базу?
Откройте объект после записи и убедитесь, что строки присутствуют в табличной части или регистрах. Также можно проверить журнал регистрации на наличие ошибок при сохранении.