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

Другое · 8 мин

Параметры сеанса 1С на клиенте: как получить и проверить

Как на клиенте 1С:Предприятие получить параметры сеанса пользователя, где смотреть значения, ограничения тонкого и веб-клиента, проверка и частые ошибки.

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

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

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

ПараметрыСеанса в глобальном контексте

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

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

bsl
Параметры = ПараметрыСеанса;
Если Параметры <> Неопределено Тогда
    Сообщить(Параметры.ИмяПользователя);
КонецЕсли;

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

Чтение параметров на клиенте не требует вызова серверной процедуры, если свойство действительно доступно на клиенте. Это ускоряет работу, но делает данные зависимыми от особенностей конкретного клиентского приложения.

Что можно узнать из параметров сеанса

Имя пользователя и идентификатор сеанса

Чаще всего нужны ИмяПользователя и УникальныйИдентификаторСеанса. Первое позволяет определить, от чьего имени ведётся работа, второе — различать параллельные сеансы одного пользователя. Оба значения полезны при записи в журнал событий или при отладке ошибок, связанных с конкретным входом.

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

База, версия платформы и тип клиента

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

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

ПараметрыСеанса неопределенДоступ ограничен

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

Значение полученоСтруктура заполнена

Сверьте идентификатор сеанса с ожидаемым

Отличия тонкого, веб и мобильного клиента

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

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

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

Как проверить, что параметры получены

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

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

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

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

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

Структура содержит имя пользователя и идентификатор сеанса

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

Неопределено или пустая структура

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

Ограничения и риски

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

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

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

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

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

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

Типичные ошибки
01
Чтение поля без проверки ПараметрыСеанса на Неопределено
02
Использование идентификатора сеанса как постоянного идентификатора пользователя

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

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

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

Сравнение вариантов

Клиентское чтение ПараметрыСеанса

Быстро и удобно для отладки, но зависит от типа клиента и версии платформы

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

Более надёжно для критичной логики, требует вызова сервера и передачи данных

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

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

Итог

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

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

Можно ли получить параметры сеанса в веб-клиенте?

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

Что делать, если ПараметрыСеанса равен Неопределено?

Убедитесь, что код выполняется на клиенте, где свойство доступно, и проверьте права сеанса. Если свойство всё равно недоступно, получайте данные на сервере и передавайте их клиенту.

Подходит ли идентификатор сеанса для идентификации пользователя?

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

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

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

Какой раздел синтакс-помощника смотреть для уточнения полей?

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