Wenn Sie ein Microsoft
Word-Testartefakt exportieren, müssen Sie über eine Konfigurationsdatei verfügen, in der
definiert wird, wie die XML-Datei einem Quality-Management-Artefakt zugeordnet werden
soll.
Vorgehensweise
Anmerkung: Ein Konfigurationseintrag muss rechts neben dem Gleichheitszeichen eine Definition einer Literalzeichenfolge, einer Tabelle oder einer Gliederung enthalten.
Eine Tabelle ist durch den Eintrag Table( gekennzeichnet. Eine Liste ist durch den Eintrag List( gekennzeichnet. Beide Einträge müssen mit einer rechten runden Klammer ()) enden.
So erstellen Sie eine Zuordnung:
- Erstellen Sie eine Gliederungsdefinition: Die Inhaltsdefinition für eine Gliederungsliste kann aus einer Einrückungsstufe oder einem einzelnen Stern (*) als Platzhalterzeichen bestehen. Eine Einrückungsstufe ist eine ganze Zahl, während das Platzhalterzeichen in Anführungszeichen gesetzt werden muss. Beide können durch Angabe einer Absatznummer nach dem Komma weiter spezifiert werden.
Im folgenden Beispiel wird das Exportdienstprogramm angewiesen, eine Gliederung zu suchen, deren Überschrift dem Muster "1.*." entspricht, und nur den ersten Absatz dieser Gliederung als Testfalltitel zu verwenden:
testcase.dc:title=List("1.*.",1)
Wenn Sie das Komma und die Zahl übergehen, wird der gesamte Inhalt der Gliederungsstufe in das Titelfeld gestellt.
Wenn Sie eine ganze Zahl ohne Anführungszeichen angeben, verwendet das Exportdienstprogramm den Inhalt an der angegebenen Einrückung:
testcase.dc:title=List(1,1)
- Erstellen Sie eine Tabellendefinition: Eine Tabelle wird entweder durch die Positionsnummer, an der sie vorhanden ist, oder durch den Inhalt der ersten Zelle definiert.
Eine Tabelle, die Sie über eine Nummer
definieren, ist statisch, sodass jedes Artefakt, vom dem die betreffende Tabelle verwendet wird,
immer auf exakt dieselbe Tabelle verweist. Eine benannte Tabelle ist dynamisch,
d. h., sind in einem Dokument mehrere Tabelle vorhanden, die mit dem Text
übereinstimmen, werden mehrere Artefakte erstellt. Auf die definierte Tabelle müssen ein Punkt und eine Zellen- oder Spaltenreferenz folgen,
analog zur Definition einer Zelle bzw. Spalte in Excel.
Das folgende Beispiel definiert eine statische Tabelle und eine statische Zelle:
testscript.dc:title=Table(1).B3
Eine dynamische Tabelle stimmt mit dem Anfang des Textes in der ersten Tabellenzelle überein. Die Abgleichfunktion beachtet die Groß-/Kleinschreibung, ignoriert jedoch Leerzeichen. Das folgende Beispiel
nimmt Informationen aus der Spalte B aus allen Tabellen, bei denen die erste Zelle mit
“Step” übereinstimmt:
testscript.steps.title=Table("Step").B
- Erstellen Sie Links für rückverweisende Referenzen: Zum Definieren einer
rückverweisenden Referenz geben Sie die links neben dem Gleichheitszeichen stehenden
Informationen aus einer zuvor definierten Zeile an:
testscript.dc:title= Table(1).G
testcase.dc:title=testscript.dc:title
Tipp: Verwenden Sie rückverweisende Referenzen, um Artefakte zu erstellen, die
Daten nutzen, die bereits von einem anderen Artefakt verwendet werden, und um einen Link
zu dem betreffenden Artefakt zu erstellen.
- Verwenden Sie Schlüsselwörter: Das Schlüsselwort XLSLink gibt an, dass das Artefakt mit allen Artefakten des angegebenen Typs im Dokument verlinkt werden soll. Im folgenden Beispiel werden alle Test-Scripts im Dokument mit allen Testfällen verlinkt:
testcase.XLSLink=testscript
Verwenden Sie die Schlüsselwörter
DOCStart und
DOCStop, um anzugeben, bei welcher Listendefinition gestartet und gestoppt werden soll. Diese Schlüsselwörter werden nur für Listentypen verwendet und müssen ein Zeichenfolgeliteral enthalten. Im folgenden Beispiel beginnt der Konfigurationseintrag mit der Verarbeitung der Liste, wenn das fünfte Element gefunden wird, und stoppt die Verarbeitung, wenn das zwölfte Element gefunden wird. Diese Übereinstimmungen müssen exakt sein; das Listenelement "12.1" beendet den Prozess nicht.
testscript.DOCStart="5."
testscript.DOCStop="12."
- Modifizieren Sie Daten: Jede Zieldefinition kann in den Modifikator Pre() eingeschlossen werden.
In den folgenden Beispielen werden die resultierenden Daten in die Tags <div> und <pre> eingeschlossen, sodass die Formatierungsangaben erhalten bleiben:
testcase.Section("myns:com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria", "RQM-KEY-TC-ACCEPT-CRITERIA-TITLE")=Pre(Table(1).C)
testcase.Section("myns:com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria", "RQM-KEY-TC-ACCEPT-CRITERIA-TITLE")=Pre("this is my text")
Abschnitte stellen einen Sonderfall dar, um ihre Verwendung zu vereinfachen und um zu verhindern, dass ihre Definitionen mit der sonst verwendeten Notation mit Punkt in Konflikt geraten.
Verwenden Sie das folgende Format, um einen Abschnitt zu aktualisieren:
testcase.Section("myns:com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria", "RQM-KEY-TC-ACCEPT-CRITERIA-TITLE")=Table(1).C
Der vorhergehende Eintrag füllt den Abschnitt mit den Abnahmekriterien, der in die Anwendung Quality Management integriert ist.
Informationen zur Vorgehensweise beim Angeben des Namens oder Anzeigenamens von vordefinierten Abschnitten finden Sie im folgenden Artikel:
Konfigurationsdateien für den Export von Excel-Testartefakten erstellen. Zum Definieren eines angepassten Abschnitts ersetzen Sie den ersten Parameter durch einen gültigen Namen und den zweiten Parameter durch einen Anzeigenamen:
testcase.Section("myns:mysection","my custom section")=Table(1).C
Kategorien werden mit der Notation
category term=Kategoriename.value=Kategoriewert definiert.
Der Kategoriename wird in Anführungszeichen gesetzt:
testcase.category term="Function".value=Table(1).H
Verwenden Sie das Et-Zeichen (
&), um demselben Feld zwei oder mehr Angaben hinzuzufügen. Die Daten können aus einer Kombination unterschiedlicher Elemente bestehen. Das folgende Beispiel zeigt hinzugefügte Daten:
testcase.description=”my description:” & Table(1).H & testscript.description
- Zugriff auf die Dokumenteigenschaften der zu exportierenden Datei:
Gehen Sie anhand der folgenden Beispiele vor, um auf die Word-Dokumenteigenschaften der Datei zuzugreifen:
- requirement.dc:title=property(“Title”)
- requirement.dc:creator=property(“Author”)
- requirement.jzalm:owner=property(“Company”)
Die
Eigenschaften, die verfügbar sind und die in
Microsoft Office integriert sind, finden Sie
unter
http://msdn.microsoft.com/en-us/library/microsoft.office.core.documentproperty.aspx.
Außerdem sind drei weitere Eigenschaften verfügbar: “Name,” “Full Name” und “Location”.
Wurde die Eigenschaft nicht definiert oder unterstützt Word die Eigenschaft nicht, gibt die Eigenschaft (“Eigenschaftsname”) die leere Zeichenfolge “” zurück.
Die zugehörigen XLS- und CFG-Beispieldateien tragen die Bezeichnung
“Testscript in Tables using Document Properties”.
Beispiel
Für Version 4.0 wurde die Änderung vorgenommen, dass der Entwurf und das Artefakt in der Liste
durch den Tag
\n getrennt werden sollen, anstatt
\n innerhalb eines
einzelnen Artefakts anzugeben. Siehe hierzu folgendes Beispiel:
1. title
1.1 testcase1 title
1.1.1 testscript1 reference to the testcase1
1.1.1.1 testscript1 step1 title
1.1.1.1.1 testscript1 step1 description
1.1.1.1.2 testscript1 step1 expectresult
1.1.1.2 testscript1 step2 title
1.1.1.2.1 testscript1 step2 description
1.1.1.2.2 testscript1 step2 expectresult
1.1.1.3 testscript1 step3 title
1.1.1.3.1 testscript1 step3 description
1.1.1.3.2 testscript1 step3 expectresult
1.1.1.4 testscript1 step4 title
1.1.1.4.1 testscript1 step4 description
1.1.1.4.2 testscript1 step4 expectresult
1.2 testcase2 title
1.2.1 testscript2 reference to the testcase2
1.2.1.1 testscript2 step1 title
1.2.1.1.1 testscript2 step1 description
1.2.1.1.2 testscript2 step1 expectresult
1.2.1.2 testscript2 step2 title
1.2.1.2.1 testscript2 step2 description
1.2.1.2.2 testscript2 step2 expectresult
1.2.1.3 testscript2 step3 title
1.2.1.3.1 testscript2 step3 description
1.2.1.3.2 testscript2 step3 expectresult
1.2.1.4 testscript2 step4 title
1.2.1.4.1 testscript2 step4 description
1.2.1.4.2 testscript2 step4 expectresult
Die Leerzeile zwischen den beiden Testfalltiteln trennt die Testfälle voneinander.