Passer au contenu principal

Intégration Xray : importer des tests, créer des tests et synchroniser les exécutions

Thunders prend en charge l'importation de tests, la création de nouveaux tests et la transmission des résultats d'exécution vers Xray.

Écrit par Ines

Thunders prend en charge l'importation de tests, la création de nouveaux tests et la transmission des résultats d'exécution vers Xray.

Thunders s'intègre nativement à Xray, rendant ainsi superflus les connecteurs tiers. L'intégration s'effectue via Thunders AI et l'interface de synchronisation des exécutions de tests.

Déploiements pris en charge

La page Connecteurs filtrée sur xray, avec les lignes Xray Data Center et Xray Cloud, toutes deux marquées Source de connaissance et synchronisation des résultats de test

Déploiement

Authentification

Remarques

Xray Cloud

Paire de clés API (ID client + secret client)

Détecte automatiquement votre point de terminaison régional (Mondial, États-Unis, UE, Australie).

Xray Data Center

Détecté automatiquement lors de la connexion à Jira Data Center

Nécessite que Jira DC soit d'abord connecté.
​
Aucun identifiant distinct n'est nécessaire.

Sur la page « Connecteurs », les lignes « Xray Cloud » et « Xray Data Center » indiquent « Source de connaissance et synchronisation des résultats de test » : Thunders AI importe et exporte des cas de test, et Thunders synchronise les résultats des exécutions avec Xray.

Les connexions à Xray sont personnelles: chaque utilisateur se connecte avec ses propres identifiants, par projet. Les membres de l'équipe configurent leur propre accès depuis la même page « Connecteurs ».

Connecter Xray Cloud

La boîte de dialogue Intégration Xray Cloud avec les champs Client ID et Client Secret et le bouton Connecter Xray Cloud
  1. Ouvrez votre projet de test, cliquez sur « Configuration », puis sur « Connecteurs ».

  2. Recherchez « Xray Cloud » dans la liste et cliquez sur « Connecter ».

  3. Saisissez votre Client ID et votre Client Secret Xray Cloud.

  4. Cliquez sur « Connecter Xray Cloud ». Thunders valide vos identifiants et détecte automatiquement votre point de terminaison régional.

  5. Une fois la connexion établie, Xray Cloud apparaît comme disponible dans le sélecteur de sources Thunders AI, dans les cas de test, les plans de test et le chat des cas de test.

Où trouver vos identifiants API Xray

Dans votre instance Xray Cloud, accédez à Paramètres > Clés API et générez une nouvelle paire de clés API. Copiez l’ID client et la clé secrète.

Connecter Xray Data Center

Xray Data Center ne nécessite pas de connexion distincte. Il est détecté automatiquement à partir de votre connexion Jira Data Center existante.

  1. Connectez d’abord Jira Data Center (URL de base + jeton d’accès personnel).

  2. Lors de la connexion à Jira DC, Thunders recherche le module complémentaire Xray. Si Xray est détecté, une invite vous demandant d’« Activer Xray DC » s’affichera directement dans la boîte de dialogue de connexion à Jira DC.

  3. Cliquez sur « Activer Xray DC » pour activer l’intégration, ou cliquez sur « Ignorer » pour connecter uniquement Jira DC.

  4. Vous pouvez également connecter Xray DC ultérieurement depuis la page « Connecteurs » en cliquant sur la vignette « Xray Data Center ».

La vignette « Xray Data Center » est désactivée tant que Jira Data Center n’est pas connecté. Si vous déconnectez Jira DC, Xray DC est automatiquement supprimé.

Connecter un serveur Jira Data Center sur un réseau privé

Si votre serveur Jira Data Center n’est accessible que depuis le réseau de votre entreprise, Thunders l’atteint par le relais de votre organisation. Lorsque vous connectez Jira Data Center, Thunders vérifie s’il peut atteindre le serveur directement ou par l’un des relais de votre organisation, et conserve le chemin qui fonctionne. Xray Data Center utilise ensuite ce même chemin pour se connecter, synchroniser les résultats des exécutions et travailler avec Thunders AI.

Le relais doit être en marche chaque fois que Thunders se connecte à Xray Data Center, y lit des données ou synchronise un résultat. Lorsque le relais n’est pas en marche, la connexion et le bouton « Synchroniser avec Xray » affichent « Votre relais est hors ligne. Démarrez-le puis réessayez. » Une synchronisation automatique qui échoue pour cette raison affiche « Échec de la dernière synchronisation. Veuillez réessayer » sur l’exécution. Démarrez le relais, puis cliquez sur « Synchroniser avec Xray » sur l’exécution. Si votre organisation n’a pas encore de relais, contactez [email protected].

Utiliser Xray avec Thunders AI

Une fois Xray connecté, activez-le à partir du sélecteur de source dans n’importe quelle interface Thunders AI (cas de test, plan de test ou discussion sur un cas de test). Thunders AI peut alors interagir avec vos données Xray.

Importer des tests Xray existants

Importez vos cas de test Xray existants dans Thunders. Indiquez une clé de test ou recherchez des tests, et Thunders AI lit les étapes, la structure et les métadonnées.

Exemple

Utilisateur : lisez XSP-1 et créez un cas de test Thunders à partir de celui-ci

Thunders AI lit le test Xray (basé sur les étapes pour les deux déploiements ; Gherkin sur Xray Cloud) et génère un cas de test Thunders qui conserve la structure d’origine. Chaque demande importe un seul test. La clé de ticket Xray est stockée en tant que mappage source dans le cas de test Thunders. Le lien est visible dans la partie « Source » du panneau des propriétés du cas de test, indiquant l’état de synchronisation avec Xray. Vous pouvez dissocier le lien du test si nécessaire.

Un cas de test Thunders créé à partir du test Xray XSP-1, avec XSP-1 comme source Xray

Importer un plan de test complet (en lot)

Indiquez un plan de test Xray à Thunders AI et l’import se fait en une seule fois : l’IA lit le plan, récupère tous les tests associés et crée les cas de test Thunders correspondants dans une même session, chacun avec son propre lien source Xray. Vous pouvez ensuite les exécuter dans Thunders et synchroniser chaque résultat vers Xray.

Exemple

Utilisateur : Lisez le plan de test XSP-10 et créez des cas de test Thunders pour tous ses tests

Thunders AI rédige des cas de test Thunders à partir des tests du plan de test Xray XSP-38

Créer de nouveaux tests dans Xray à partir de Thunders

Vous pouvez créer de nouveaux tickets de test Xray directement depuis Thunders via Thunders AI. Lorsque vous générez un cas de test et que Xray est activé, Thunders AI peut créer le test dans votre projet Xray.

Exemple

Utilisateur : Créez le test correspondant à ce cas de test dans le projet Xray [nom du projet].

Un cas de test Thunders et le test Xray XSP-58 que Thunders AI a créé à partir de celui-ci

Rechercher du contenu dans Xray

Thunders AI peut rechercher dans votre espace de travail Xray des tests, des plans de test, des ensembles de tests, des exécutions de test et des conditions préalables. Utilisez cette fonctionnalité pour identifier la couverture existante avant de rédiger de nouveaux tests.

Exemple

Vous : Recherchez dans XRAY [nom du projet] tous les tests liés au flux de connexion

Thunders AI recherche dans le projet Xray XSP les tests liés au flux de connexion

Utiliser les tests XRAY comme contexte

Lors de la création de tests, vous pouvez référencer des tickets Xray comme contexte. Indiquez soit :

  • Une clé de test (par exemple, XSP-42), ou

  • Une URL de ticket.

Thunders AI récupère les détails du test et les utilise comme contexte pour générer de nouveaux cas de test.

Partir d’un ticket

Dans une nouvelle conversation Thunders AI, sous « Vous ne savez pas par où commencer ? », cliquez sur « Tester un ticket » et choisissez une suggestion, par exemple « Crée un cas de test à partir d'un de mes tickets ». Si aucune source de tickets n’est encore connectée à votre projet, Thunders AI vous demande d’abord « Où sont vos tickets ou vos spécifications ? ». Cliquez sur « Xray » pour connecter Xray Cloud. Une fois la connexion établie, Thunders AI active Xray pour la conversation et envoie votre demande. Cliquez sur « Ailleurs » pour envoyer la demande sans source. Cette liste ne propose pas Xray Data Center.

Synchroniser les résultats des tests avec Xray

Après avoir exécuté un test dans Thunders, vous pouvez renvoyer les résultats d’exécution vers Xray. Cela permet de maintenir à jour votre couche de gestion des tests Xray grâce aux résultats d’exécution générés par l’IA. Vous pouvez synchroniser une exécution manuellement depuis la page de cette exécution, ou activer la synchronisation automatique pour que Thunders transmette chaque exécution terminée à votre place.

Comment synchroniser manuellement

  1. Accédez à la page de détails d’une exécution terminée.

  2. Si le cas de test dispose d’un mappage source Xray, un bouton « Synchroniser avec Xray » apparaît dans le panneau des propriétés de l’exécution.

  3. Cliquez sur « Synchroniser avec Xray ». Les résultats sont transférés vers Xray en tant qu’exécution de test.

  4. Une fois la synchronisation effectuée, le bouton est remplacé par une ligne de confirmation indiquant la clé d’exécution Xray et la date de synchronisation.

Synchroniser avec Xray sur une exécution terminée, et le résultat synchronisé dans le test Xray

Vous trouvez tous les détails de l'exécution dans le commentaire de l'exécution du test, dans le ticket Xray. Consultez « Éléments synchronisés » ci-dessous.

Synchroniser automatiquement

Activez la synchronisation automatique pour que Thunders transmette chaque exécution terminée vers Xray sans aucun clic.

  1. Ouvrez votre projet de test, cliquez sur « Configuration », puis sur « Connecteurs ».

  2. Sur la vignette Xray connectée, cliquez sur « Gérer ».

  3. Dans la section « Paramètres », activez « Synchronisation automatique des résultats de test ».

  4. Cliquez sur « Enregistrer ». Thunders confirme avec le message « Paramètres enregistrés ».

La page Gérer de Xray Cloud, avec la synchronisation automatique des résultats de test activée dans la section Paramètres

Fonctionnement de la synchronisation automatique

  • Thunders transmet une exécution dès qu’elle se termine, qu’elle soit réussie, échouée ou interrompue.

  • Seules les exécutions des cas de test associés à un ticket Xray sont transmises. Les autres exécutions ne sont pas concernées.

  • La transmission utilise les identifiants de l’utilisateur qui a activé le paramètre. Les connexions à Xray sont personnelles, cette connexion doit donc rester active.

  • Une exécution déjà synchronisée n’est pas transmise une seconde fois.

  • Sur la page de détails de l’exécution, le panneau des propriétés affiche « Synchronisation… » pendant la transmission, puis la confirmation « Synchronisé avec Xray » avec la clé d’exécution Xray. Si la transmission échoue, le panneau affiche « Échec de la dernière synchronisation. Veuillez réessayer », et le bouton « Synchroniser avec Xray » reste disponible pour réessayer manuellement.

Éléments synchronisés

  • Statut global : Réussi ou Échoué (les exécutions interrompues sont signalées comme « Abandonnées »).

  • Statut par étape : chaque étape de test est associée à son propre résultat de réussite ou d’échec.

  • Captures d’écran : des captures d’écran avant l’exécution et après l’action finale sont jointes à chaque étape.

  • Résultats réels : pour les étapes ayant échoué, la description du résultat réel est incluse.

  • Horodatages : heures de début et de fin de l'exécution.

  • Conditions de l'exécution : un commentaire sur l'exécution du test dans Xray indique sur une ligne les conditions de l'exécution : environnement, persona, appareil et résolution. Seules les valeurs que l'exécution possède apparaissent. Le persona apparaît par son rôle, par exemple QA Engineer, et non par son nom.

  • Étapes Thunders : le même commentaire liste chaque étape Thunders avec son statut (Passed, Failed, Not run ou Blocked) et, pour une étape en échec, le bug que Thunders a détecté. Vous voyez les étapes même lorsque le test Xray n'a pas d'étapes propres.

  • Lien vers l'exécution : le commentaire se termine par le lien « Open the run in Thunders » vers l'exécution.

Le bouton de synchronisation n’est visible que lorsque le cas de test est associé à un ticket Xray. Cette association est créée automatiquement lorsque vous importez un test depuis Xray ou que vous créez un test dans Xray via Thunders AI.

Ce que Thunders AI peut faire avec Xray

Lorsque Xray est connecté et activé, Thunders AI peut exploiter les contenus Xray suivants :

Contenu Xray

Ce que Thunders AI peut faire

Tests

Récupérer un test par clé, effectuer une recherche dans votre bibliothèque de tests et lire les définitions d’étapes — au niveau des étapes pour les deux déploiements, et au niveau Gherkin sur Xray Cloud.

Plans de test

Récupérer un plan de test et les tests qui y sont associés, ou rechercher des plans par nom ou selon des critères.

Ensembles de tests

Consultez un ensemble de tests ou effectuez une recherche parmi les ensembles pour comprendre comment les tests sont regroupés.

Exécutions de tests

Rechercher parmi les exécutions passées pour consulter l'historique et les résultats.

Test Runs

Récupérez les détails d'une exécution et mettez à jour son statut.

Conditions préalables

Récupérez ou recherchez les conditions préalables associées à vos tests.

Ces fonctionnalités sont disponibles à la fois pour Xray Cloud et Xray Data Center, sauf indication contraire.

Déconnecter Xray

Le menu de la ligne Xray Cloud connectée, ouvert sur Déconnecter

Xray Cloud

Pour déconnecter Xray Cloud, accédez à « Configuration » > « Connecteurs », ouvrez le menu ⋮ sur la ligne « Xray Cloud », puis cliquez sur « Déconnecter ». Vous pouvez aussi cliquer sur « Déconnecter » dans sa page « Gérer ». Cela supprime les identifiants et désactive les outils Xray dans Thunders AI.

Xray Data Center

Xray Data Center est automatiquement déconnecté lorsque vous déconnectez Jira Data Center. Il n'existe pas d'action de déconnexion distincte pour Xray DC.

Avez-vous trouvé la réponse à votre question ?