Inhaltsverzeichnis

1.  Themenbeschreibung  2

2.  Aufbereitung der Standardtestberichte für die interne Veröffentlichung  2

2.1  Genauere Problembeschreibung  2

2.2  Aufbau und Funktionsweise des Makros  3

2.3  Testphase und mögliche Unstimmigkeiten  9

3.  Schlussbetrachtung  10

Anhang: Quelltext  des Makros  11

Christoph  Weigel Praktikumsarbeit Seite  1

1. Themenbeschreibung

Es sollen mit Hilfe eines Makros Testberichte aufbereitet werden. Diese Testberichte werden von Quality Center erstellt und als eine Word-Datei extern abgespeichert. Nach dem das Makro die Testberichte bearbeitet hat, sollen diese übersichtlicher und klarer strukturiert wirken.

Um dieses Makro umzusetzen ist es notwendig, selbstständig eine Recherche über die Grundlagen eins Makros durchzuführen. Es ist darauf zu achten wie man ein Makro erstellt, welche zugrundeliegende Programmiersprache verwendet wird und welche Eigenschaften diese Programmiersprache aufweist. So soll eine fehlerfreie Programmierung möglich sein. Aus einem ersten Entwurf sollen Rückschlüsse gezogen werden, mit denen ein optimales Makro gestalten werden soll. Die Laufzeit des Makros darf, gemessen an der Dokumentengröße, einen akzeptablen Rahmen nicht überschreiten. Das erarbeitete Makro soll anschließend an mehreren Testberichten geprüft werden, um möglichst viele Fehler zu erkennen und zu beseitigen.

2. Aufbereitung der Standardtestberichte für die interne Veröffentlichung

2.1 Genauere Problembeschreibung

In dem Testdatenbanksystem Quality Center besteht die Möglichkeit einen Testbericht zu erstellen, in dem sämtliche Informationen über mehrere Testläufe in Microsoft Word ausgegeben werden können. Diese Informationen können Workflow, Status oder Anhang in einem Test sein.

Der Testbericht wird zwar gemäß der Ordnerstruktur im Quality Center ausgegeben, doch die Gliederung ist sehr unübersichtlich und unsystematisch für Leser ohne Erfahrungen mit dem Quality Center. Desweiteren sind die Beschreibungen der Anhänge nicht gut zuordenbar.

Die manuelle Formatierung dieser Dokumente ist sehr zeitaufwendig und ungeeignet, da große Dokumente mit über 1000 Seiten zu bearbeiten sind.

Die meisten Formatierungen müssen über das gesamte Dokument wiederholt durchgeführt werden.

Um dieses zeitliche Problem bei der Formatierung dieser Dokumente zu umgehen, soll ein Makro geschrieben werden, das folgende Kriterien erfüllt: • Löschen der alten Gliederung

Christoph Weigel Praktikumsarbeit Seite 2

• Löschen von überflüssigen Gliederungspunkten

• Setzen der neuen Gliederung

• Aktualisieren des Inhaltsverzeichnisses

• Setzen von Seitenumbrüchen, damit Beschreibungen besser zu deren Anhängen

zugeordnet werden können

Das Makro wird in dem Makroeditor von Microsofts Word 2007 erstellt.

2.2 Aufbau und Funktionsweise des Makros

Am Anfang war es wichtig den Quelltext in einer übersichtlichen Form darzustellen, damit man Befehle und Anweisungen die zu bearbeiten sind, schnell finden kann. Somit wurde das Makro in eine Hauptprozedur und in sechs Unterfunktionen eingeteilt. Dabei nimmt die Hauptprozedur die Administration ein und die Unterfunktionen lösen die geforderten Aufgaben.

Hauptprozedur: ReportQualityCenter() Unterfunktionen: LöschenderGliederung(strFind, b, c, d)

Bis auf die Unterfunktion „Zählalgorithmus“ werden alle Unterfunktionen in der Hauptprozedur ausgeführt. Die Unterfunktion „LöschenderGliederung“ wird drei Mal in der Hauptprozedur ausgeführt.

Ein Anfangsproblem bei der Erstellung des Makros war, Regelmäßigkeiten in dem Dokument zu erkennen, an denen mit Hilfe von Schleifen der Cursor immer wieder positioniert werden konnte. Diese Regelmäßigkeiten mussten Kriterien sein, die eindeutig sind und nicht zu Verwechselungen führen durften. Da das zu bearbeitende Dokument wenige regelmäßige Formatierungen aufweist, wurde nach Zeichenketten (nachfolgend Positionierungswörter genannt) gesucht, an denen eine Positionierung des Cursors festgemachen werden konnte. Für jede Unterfunktion mussten andere Wörter gesucht werden.

Im folgenden Abschnitt sind Erklärungen zu den Unterfunktionen dargestellt. Dabei werden die Aufgaben der Funktionen dargelegt, aber auch die Umsetzung der Lösungen in einen

Christoph Weigel Praktikumsarbeit Seite 3

Algorithmus wird grob geschildert. Einzelheiten wie verwendete Parameter oder Befehlsfolgen sind dabei vernachlässigt worden.

Funktion: „Zählalgorithmus“

Diese Unterfunktion wird in den anderen Unterfunktionen aufgerufen. Sie ist dafür zuständig, die Positionierungswörter zu zählen, die ihr über die Variable „strFind“ übergeben wird. Diese Wörter weisen die oben genannten Regelmäßigkeiten auf. Sie hat eine „Call by Reference“ Funktion, das heißt sie gibt einen Wert für die Variable „Zähler“ zurück. Das Hauptelement dieser Unterfunktion ist eine WHILE-Schleife, die solange die Variable „Zähler“ um eins erhöht, wie das Positionierungswort in dem Dokument gefunden wird. Diese Schleife bricht am Ende des Dokumentes automatisch ab. Die Variable „Zähler“ wird in den anderen Unterfunktionen für eine FOR-Schleife verwendet, die nach einer bestimmten Anzahl von Durchläufen abgebrochen wird. Diese FOR-Schleife hätte auch als WHILE-Schleife eingebunden werden können. Doch so ist vor dem Durchlaufen der Schleife klar, wie oft sie durchlaufen werden muss und sie kann an einer geeigneten Stelle abgebrochen werden. Der Nachteil dieser Variante ist, dass sie laufzeitintensiver ist.

Funktion: „LöschenderGliederung“

Diese Unterfunktion löscht die Gliederungsnummern vor den letzten drei Gliederungsebenen der einzelnen Testfälle. Da der gesamte Ablauf dieser Unterfunktion drei Mal durchlaufen werden muss, aber mit unterschiedlichen Variablen, wurde beschlossen, diese Unterfunktion wiederholt mit einer Parameterübergabe in der Hauptprozedur auszuführen. Dadurch wird der gesamte Quelltext übersichtlicher und kompakter.

Abb. 1: Ursprüngliche Gliederung des Testberichtes die durch die Unterfunktionen bearbeitet wird

Christoph Weigel Praktikumsarbeit Seite 4

Die Positionierungswörter finden sich am Anfang der Gliederungspunkte in den einzelnen Ebenen. So fängt die drittletzte Gliederungsebene aller Testfälle mit „Test Set :“, die vorletzte Ebene mit „Plan: Test Name :“ und die letzte Ebene mit “Run Name :“ an. Diese Wörter und drei weitere Variablen, die zum Löschen der Gliederung notwendig sind, werden von der Hauptprozedur an die Unterfunktion übergeben. In der Unterfunktion wird zuerst die Unterfunktion Zählalgorithmus ausgeführt. Anschließend wird mit der ermittelten Anzahl der Positionierungswörter eine FOR-Schleife durchlaufen.

Die Gliederungsnummern werden, durch die Generierung in Word, in einer unterschiedlichen Formatierung ausgegeben. Daher ist es notwendig in der Schleife eine Entscheidung zu definieren, die ermittelt wie die Gliederungsnummern formatiert wurden. Ist diese als Feld formatiert, kann die Gliederungsnummer als Ganzes, mit einem Befehl gelöscht werden. Ist die Gliederungsnummer aber lediglich als Zeichenkette ausgegeben, muss jedes Zeichen der Gliederungsnummer einzeln eingelesen und gelöscht werden. Dieses Löschen der Zeichen endet, wenn das eingelesene Zeichen der Anfangsbuchstabe des Positionierungswortes ist.

Funktion: „SetzenderGliederung“

Diese Unterfunktion erzeugt eine neue Nummerierung der letzten drei Gliederungsebenen. Bei der Erstellung eines geeigneten Ablaufplans gab es einige Probleme, da dies eine sehr komplexe Aufgabe war. Das Schema musste mehrmals überarbeitet werden. Nachfolgend wird eine erste Lösung dieses Problems erläutert. Anschließend werden die Lösungen beschrieben, wie das Makro optimiert wurde.

Die Nummerierung der Gliederungsebenen erfolgt über vier verschachtelte FOR-Schleifen, wobei jede FOR-Schleife eine Gliederungsebene darstellt. Der Laufindex einer FOR-Schleife bildet somit einen Teil der Nummerierung ab. In jeder übergeordneten FOR-Schleife werden

Abb. 2: Schaubild der Nummerierung durch vier FOR-Schleifen

Christoph Weigel Praktikumsarbeit Seite 5