Тип: МенеджерОкнаВнешнегоСайта. Используется для доступа к функциям окна внешнего сайта, когда веб-клиент интегрирован в него.
Полное описание, параметры и ограничения
Глобальный контекст.ОкноВнешнегоСайта (Global context.ExternalSiteWindow)
Глобальный контекст (Global context)
ОкноВнешнегоСайта (ExternalSiteWindow)
Доступен, начиная с версии 8.3.16.
Использование:
Только чтение.
Описание:
Тип: МенеджерОкнаВнешнегоСайта.
Используется для доступа к функциям окна внешнего сайта, когда веб-клиент интегрирован в него.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, толстый клиент.
Использование в версии:
Доступен, начиная с версии 8.3.16.
Методическая информация
Практические примеры
Принять сообщение только своего внешнего сайта
Источник сообщения проверяется до обработки данных. Значение приходит настоящему обработчику из окна внешнего сайта.
Где и как запускать
Клиентский модуль собственной формы; внешний сайт должен действительно предоставлять окно интеграции.
Подготовка
Модуль собственной управляемой формы веб-клиента, интегрированного в ваш учебный внешний сайт. Создайте строковый реквизит РазрешенныйИсточник и задайте точный основной адрес своего сайта с протоколом и портом.
Обработчик подключается из кнопки; сообщение должен послать собственный внешний сайт. Не вызывайте обработчик вручную и не используйте звёздочку вместо ограничения источника.
&НаКлиенте
Процедура ПодключитьСообщенияСайта()
Если Не ОкноВнешнегоСайта.Доступно Тогда
Сообщить("Окно внешнего сайта недоступно");
Возврат;
КонецЕсли;
Оповещение = Новый ОписаниеОповещения("ПриСообщенииСайта", ЭтотОбъект, РазрешенныйИсточник);
ОкноВнешнегоСайта.ПодключитьОбработчикСообщений(Оповещение);
КонецПроцедуры
&НаКлиенте
Процедура ПриСообщенииСайта(Сообщение, РазрешенныйИсточник) Экспорт
Если Сообщение.Источник <> РазрешенныйИсточник Тогда
Возврат;
КонецЕсли;
Сообщить("Принято сообщение от настроенного учебного сайта");
КонецПроцедурыРазбор по шагам
Подготовьте собственную интеграцию внешнего сайта с веб-клиентом 1С.
Подключите экспортный обработчик с разрешённым основным адресом.
Отбросьте сообщения с другим источником до разбора данных.
Как проверить результат
Свой тестовый сайт даёт фактический Источник, соответствующий настроенному основному адресу.
Для иного источника обработчик возвращается без дальнейшей работы.
Ожидаемый результат
Код показывает вызовы на собственных учебных объектах; фактические данные и результат проверьте в подготовленной среде. Здесь пример не выполнялся.
На что обратить внимание
Источник содержит протокол, домен и порт, не произвольный URL пути. Проверка origin сама по себе не заменяет проверку структуры сообщения и полномочий.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Отправить собственное сообщение внешнему сайту
Готовый менеджер доступен, когда веб-клиент действительно интегрирован во внешнюю страницу.
Где и как запускать
Веб-клиент собственной интеграции внешнего сайта.
Подготовка
Вставьте блок в модуль собственной управляемой формы. Клиентскую процедуру вызовите из обработчика своей кнопки; серверную — через собственный серверный обработчик команды. Специальное место вставки указано отдельно.
Собственный учебный сайт с настроенной интеграцией веб-клиента и согласованным обработчиком строки learning-sum. Обычное окно браузера не заменяет эту интеграцию.
&НаКлиенте
Процедура СообщитьСайтуУчебнуюСумму()
ОкноСайта = ОкноВнешнегоСайта;
Если Не ОкноСайта.Доступно Тогда
Сообщить("Интеграция с внешним сайтом недоступна");
Возврат;
КонецЕсли;
Сумма = 50 + 75;
Сообщение = Новый СообщениеВнешнемуСайту("learning-sum=" + Строка(Сумма));
ОкноСайта.ОтправитьСообщение(Сообщение);
КонецПроцедурыРазбор по шагам
Получите менеджер и проверьте Доступно.
Вычислите собственную сумму.
Отправьте документированный объект сообщения.
Как проверить результат
При недоступности отправки нет.
Передается СообщениеВнешнемуСайту, не произвольная Структура.
Ожидаемый результат
При настроенной интеграции сайту отправлена строка собственного расчета.
На что обратить внимание
Возврат процедуры не гарантирует обработку сообщения сайтом. Не передавайте секреты неизвестной внешней странице.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.