1С веб-клиент: как передать параметры при запуске

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

Веб-клиент 1С запускается по адресу вида http://server/base/ru_RU/, и именно в эту строку добавляются параметры запуска. Часть из них платформа обрабатывает сама — например, отключение проверки сертификата или задание скорости соединения. Другую часть разработчик передаёт через специальный параметр О (он же Оptions в некоторых описаниях) или через строку запуска, которую затем разбирает прикладной код в модуле управляемого приложения.

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

Как устроена строка запуска веб-клиента

Базовый адрес веб-клиента формируется при публикации информационной базы на веб-сервере (IIS или Apache). Типичный вид: http://server/base. После адреса базы через вопросительный знак добавляются параметры в формате ключ=значение, разделённые амперсандом &. Пробелы и кириллица в значениях должны быть URL-кодированы, иначе браузер или веб-сервер исказит строку.

Платформа различает параметры, которые обрабатывает сама (например, LowClientConnectionSpeed, DisableCertificateValidation, wslang для языка интерфейса), и произвольную строку, которую можно передать для прикладной обработки. Прикладные данные принято передавать через параметр О (кириллическая буква «О») — его значение затем доступно в коде через функцию глобального контекста ПараметрЗапуска.

Пример полного адреса: http://server/base/ru_RU/?О=ОткрытьОтчет;Период=Месяц. Здесь после О= идёт произвольная строка, которую разработчик разбирает сам — разделители и структуру он определяет самостоятельно, платформа её не интерпретирует.

Платформенные параметры URL веб-клиента

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

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

Передача прикладных параметров через параметр О

Прикладной сценарий строится в три шага: сформировать строку параметров, добавить её в URL после О=, разобрать строку в коде конфигурации. Формат строки полностью на совести разработчика — чаще всего используют пары «ключ=значение» через точку с запятой, по аналогии с query-строкой, либо простые команды с одним аргументом.

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

Процедура ПриНачалеРаботыСистемы()
	СтрокаПараметров = ПараметрЗапуска;
	Если СтрНайти(СтрокаПараметров, "ОткрытьОтчет") > 0 Тогда
		ОткрытьФорму("Отчет.Продажи.Форма");
	КонецЕсли;
КонецПроцедуры

Если параметров несколько, строку разбивают функциями работы со строками: СтрРазделить по разделителю, затем поиск «=» в каждом фрагменте. Результат удобно сложить в структуру и передать дальше — например, в параметры открываемой формы. Такой подход изолирует разбор строки в одном месте и упрощает поддержку.

Открытие конкретных объектов по ссылке

Частая задача — дать пользователю ссылку, которая сразу открывает нужный документ или элемент справочника, минуя навигацию по интерфейсу. В 1С для этого существуют навигационные ссылки: каждый объект базы имеет уникальную навигационную ссылку вида e1cib/data/Документ.РеализацияТоваровУслуг?ref=..., которую можно получить через функцию ПолучитьНавигационнуюСсылку.

Полный адрес для веб-клиента складывается из адреса публикации и навигационной ссылки: http://server/base/ru_RU/#e1cib/data/... (в зависимости от версии платформы разделитель может отличаться). Такую ссылку можно отправить пользователю по почте или встроить во внешнюю систему. При переходе веб-клиент запросит аутентификацию, если сеанс ещё не открыт, и затем покажет объект.

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

Пошаговая настройка и проверка результата

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

1. 1
   Убедитесь, что база опубликована на веб-сервере и веб-клиент открывается по адресу публикации
2. 2
   Сформируйте строку прикладных параметров и URL-кодируйте спецсимволы
3. 3
   Добавьте строку в URL после параметра О= и откройте адрес в браузере
4. 4
   В модуле управляемого приложения в ПриНачалеРаботыСистемы получите строку через ПараметрЗапуска
5. 5
   Разберите строку и выполните нужное действие: открытие формы, запуск отчёта
6. 6
   Проверьте поведение под пользователем с ограниченными правами, а не только под администратором

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

Типичные ошибки и ограничения

Самая распространённая ошибка — забыть URL-кодирование. Символы &, =, пробел и кириллица внутри значения параметра О разрушают структуру URL: браузер воспринимает амперсанд как начало следующего параметра, и строка обрезается. Кодируйте значение целиком, а в коде платформы при необходимости декодируйте.

Вторая группа ошибок связана с моментом обработки. Код в ПриНачалеРаботыСистемы выполняется до полной инициализации интерфейса, поэтому некоторые действия (например, открытие формы с модальными вызовами) могут вести себя неожиданно. Надёжнее откладывать сложные действия через ПодключитьОбработчикОжидания с коротким интервалом однократного вызова.

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

FAQ