Оглавление
Введение
Чтобы записать студента на курс, можно создать Бизнес-процесс с роботом "Запустить курс для студента". Для работы робота нам потребуется информация об id курса и id студента.
Где находится робот
Чтобы использовать робота в БП, необходимо выбрать пункт меню "Действие приложений".
(Также робота можно использовать в разделе CRM).
Дальше в списке роботов находим "Запустить курс для студента", зажимаем ЛКМ и перетягиваем робота в поле редактирования БП
Настройка робота
Для настройки робота нажимаем на "шестеренку" в правом верхнем углу блока робота или двойным кликом левой кнопки мыши.
Откроется диалоговое окно
Поля робота
В роботе есть 4 главных поля
Поля "ID курса" и "ID студента" являются обязательными для заполнения. (ВАЖНО! БЕЗ НИХ РОБОТ ВЫДАСТ ОШИБКУ)
Выбор да или нет в поле "Отправить ссылку на курс битрикс-пользователям через битрикс-уведомления" отвечает за то, будет ли отправляться битрикс-уведомление студенту, который есть на портале. Если студента нет на портале, отдельное уведомление в Битрикс не придет.
Эта ссылка также возвращается в результате работы действия (см. ниже)
В поле "Ваш никнейм в телеграме для отправки результатов.." можно вписать Ваш никнейм в Telegram (без знака @) , чтобы Вам приходило логирование в Telegram о результате работы данного действия.
Подробнее об этом можно прочитать в статье Телеграм-бот - настройка логирования роботов.
Пример заполнения:
Как избежать ошибок
Правила довольно просты:
- ID курса должно быть целым числом и такой курс должен существовать.
- ID студента должно быть целым числом и такой студент должен существовать.
- Если передаете телеграм-никнейм - он должен содержать только разрешенные Telegram символы и Вы должны быть пользователем Telegram-бота Базы знаний @kdb24_bot (подробнее об этом можно прочитать в статье Телеграм-бот - настройка логирования роботов).
Что возвращает робот
В дальнейших элементах БП мы можем использовать данных полученные от робота. Они хранятся в "Дополнительные результаты" в окне "Вставка значения"
Тут отображаются все данные которые мы можем использовать как вместе, так и отдельно.
"Ссылка на прохождение курса"
В поле "Ссылка на прохождение курса" хранится такая структура данных:
- student_id - id студента
- student_name - имя студента
- student_link - ссылка для авторизации для студента
Если студент имеет привязку к Битриксу:
- bitrix_id - id пользователя
- bitrix_name - имя пользователя
- bitrix_email - эл. почта пользователя
"ok"
В поле "ok" хранится значение N или Y, что означает:
- N - Робот не сработал из-за ошибки
- Y - Робот сработал успешно
"Ошибка"
В поле "Ошибка" хранится текст с ошибкой, которая произошла во время выполнения работы робота. Если поле пустое, то значит ошибок не было:
"Код ответа"
В поле "Код ответа" хранится статус код операции.
200 (успешно)
404 (студент или курс не найдены)
400 (некорректный запрос)
500 (ошибка на стороне сервера)
Во всех случаях, кроме 200, приходит подробная информация об ошибке в поле "Ошибка".