Guide de l'administrateur - Squash TM v1.4.0

Guide de l'administrateur - Squash TM v1.4.0 Fichier : Squash - SP 3.1 - Squash TM - F_Déploiement - Guide administrateur Squash TM.1.4.0 v01.00.00.doc Page 1

Copyright Ce document est la propriété de SQUASH. Licence Ce document et toutes ses annexes sont placés sous les termes de la licence Creative Commons Attribution- NonCommercial-NoDerivs 3.0 Unported License, dont les principales dispositions sont rappelées ci-dessous. You are free : to Share to copy, distribute and transmit the work Under the following conditions : Attribution You must attribute the work in the manner specified by the author or licensor (but not in any way that suggests that they endorse you or your use of the work). Noncommercial You may not use this work for commercial purposes. No Derivative Works You may not alter, transform, or build upon this work. With the understanding that : Waiver Any of the above conditions can be waived if you get permission from the copyright holder. Public Domain Where the work or any of its elements is in the public domain under applicable law, that status is in no way affected by the license. Other Rights In no way are any of the following rights affected by the license: o Your fair dealing or fair use rights, or other applicable copyright exceptions and limitations; o The author's moral rights; o Rights other persons may have either in the work itself or in how the work is used, such as publicity or privacy rights. Notice For any reuse or distribution, you must make clear to others the license terms of this work. The best way to do this is with a link to this web page. Page 2

Historique des versions Version Date Auteur(s) Description 00.00.01 10/12/2012 Laurent MASSER [Henix] Création 01.00.00 04/03/2013 Laurent MASSER [Henix] Publication en ligne Page 3

Sommaire Historique des versions... 3 Sommaire... 4 1 Généralités... 6 1.1 Présentation générale de la page d administration... 6 1.1.1 Page d administration... 6 2 Gestion des Utilisateurs... 8 2.1 Présentation de la page de gestion des utilisateurs... 8 2.1.1 Ajouter un utilisateur... 9 2.1.2 Consulter/modifier un utilisateur... 9 2.1.3 Ajouter des habilitations à un utilisateur... 10 3 Gestion des projets... 11 3.1 Présentation de la page de Gestion des projets... 11 3.2 Ajouter un projet/créer un projet à partir d un modèle... 12 3.3 Consulter/modifier un projet... 13 3.3.1 L onglet Principal :... 14 3.3.2 L onglet Champs personnalisés :... 17 4 Gestion des bugtrackers... 20 4.1 Informations générales... 20 4.2 Paramétrer un bugtracker... 20 5 Gestion des Champs personnalisés... 22 Page 4

5.1 Informations générales... 22 5.2 Paramétrer un champ personnalisé... 22 5.2.1 Types de champ et notions de base... 22 5.2.2 Ajouter un champ personnalisé... 23 6 Administration des pages Login et Accueil... 24 6.1 Changer le message de la page de connexion... 24 6.2 Changer le message de la page d accueil... 24 Page 5

1 Généralités Guide d administration de l outil SQUASH. L objet de cet outil est de présenter les fonctions d administration de l outil Squash TM. 1.1 PRESENTATION GENERALE DE LA PAGE D ADMINISTRATION 1.1.1 Page d accueil La page d administration est accessible grâce au bouton [Administration] de la page d accueil : Barre de menu Espace Home Espace Exigences Barre de navigation Espace Cas de Tests Espace Campagnes Espace Bugtracker Espace Rapport Page 6

1.1.2 La page d administration La page d administration présente les informations de la manière suivante : La barre de navigation à gauche de l écran : Elle permet de naviguer entre les espaces de l application (Cf. Guide de l utilisateur). La barre de menu : Elle permet de consulter son compte, d accéder à l espace administration, d utiliser le filtre global et de se déconnecter de l applicatiton (Cf. Guide de l utilisateur). La zone de travail : Elle est composée des 6 boutons d accès aux espaces de gestion de Squash TM et d un bloc statistique. Les 6 boutons sont détaillés ciaprès. Le bloc statistique présente la version applicative en exécution, le nombre de projets et d utilisateurs créés dans l application, ainsi que la somme de tous les éléments créés par type d élément (exigences, cas de test, campagne, itération, suite de tests). Page 7

2 Gestion des Utilisateurs La gestion des utilisateurs est accessible grâce au bouton 2.1 PRESENTATION DE LA PAGE DE GESTION DES UTILISATEURS La page de gestion des utilisateurs présente les informations suivantes : Un bouton [Retour] permet de revenir à la page d administration Le tableau des utilisateurs présentant les utilisateurs enregistrés dans l application. Un bouton [Ajouter un utilisateur] qui permet comme son nom l indique de créer de nouveaux utilisateurs. Page 8

2.1.1 Ajouter un utilisateur La procédure d ajout d un utilisateur est la suivante : 1. Le bouton ouvre une pop-up. 2. Remplissez les informations obligatoires Login, Prénom, Nom, Mot de passe et Confirmation puis cliquez sur [Ajouter]. 3. L utilisateur est ajouté au tableau des utilisateurs. 2.1.2 Consulter/modifier un utilisateur Il est possible de consulter/modifier les informations d un utilisateur en cliquant sur son login dans le tableau des utilisateurs. On accède alors à la page de consultation de l utilisateur qui se présente ainsi : Page 9

Le bloc Informations utilisateurs permet de modifier les données caractérisant un utilisateur. Le bloc Habilitations permet d habiliter un utilisateur aux projets créés dans Squash. Ainsi il est possible d assigner un profil au sein du groupe accordé à l utilisateur (Cf. Gestion des habilitations). L icône permet de supprimer l habilitation sélectionnée. 2.1.3 Ajouter des habilitations à un utilisateur Pour ajouter des habilitations à un utilisateur il faut cliquer sur le bouton dans le bloc Habilitations : 1. Une pop up s ouvre dans laquelle vous pouvez choisir le projet et la permission associée à ce projet pour l utilisateur concerné. 2. Cliquer sur le bouton [Ajouter] le tableau du bloc Habilitations est mis à jour. FOCUS : Vous pouvez modifier les habilitations de l utilisateur sur le projet directement depuis le tableau en cliquant sur la liste déroulante de la colonne Profil. Un utilisateur peut avoir des profils différents sur des projets différents. Page 10

3 Gestion des projets L espace de Gestion des projets est accessible grâce à ce bouton sur la page d administration. 3.1 PRESENTATION DE LA PAGE DE GESTION DES PROJETS La page de gestion des projets affiche les informations de la manière suivante : Un bouton [Retour] permet de revenir à la page d administration. Le tableau des projets présente les projets créés dans l application. Un bouton [Ajouter un projet] permet de créer de nouveaux projets. Un bouton [Créer à partir d un modèle de projet] permet de créer un projet à partir d un modèle. Page 11

3.2 AJOUTER UN PROJET/CREER UN PROJET A PARTIR D UN MODELE La procédure de création d un projet est la suivante : 1. Le bouton ouvre une pop-up. 2. Remplissez les informations obligatoires : Nom. 3. Cliquer sur le bouton [Ajouter] 4. Le projet est créé et apparaît dans le tableau. FOCUS : Tous les champs de la pop-up sont modifiables après création. La case à cochée Modèle de Projet permet d ajouter ce projet dans la liste des modèles de projets, accessible depuis le bouton [Créer à partir d un modèle de projet]. Une icône apparait dans la colonne dédié dans le tableau des projets. Page 12

3.3 CONSULTER/MODIFIER UN PROJET La page de consultation d un projet est accessible en cliquant sur le nom du projet dans le tableau des projets. La page de consultation d un projet présente les informations de cette manière : Page 13

La page comprend différents éléments : Un bouton [Renommer] qui permet de modifier le nom du projet. Un bouton [Supprimer] qui permet d effacer le projet sous condition qu il ne contienne plus de données (exigences, cas de test, campagnes, itérations, suites de tests). Et 2 onglets détaillés ci-après. 3.3.1 L onglet Principal : Cet onglet est organisé en 5 blocs escamotables : Bloc Informations projet dans lequel il est possible de modifier l étiquette (champ texte simple) et la description (éditeur riche) du projet. Bloc Bugtracker dans lequel il est possible de lier un bugtracker au projet. (ne s affiche que si vous avez configuré un bugtracker à l application). Bloc Utilisateurs dans lequel il est possible d ajouter des utilisateurs sur le projet et de modifier leur habilitation. Bloc Automatisation dans lequel vous pouvez activer le lien TM/TA sur le projet et de relier ce projet à Squash TA Server. Bloc Pièces jointes depuis lequel vous pouvez ajouter des pièces jointes au projet (pièces uniquement accessible depuis cet espace, exemple, document de gestion des habilitations, procédure de connexion au bugtracker, procédure d activation du lien TM/TA ). Un Onglet Champs personnalisés : Il comprend 5 onglets respectivement dédié à l administration des champs personnalisés pour les différents éléments de Squash TM, exigences, cas de tests, campagnes, itérations et suites de tests. 3.3.1.1 Configurer le lien avec le bugtracker : La configuration du lien avec le bugtracker s effectue depuis le bloc Bugtracker, en suivant la procédure suivante. Pré-requis : avoir configuré un bugtracker dans Squash (Cf. 1. Le champ Bugtracker propose une liste déroulante affichant proposant plusieurs choix : a. Pas de bugtracker : cette option signifie qu aucun bugtracker n est relié au projet b. Le nom des bugtrackers paramétrés dans l application. Choisissez l option que vous souhaitez. Page 14

2. Définissez dans le champ Nom du projet dans le bugtracker, l intitulé du projet configuré dans votre bugtracker, en respectant scrupuleusement l orthographe et la casse. FOCUS : Une fois qu un bugtracker est relié à un projet, il sera possible de relever des anomalies depuis les exécutions des cas de test (cf.) Il sera alors nécessaire de vous connecter grâce à des identifiants configurés dans le bugtracker choisi. 3.3.1.2 Ajout d utilisateurs sur le projet / modification des habilitations des utilisateurs Pré-requis : Avoir créé des utilisateurs depuis l espace Gestion des utilisateurs (cf. Ajouter un utilisateur) Il est possible d ajouter des utilisateurs sur un projet depuis le bloc Utilisateurs en suivant la procédure suivante : 1. Dans le bloc utilisateurs cliquez sur le bouton 2. Une pop-up s ouvre dans laquelle vous devez renseigner le Login de l utilisateur à ajouter. Une liste déroulante vous permet de choisir le profil et les droits associés à l utilisateur sur ce projet. 3. Cliquez sur [Ajouter], l utilisateur apparait dans le tableau du bloc Utilisateurs. FOCUS : Le champ de texte simple propose la saisie par auto-complétion. Ainsi, dès les premières lettres inscrites, le champ affiche une liste déroulante contenant tous les utilisateurs dont les logins commencent par les lettres saisies. La colonne Profil du tableau du bloc Utilisateurs contient une liste déroulante affichant les profils disponible pour l utilisateur. Vous pouvez modifier le profil des utilisateurs depuis cet endroit. Notez que cette modification ne sera effective que sur le projet depuis lequel elle a été effectuée. 3.3.1.3 Paramétrer le lien TM/TA L activation du lien TM/TA sur un projet est paramétrable depuis le bloc Automatisation : Page 15

Cependant, il est nécessaire de suivre les quelques étapes ci-dessous : Cette fonctionnalité fait intervenir plusieurs outils de la suite outillée Squash. Pour Squash TA Server et Squash TA veillez consulter la documentation en ligne à l adresse suivante : http://www.squashtest.org/index.php/fr/squash-ta/decouvrir-squash-ta Pré-requis : avoir installé Squash TM et Squash TA server. Avoir créé au moins un projet dans Squash TM. Squash TM doit être à l'arrêt. Les étapes 1 à 7 s effectuent depuis Squash TM. Les étapes 8 et 9 s effectuent depuis Squash TA Server 1. Rendez-vous dans le dossier Services qui se situe dans votre répertoire d installation de Squash TM. Ex: C:\Squash-TM_1.4.0\conf\services. 2. Ouvrez le fichier tm.testautomatisation.conf.properties. 3. Renseignez les informations suivantes dans le champ suivant : tm.test.automation.server.callbackurl= "indiquez l'url de votre Squash TM" ex: http://192.168.2.24:8080/squash/ Cette adresse sera utilisée par Squash TA server pour notifier de l'avancement des tests à Squash TM. 4. Lancez Squash TM. Rendez-vous dans la gestion des projets. 5. Cliquez sur le libellé du projet que vous souhaitez lier à Squash TA server. 6. Dans le bloc Automatisation, renseignez les champs suivants : Activation du lien TM/TA : validez la checkbox. Url du serveur TA : "indiquez l'url de votre Squash TA server". Login : indiquez le login de JIM (voir étape 8). Mot de passe : indiquez le mot de passe de JIM. 7. Dans Squash TM, créez un utilisateur "Bob" dont le groupe d'habilitation est "Serveur d'automatisation des tests". Attribuez-lui un couple login/mdp. Cet utilisateur servira d'utilisateur pour Squash TA server pour se connecter à Squash TM. Voir schéma ci-dessus. 8. Dans Squash TA Server, créez un utilisateur "JIM" accrédité des droits nécessaires à la lecture et à l'exécution de projets de tests automatisés. Associez-lui un couple Login/Mdp. "JIM" servira d'utilisateur à Squash TM pour se connecter à Squash TA server. Page 16

9. Depuis le fichier conf.properties, situé dans le dossier execution_home de votre répertoire d'installation de Squash TA Server, renseignez les informations suivantes : (Url de Squash TM).login = "login de bob" (Url de Squash TM).password = "mot de passe bob" Exemple: http\://192.168.2.24\:8080/squash.login = taserver http\://192.168.2.24\:8080/squash.password = tapass Attention : Les antislashs sont obligatoires devant tous les ":". Désormais votre projet est lié à Squash TA server. Dans ce projet, vous pourrez alors associer des scripts de tests automatisés à des cas de test TM. Vous pourrez ensuite exécuter ces tests automatisés depuis l espace campagne et lire les résultats de leurs exécutions. 3.3.1.4 Ajouter des pièces jointes à un projet : Il est possible d ajouter des pièces jointes à la page de consultation d un projet depuis le bloc Pièces jointes : 1. Depuis le bloc Pièces jointes, cliquez sur le bouton [Ajouter]. Une pop-up «Attacher de nouvelles pièces» apparaît. 2. Cliquez sur le bouton [Parcourir ] choisissez la pièce jointes que vous souhaitez ajouter au projet. 3. Cliquez sur le bouton [Envoyer], le bloc Pièces jointes est mise à jour avec une icône représentant la pièce jointe choisie. FOCUS : Attention le format et la taille des pièces jointes est paramétrables. Pour en savoir plus veillez suivre ce lien : Comment paramétrer la gestion des pièces jointes (taille et extensions autorisées)? 3.3.2 L onglet Champs personnalisés : L onglet Champs personnalisés présente 5 blocs escamotables depuis lesquels il est possible d ajouter des champs personnalisés aux éléments suivants : 1. Exigences 2. Cas de test 3. Campagne Page 17

4. Itération 5. Suite de tests Page 18

Pour ajouter des champs personnalisés veillez suivre la procédure suivante. Pré requis : avoir créé des champs personnalisés dans l espace Gestion des Champs personnalisés. 1. Depuis la page de consultation du projet, cliquez sur l onglet Champs personnalisés. 2. Cliquez le bouton [Ajouter un champ personnalisé] dans le bloc escamotable dédié au type d élément auquel vous voulez voir apparaitre le champ personnalisé. 3. Dans la pop-up est listé sous forme de tableau, l ensemble des champs personnalisés paramétrés dans l espace Gestion des Champs personnalisés. Choisissez le champ personnalisé voulu, puis cliquez sur le bouton [Oui]. 4. Le bloc est mis à jour avec le nom du champ personnalisé précédemment ajouté. FOCUS : Une fois associé à un projet, un champ personnalisé peut être retiré. Il suffit de cliquer sur l icône de suppression en bout de ligne du tableau du bloc dédié. Cette action ne supprime que l association et non le champ personnalisé en lui-même. (cf. Page 19

4 Gestion des bugtrackers 4.1 INFORMATIONS GENERALES Squash TM supporte deux bugtrackers : 1. Mantis nativement supporté par Squash TM. 2. Jira grâce à un plugin dédié. Pour en savoir plus sur Jira, une documentation est disponible en suivant ce lien : Comment installer le plugin Jira? 4.2 PARAMETRER UN BUGTRACKER Pour paramétrer un bugtracker il faut suivre ces quelques étapes : Pré-requis : Avoir correctement installé le bugtracker choisi. 1. Depuis la page d accueil de l administration, cliquez sur le bouton [Gestion des bugtrackers]. Une page s ouvre affichant un tableau et un bouton [Ajouter un bugtracker]. 2. Cliquez sur le bouton [Ajouter un bugtracker]. Une pop-up s ouvre : Page 20

3. Renseignez les informations demandées : a. Nom : champ texte 255 caractères max. b. Type : Liste déroulante proposant soit Mantis ou Jira (sous réserve que le plugin Jira soit installé dans le dossier plugin du répertoire d installation de Squash TM). c. Url : adresse url de votre bugtracker ex : http://localhost/mantis. d. S affiche dans l Iframe : Jira : Jira supporte cette fonctionnalité. Si la case est cochée, lorsque vous cliquez sur le bouton de l espace Bugtracker dans la barre de navigation, le bugtracker s affichera dans la zone de travail. Si la case n est pas cochée, Jira s ouvrira dans une nouvelle fenêtre. Mantis : Mantis ne supporte pas cette fonctionnalité. Si la case est cochée et que vous cliquez sur le bouton de l espace bugtracker. 4. Cliquer sur le bouton [Ajouter]. Le tableau de l'espace bugtracker est mis à jour avec les informations précédemment renseignée. Page 21

5 Gestion des Champs personnalisés 5.1 INFORMATIONS GENERALES Depuis l espace Gestion des Champs personnalisés, vous pouvez ajouter des champs personnalisés à Squash TM. Ce sont des éléments personnalisables qui seront ajoutés de la manière suivante selon les éléments cibles dans l application : Exigences : les champs personnalisés seront ajoutés au bloc Informations générales. Cas de test : dans le bloc Description. Campagne, Itération, Suite de tests : dans le bloc dédié Champs personnalisés. 5.2 PARAMETRER UN CHAMP PERSONNALISE 5.2.1 Types de champ et notions de base Il existe trois types de champ personnalisé : Le champ texte simple. La case à cocher ou checkbox. La liste déroulante. FOCUS : Il est nécessaire d apporter quelques explications concernant les termes employés dans cet espace. Le «Nom» du Champ personnalisé est ce qui s affichera dans les différents tableaux de l espace administration à savoir : Le tableau des champs personnalisés La liste déroulante de la pop-up d Ajout des champs personnalisés et dans les tableaux dédiés de l onglet Champs personnalisés de la Gestion des projets. Le «Libellé» du champ est ce qui s affichera dans les espaces décrit en 5.1 Informations générales Page 22

5.2.2 Ajouter un champ personnalisé Pour ajouter un champ personnalisé à Squash TM, suivez ces quelques points : 1. Depuis la page de Gestion des champs personnalisés cliquez sur le bouton [Ajouter un champ personnalisé]. 2. Une pop-up s ouvre dans laquelle vous devez renseigner les champs suivants : le Nom. le Libellé. le Code. le type de contrôle de l item : liste déroulante (texte simple, dates, liste, oui/non...), une liste de valeurs (pour les champs de type de contrôle "liste" et "case à cochée"), une checkbox obligatoire (cochée par défaut), un champ valeur par défaut (pour les champs de type de contrôle «texte simple» et «case à cochée». Optionnel : si non coché, alors le champ personnalisé doit obligatoirement être renseigné à la création de l élément qui lui est associé. Voici les pop-up en fonction du type de contrôle choisit : 3. Cliquez ensuite sur le bouton [Ok]. Le champ personnalisé est désormais ajouté au tableau des champs personnalisés. Il peut être associé à un projet comme expliquer en 3.3.2 L onglet Champs personnalisés : FOCUS : Pour les champs personnalisés de type de contrôle Liste déroulante, il est nécessaire d ajouter des options. Les options sont les choix affichés dans la liste déroulante. Vous pouvez modifier le nom, le libellé, le code, la valeur par défaut ainsi que les options après création du champ personnalisé. Page 23

6 Administration des pages Login et Accueil Il est possible de modifier les messages d accueil de l application pour se faire deux boutons sont dédiés à chaque message : Le message de la page de connexion. Le message de la page d accueil. 6.1 CHANGER LE MESSAGE DE LA PAGE DE CONNEXION La procédure est très simple : 1. Dans la page d administration, cliquez sur le bouton [Changer le message de la page de login]. 2. Une page apparait dont la zone de travail est un éditeur riche. Dans celui-ci vous pouvez insérer le texte et les éléments que vous souhaitez dans la limite des fonctionnalités à votre disposition dans la barre d outils. 6.2 CHANGER LE MESSAGE DE LA PAGE D ACCUEIL La procédure est identique à celle du message de connexion à l application. Si ce n est qu un bouton lui est dédié dans la page d administration. Page 24