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

Другое · 8 мин

Контекст в 1С: среда выполнения и передача данных

Разбираем, что означает контекст выполнения в 1С: клиент/сервер, формы, параметры и проверка доступных данных без лишней теории и без привязки к версии.

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

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

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

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

Что понимают под контекстом в 1С

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

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

Где контекст проявляется: клиент, сервер, форма

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

Форма и команда: параметры и текущий объект

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

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

Перенос контекста между клиентом и сервером

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

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

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

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

Где выполняется кодКлиент или сервер

Определяет доступ к формам и к данным

Что передано в параметрыСписок аргументов процедуры

Явно задаёт часть контекста для вызываемого кода

Какой объект активенТекущая форма или запись

Проверяйте перед использованием свойств объекта

Что входит в контекст выполнения

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

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

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

Частые ошибки при работе с контекстом

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

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

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

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

Где выполняется код
Норма

Клиент — доступны формы и элементы; сервер — доступны данные и общие модули

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

Клиентский объект вызван на сервере или сессия завершена до конца операции

Как проверить, какой контекст сейчас активен

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

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

Итог

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

Контекст не является одним объектом; он зависит от места выполнения, передаваемых параметров и текущей формы. Явная передача параметров и проверка места выполнения снижают риск ошибок.

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

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

Можно ли использовать текущую форму в серверной процедуре?

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

Что делать, если код работает на клиенте, но падает на сервере?

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

Является ли контекст границей прав доступа?

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