Connectez votre instance Squash TM depuis la page « Connecteurs » avec son URL et un jeton d'API personnel. Thunders AI peut alors lire vos cas de test et vos exigences Squash TM, les transformer en cas de test Thunders, et créer ou modifier des cas de test dans Squash TM. Après une exécution, Thunders enregistre le résultat comme une nouvelle exécution dans une itération Squash TM, manuellement depuis le rapport d'exécution ou automatiquement à la fin de l'exécution.
Avant de commencer
Squash TM 7.1 ou version ultérieure.
Un jeton d'API personnel de votre compte Squash TM, avec la permission « Lecture et écriture ». Créez-le dans Squash TM, sous « Mon compte » > « Jetons personnels d'API ». Squash TM n'affiche le nouveau jeton qu'une seule fois : copiez-le avant de fermer la fenêtre.
L'URL de votre Squash TM, avec le chemin après le domaine, par exemple
https://squash.example.com/squash.Un serveur Squash TM que Thunders peut joindre, depuis Internet ou via le relais de votre organisation. Consultez la section « Connecter un serveur Squash TM sur un réseau privé » ci-dessous.
Connecter Squash TM
Ouvrez votre projet de test et accédez à la page « Connecteurs ».
Repérez Squash TM dans la liste et cliquez sur « Connecter ».
Dans « URL de Squash TM », saisissez l'adresse de votre Squash TM, avec le chemin après le domaine.
Dans « Jeton d'API personnel », collez votre jeton. Pour les étapes de création du jeton, cliquez sur « Comment créer ce jeton ? ».
Cliquez sur « Connecter ». Thunders vérifie l'URL et le jeton, confirme avec le message « Squash TM connecté », puis ouvre la page des paramètres de Squash TM. Pour synchroniser les résultats des exécutions, choisissez-y une itération par défaut. Consultez la section « Synchroniser automatiquement » ci-dessous.
Une fois la connexion établie, Squash TM apparaît dans le sélecteur de sources, en bas du champ de saisie de Thunders AI.
Les connexions à Squash TM sont personnelles : chaque utilisateur se connecte avec son propre jeton d'API, par projet. Thunders stocke le jeton sous forme chiffrée. Les membres de l'équipe configurent leur propre accès depuis la même page « Connecteurs ». |
Connecter un serveur Squash TM sur un réseau privé
Si votre serveur Squash TM n'est joignable que depuis le réseau de votre entreprise, Thunders le joint via le relais de votre organisation. Le relais doit être démarré et pouvoir joindre le serveur Squash TM chaque fois que Thunders se connecte, lit des données dans Squash TM ou synchronise un résultat. Si le relais n'est pas démarré, Thunders affiche « Votre relais est hors ligne. Démarrez-le puis réessayez. » Si votre organisation n'a pas encore de relais, contactez [email protected].
Si la connexion échoue
Thunders affiche | Que faire |
« Squash TM a refusé le jeton d'API. Vérifiez le jeton (Mon compte → Jetons d'API) et que l'URL est la racine de l'instance (ex. | Créez un nouveau jeton d'API et collez-le à nouveau. Vérifiez que l'URL se termine par le chemin après le domaine, sans rien après. |
« L'API REST Squash TM est introuvable à cette URL. Vérifiez qu'elle inclut le chemin de contexte (ex. /squash). » | Ajoutez le chemin après le domaine à l'URL, par exemple |
« Cette URL ne répond pas comme l'API REST Squash TM (elle est peut-être derrière une page de connexion ou un proxy). Vérifiez l'URL, y compris le chemin de contexte (ex. /squash). » | L'URL ouvre une page de connexion, et non Squash TM. Utilisez l'adresse du serveur Squash TM lui-même, avec le chemin après le domaine. |
« Thunders ne peut pas joindre cette adresse. Vérifiez l'URL. » | Vérifiez que l'URL ne contient pas d'erreur de saisie. Pour un serveur sur un réseau privé, vérifiez que votre relais est démarré et peut joindre le serveur. |
« Cette URL Squash TM n'est pas autorisée. Elle doit pointer vers une adresse publique sur Internet, et non vers un réseau local ou privé. » | L'adresse se trouve sur un réseau privé, et aucun relais de votre organisation ne l'a jointe. Utilisez une adresse publique, ou connectez-vous via un relais qui peut joindre le serveur. |
Si Squash TM ne peut pas créer votre jeton et affiche « Aucun secret JWT n'est défini pour cette instance. Veuillez vous rapprocher de votre administrateur SquashTM. », l'administrateur de Squash TM doit d'abord définir squash.rest-api.jwt.secret sur le serveur Squash TM. Ce réglage se fait côté Squash TM, et non dans Thunders.
Utiliser Squash TM avec Thunders AI
Activez Squash TM dans le sélecteur de sources, et nommez Squash TM dans votre demande. Thunders AI n'utilise Squash TM que si vous le nommez : une demande de création ou de rédaction de test qui ne mentionne pas Squash TM crée uniquement un cas de test Thunders.
Squash TM ne propose pas de recherche par mot-clé. Indiquez à Thunders AI le projet et le nom, la référence ou l'identifiant du cas de test : il parcourt les dossiers du projet pour le trouver.
Importer un cas de test Squash TM existant
Exemple Vous : Dans le projet Squash TM [nom du projet], lisez le cas de test « Paiement avec une carte enregistrée » et créez un cas de test Thunders à partir de celui-ci. |
Thunders AI lit le cas de test Squash TM, avec son prérequis, sa description et toutes ses étapes dans l'ordre, et rédige un cas de test Thunders qui conserve les mêmes étapes.
Le nouveau cas de test garde un lien vers sa source. Dans le panneau des propriétés du cas de test, la liste « Source » affiche le cas de test Squash TM par sa référence et son nom, par exemple « TC-001 · Paiement avec une carte enregistrée », avec un lien vers Squash TM. La colonne « Type » affiche son type Squash TM : « Classique », « Gherkin », « BDD » ou « Exploratoire ». Pour supprimer le lien, cliquez sur « Détacher ». Thunders arrête alors de synchroniser les nouvelles exécutions de ce cas de test, et les exécutions déjà synchronisées le restent.
Créer un test Thunders à partir d'une exigence Squash TM
Exemple Vous : Dans le projet Squash TM [nom du projet], lisez l'exigence « Cartes de paiement enregistrées » et créez un cas de test Thunders qui la couvre. |
Thunders AI lit l'exigence, avec sa description actuelle et les cas de test Squash TM qui la vérifient déjà, et s'en sert comme contexte pour le nouveau cas de test.
Créer un cas de test dans Squash TM
Exemple Vous : Créez ce cas de test dans le projet Squash TM [nom du projet]. |
Thunders AI recherche les projets Squash TM que votre jeton d'API peut voir. S'il n'y en a qu'un, il l'utilise. S'il y en a plusieurs et que votre demande n'en nomme aucun, il vous demande de choisir. Il crée un cas de test classique, écrit chaque étape sous forme d'action avec son résultat attendu, et vous indique l'identifiant et le nom du nouveau cas de test.
Si vous faites la demande depuis un cas de test Thunders, Thunders lie le nouveau cas de test Squash TM à celui-ci, pour que vous puissiez synchroniser ses exécutions avec Squash TM.
Modifier un cas de test dans Squash TM
Exemple Vous : Mettez à jour le cas de test Squash TM lié avec les étapes actuelles de ce cas de test. |
Thunders AI ne modifie un cas de test Squash TM existant que si vous le demandez, et uniquement un cas de test classique. Il met à jour le nom, la description, le prérequis ou les étapes que vous demandez, puis vous indique les étapes mises à jour, ajoutées et supprimées. Les étapes qui appellent un autre cas de test restent inchangées.
Synchroniser les résultats avec Squash TM
Thunders enregistre chaque exécution que vous synchronisez comme une nouvelle exécution du cas de test Squash TM lié, dans l'itération que vous choisissez. Vous pouvez synchroniser une exécution manuellement depuis son rapport, ou activer la synchronisation automatique. Seules les exécutions d'un cas de test lié à un cas de test Squash TM peuvent être synchronisées. Ce lien est créé lorsque vous importez un cas de test depuis Squash TM, ou que vous en créez un dans Squash TM via Thunders AI.
Synchroniser manuellement
Ouvrez le rapport d'une exécution terminée.
Dans le panneau des propriétés, la section « Source » affiche le cas de test Squash TM lié et le message « Pas encore synchronisé avec Squash ».
Cliquez sur « Synchroniser avec Squash ». La fenêtre affiche « Choisissez l'itération de ce résultat. »
Choisissez une « Campagne », puis une « Itération ». Le projet Squash est celui du cas de test lié. Si le Planning de l'exécution ou votre itération par défaut désigne déjà une itération, la fenêtre la présélectionne et indique d'où elle vient.
Cliquez sur « Synchroniser avec Squash ».
Une fois la synchronisation terminée, le bouton est remplacé par « Synchronisé avec Squash » et le numéro de la nouvelle exécution, qui l'ouvre dans Squash TM.
Si la synchronisation échoue, la section « Source » affiche la raison, et « Synchroniser avec Squash » reste disponible pour réessayer.
Synchroniser automatiquement
Sur la page « Connecteurs », cliquez sur « Gérer » sur la ligne Squash TM.
Dans « Paramètres », sous « Itération par défaut », choisissez un « Projet Squash », une « Campagne » et une « Itération ». Les exécutions sont synchronisées dans cette itération, sauf si leur Planning en définit une autre.
Activez « Synchroniser après chaque exécution ». L'interrupteur reste indisponible tant que vous n'avez pas choisi d'itération.
Cliquez sur « Enregistrer ». Thunders confirme avec le message « Paramètres enregistrés ».
Fonctionnement de la synchronisation automatique
|
Envoyer les exécutions d'un Planning dans leur propre itération
Lorsque votre connexion Squash TM a la synchronisation automatique activée, la fenêtre du Planning affiche un champ facultatif « Itération Squash », sous « Persona ». Choisissez un projet, une campagne et une itération pour y enregistrer les exécutions de ce Planning. Laissez le champ vide pour utiliser l'itération par défaut du connecteur, ou cliquez sur « Utiliser l'itération par défaut » pour effacer votre choix. Pour le reste de la fenêtre, consultez comment planifier un groupe de test.
Thunders choisit l'itération dans cet ordre :
L'itération choisie dans la fenêtre « Synchroniser avec Squash ».
L'itération définie sur le Planning de l'exécution.
L'itération par défaut de la connexion Squash TM.
Ce que Thunders enregistre dans Squash TM
L'exécution : une nouvelle exécution du cas de test dans l'itération choisie. Si le cas de test ne figure pas encore dans le « Plan d'exécution » de l'itération, Thunders l'y ajoute d'abord.
Le statut global : une exécution réussie est enregistrée en « Succès », une exécution échouée en « Échec », et une exécution interrompue, arrêtée ou annulée en « Bloqué ».
Le commentaire : une liste « Thunders steps » avec chaque étape Thunders et son résultat. Pour une étape en échec, le commentaire indique aussi ce que Thunders a trouvé : le type et la gravité du problème, l'élément, ainsi que les résultats attendu et réel. Le commentaire se termine par un lien « Thunders run: » vers l'exécution dans Thunders. Ce commentaire est rédigé en anglais.
Thunders ne fait pas correspondre ses étapes aux étapes de l'exécution Squash TM, et ne transfère pas les captures d'écran. Le résultat de chaque étape Thunders figure dans le commentaire de l'exécution. Pour voir les captures d'écran, ouvrez l'exécution Thunders depuis le lien du commentaire. |
Ce que Thunders AI peut faire avec Squash TM
Lorsque Squash TM est connecté et activé, Thunders AI peut exploiter les contenus Squash TM suivants :
Contenu Squash TM | Ce que Thunders AI peut faire |
Projets | Lister les projets que votre jeton d'API peut voir. |
Cas de test | Parcourir l'arborescence des dossiers d'un projet, lister ses cas de test, et lire un cas de test avec ses étapes et son type. Créer des cas de test classiques, et modifier un cas de test classique existant si vous le demandez. |
Exigences | Lister les exigences d'un projet, et lire une exigence avec sa description et les cas de test qui la vérifient. |
Campagnes et itérations | Lister les campagnes d'un projet et les itérations d'une campagne, et lire le Plan d'exécution d'une itération. |
Exécutions | Lire une exécution. Lorsque vous demandez d'enregistrer un résultat, créer une exécution et définir le statut de l'exécution et de chacune de ses étapes. |
Déconnecter Squash TM
Sur la page « Connecteurs », cliquez sur « Gérer » sur la ligne Squash TM, puis sur « Déconnecter », et confirmez. Cela supprime votre jeton d'API et vos réglages enregistrés, dont l'itération par défaut et la synchronisation automatique. Squash TM n'est alors plus disponible pour vous dans Thunders AI.
Questions fréquentes
Comment voir le résultat de chaque étape dans Squash TM ?
Ouvrez le commentaire de l'exécution dans Squash TM. Une synchronisation depuis Thunders enregistre le résultat global de l'exécution, et le commentaire liste chaque étape Thunders avec son résultat et un lien vers l'exécution dans Thunders. Thunders ne renseigne pas les étapes de l'exécution Squash TM.
Comment relancer une synchronisation qui a échoué ?
Cliquez à nouveau sur « Synchroniser avec Squash » dans le rapport d'exécution. La section « Source » affiche la raison donnée par Squash TM, par exemple « Squash TM a refusé la synchronisation (HTTP 403) » : vérifiez que votre jeton d'API est toujours valide et qu'il a la permission « Lecture et écriture ». Si Squash TM a créé l'exécution pendant la tentative échouée, la nouvelle tentative enregistre le résultat dans cette même exécution, sans en créer une seconde.
Comment synchroniser une exécution dans une autre itération que celle par défaut ?
Synchronisez-la manuellement. La fenêtre « Synchroniser avec Squash » présélectionne l'itération par défaut, ou celle du Planning, et vous pouvez choisir une autre campagne et une autre itération avant de confirmer. Pour envoyer toutes les exécutions d'un Planning dans une autre itération, renseignez « Itération Squash » dans la fenêtre du Planning.
Comment changer l'URL ou le jeton d'API de Squash TM ?
Déconnectez Squash TM depuis sa page « Gérer », puis connectez-le à nouveau avec la nouvelle URL ou le nouveau jeton. La déconnexion supprime votre itération par défaut et votre réglage de synchronisation automatique : définissez-les à nouveau après la connexion.