Configurer Xsquash dans Jira

Xsquash et Xsquash Cloud renforcent l'intégration entre SquashTM et Jira Data Center et Cloud. Ils récupèrent les cas de test et les exécutions associés aux exigences synchronisées avec Xsquash4Jira dans SquashTM, afin de les afficher directement dans les demandes Jira.

Configurer Xsquash sur Jira Data Center

Xsquash est un composant additionnel pour Jira Data Center, disponible sur l'Atlassian Marketplace.

Installation de Xsquash

Pour installer Xsquash sur Jira Data Center :

1. Se connecter à l'instance Jira en tant qu'administrateur ;
2. Aller sur l'Administration Jira et choisir l'option Gérer les apps. L'Atlassian Marketplace pour Jira s'affiche ;
3. Rechercher "Xsquash" sur la Marketplace ;
4. Cliquer sur le bouton [Installer] pour télécharger et installer le plugin.

Pour installer une précédente version du plugin Xsquash sur Jira :

1. Se rendre sur la page Historique des versions de Xsquash sur la Marketplace ;
2. Télécharger la version souhaitée sur le poste utilisateur ;
3. Se connecter à l'instance Jira en tant qu'administrateur ;
4. Importer manuellement le plugin en utilisant la fonctionnalité Importer l'app de la page Gérer les apps.

Déclarer un serveur dans Xsquash

La configuration du plugin Xsquash se fait depuis l'Administration Jira, section Gérer les apps. Dans le menu gauche de l'écran, rechercher "Xsquash" puis cliquer sur [Configuration]. Xsquash permet de configurer plusieurs serveurs Xsquash4Jira issus de différentes instances SquashTM :

Pour ajouter un nouveau serveur, cliquer sur le bouton [Ajouter] et remplir le formulaire avec les informations suivantes :

• le nom du serveur (nom libre) ;
• l'URL de base de SquashTM (s'arrêter à /squash) ;
• le nom du serveur de type jira.xsquash déclaré dans SquashTM qui correspond à l'instance Jira (bien respecter la casse) ;

• selon le mode d'authentification, le login et le mot de passe, ou un jeton d'API avec droits de lecture d'un compte SquashTM. Ce compte sera utilisé pour toutes les requêtes API envoyées à SquashTM par le plugin.

  Warning

  L'authentification basique ne sera plus disponible mi-2027, cliquer ici pour en savoir plus.

  En savoir plus

  Pour en savoir plus sur la génération de jetons d'API dans SquashTM, consulter la section Jetons d'API personnels.

  Il est recommandé d'utiliser un compte administrateur SquashTM pour cette configuration car celui-ci a accès à tous les projets de l'instance. Mais il est tout à fait possible d'utiliser un compte ne disposant que de droits de lecture (profil "Invité") sur les projets SquashTM contenant les données de recette (cas de test et exécutions) à synchroniser côté Jira.

Configurer Xsquash sur un projet

Le plugin Xsquash se configure indépendamment pour chaque projet Jira.

Pour configurer Xsquash sur un projet, accéder aux Paramètres du projet, rechercher "Xsquash" dans le menu vertical puis cliquer sur [Configuration]. Activer Xsquash à l'aide du bouton radio puis sélectionner le serveur souhaité dans la liste.

Par défaut, les onglets de synchronisation des données de recette SquashTM sont nommés Cas de test SquashTM et Exécutions SquashTM. La pop-up de configuration permet de renommer ces onglets affichés sur les demandes Jira du projet. Une fois la configuration terminée, cliquer sur [Sauvegarder].

Configurer Xsquash Cloud (Forge) sur Jira Cloud

Xsquash Cloud (Forge) est une application disponible sur l’Atlassian Marketplace.

Migration des données de Xsquash Cloud (Connect) à Xsquash Cloud (Forge)

Cette fonctionnalité permet à un administrateur Jira d'importer la configuration de l'application précédente (serveurs et paramétrage des projets associés) directement dans la nouvelle application. Pour cela, le fichier de configuration doit être récupéré auprès de nos équipes, sur simple demande. Une fois ce fichier importé, les serveurs sont automatiquement créés et activés sur les projets Jira Cloud concernés.

Pour importer les serveurs existants et les activer sur les projets Jira, suivre les étapes :
1. Installer l'application depuis l'Atlassian Marketplace ;
2. Contacter le support SquashTM en précisant explicitement le souhait d'effectuer la migration de Xsquash Cloud (Connect) vers Xsquash Cloud (Forge) ;
3. Le support fournit un ou plusieurs fichier(s) de migration au format JSON ;
4. Importer ce ou ces fichier(s) JSON dans l'application afin de restaurer la configuration des serveurs et les activer automatiquement sur les projets concernés. Dans le cas où plusieurs fichiers JSON ont été fournis, celui contenant la configuration des serveurs doit être importé en premier.

Installation de Xsquash Cloud

Déclarer un serveur dans Xsquash Cloud

Pour configurer Xsquash Cloud, cliquer sur [Paramètres] > Apps Marketplace puis dans le menu à gauche de l'écran, rechercher "Xsquash" puis cliquer sur [Configuration]. Xsquash permet de configurer plusieurs serveurs Xsquash4Jira issus de différentes instances SquashTM :

Pour télécharger les logs :
1. Cliquer sur Paramètres, puis dans les paramètres administrateur Jira sur Apps Jira ;
2. Dans le menu à gauche, cliquer sur Accès aux apps ;
3. Sur la nouvelle page, dans le menu à gauche, cliquer sur Sites et sélectionner l'instance sur laquelle l'application est installée ;
4. Dans le menu à gauche, cliquer sur Apps connectées ;
5. Rechercher Xsquash ;
6. Cliquer sur Afficher les informations de l'app en bout de ligne ;
7. Dans le bloc Analyses et journaux, cliquer sur [Télécharger les journaux].

Cliquer sur le bouton [Ajouter un serveur SquashTM] pour ajouter un nouveau serveur SquashTM et remplir le formulaire avec les informations suivantes :

• le nom du serveur (nom libre) ;
• l'URL de base de SquashTM (s'arrêter à /squash) ;
• le nom du serveur de type jira.xsquash déclaré dans SquashTM qui correspond à l'instance Jira (bien respecter la casse) ;

• le jeton d'API avec droits de lecture d'un compte SquashTM. Ce compte sera utilisé pour toutes les requêtes API envoyées à SquashTM par le plugin.

  Warning

  L'authentification basique ne sera plus disponible mi-2027, cliquer ici pour en savoir plus.

  En savoir plus

  Pour en savoir plus sur la génération de jetons d'API dans SquashTM, consulter la section Jetons d'API personnels.

  Il est recommandé d'appliquer le principe de moindre privilège : utiliser un jeton d'API en lecture seule correspondant à un compte technique ne disposant que du profil "Invité" sur les projets SquashTM devant être accessibles depuis Jira.

Configurer Xsquash Cloud sur un projet

Le plugin Xsquash Cloud se configure indépendamment pour chaque projet.

Pour configurer Xsquash Cloud sur un projet, accéder aux Paramètres de l'espace, puis cliquer sur [Xsquash] dans le menu vertical. Activer Xsquash à l'aide du bouton radio puis sélectionner le serveur souhaité dans la liste.

Par défaut, les onglets de synchronisation des données de recette SquashTM sont nommés Cas de test SquashTM et Exécutions SquashTM. La pop-up de configuration permet de renommer ces onglets affichés sur les demandes Jira du projet. Une fois la configuration terminée, cliquer sur [Enregistrer].

Aperçu d'une demande Jira

Sur Jira Data Center et Jira Cloud, les onglets ajoutés par Xsquash s'affichent dans le bloc Activité des demandes du projet configuré.
Pour plus d'information, voir la page Suivre les activités de test dans Jira.