Fiche-Ressource
Lycée Aristide Bergès
Utilisation Tuleap-Campus
Outils de développement collaboratifs
Rédigé par
David ROUMANET
Professeur BTS SIO
Changement
Date Révision
23/12/2018 Création du document
05/04/2019 Utilisation mediaWiki, Kanban, Test Management...
05.04.19
Fiche-Ressource
Sommaire
A Objectifs du document........................................................................................................1
B Choix de l'outil Tuleap.........................................................................................................1
C Vue d'ensemble..................................................................................................................2
D Création d'un projet............................................................................................................3
D.1 Gestion des services..................................................................................................4
D.2 Ajout de membres......................................................................................................5
E Utilisation GIT.....................................................................................................................6
F Gestion Kanban..................................................................................................................7
F.1 Usage de Kanban.......................................................................................................7
F.2 Effacer une tâche........................................................................................................7
F.3 Rapport Kanban..........................................................................................................8
G Utilisation mediaWiki..........................................................................................................9
G.1 Création d'une page...................................................................................................9
G.2 Modification d'une page...........................................................................................10
G.3 Discussion sur une page.........................................................................................10
G.4 Historique d'une page..............................................................................................10
H Utilisation du module "Test Management"........................................................................12
H.1 Création de campagne et de tests...........................................................................12
H.2 Valider les tests........................................................................................................13
Révision : 13 Nombre de pages : 15
Fiche-Ressource
A Objectifs du document
Le développement est devenu plus complexe et implique plusieurs personnes, voire plusieurs équipes.
Au travers de l'outil Tuleap-Campus, ce document a pour objectifs principaux :
• De faire connaître les outils utiles au développement en équipe
• D'apporter les connaissances techniques dans l'utilisation de ces outils
• De pousser les étudiants à travailler en équipe et utiliser les bons processus
Dans les objectifs secondaires :
• De permettre à l'étudiant l'ajout de nouvelles compétences dans son CV et son portefeuille de
compétences
B Choix de l'outil Tuleap
Il existe de nombreux outils permettant de faire les tâches similaires, mais :
• Rares sont ceux qui intègrent l'ensemble des outils nécessaires dans une seule interface
• Les outils ne communiquent pas toujours entre-eux
L'éditeur Enalean propose un ensemble d'outils dans un environnement intégré, avec une seule
authentification. La version dédiée aux projets pédagogiques s'appelle Tuleap-Campus.
Il s'agit d'un outil dit "ALM" (Application Lifecycle Management) : Ce terme couvre l'ensemble des moyens
nécessaires au développement ou à la maintenance d'une application.
Cette fiche explique donc comment utiliser les différents outils. Au préalable, vous devez vous créer un
compte.
Créez un identifiant composé de votre première lettre de prénom (ou premières lettres de
prénoms pour les prénoms composés comme Jean-Pierre, etc.) et de votre nom de famille. Dans
le cas où l'identifiant n'est pas disponible (homonyme?), ajouter -lab à la fin (pour Lycée Aristide
Bergès) ou autre chose (date de naissance ou département mais attention, ces données révèlent
des choses sur vous).
Utilisez une adresse de courrier valide, car vous recevrez un courrier d'activation du compte.
05.04.19
Fiche-Ressource
C Vue d'ensemble
Tuleap n'affiche pas immédiatement une page pleine d'information, il faudra d'abord créer un projet (ou bien
être inscrit à un projet.
Recherche Paramètres
Gestion des Profil
Accueil
projets
Dans le menu "PROJETS ▼" il est possible de sélectionner un projet existant ou d'en créer un. La vue d'un
projet est beaucoup plus intéressante.
En effet, Tuleap propose de nombreux outils pour permettre la gestion complète d'un projet.
Révision : 13 Nombre de pages : 15
Fiche-Ressource
Voici le tableau de bord de Tuleap-Campus. Il est en partie personnalisable (déplacement de cadres, nombre
de colonnes, contenus et widgets…).
Menu principal des
outils
Tableau de bord Tableau de bord
Kanban Équipe
Tableau de bord
Activité
D Création d'un projet
La création d'un projet nécessite quelques renseignements et le choix
du type de projet.
Quel que soit le projet choisi, il est toujours possible de modifier les
services associés.
La liste des fonctions disponibles se trouve dans le menu "Administration" :
Projet privé : seuls les membres du projet peuvent y avoir accès.
Projet public : seuls les membres enregistrés dans Tuleap peuvent y avoir accès.
05.04.19
Fiche-Ressource
D.1 Gestion des services
Cliquez sur "Services" pour activer les services dont vous avez besoin, voici leur utilité :
Service Explication
Sommaire Le titre du projet apparaît dans la colonne de gauche. Équivalent à accueil.
Admin Le menu d'administration (celui dans lequel vous êtes actuellement)
Documents Gestionnaire de documentation. Il contient l'historique des versions, les journaux de
consultation ou modification, etc.
L'intérêt est de pouvoir créer une structure (dossiers/fichiers) : installation,
administration, manuel utilisateur, FAQ, etc.
Un document peut être un fichier, mais aussi un lien, une page Wiki, ...
Annonces
SVN SVN signifie SubVersioN et permet de synchroniser un répertoire d'un serveur avec
celui des développeurs. Nous préfèrerons GIT.
Fichiers Gestionnaire de fichiers, pour les utilisateurs finaux. Cela correspond généralement
aux exécutables de l'application et Tuleap utilise le terme "Paquet" dans ce menu.
Suivi Gestionnaire des tickets (bugs, incidents, mise à jour, tâches, etc.)
AgileDashboard Gestionnaire de stories ou de tâches selon la méthode Agile choisie.
WikiMedia Permet de créer des pages WikiMedia. La syntaxe d'un lien est [[mot]] : cela permet de
créer une nouvelle page qui portera dans le lien 'mot'.
Les autres services ne seront pas abordés ici.
Révision : 13 Nombre de pages : 15
Fiche-Ressource
D.2 Ajout de membres
L'intérêt de Tuleap-Campus, est le travail collaboratif. Dans la partie administration, il suffit de cliquer sur
Membres.
Il est aussi possible d'utiliser un fichier texte contenant l'adresse email des utilisateurs à importer : la seule
condition étant que cette adresse soit celle d'un utilisateur enregistré et actif !
05.04.19
Fiche-Ressource
E Utilisation GIT
L'ajout d'un gestionnaire GIT est très facile : il suffit de cliquer sur le bouton [+ Ajouter un dépôt] et de lui
donner un nom.
Il est ensuite possible d'y accéder via un lien SSH ou un lien HTTPS (ce dernier est préférable sous Visual
Studio).
Il est possible de régler quelques options, dont les permissions et les notifications :
Révision : 13 Nombre de pages : 15
Fiche-Ressource
F Gestion Kanban
La gestion des tâches peut utiliser la méthode Scrum ou Kanban. Ici, c'est la méthode Kanban qui est décrire
(plus simple d'approche).
F.1 Usage de Kanban
Les colonnes sont "masquables" en cliquant sur leur icône à gauche.
On trouve 5 colonnes (la dernière, "archive" est en affichage masqué ci-dessus). Lorsqu'on survole une
colonne, un signe (+) s'affiche en bas, permettant d'ajouter une tâche dans la colonne choisie.
Il suffit ensuite d'écrire le titre de la tâche, puis de valider.
Pour déplacer une tâche, il suffit de la glisser dans la nouvelle colonne. On peut aussi les ordonner par
priorité, verticalement.
L'icône avec le symbole infini (∞) permet de limiter le nombre de tâches dans une colonne (si on dépasse ce
nombre, la colonne se teinte en jaune et une icône ▲ apparaît).
F.2 Effacer une tâche
Il n'est pas facile d'effacer une tâche. En réalité, la première option est de la déplacer dans la colonne
"Archive". La deuxième option est de noter le numéro de la tâche puis dans l'outil de suivi, choisir les tâches
Kanban et administration… ici, ce cache le lien "Suppression d'artefact" dans lequel il faut saisir le numéro de
la tâche.
Une demande de confirmation
s'affiche avant l'effacement, avec un
aperçu de la tâche.
05.04.19
Fiche-Ressource
F.3 Rapport Kanban
Il y a un bouton [Afficher les rapports] dans le menu Kanban.
Le diagramme est dynamique, en passant la souris dessus, on a le détail du nombre de tâches.
Révision : 13 Nombre de pages : 15
Fiche-Ressource
G Utilisation mediaWiki
MediaWiki utilise une syntaxe particulière et son fonctionnement n'est pas aussi intuitif qu'un CMS.
Moteur de recherche
G.1 Création d'une page
La création de pages se fait en tapant dans le moteur de recherche, le mot-clé qui sera le titre de la page. Le
moteur se trouve en haut à droite. WikiMedia propose alors de créer la page puisqu'il ne la trouve pas. C'est
ainsi qu'a été créée la page Exemple.
Il est aussi possible de créer un lien qui n'existe pas,
en tapant le mot-clé entre des doubles crochets
[[Exemple2]]. Le lien sur le mot-clé s'affiche en
rouge, indiquant qu'il n'existe pas encore de page
dans ce Wiki. Un clic dessus permettra de modifier Lien de création de
page
la page inexistante :)
Si la page appartient à une page existante (et est donc une sous-page), le lien portera le nom de la page
principale puis le mot-clé de la nouvelle page séparé par le symbole deux-points ':'. [[Manuel:Exemple3]] ►
Manuel:Exemple3
05.04.19
Fiche-Ressource
G.2 Modification d'une page
La modification d'une page reste très simple, il suffit de cliquer sur l'onglet [modifier] dans le bandeau de la
page :
La syntaxe se rapproche du Markdown.
La page suivante décrit précisément les possibilités du rédacteur :
[Link]
Il est recommandé de remplir le champ "Résumé :"
et de préciser s'il s'agit d'une modification mineure ou
pas (en cochant ou pas la case correspondante).
Ces informations seront enregistrées en tant que
méta-informations et visibles dans l'historique.
G.3 Discussion sur une page
Le principe est simple : si une information dans la page nécessite des corrections ou des modifications, il est
possible d'en discuter (en cliquant sur [discussion] dans le bandeau) pour permettre à chacun de donner son
avis.
Cette page fait fonction de compte-rendu, afin que les rédacteurs suivants connaissent les décisions retenues
parmis les propositions faites.
G.4 Historique d'une page
Cette fonction permet de suivre les modifications faites : par qui, quand et quoi.
Révision : 13 Nombre de pages : 15
Fiche-Ressource
05.04.19
Fiche-Ressource
H Utilisation du module "Test Management"
C'est un module intéressant pour créer un parcours de test. Il suffit de créer une nouvelle campagne de test,
et d'y ajouter les tests : ce ne sont pas des tests automatisés dans Tuleap-Campus mais une validation
humaine.
H.1 Création de campagne et de tests
La première opération est de créer une campagne en cliquant sur le bouton [+ Nouvelle campagne ].
Après avoir saisie le nom, il faut y ajouter les différents tests que l'équipe de validation doit mettre en œuvre.
En éditant la campagne, il est possible
d'ajouter des tests, mais aussi un lien Editer la campagne
Jenkins (outil d'intégration continue) 1.
Il est alors possible de rendre les tests
disponibles (cochés) ou pas dans la
campagne en cours. Ajouter des tests
Cocher pour valider
la présence des tests
dans la campagne.
1 [Link]
Révision : 13 Nombre de pages : 15
Fiche-Ressource
H.2 Valider les tests
Dans la liste des tests présents dans la campagne en cours, il sufft de sélectionner le test a modifier.
Liste des tests, par
catégories
Il est alors possible d'éditer le test, d'y apporter un commentaire ou d'utiliser un bouton de validation :
• succès ( v )
• échec ( x )
• bloqué ( ! )
• non-exécuté ( ? )
05.04.19
