"Да как ты задолбал со своими ботами" - скажете вы. "Да я сам не в восторге от этого" - отвечу я.
Но, как в старом видео: "Миша, скажи, чё ты такой умный? Твоя задача здесь - извини".
Спустя несколько лет создания задач через письма, возник запрос на создание задач через telegram. Ну а моя задача здесь - поехали настраивать.
Подготавливаем наш redmine
- Переходим в Настройки -> API и включаем REST
- Создаем пользователя Telegram bot и выдаем ему права администратора:
Права администратора пользователю бота понадобятся в том случае, если вы захотите идентифицировать сотрудника в redmine. Если этого не потребуется, просто добавьте ему необходимые права в тех проектах, в которых он будет создавать задачи.
- Авторизуемся под этим пользователем, заходим в "Мой аккаунт" и копируем себе "API access key"
Начинаем писать код
Подключаемся по API к Redmine
Для интеграции с redmine мы будем использовать библиотеку python-redmine
- Для начала создадим файл config.py, в который мы поместим полученный API token:
- Создаем файл rm_connector.py и прописываем в него данные для авторизации в redmine:
На вывод мы получаем объект Redmine (<redminelib.Redmine object at 0x7ab52a862350>), с которым уже и будем работать.
- Получаем id проекта в редмайне:
- Создаем задачу:
project_id - Проект, в котором мы создаем задачу
subject - Название задачи
description - Описание задачи
- Проверяем, что задача создалась:
Как мы видим, задача создается с трекером "Ошибка". Мы также можем передавать id трекера при создании задачи.
По умолчанию: 1 - Ошибка, 2 - Улучшение, 3 - Поддержка.
- Обернем все это в отдельный класс:
Пробуем еще раз создать задачу, но уже с трекером "Поддержка"
Теперь мы можем создавать задачи с разными трекерами. Пора начинать писать бота, который будет принимать задачи.
Настраиваем бота
Как обычно, используем библиотеку pytelegrambotapi.
Сразу обозначим ТЗ: говорим пользователю, что ему нужно будет использовать хештеги #Ошибка, #Улучшение и #Поддержка.
- Обозначим это:
- Создадим обработчик текстовых сообщений, который будет создавать задачу:
- Запускаем и пробуем создать задачу:
Задача создается, но непонятно, кто же ее автор. Давайте для этого сделаем связь по telegram id пользователя.
Дорабатываем идентификацию автора задачи
- Заходим в Настраиваемые поля -> Пользователи и добавляем новое поле Telegram ID
- В Настраиваемые поля -> Задачи добавляем новое поле "Заказчик"
- В настройках проекта включаем это поле для задач:
- В rm_connector.py добавляем поиск пользователя по telegram id:
- И последним штрихом добавляем подстановку заказчика в нужное поле:
- Проверяем, как это все работает:
Для корректной работы не забудьте проставить Telegram ID пользователям в самом Redmine:
Дополнительные фишки
- Можно получить всю информацию о задаче по ID
- Повысить, либо понизить приоритет задачи:
Само собой, у моего production бота функционал намного шире, но не факт, что он вам пригодится. Да и не вижу смысла расписывать все по второму кругу. Вы всегда можете почитать остальные мои статьи по телеграм ботам и расширить возможности своего бота.