Travailler avec Heatmap

This page guides you through the user journey of interacting with the Heatmap. The page leads you through various stages, including creating test cases in Studio, setting up Heatmap ratios and configurations, examining and testing transactions, and running test sets. Check the following topics to start using the Heatmap.

Create test cases in Studio

To get started with the Heatmap, you need to create test cases for your SAP transactions with UiPath Studio. To ensure the Heatmap accurately shows which transactions are covered by tests and their status, you need to set the Studio project Enable SAP monitoring setting to True.

Liaison et connexion entre la carte thermique, les cas de test et les transactions

Toutes les transactions à l'intérieur de la carte thermique ont une étiquette unique qui leur est automatiquement attribuée au moment de l'exécution. Le libellé a le format suivant : TRAN:SAP_CODE ou PROG:SAPPROGRAM.

Les informations sur les transactions réellement exécutées et leurs dépendances sont collectées au moment de l’exécution. Pour autoriser les cas de test à être liés aux transactions exécutées, accédez aux paramètres de votre projet Studio, puis, sous UI Automation Classic, définissez Activer la surveillance SAP (Enable SAP Monitoring) sur Vrai (True). Ce paramètre est disponible uniquement pour les projets d’automatisation de test.

Remarque : l’activation de la surveillance SAP dans UI Automation Classic aura également pour effet de lier les cas de test et les transactions pour les activités modernes d’UI Automation.

Par exemple, une transaction nommée Create Purchase Order, avec ME21N comme code SAP, a le libellé  TRAN:ME21N. Si vous souhaitez créer un cas de test pour cette transaction, le même libellé s'affiche dans le champ Libellés (Labels) de la boîte de dialogue Créer un cas de test (Create Test Case).

Configure Heatmap ratios and settings

After you create test cases in UiPath Studio for your SAP transactions, you can configure the ratios and settings based on which the Heatmap will display the test relevance and coverage.

Ratios de carte de densité

La carte thermique est créée en fonction des valeurs des attributs SAP suivants :

Attribut SAP	Description	Valeur par défaut
Utilisateurs	Le nombre d’utilisateurs utilisant la transaction.	40
Exécution	Le nombre d’exécutions par transaction.	10
Délai (Time)	Le temps de traitement global nécessaire à l’exécution d’une transaction.	10
Objet	Nombre d’objets de développement utilisés dans une transaction, tels que des écrans, des modules fonctionnels, des tables.	10
Intensité	Type de transaction : Les transactions à haute intensité sont considérées comme des transactions de type Créer (Create) Les transactions d'intensité moyenne sont considérées comme des transactions de type Modifier (Change) Transaction de faible intensité (Type de transactions Afficher (Display))	30

Important :

La somme de tous les ratios d'attribution doit être égale à 100.

Pages de destination SAP FIORI

Par ailleurs, vous pouvez activer ou désactiver la visibilité des pages de destination SAP Fiori dans la carte thermique.

Connexion directe à l'instance SAP

Les paramètres peuvent être ajustés en fonction des besoins du client à partir du coin supérieur droit de la carte thermique .

Connexion avec un fichier CSV

Vous les configurez lors du téléchargement du fichier CSV à partir de SAP, dans l'onglet Paramètres (Parameters).

Modification des paramètres de la carte de densité

La modification des paramètres de la carte thermique implique la modification des taux d’affectation des attributs SAP utilisés pour générer la carte thermique, ainsi que la modification de sa visibilité en ce qui concerne les pages de destination SAP FIORI.

Connexion directe à l'instance SAP

1. Sélectionnez l’icône en forme d’engrenage en haut à droite pour ouvrir les paramètres de la carte thermique.
2. Modifiez les ratios d'affectation en fonction de votre cas d'utilisation.
   Par exemple, pour mettre en évidence les transactions les plus intenses (de type Créer (Create)), plutôt que les plus utilisées, modifiez le ratio Utilisateur (User ratio) sur 10, puis le ratio Intensité (Intensity) sur 60.
3. Sous Visibilité, activez le bouton Afficher les pages de destination SAP FIORI pour afficher les pages de destination SAP FIORI dans la carte thermique.

Connexion avec un fichier CSV

Après avoir exécuté le programme Z_UIPATH_CUST_HEATMAP_DOWNLOAD , accédez à l'onglet Paramètres (Parameters) et configurez les ratios.

Consultez la page Ratios de la carte thermique pour en savoir plus sur les attributs SAP et les ratios d’affectation.

Analyze and test transactions

After you create tests for your SAP transactions, and configure the Heatmap ratios, you can start analyzing the results and testing specific transactions. Check the following sections for information on how to leverage the Heatmap.

Understanding the Heatmap results

The analysis of Heatmap results involves viewing the test coverage of your transactions, filtering test coverage types, and reviewing transaction overviews. Explore the following topics to gain a comprehensive understanding of how to examine Heatmap results.

Affichage de la couverture de test pour les transactions

Pour savoir quelles transactions ont des tests automatisés, ainsi que les résultats :

1. Sous la carte thermique, sélectionnez Réussi (Passed) pour voir les transactions qui ont réussi leurs résultats de test.
2. Sous la carte thermique, sélectionnez Échec (Failed) pour voir les transactions qui ont échoué à leurs résultats de test.
3. Sous la carte thermique, sélectionnez Aucun cas de test exécuté (No test case executed) pour afficher les transactions auxquelles aucun cas de test n’a été exécuté.
4. Sous la carte thermique, sélectionnez Aucun cas de test affecté (No test case assigned) pour voir les transactions auxquelles aucun cas de test n'est affecté.
5. Sous la carte thermique, sélectionnez Afficher tout (Show all) (sélectionné par défaut) pour voir toutes les transactions ci-dessus.

Filtrage des transactions de carte de densité

1. Ouvrez la carte thermique et sélectionnez le nombre de transactions que vous souhaitez afficher dans la liste déroulante Toutes les transactions :
   1. Toutes les transactions (All transactions) (par défaut)
   2. 10 premières transactions
   3. 20 premières transactions
2. Sélectionnez l’heure de début des transactions dans la liste déroulante Dernière semaine :
   1. Le mois dernier (Last Month) (par défaut)
   2. Dernière semaine (Last Week)
   3. Last Day
      L'heure de début et de fin des transactions s'affiche à côté de la liste déroulante Période (Time Period) .
3. Sélectionnez les types de transactions que vous souhaitez afficher dans la liste déroulante Tous les types de transactions :
   1. Transactions standard
   2. Transactions personnalisées
4. Dans la liste déroulante Tous les types d’interfaces, sélectionnez les types d’interfaces dans lesquelles vous souhaitez afficher les transactions :
   1. [T] - Transaction dans SAP WinGUI
   2. [R] - Rapport/Programme dans SAP WinGUI
   3. [W] - Transaction dans SAP WebGUI
   4. [F] - Application dans SAP FIORI

Consulter l'aperçu d'une transaction

1. Sélectionnez une transaction dans la carte de densité.
2. Sous Détails de la transaction sélectionnée : Maintenir les codes de transaction (Details of selected transaction: Maintain Transaction Codes), sélectionnez Vue d'ensemble (Overview)
3. Vérifiez le nom de la transaction et son code SAP.
   Le code SAP d'une transaction est utilisé pour générer un libellé unique

Générer des cas de test pour une transaction spécifique

You can generate manual tests using Autopilot^TM for transactions viewed as part of the Heatmap. The generated test cases will have the following labels assigned:

• autopilot-generated
• TRAN:<transactionCode>

1. Dans la carte thermique, sélectionnez la transaction concernée.
2. Sélectionnez Générer des cas de test.

   La fenêtre Fournir des documents d’assistance s’ouvre, vous invitant à charger les pièces jointes ou tout autre document nécessaire pour générer des cas de test.

   Figure 1. Exemple de bouton Générer des tests pour la transaction sélectionnée
   

   

   
   
3. Dans la fenêtre Fournir des documents d’assistance, sélectionnez des pièces jointes supplémentaires.

   Celles-ci seront utilisées lors de la génération de tests. Vous pouvez également charger d’autres fichiers vous-même.

   Figure 2. Sélection d'un document dans la fenêtre Fournir des documents d'assistance
   

   

   
   
4. Select Next and provide additional instructions that Autopilot^TM should use when generating test cases. Choose from a prompt from the Prompt library or type these instructions in the Provide Additional Guidance window.

   For instance, you can specify Autopilot^TM the number of test cases that you want to generate. The maximum number of test cases is 50.

   Graphique 3. Instructions supplémentaires saisies dans la fenêtre Fournir des conseils supplémentaires
   

   

   
   
5. Sélectionnez Générer des tests pour lancer le processus.

   Lorsque la génération sera terminée, vous recevrez une notification La génération de cas de test est terminée. Selon vos préférences de notification, vous pouvez recevoir la notification dans l'application ainsi que par e-mail.

6. Sélectionnez la notification Génération de test terminée pour examiner les cas de test générés.
   1. Développez chaque cas de test dans le panneau Générer des tests et examinez les cas de test générés.
   2. Si vous êtes satisfait de leur contenu, sélectionnez Créer des tests (Create tests).
   Figure 4. Sélectionner les tests que vous souhaitez créer et développer un cas de test
   

   

   
   
7. Si vous n'êtes pas satisfait des cas de test générés, sélectionnez Affiner les tests (Refine tests) et fournissez des détails supplémentaires sur votre cas d'utilisation.
   1. Attach more relevant documents for Autopilot^TM to use.
   2. Cliquez sur Suivant et saisissez des informations supplémentaires dans la zone de texte Fournir des instructions.
   3. Après avoir affiné les étapes, sélectionnez Régénérer les tests (Regenerate tests).
   4. Cliquez sur la notification Génération de test terminée pour accéder aux cas de test régénérés.
   5. Développez chaque cas de test et vérifiez-les.
   6. Sélectionnez les cas de test qui vous conviennent, puis sélectionnez Créer des tests.

Les cas de test générés comporteront ces libellés :

• autopilot-generated
• TRAN:<transactionCode>

Par exemple, si le libellé de la transaction choisie est TRAN:SE38, ce même libellé sera appliqué à tous les cas de test générés à partir de celle-ci.

Creating test cases and test sets

After you analyze the results displayed in the Heatmap, you can start improving your testing portfolio, by creating test cases and test sets for uncovered or failed transactions. Check the following pages for steps on creating test cases and test sets for a specific transaction.

Création de cas de test pour une transaction spécifique

1. Sélectionnez une transaction dans la carte de densité.
2. Sous Détails de la transaction sélectionnée : tenir à jour les codes de transaction, sélectionnez Cas de test.
3. Sélectionnez Créer un cas de test (Create Test Case) et configurez le cas de test que vous souhaitez créer.
   Vous pouvez ajouter d'autres libellés à côté de celui déjà attribué au cas de test.

   Important :

   Lorsque vous créez un cas de test pour une transaction spécifique, assurez-vous de laisser intact le libellé déjà attribué à la transaction. Sinon, le cas de test que vous créez ne sera pas lié à la transaction.

   Pour cet exemple, le libellé déjà attribué est TRAN:SE16.

En savoir plus sur l'association des cas de test aux transactions ici.

Création d'ensembles de tests pour une transaction spécifique

1. Créez des cas de test pour une transaction spécifique.
2. Sélectionnez la transaction pour laquelle vous avez créé les cas de test.
3. Sous Détails de la transaction sélectionnée : Gérer les codes de transaction (Maintenir les codes de transaction) , sélectionnez Ensembles de test ( Test Sets) et configurez l'ensemble de test que vous souhaitez créer.
   Astuce :

   Pour faciliter le processus de liaison d'un ensemble de test à une transaction, ajoutez le libellé de la transaction à l'ensemble de test que vous souhaitez lier. De cette façon, vous pouvez rechercher l'ensemble de tests que vous venez de créer, en utilisant ce libellé spécifique.

   Pour cet exemple, le même libellé que nous avons utilisé pour créer les cas de test (TRAN:SE16) que nous avons ajouté à l'ensemble de tests.
   
   

   

   
   
4. After you create the test set, navigate to Test Sets in Test Manager.
5. Recherchez l’ensemble de tests que vous avez créé et ouvrez-le.
   Vous pouvez rechercher l’ensemble de tests à l’aide du libellé que vous avez ajouté à l’étape 3.
6. Sélectionnez Tâches (Tasks) > Affecter des cas de test (Assign Test Cases) > Affectation statique (Static Assignment).
7. Recherchez les cas de test que vous avez créés à l'étape 1 et affectez-les à cet ensemble de test.
   
   

   

   
   
8. Revenez à la page Heatmap , sélectionnez la transaction et consultez l'ensemble de tests qui lui est affecté.

Lier l'ensemble de tests d'Orchestrator à une transaction

1. Sélectionnez une transaction et sous Détails de la transaction sélectionnée : Gérer les codes de transaction, sélectionnez Ensembles de test.
2. Sélectionnez Lier (Link), choisissez les ensembles de test Orchestrator que vous souhaitez lier, puis sélectionnez Lier (Link).

Execute test sets for a transaction

1. Lier un ensemble de tests à une transaction.
2. Sélectionner Plus d’options (More Options) en ligne avec l'ensemble de tests que vous souhaitez exécuter.
3. Sélectionnez l'une des options suivantes :
   • Exécuter manuellement
   • Exécuter automatiquement
4. Consultez les résultats des tests dans la carte thermique.

Pièces jointes de carte de densité

The SAP data that generates the heatmap can be found in Test Manager's Dashboard, under Attachments:

• Pour ConnectSapInstance as Data Source : trois fichiers JSON sont joints (pour Day, Week et Month)
• Pour UploadFromCSV as Data Source : le fichier CSV téléchargé est joint.