16  /  44

Серверное приложение без интерфейса в Битрикс24

Просмотров: 5992

  Создание записи приложения в Маркетплейсе

Пример состоит из SDK CRest и PHP-файла с примером, которые вы должны разместить на своем веб-сервере до добавления приложения в свой Битрикс24. Приложение умеет получать авторизацию пользователя Битрикс24 и используя ее, находясь при этом вне Битрикс24, обращаться к REST API, получая ФИО пользователя, установившего приложение.

Внимание! Данный пример работает на основе SDK CRest. Перед использованием примера необходимо открыть через браузер файл checkserver.php и проверить корректность настроек вашего сервера. Для реального тиражного приложения необходимо пронаследовать класс CRest, переопределив методы getSettingData/setSettingData, которые занимается получением/сохранением токенов авторизации в текстовый файл. Эти методы не предназначены для эксплуатации приложения на нескольких Битрикс24 одновременно. Подробнее.

Скачать архив:

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

Нажмите на рисунок, чтобы увеличить

Заполните доступные разделы системы (1) для данного примера значениями "Пользователи". Ознакомьтесь с правилами публикации (2). Это необходимо для понимая требований, которые накладываются на тиражные решения.

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

После добавления версии приложения необходимо заполнить название (1) код приложения (2), категории (3), описание приложения (4), ценовую политику (5) и протестировать (6):

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

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

  Версии приложения

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

Добавим первую версию приложения. Перейдите на закладку Версии и нажмите Добавить новую версию. В открывшейся форме заполните базовые поля, укажите необходимые для приложения права (для нашего примера нужны права на управление пользователями), а также URL текущего примера, размещенного на вашем сервере:

Нажмите на рисунок, чтобы увеличить

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

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

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

Укажите эти значения в соответствующих константах, задайте точный URL (APP_REG_URL) к приложению:

Нажмите на рисунок, чтобы увеличить

и обновите скрипт на вашем сервере.

Откройте пример в браузере по вашему URL:

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

Запущенное приложение выведет отладочную информацию о процессе получения авторизации, а также Фамилию Имя Отчество текущего пользователя, получив его по REST API с использованием этих авторизационных данных.


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

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