24  /  48

Встройка REST_APP_URI

Просмотров: 27420
Дата последнего изменения: 24.09.2021
Сложность урока:
3 уровень - средняя сложность. Необходимо внимание и немного подумать.
1
2
3
4
5

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

И если ваше тиражное приложение стало популярным, вы можете не волноваться, хватит ли вам мощностей для его работы.

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

Рассмотрим новую встройку REST_APP_URI. Она отличается тем, что не имеет ни кнопки в Битрикс24, ни фрейма среди контента Битрикс24, как, например, Пользовательские типы полей Когда открывается форма, допустим, карточка лида в CRM, в которой выводится поле нашего пользовательского типа, то в карточке, фактически, выводится фрейм с приложением. В этот фрейм передаются все данные о поле, значении и режиме работы. Для приложения все выглядит так, как если бы оно было открыто в месте встройки с идентификатором USERFIELD_TYPE.
Подробнее...
в карточках CRM.

Как работать с этой встройкой?

Регистрируется она, как и любая другая, методом placement.bind veb1.jpg . Вы указываете путь до своего обработчика и можете использовать её на портале. Для использования разместите в любом месте портала ссылку на эту встройку. Ссылка выглядит так: /marketplace/view/#appCode#/

veb2.jpg

где #appCode# - это код вашего приложения. Приложение может быть как локальным, так и тиражным решением.

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

В примере на рисунке выше использованы ВВ-коды для добавления ссылки в пост Живой ленты. Выглядеть это будет так:

veb3.jpg

И если вы нажмете на uri в этом посте, то откроется слайдер с вашим обработчиком:

veb4.jpg

Обратите внимание на PLACEMENT_OPTIONS. В его значении указано test=y. Это как раз тот test=y veb17.png , который при указании встройки мы добавили в параметры ссылки.

Это и является ключевой особенностью этой встройки - что благодаря использованию GET-параметра params можно передавать во встройку любые параметры, не ограничиваясь ничем, кроме правил формирования URL.

Такая особенность позволяет применять эту встройку во множестве вариантов.

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

Скорее всего, вы найдете и множество других полезных применений для встройки REST_APP_URI.



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

Если вы нашли неточность в тексте, непонятное объяснение, пожалуйста, сообщите нам об этом в комментариях.
Развернуть комментарии
Доступна новая документация по REST: понятнее описания, больше примеров, удобнее поиск
Перейти