Transitionnal (QSOS 1.7 - french)
From QSOS wiki
Contents |
Prérequis
Les outils nécessaires pour réaliser les tâches usuelles sont :
- conception de grille : FreeMind
- édition d'une évaluation : Xul Editor 1.2
Concevoir une grille
À partir de la version 1.7, QSOS utilise le mindmap (format .mm de FreeMind) comme format de conception des grilles. Un modèle de grille est fourni sur le dépôt Git du projet.
Pour concevoir une nouvelle grille, il convient donc de partir de ce modèle et de l'enrichir en respectant les conventions suivantes :
- La section "Maturité" NE DOIT PAS être modifiée
- Les axes fonctionnels sont les autres branches du mindmap
- Les descriptions des axes fonctionnels et des critères doivent être au format bulle
- Les différents niveaux de score (0, 1 ou 2) pour chaque critère doivent être marqués avec les marqueurs correspondants
Décrire un axe ou une critère
La description de chaque axe et de chaque critère est important dans la mesure où cela fournit des indications aux évaluateurs afin de lever toute ambigüité sur la fonctionnalité évaluée.
Le formattage du noeud au format "Bulle" se fait via le menu "Mise en forme > Bulle" (cf. Figure 1).
Décrire les niveaux de score
Chaque niveau de score doit être décrit précisément afin de permettre aux évaluateurs de noter de manière objective le critère évalué.
La barre d'outils située sur la gauche de l'écran Freemind permet de marquer les niveaux de scores avec les marqueurs correspondants. Seuls les niveaux 0, 1 et 2 sont pris en compte par les outils de transformation QSOS lors de la création de la fiche d'évaluation. (cf. Figure 2)
Évaluer un logiciel
Une fois la grille d'évaluation au point, il ne reste plus qu'à transformer la grille au format .mm en une fiche d'évaluation au format .qsos
Générer une fiche d'évaluation vierge
Le fichier XSLT à utiliser est disponible sur le dépôt Git du projet QSOS.
FreeMind permet directement d'appliquer ce schéma pour obtenir une fiche d'évaluation vierge. Pour cela, sélectionner l'option "Exporter > En utilisant une XSLT..." dans le menu "Fichier" (cf. Figure 3)
Freemind vous invite à enregistrer votre grille si cela n'est pas fait.
Dans la boîte de dialogue qui apparaît, sélectionnez le fichier XSLT ainsi que l'emplacement d'enregistrement de l'évaluation QSOS générée.
Compléter une fiche
La fiche d'évaluation générée précédemment peut être éditée directement à l'aide de l'éditeur de fiche Xul Editor.
Comparer plusieurs évaluations
La comparaison de plusieurs évaluations de logciels de la même famille nécessite l'utilisation de l'outil O3S
Le projet QSOS fournit une instance O3S. L'ajout de nouvelles fiches dans ce référentiel communautaire se fait pour l'instant uniquement par le biais de la liste de diffusion de QSOS (francophone ou anglophone selon la langue de votre évaluation).
Une fois les évaluations ajoutées au référentiel O3S, leur comparaison se fait en 4 étapes :
- Sélectionner la famille de logiciels
- Pondérer les axes et critères
- Sélectionner les logiciels à comparer
- Visualiser la comparaison :
- sous forme de tableau
- sous forme de radars
Opérations avancées
QSOS fourni par ailleurs quelques outils pour effectuer les opérations suivantes :
- Récupérer la grille au format MindMap utilisée dans une évaluation existante
- Générer un MindMap correspondant à une évaluation
- Répercuter les modifications apportées à une grille aux évaluations existantes
L'ensemble de ces opérations nécessite au minimum un processeur XSLT installé sur votre machine (exemple sous Linux : xsltproc).
Récupérer une grille
La récupération d'une grille à partir d'une fiche d'évaluation existante s'effectue à l'aide de la feuille XSLT QSOS1.6 to Template MM disponible sur le Git du projet QSOS.
Il vous suffit alors d'appliquer cette feuille de style à l'évaluation.
Exemple :
xsltproc -o ma-grille.mm /chemin/vers/qsos1.6_to_templateMM.xsl mon-evaluation.qsos
Générer le mindmap d'une évaluation
La génération d'un mindmap pour une évaluation se fait à l'aide de la feuille XSLT QSOS1.6 to Evaluation MM disponible sur le Git du projet QSOS.
Il vous suffit alors d'appliquer cette feuille de style à l'évaluation.
Exemple :
xsltproc -o mon-mindmap.mm /chemin/vers/qsos1.6_to_evaluationMM.xsl mon-evaluation.qsos
La Figure 4 est un exemple de représentation au format MindMap d'une évaluation avec des notes et quelques commentaires.
La correspondance entre les notes et le formalisme du mindmap généré est le suivant :
- les critères notés 0 sont marqués d'une croix rouge
- les critères notés 1 sont marqués d'un point d'exclamation vert
- les critères notés 2 sont marqués d'une coche verte
- les commentaires sont des feuilles simples (nœuds finaux sans formattage bulle)
- pour chaque critère, le libellé du score correspondant à sa note est une feuille au format bulle
Répercuter les modifications d'une grille
La répercussion des modifications d'une grille à une évaluation déjà remplie se fait en deux étapes :
- Générer une évaluation vierge de la grille modifiée
- Synchroniser le contenu de l'évaluation avec l'évaluation vierge
La première étape est la procédure standard de création d'une évaluation à partir d'une grille au format MindMap.
La deuxième étape se fait avec le script Perl syncglobaldesc et nécessite l'installation de la librairie Perl QSOS-Document
Installation de la librairie QSOS-Document
Cette librairie dépend des librairies Perls suivants :
- XML::Twig
- Tie::Ixhash
Le code source de la librairie QSOS-Document peuvent être récupérés en clonant le dépôt git du projet QSOS (dans le répertoire libs/perl. Une archive avec le contenu de ce répertoire est également disponible sur qsos.org
Avant toute tentative d'installation de QSOS-Document, assurez-vous donc d'avoir préalablement installé ces librairies sur votre machine.
- Pour une machine Debian ou dérivée la commande suivante installe ces dépendances
apt-get install libxml-twig-perl libtie-ixhash-perl
- Pour une machine à base de RedHat (CentOS / SL / Fedora), cela se fait de cette manière
yum install perl-XML-Twig perl-Tie-IxHash
Une fois ces dépendances installés, vous pouvez compiler la librairie QSOS-Document à l'aide des commandes suivantes (privilèges root obligatoire pour la dernière instruction) :
cd /chemin/vers/QSOS-Document/ perl Makefile.PL make make install
Ces commandes peuvent renvoyer l'alerte suivante :
WARNING: Setting ABSTRACT via file 'lib/QSOS/Document.pm' failed at /usr/share/perl/5.12/ExtUtils/MakeMaker.pm line 583
Cette alerte peut être ignorée
Utilisation de syncglobaldesc
Le script syncglobaldesc doit être téléchargé sur votre machine
Ce script nécessite par ailleurs d'être exécutable :
chmod +x /chemin/vers/syncglobaldesc
Ce script s'utilise de la manière suivante
/chemin/vers/syncglobaldesc -l -m -r -t /chemin/vers/modele-vierge.qsos -f /chemin/vers/evaluation.qsos
Cette commande affiche uniquement les différences trouvés entre le modèle et l'évaluation. Pour que la synchronisation soit effective, ajouter l'option -s à cette commande :
/chemin/vers/syncglobaldesc -l -m -r -t /chemin/vers/modele-vierge.qsos -f /chemin/vers/evaluation.qsos
/!\ ATTENTION /!\ L'option -s présente dans cette dernière commande écrase sans autre avertissement l'évaluation (evaluation.qsos)
