Den Report Designer verwenden

Mit dem Report Designer können Sie benutzerdefinierte Reports erstellen, damit Sie Ihr Team über den neuesten Status Ihrer Tests auf dem Laufenden halten können. Für ein schnelles und einfaches Reporting können Sie die Reporting-Vorlagen anpassen, die Tosca als Teil der Standard-Untermenge bereitstellt. Sie können auch Ihre eigenen erstellen.

Bitte beachten Sie, dass der Report Designer auf einer Drittanbietersoftware namens List & Label^® basiert. Nähere Anweisungen zum Anpassen von Reports auf der Benutzeroberfläche des Report Designer finden Sie im Handbuch von List & Label (wird in einem neuen Reiter geöffnet).

Bevor Sie beginnen

Stellen Sie vor der Verwendung des Report Designer sicher, dass Sie Folgendes eingerichtet haben:

• Sie haben eine Report Definition erstellt.

• Sie haben eine Dataset Definition angegeben.

• Sie haben Default als Ihre Designer Definition ausgewählt.

Benutzerdefinierte Designobjekte zu Ihrem Report hinzufügen

Es gibt eine Vielzahl von standardmäßigen List & Label-Objekten, mit denen Sie einen Report anpassen können, z. B. Text, Variablen, Diagramme oder Tabellen.

Sie können auch benutzerdefinierte Tosca Commander-Designobjekte hinzufügen, bei denen es sich um Attribute zum Anpassen Ihres Reports handelt. Sehen Sie sich die Liste der verfügbaren Objekte und deren Attribute am Ende dieses Kapitels an.

Um benutzerdefinierte Designobjekte zu Ihrem Report hinzuzufügen, führen Sie diese Schritte aus:

1. Gehen Sie zum Bereich Reporting und wählen Sie Ihren Report aus.

2. Überprüfen Sie im Reiter Details, ob die Spalte Columns angezeigt wird. Wenn Sie sie nicht sehen, verwenden Sie den Column Chooser, um sie hinzuzufügen.

3. Wählen Sie für die Dataset Definition im Aufklappmenü Columns Folgendes aus:

   • Das Attribut Name.

   • Alle weiteren Attribute, die Sie in Ihrem Report haben möchten. Der Object type legt fest, welche Attribute verfügbar sind.

     Wir empfehlen Ihnen, nur Attribute hinzuzufügen, die für Ihren Report unbedingt erforderlich sind. Jedes zusätzliche Attribut erhöht die durch Tosca zu ladende Datenmenge, was die Wartezeiten erhöht.

Ihren Report entwerfen

Um Ihren Report zu entwerfen, führen Sie diese Schritte aus:

1. Klicken Sie mit der rechten Maustaste auf die Report Definition und wählen Sie Design Report... aus dem Kontextmenü.

2. Erstellen Sie auf der Oberfläche Report Designer Ihr Report-Layout. Nähere Informationen finden Sie im Handbuch von List & Label (wird in einem neuen Reiter geöffnet).

Zusätzliche Schritte für benutzerdefinierte Designobjekte

Wenn Sie benutzerdefinierte Designobjekte hinzugefügt haben, müssen Sie einige zusätzliche Schritte ausführen, um die Informationen korrekt anzuzeigen:

1. Doppelklicken Sie auf dem Reiter Objects des Report Designer auf das Containerelement, das benutzerdefinierte Designobjekte enthält.

2. Gehen Sie im Folgedialog auf den Reiter Data Line und wählen Sie Append line definition->Text aus.

3. Gehen Sie im nächsten Dialog zum Reiter Data and Functions und führen Sie die folgenden Aktionen aus:

   • Erweitern Sie die Liste Fields und suchen Sie Ihr Containerelement. Erweitern Sie dann das Containerelement.

   • Doppelklicken Sie in der Liste der Containerelemente auf SurrogateNum und wählen Sie OK aus.

4. Sie befinden sich jetzt wieder im Dialog Table Contents. Wählen Sie von hier aus SurrogateNum, gehen Sie dann zum Bereich Layout und setzen Sie Appearance Condition auf Never Show.

Versionswechsel für Reports

Wenn Sie Reports mit Versionen von List & Label erstellt haben, die Tosca nicht mehr unterstützt, müssen Sie diese Reports aktualisieren, bevor Sie sie weiter bearbeiten oder ausdrucken können. Beachten Sie, dass Sie Reports nach einem Versionswechsel nicht zurücksetzen können.

Um einen Versionswechsel eines Reports durchzuführen, führen Sie diese Schritte aus:

1. Navigieren Sie zu der Reportdefinition, für die Sie einen Versionswechsel durchführen möchten.

2. Klicken Sie mit der rechten Maustaste auf das untere Element Report Definition und wählen Sie Upgrade Report to use latest ListAndLabel version aus dem Kontextmenü.

3. Wenn Sie einen Versionswechsel von 2023.2 oder älter durchgeführt haben und benutzerdefinierte Designobjekte in Ihrem Report verwenden, müssen Sie diese zusätzlichen Schritte auch für benutzerdefinierte Designobjekte ausführen.

Benutzerdefinierte Designobjekte und Attribute des Tosca Commander

Sie fügen einem Report die folgenden benutzerdefinierten Designobjekte hinzu:

• Execution Log Chart

• Execution Result Icon

• Requirement Execution Status Chart

• Requirement Coverage Executed Chart

• Requirement Coverage Specified Chart

Execution Log Chart

Die ExecutionLog chart zeigt die Ausführungsergebnisse wie in der Tosca Commander Spalte Loginfo (siehe Kapitel " Mit Ausführungsergebnissen arbeiten") an.

Um diese Ergebnisse korrekt anzuzeigen, wählen Sie folgende Attribute für den Objekttyp ExecutionLog:

• NumberOfTestCases

• NumberOfTestCasesPassed

• NumberOfTestCasesFailed

• NumberOfTestCasesNotExecuted

• NumberOfTestCasesWithUnknownState

Das Diagramm wird im Report wie folgt angezeigt:

Execution Result Icon

Sie können die Symbole Passed und Failed von einer ExecutionList in den Report Designer übertragen.

Um dies zu tun, wählen Sie das Attribut Result für den Objekttyp ExecutionTestCaseLog.

Die Symbole Passed und Failed werden im Report wie folgt angezeigt:

Requirement Execution Status Chart

Für Anforderungs-Sets und Anforderungen können Sie die Zellen aus der Spalte Execution State (%) in Ihrem Report anzeigen. Um dieses Diagramm korrekt anzuzeigen, wählen Sie die folgenden Attribute für die Objekttypen RequirementSets und Requirements:

• StatusPassed

• StatusFailed

• StatusMissingLink

• StatusNotExecuted

Das Diagramm wird im Report wie folgt angezeigt:

Requirement Coverage Executed Chart

Für Anforderungs-Sets und Anforderungen können Sie die Zellen aus der Spalte Coverage Executed (%) in Ihrem Report anzeigen.

Um dieses Diagramm korrekt anzuzeigen, wählen Sie das Attribut CoverageExecuted für die Objekttypen RequirementSets und Requirements.

Das Diagramm wird im Report wie folgt angezeigt:

Requirement Coverage Specified Chart

Für Anforderungs-Sets und Anforderungen können Sie die Zellen aus der Spalte Coverage Executed (%) in Ihrem Report anzeigen. Um dieses Diagramm korrekt anzuzeigen, wählen Sie das Attribut CoverageSpecified für die Objekttypen RequirementSets und Requirements.

Das Diagramm wird im Report wie folgt angezeigt: