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