Skip to content
YohannsMonnier edited this page Sep 13, 2010 · 2 revisions

Internethux : Connecteur Rbot-Redmine

Le but de ce projet est de créer un robot IRC capable d’interagir avec Redmine.

Liste des fonctionnalités

  • Identification du développeur
  • Liste des tâches par développeur (ouvertes)
  • Liste des tâches d’un projet
  • Chronomètre par développeur pour minuter les tâches par développeur
  • … (pour l’instant)

Comment ça marche ?

Fonctions utilisateur

Le Robot s’appuiera sur le Robot IRC RedBot(Robot Open Source écrit en Ruby) et sur le Webservice destiné au connecteur.

  • La fonction connect : Cette fonction permet de s’identifier à Redmine.

Le robot vérifie l’identité de l’utilisateur sur redmine et enregistre la correspondance nickname irc et login redmine.
Voici comment utiliser cette fonction : “connect username password”.
Il est évidemment conseillé de le faire dans une conversation privée avec votre robot.

  • La fonction disconnect : Cette fonction permet d’effacer les informations d’identification, ainsi que les tâches en cours.

Voici comment utiliser cette fonction : “disconnect”.

  • La fonction redmine tasks : Cette fonction permet de lister les tâche qui sont assignées à l’utilisateur.

Sans ajouter de paramètre, on récupère l’ensemble des tâches ouvertes qui nous sont assignées. La fonction peut aussi être utilisée comme ceci “redmine tasks identifiant-projet” pour se voir lister l’ensemble des tâches qui sont assignées à l’utilisateur et ouverte pour un projet en particulier, c’est plus rapide quand de nombreux projets sont ouverts.

  • La fonction start : Cette fonction ferme maintenant la tâche en cours (si une tâche est ouverte) pour ouvrir la nouvelle tâche.

La fonction peut être utilisée comme ceci “start numTache”. Cependant, si vous fermez une tache , vous pouvez aussi spécifier un message pour le commentaire comme ceci : “start numTache Commentaire”. Ce commentaire n’est cependant pas obligatoire.

  • La fonction stop : cette fonction permet maintenant de fermer automatiquement la tâche en cours, sans avoir à spécifier le numéro de la tâche.

Voici comment utiliser cette fonction : “stop” ou “stop Commentaire”.
Le commentaire n’est pas obligatoire.

  • La fonction tasks : Cette fonction permet d’afficher la tâche en cours de l’utilisateur.

Voici comment utiliser cette fonction : “tasks”.

  • La fonction addtime : cette fonction permet d’ajouter du temps pour un tache, par exemple si on a pas eu le temps de démarrer le compteur et qu’on s’en aperçoit trop tard.

Voici comment utiliser cette fonction : “addtime numTache nbHeure Commentaire”.
Le commentaire n’est pas obligatoire.

  • La fonction comment : cette fonction permet de déposer un commentaire pour une tache. Utile lorsque l’on veut donner une information à un collaborateur sur la tâche en cours.

Voici comment utiliser cette fonction : “comment numTache Commentaire”.
Cette fois ci, le message est évidement obligatoire.

Fonctions administrateur (chef de projet)

Pour utiliser ces fonctions, il faut s’authentifier en administrateur de Rbot.
Pour cela, utiliser la fonction auth : “auth passwordAdminRbot”

  • La fonction users : cette fonction liste les utilisateurs connectés, et si ils ont lancé une tâche, affiche la tâche en cours.

Voici comment utiliser cette fonction : “users”.

  • La fonction alert users : cette fonction liste les utilisateurs connectés qui n’ont pas lancé de tâche.

Elle envoi aussi un message d’alerte aux utilisateurs qui n’ont pas lancés de tâche, leur demandant de le faire le plus rapidement possible.
Voici comment utiliser cette fonction : “alert users”.

  • La fonction kill : cette fonction permet de déconnecter un utilisateur identifié.

Elle est utile lorsqu’un utilisateur a oublié de fermer sa tâche et/ou de se déconnecter avant de quitter IRC. Elle est généralement utilisée par l’administrateur après qu’il ait lancé une commance “users” pour vérifier que personne n’ait oublié de fermer ses tâches avant de partir le soir. C’est avec le nom IRC que l’on supprime les données d’identification et les tâches de l’utilisateur.
Voici comment utiliser cette fonction : “kill ircUserName”.