Arbeiten mit Heatmap

Diese Seite führt Sie durch die Interaktion mit der Heatmap. Die Seite führt Sie durch verschiedene Phasen, einschließlich der Erstellung von Testfällen in Studio, der Einrichtung von Heatmap-Verhältnissen und -Konfigurationen, der Prüfung und dem Test von Transaktionen und der Ausführung von Testsätzen. Überprüfen Sie die folgenden Themen, um mit der Verwendung der Heatmap zu beginnen.

Sie arbeiten mit einer Heatmap-Ansicht auf zwei Ebenen:

• Anwendungskomponenten: Visuelle Container, die verwandte SAP-Transaktionen unter einer bestimmten Komponente oder einem bestimmten Modul gruppieren.
• Transaktionen: Kästchen innerhalb von Komponenten, die einzelne SAP-Transaktionen oder -Programme darstellen. Jedes Feld zeigt Transaktionsdaten an, z. B.:
  • Transaktionsname
  • SAP-Code
  • Teststatus und Abdeckung

Creating test cases in Studio

Voraussetzungen

• 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.

Verknüpfung und Verbindung zwischen Heatmap, Testfällen und Transaktionen

Allen Transaktionen in der Heatmap wird zur Laufzeit automatisch eine eindeutige Beschriftung zugewiesen. Die Beschriftung hat das folgende Format: TRAN:SAP_CODE oder PROG:SAPPROGRAM.

Die Informationen über tatsächlich ausgeführte Transaktionen und ihre Abhängigkeiten werden zur Laufzeit gesammelt. Damit Testfälle eine Verknüpfung mit den ausgeführten Transaktionen herstellen können, wechseln Sie zu Ihren Studio-Projekteinstellungen und legen Sie unter UI-Automatisierung klassisch die Option SAP-Überwachung aktivieren auf True fest. Diese Einstellung ist nur für Projekte der Testautomatisierung verfügbar.

Hinweis:

Durch Aktivieren der SAP-Überwachung unter UI-Automatisierung klassisch werden auch Testfälle und Transaktionen für moderne UI-Automatisierungsaktivitäten verknüpft.

Beispielsweise hat eine Transaktion mit dem Namen Create Purchase Order mit ME21N als SAP-Code die Beschriftung TRAN:ME21N . Wenn Sie einen Testfall für diese Transaktion erstellen möchten, wird dieselbe Beschriftung im Feld Beschriftungen des Dialogfelds Testfall erstellen angezeigt.

Configuring Heatmap ratios and settings

Nachdem Sie Testfälle in UiPath Studio für Ihre SAP-Transaktionen erstellt haben, können Sie die Verhältnisse und Einstellungen konfigurieren, auf deren Grundlage die Heatmap die Testrelevanz und -abdeckung anzeigt.

Ändern der Heatmap-Einstellungen

Die Heatmap wird basierend auf den Werten von fünf SAP-Attributen generiert. Sie können die Zuweisungsverhältnisse konfigurieren, um die Attribute zu priorisieren, die für Ihre Teststrategie am relevantesten sind.

SAP-Attribut	Beschreibung	Standardwert
Benutzer	Die Anzahl der Benutzer, die die Transaktion verwenden.	40
Ausführung	Die Anzahl der Ausführungen pro Transaktion.	10
Zeit	Die gesamte Verarbeitungszeit bei der Ausführung einer Transaktion.	10
Objekt	Die Anzahl der in einer Transaktion verwendeten Entwicklungsobjekte, z. B. Bildschirme, Funktionsmodule, Tabellen.	10
Intensität	Transaktionstyp: Transaktionen mit hoher Intensität gelten als Transaktionen des Typs Erstellen Transaktionen mit mittlerer Intensität gelten als Transaktionen des Typs Ändern Transaktionen mit niedriger Intensität gelten als Transaktionen des Typs Anzeigen	30

Wichtig:

Die Summe aller Zuweisungsverhältnisse muss gleich 100 sein. #### SAP FIORI Landing-Pages Darüber hinaus können Sie die Sichtbarkeit von SAP Fiori-Zielseiten in der Heatmap aktivieren oder deaktivieren.

Connection to SAP instance

Adjust the Heatmap assignment ratios and SAP Fiori landing page visibility settings to tailor how test relevance and coverage are calculated and displayed.

1. Wählen Sie das Zahnradsymbol oben rechts aus, um die Heatmap-Einstellungen zu öffnen.

2. Ändern Sie die Zuweisungsverhältnisse entsprechend Ihrem Anwendungsfall.

Um beispielsweise die intensivsten Transaktionen ( vom Typ Erstellen) anstatt die am häufigsten verwendeten hervorzuheben, ändern Sie das Verhältnis Benutzer zu 10 und dann das Verhältnis Intensität zu 60.

3. Wählen Sie unter Sichtbarkeit den Umschalter SAP FIORI Landing-Pages anzeigen aus, um SAP FIORI Landing-Pages in der Heatmap anzuzeigen.

   

Connection to CSV file

Nachdem Sie das Z_UIPATH_CUST_HEATMAP_DOWNLOAD-Programm ausgeführt haben, wechseln Sie zur Registerkarte Parameter und konfigurieren Sie die Verhältnisse.

Analyzing and testing transactions

Nachdem Sie Tests für Ihre SAP-Transaktionen erstellt und die Heatmap-Verhältnisse konfiguriert haben, können Sie mit der Analyse der Ergebnisse und dem Testen bestimmter Transaktionen beginnen. In den folgenden Abschnitten finden Sie Informationen zur Nutzung der Heatmap.

Verstehen der Heatmap-Ergebnisse

Die Analyse der Heatmap-Ergebnisse umfasst die Anzeige der Testabdeckung Ihrer Transaktionen, das Filtern der Testabdeckungstypen und die Überprüfung der Transaktionsübersichten. Erkunden Sie die folgenden Themen, um ein umfassendes Verständnis für die Untersuchung von Heatmap-Ergebnissen zu erhalten.

Anzeigen der Testabdeckung für Transaktionen

So sehen Sie, welche Transaktionen über automatisierte Tests verfügen, und die Ergebnisse:

1. Wählen Sie Bestanden unter der Heatmap aus, um die Transaktionen mit den Ergebnissen anzuzeigen, die den Test bestanden haben.

2. Wählen Sie Fehlgeschlagen unter der Heatmap aus, um die Transaktionen mit den Ergebnissen anzuzeigen, die den Test nicht bestanden haben.

3. Wählen Sie unter der Heatmap die Option Kein Testfall ausgeführt aus, um die Transaktionen anzuzeigen, für die kein Testfall ausgeführt wurde.

4. Wählen Sie unter der Heatmap die Option Kein Testfall zugewiesen aus, um die Transaktionen anzuzeigen, denen keine Testfälle zugewiesen sind.

5. Wählen Sie unter Heatmap die Option Alle anzeigen (standardmäßig ausgewählt) aus, um alle oben genannten Transaktionen anzuzeigen.

   

Heatmap-Transaktionen filtern

Narrow the set of transactions displayed in the Heatmap by applying filters for the number of top transactions, time period, transaction type, and interface type.

1. Öffnen Sie Heatmap und wählen Sie die Anzahl der Transaktionen, die in der Dropdownliste Alle Transaktionen angezeigt werden sollen:
   • Alle Transaktionen (Standard)
   • Top 10 der Transaktionen
   • Top 20 der Transaktionen
2. Wählen Sie die Startzeit für Transaktionen in der Dropdownliste Letzte Woche aus:
   • Letzter Monat (Standard)
   • Last Week
   • Last Day

Die Start- und Endzeit der Transaktionen wird neben der Dropdownliste Zeitspanne angezeigt. 3. Wählen Sie in der Dropdownliste Alle Transaktionstypen die Transaktionstypen aus, die angezeigt werden sollen:

• Standardtransaktionen
• Benutzerdefinierte Transaktionen

Wählen Sie aus der Dropdownliste Alle Schnittstellentypen die Schnittstellentypen aus, für die Sie Transaktionen anzeigen möchten:

• [T] – Transaktion in SAP WinGUI
• [R] – Bericht/Programm in SAP WinGUI
• [W] – Transaktion in SAP WebGUI
• [F] – Anwendung in SAP FIORI

Überprüfen der Übersicht einer Transaktion

View the name and SAP code of a specific transaction selected in the Heatmap to confirm its identity before creating test cases or test sets for it.

1. Wählen Sie eine Transaktion aus der Heatmap aus.
2. Wählen Sie unter Details der ausgewählten Transaktion: Transaktionscodes beibehalten die Option Übersicht aus.
3. Überprüfen Sie den Transaktionsnamen und seinen SAP-Code.

Der SAP- Code einer Transaktion wird verwendet, um eine eindeutige Beschriftung zu generieren

Generieren Sie Testfälle für eine bestimmte Transaktion.

Hinweis:

Die Funktionsverfügbarkeit hängt von der Cloud-Plattform ab, die Sie verwenden. Weitere Informationen finden Sie auf der Seite zur Verfügbarkeit der Test Manager-Funktion.

Sie können manuelle Tests mit Autopilot für Transaktionen generieren, die als Teil der Heatmap angezeigt werden. Den generierten Testfällen werden die folgenden Beschriftungen zugewiesen:

• autopilot-generated
• TRAN:<transactionCode>

Voraussetzungen

(Nur für Cloud Kommerziell) Wenn Sie RAG beim Generieren von Tests nutzen möchten, müssen Sie mit der Kontextgrundlage beginnen, zu der RAG gehört. Um mit Kontextgrundlage zu beginnen, besuchen Sie die entsprechende Seite mit den bewährten Methoden .

Unterstützte Dateitypen

Autopilot kann verschiedene Dateitypen verarbeiten. Je nach Dateityp kann Autopilot bestimmte Inhalte daraus verarbeiten. In der folgenden Liste sind die Dateitypen aufgeführt, die Sie Autopilot anbieten können, zusammen mit Details zum Inhaltstyp, den Autopilot von jedem Typ verarbeiten kann:

• Verarbeitet nur Textinhalt – Autopilot verarbeitet nur den Textinhalt aus diesen Dateitypen:
  • TXT
  • BPMN
  • CSV
• Verarbeitet sowohl Text- als auch Bildinhalte – Autopilot verarbeitet sowohl den Text als auch die Bilder dieser Dateitypen:
  • DOCX
  • XLSX
  • PNG
  • JPG
  • PDF

Schritte

1. Wählen Sie in der Heatmap die gewünschte Transaktion aus.

2. Wählen Sie Testfälle generieren aus. Das Fenster Zusätzlichen Kontext bereitstellen wird geöffnet und konzentriert sich auf Dokumente hinzufügen, die Sie zur Eingabe von Anhängen oder anderen Dokumenten auffordern, die zum Generieren von Testfällen erforderlich sind. Abbildung 1. Beispiel der Schaltfläche Tests generieren für die ausgewählte Transaktion

   

3. Wählen Sie im Abschnitt Dokumente hinzufügen zusätzliche Anlagen aus. Diese werden beim Generieren von Tests verwendet. Sie können auch selbst andere Dateien hochladen.

Abbildung 2. Der Abschnitt Dokumente hinzufügen zum Generieren von Tests (nur für Cloud Kommerziell)

4. (For Cloud Commercial only) In the Leverage RAG section of the Provide additional context window, select an index which stores your data uploaded to Context Grounding. The selected index helps Autopilot in generating more accurate tests by giving it context about the applications that you are trying to automate. For example, you can leverage RAG when a requirement document has incomplete information or refers to additional details in other sections. In this case, you can leverage RAG to draw those details from indexed references.

   Hinweis:

   For best practices on working with Context Grounding, visit Best practices.

   1. From the Select folder dropdown list, select the folder where you store the indexes storing the desired information you want to share with Autopilot.

   2. From the Select index dropdown list, select the specific index that you want Autopilot to reference.

   3. For Number of results, enter the number of tests you want Autopilot to generate based on the referenced information.

   4. Select Next and provide additional instructions that Autopilot should use when generating test cases. Choose from a prompt from the Prompt library or enter these instructions in the Provide additional guidance window. These are some of the instructions that Autopilot can follow:

      • Sie können Autopilot die Anzahl der Testfälle anweisen, die Sie generieren möchten. Die maximale Anzahl von Testfällen ist 50.
      • Sie können angeben, dass der Autopilot alle Benutzerschritte und Akzeptanzkriterien abdecken soll, die in der Anforderung des Kreditantrags beschrieben sind.
      • Sie können Autopilot anweisen, Vorbedingungen zu generieren.
      • Sie können Autopilot angeben, um für jeden Testschritt ein erwartetes Ergebnis zu generieren.
      • By default, Autopilot considers existing tests linked to a requirement to prevent duplicating tests. However, you can instruct Autopilot to disregard existing tests during new test generation. You can do this by providing an instruction like: "Do not consider tests that are linked to this requirement when generating tests".Figure 4. Additional instructions entered in the Provide additional guidance window.

   5. Wählen Sie optional aus der Dropdownliste Modell das KI-Modell aus, das der Autopilot verwenden soll. Autopilot verwendet beim Generieren von Tests standardmäßig Claude 3.7 Sonnet, was auch das empfohlene Modell ist.

      Hinweis:

      Die in der Auswahlliste Modell verfügbaren Modelle hängen von der AI Trust Layer-Richtlinie ab, die auf Ihre Organisation und Ihren Mandanten angewendet wird. Wenn alle unterstützten Modelle aktiviert sind, wird Claude 3.7 Sonnet als empfohlene Option angezeigt. Wenn nur ein Modelltyp aktiviert ist (z. B. Azure OpenAI), wird nur das GPT 4o-Modell angezeigt und automatisch empfohlen.

   6. Wählen Sie Tests generieren aus, um den Prozess zu starten. Wenn die Generierung abgeschlossen ist, erhalten Sie die Benachrichtigung Testfallgenerierung abgeschlossen . Je nach Ihren Benachrichtigungseinstellungen können Sie die Benachrichtigung sowohl in der App als auch per E-Mail erhalten.

   7. Select the Test generation completed notification to review the generated test cases. Expand each test case in the Generate tests panel, and review the generated test cases. If you are satisfied with their content, select Create tests.

   8. Wenn Sie mit den generierten Testfällen nicht zufrieden sind, wählen Sie Tests verfeinern aus und geben Sie zusätzliche Details zu Ihrem Anwendungsfall an.

      • Hängen Sie weitere relevante Dokumente an, die Autopilot verwenden soll.
      • Select Next and enter additional details in the Provide instructions text box.
      • Nachdem Sie die Schritte verfeinert haben, wählen Sie Tests erneut generieren aus.
      • Select the Test generation completed notification to access the regenerated test cases.
      • Erweitern und überprüfen Sie jeden Testfall.
      • Wählen Sie die Testfälle aus, mit denen Sie zufrieden sind, und wählen Sie dann Tests erstellen aus.

   Die generierten Testfälle weisen die folgenden Beschriftungen auf:

   • autopilot-generated
   • TRAN:<transactionCode>

   Wenn die Bezeichnung der ausgewählten Transaktion beispielsweise TRAN:SE38 ist, wird dieselbe Bezeichnung auf alle daraus generierten Testfälle angewendet.

Abbildung 3. Der Abschnitt Nutzung von RAG zum Generieren von Tests

Figure 4. Additional instructions in Guidance window

Abbildung 5. Auswählen der Tests, die Sie erstellen möchten, und Erweitern eines Testfalls

Erstellen von Testfällen und Testsätzen

Nachdem Sie die in der Heatmap angezeigten Ergebnisse analysiert haben, können Sie mit der Verbesserung Ihres Testportfolios beginnen, indem Sie Testfälle und Testsätze für nicht abgedeckte oder fehlgeschlagene Transaktionen erstellen. Auf den folgenden Seiten finden Sie Schritte zum Erstellen von Testfällen und Testsätzen für eine bestimmte Transaktion.

Testfälle für eine bestimmte Transaktion erstellen

Allen Transaktionen in der Heatmap wird zur Laufzeit automatisch eine eindeutige Beschriftung zugewiesen. Die Beschriftung hat das folgende Format: TRAN:SAP_CODE oder PROG:SAPPROGRAM.

Die Informationen über tatsächlich ausgeführte Transaktionen und ihre Abhängigkeiten werden zur Laufzeit gesammelt. Damit Testfälle eine Verknüpfung mit den ausgeführten Transaktionen herstellen können, wechseln Sie zu Ihren Studio-Projekteinstellungen und legen Sie unter UI-Automatisierung klassisch die Option SAP-Überwachung aktivieren auf True fest. Diese Einstellung ist nur für Projekte der Testautomatisierung verfügbar.

Hinweis:

Durch Aktivieren der SAP-Überwachung unter UI-Automatisierung klassisch werden auch Testfälle und Transaktionen für moderne UI-Automatisierungsaktivitäten verknüpft.

Beispielsweise hat eine Transaktion mit dem Namen Create Purchase Order mit ME21N als SAP-Code die Beschriftung TRAN:ME21N . Wenn Sie einen Testfall für diese Transaktion erstellen möchten, wird dieselbe Beschriftung im Feld Beschriftungen des Dialogfelds Testfall erstellen angezeigt.

1. Wählen Sie eine Transaktion aus der Heatmap aus.
2. Wählen Sie unter Details der ausgewählten Transaktion: Transaktionscodes beibehalten die Option Testfälle aus.
3. Wählen Sie Testfall erstellen aus und konfigurieren Sie den Testfall, den Sie erstellen möchten.

Sie können weitere Beschriftungen neben der Beschriftung hinzufügen, die dem Testfall bereits zugewiesen ist.

Wichtig:

Wenn Sie einen Testfall für eine bestimmte Transaktion erstellen, stellen Sie sicher, dass Sie die Beschriftung, die der Transaktion bereits zugewiesen ist, unverändert lassen. Andernfalls wird der von Ihnen erstellte Testfall nicht mit der Transaktion verknüpft. In diesem Beispiel ist die bereits zugewiesene Bezeichnung TRAN:SE16.

Erstellen von Testsätzen für eine bestimmte Transaktion

Create a test set for a specific Heatmap transaction so you can group and execute the test cases that cover it.

1. Erstellen Sie Testfälle für eine bestimmte Transaktion.

2. Wählen Sie die Transaktion aus, für die Sie die Testfälle erstellt haben.

3. Wählen Sie unter Details der ausgewählten Transaktion: Transaktionscodes beibehalten die Option Testsätze aus und konfigurieren Sie den Testsatz, den Sie erstellen möchten.

   Tipp:

   Um die Verknüpfung eines Testsatzes mit einer Transaktion zu vereinfachen, fügen Sie die Beschriftung der Transaktion zu dem Testsatz hinzu, den Sie verknüpfen möchten. So können Sie mit dieser bestimmten Beschriftung nach dem Testsatz suchen, den Sie gerade erstellt haben. In diesem Beispiel haben wir die gleiche Bezeichnung, die wir zum Erstellen der Testfälle verwendet haben (TRAN:SE16), dem Testsatz hinzugefügt.

   

4. Nachdem Sie den Testsatz erstellt haben, navigieren Sie im Test Manager zu Testsätze.

5. Search for the test set you created and open it. You can search for the test set using the label that you added at Step 3.

6. Wählen Sie Aufgaben > Testfälle zuweisen > Statische Zuweisung aus.

7. Suchen Sie nach den Testfällen, die Sie in Schritt 1 erstellt haben, und weisen Sie sie diesem Testsatz zu.

   

8. Navigieren Sie zurück zur Heatmap- Seite, wählen Sie die Transaktion aus und sehen Sie sich den ihr zugewiesenen Testsatz an.

Ausführen von Testsätzen für eine Transaktion

Run a test set that is linked to a specific Heatmap transaction so the test results are reflected back in the Heatmap as test coverage for that transaction.

1. Verknüpfen Sie einen Testsatz mit einer Transaktion.
2. Wählen Sie Weitere Optionen in der Zeile des auszuführenden Testsatzes aus.
3. Wählen Sie eine der folgenden Optionen aus:
   • Manuell ausführen
   • Automatisiert ausführen
4. Sehen Sie sich die Testergebnisse in der Heatmap an.

Heatmap-Anhänge

Die SAP-Daten, die die Heatmap generieren, finden Sie im Dashboard des Test Managers unter Anhänge:

• Für ConnectSapInstance als Datenquelle: drei JSON-Dateien sind angehängt (für Tag, Woche und Monat)
• Bei UploadFromCSV als Datenquelle: Die hochgeladene CSV-Datei wird angehängt.

Ergebnis

The test sets are executed for the selected transactions and the results are reflected in the Heatmap. Transactions with passing tests display in the corresponding coverage state, and test case logs are available in the Execution section of your project.