Работа с Push & Pull в рамках браузера

Просмотров: 52722
Дата последнего изменения: 04.02.2020

Роберт Басыров

Сложность урока:

3 уровень - средняя сложность. Необходимо внимание и немного подумать.

Недоступно в лицензиях:

Ограничений нет

Рассмотрим как работать со штатным Push & Pull клиентом в рамках приложения. Пример страницы для приложения с веб-интерфейсом:

<!DOCTYPE html>
<html>
<head>
	<title>Bitri24 application with Push & Pull</title>
	<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />

	<script src="//api.bitrix24.com/api/v1/"></script>
	<script src="//api.bitrix24.com/api/v1/pull/"></script>
</head>
<body>
	<script>
		
		window.appPullClient = new BX.PullClient({
			restApplication: 'myApplication_test.bitrix24.ru',
			restClient: BX24,
			userId: 1
		});

		window.appPullClient.subscribe({
			moduleId: 'application',
			callback: function (data) {
				console.warn(data); // {command: '...', params: {...}, extra: {...}}
			}.bind(this)
		});
		
		window.appPullClient.start();
				
	</script>
</body>
</html>

При инициализации BX.PullClient необходимо указать следующие параметры:

restApplication - укажите произвольный строковый идентификатор приложения. (Должен быть уникален для каждого портала, на котором установлено ваше приложение)
userId - укажите идентификатор текущего авторизованного пользователя

Если веб-страницу у вас создаёт "1С-Битрикс: Управление сайтом" и вашу редакцию входит модуль Push & Pull, рекомендуется вместо подключения:

<script src="//api.bitrix24.com/api/v1/pull/"></script>

подключать встроенную библиотеку Минимальная версия модуля pull 18.5.500 через:

\Bitrix\Main\UI\Extension::load("pull.client");

Подключение PullClient позволит front-end вашего приложения получать события из канала, которые туда будет отправлять back-end вашего же приложения при помощи метода pull.application.event.add.

Курсы разработаны в компании «1С-Битрикс»

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

Развернуть комментарии