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

Другое · 8 мин

Контекст в 1С: что это, из чего состоит и где применяется

Что такое контекст в 1С: из чего состоит, где применяется в коде, чем отличается клиентский и серверный контекст, способы проверки и частые ошибки.

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

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

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

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

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

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

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

Где контекст применяется в коде

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

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

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

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

Сценарий: отбор данных в отчёте

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

Клиентский и серверный контекст: различия

Клиентский контекст относится к рабочему месту пользователя: тонкий или толстый клиент, веб-клиент или мобильное приложение. Там доступны интерфейсные элементы, текущая форма и локальные настройки клиента. Серверный контекст относится к выполнению на сервере 1С:Предприятия, где нет прямого доступа к форме пользователя, но есть доступ к данным базы и общим серверным ресурсам.

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

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

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

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

Текущий пользователь
Норма

Соответствует ожидаемой роли

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

Пустой или не тот пользователь

Параметры сеанса
Норма

Заполнены и совпадают с настройкой

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

Отсутствуют или меняются неожиданно

Дата и время
Норма

Соответствуют настройкам базы

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

Различаются между клиентом и сервером

Как проверить и отладить контекст

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

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

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

Ограничения, риски и типичные ошибки

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

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

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

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

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

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

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

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

Итог

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

Контекст зависит от места выполнения кода; проверяйте пользователя, сессию и дату, не меняйте рабочие значения без копии и тестирования.

Чем контекст отличается от параметров процедуры?

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

Можно ли изменить контекст пользователя прямо в коде?

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

Почему одна и дата разная на клиенте и сервере?

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

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

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

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

Да. Один и тот же фрагмент кода может работать для администратора и выдавать ошибку для обычного пользователя из-за ограничений прав. Тестирование под несколькими ролями помогает выявить зависимости от контекста до внедрения в рабочую базу.