Wenn Sie ein Microsoft
Excel-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.
Informationen zu diesem Vorgang
Konfigurationsdateien enthalten Anweisungen, die Informationen zu Quality-Management-Artefakten mit Datenpositionen verknüpfen. Jede Anweisung in einer Konfigurationsdatei besteht aus zwei Seiten, die durch ein Gleichheitszeichen verbunden sind. Die linke Seite der Anweisung besteht aus Schlüsselwörtern. Rechts vom Gleichheitszeichen können in der Konfiguration drei mögliche Elemente stehen:
- Eine Spalten- oder Zellendefinition, z. B. D or D4
- Eine Literalzeichenfolge, z. B. "execution"
- Eine Referenz auf ein anderes Artefakt (wird auch als rückverweisende Referenz bezeichnet), z. B. eine Test-Script-Beschreibung
Geben Sie einfach die Spalten- oder Zellen-ID an, um eine Zeile oder Zelle zu
definieren:
testscript.dc:title=G
Zum Definieren einer
Literalzeichenfolge setzen Sie die Zeichenfolge einfach in Anführungszeichen:
testscript.steps.type="execution"
Zum Definieren einer
rückverweisenden Referenz geben Sie die links neben dem Gleichheitszeichen stehenden
Informationen aus einer zuvor definierten Zeile an:
testscript.dc:title=G
testcase.dc:title=testscript.dc:title
Anmerkung: Rückverweisende Referenzen werden für die Erstellung von Artefakten verwendet, die
Daten nutzen, die bereits von einem anderen Artefakt verwendet werden. Dabei wird ein
Link zu dem betreffenden Artefakt erstellt. Rückverweisende Referenzen können nicht zusammen mit dem Schlüsselwort XLSLink verwendet werden.
Schlüsselwörter und Sonderfälle
Einige der Schlüsselwörter werden links vom Gleichheitszeichen angegeben. Sie beginnen alle mit "XLS" und ersetzen das nach dem Artefakt folgende Feld. Sie sind wie folgt definiert:
- XLSStartRow definiert die Zeile, ab der die Artefaktdaten beginnen.
- XLSDelimeter definiert das Element, das das nächste Artefakt angibt (zurzeit wird nur \n unterstützt).
- XLSLink gibt an, dass das Artefakt mit allen Artefakten des angegebenen Typs im Arbeitsblatt verlinkt wird.
- XLSLinkReverse weist das Exportdienstprogramm an, den XML-Code für den Link in das Hauptartefakt zu schreiben, anstatt in das Artefakt, das den Link herstellt. Verwenden Sie dieses Schlüsselwort mit Links, die auf sich selbst verweisen. Verwenden Sie dieses Schlüsselwort, wenn Sie ein Artefakt erstellen, das auf einem anderen Artefakt basiert (beispielsweise requirement.dc:title=testcase.dc:title), es jedoch erforderlich ist, dass der Link im Originalartefakt erstellt wird, also dem Artefakt rechts vom Gleichheitszeichen. Wenn Sie requirement.XLSLinkReverse=true angeben, wird der Link in das Hauptartefakt gestellt und nicht in das Artefakt, das den auf sich selbst verweisenden Link angibt.
- XLSArtifactID gibt die externe ID des Artefakts an. Wird die
externe
ID des Artefakts nicht angegeben, wird eine
externe
Standard-ID mit folgendem Format zugewiesen:
Name der Excel-Datei_Name des Excel-Arbeitsblatts[_Artefaktanzahl].xml
Dabei ist Artefaktanzahl die Anzahl der Artefakte in einem einzelnen Arbeitsblatt, wenn das Arbeitsblatt mehrere Artefakte enthält. Enthält das Arbeitsblatt ein einzelnes Artefakt, ist dieses Argument nicht erforderlich.Wichtig: Enthält das Arbeitsblatt ein Artefakt mit derselben
externen ID wie ein anderes Artefakt, wird das Artefakt mit dem Arbeitsblattinhalt aktualisiert. Wenn Sie beispielsweise dasselbe Excel-Arbeitsblatt mit derselben Konfiguration mehrmals
exportieren, wird die
externe
ID jedes Mal aktualisiert.
Vorsicht:
Wenn Sie artifact.XLSArtifactID="urn:com.ibm.rqm:testplan:2" verwenden und der Wert als Zeichenfolge und nicht als Zelle angegeben ist, müssen Sie sicherstellen, dass das Arbeitsblatt nicht leer ist und dass artifact.XLSWorksheetID nicht zum Angeben des Arbeitsblatts verwendet wird, aus dem die XLSArtifactID gelesen wird.
Führen Sie einen der folgenden Schritte aus, um neue Artefakte zu erstellen, wenn Sie dieselben Excel-Dateien in dasselbe Repository exportieren:
- XLSWorksheetID gibt den Namen des zu verarbeitenden Arbeitsblatts an. Sie müssen für dieses Schlüsselwort eine Literalzeichenfolge verwenden.
Anmerkung: Ab Version 4.0 wurde die Syntax für die Verlinkung von
testsuite mit
testcases wie folgt geändert: Von
testsuite.testcases=testcase
in
testsuite.XLSLink=testcase
- Hier einige Beispiele:
- testscript.XLSStartRow=7
- testscript.title=B
- testscript.steps.type="execution"
- testscript.steps.description=B
- testscript.steps.title=B
- testscript.steps.name=B
- testscript.steps.expectedResult=F
- testscript.XLSDelimeter=\n
- testcase.dc:title=C1
- testcase.dc:description=C2
- testcase.XLSLink=testscript
- testcase.XLSArtifactID=D1
- testcase.XLSWorksheetID="test_case_1"
Script-Schritte, Kategorien, Abschnitte, Bildexporte, dynamische Suchen nach einem Wort oder einer Wortfolge und Arbeitsblatteigenschaften sind Sonderfälle. In jedem Schritt sind bestimmte Schritte erforderlich.
Da ein Script vielen Schritte umfassen kann, werden alle Zeilen bis zu einer Leerzeile als ein Schritt aufgefasst. Nach der Leerzeile beginnt ein neuer Schritt.
Abschnitte sind Sonderfälle. Verwenden Sie das Sonderformat für Abschnitte, um die Verwendung von Abschnitten zu vereinfachen und um zu verhindern, dass Abschnittsdefinitionen gegen die Punktschreibweise verstoßen.
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")=C
Dieser Beispielkonfigurationseintrag füllt den Abschnitt mit den Abnahmekriterien, der in
die Anwendung Quality Management integriert ist.
- So bestimmen Sie den Namen oder Anzeigenamen von vordefinierten Abschnitten:
- Aktualisieren Sie den vordefinierten Abschnitt einer Ressource in Quality Management.
- Lesen
Sie die
Ressource
als
XML
mit
abbreviate=false.
- Suchen Sie das Element im XML-Dokument mit dem Abschnittsnamen, beispielsweise
com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria.
- Suchen Sie das Attribut extensionDisplayName in dem Element, das den Anzeigenamen des Abschnitts enthält, z. B.
RQM-KEY-TC-ACCEPT-CRITERIA-TITLE.
- 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")=C
- Verwenden Sie zum Definieren einer Kategorie das Format category term=Kategoriename.value=Kategoriewert:
testcase.category term="Function".value=H
- Einem Artefakt kann ein angepasstes Attribut hinzugefügt werden. Wenn in einem einzelnen Testfall zwei angepasste Attribute (customAttributes) vorhanden sind, und zwar testcaseCustomAttribute1 und testcaseCustomAttribute1, müssen die zwei angepassten Attribute testcaseCustomAttribute1 und testcaseCustomAttribute2 in der Anwendung Quality Management erstellt werden, bevor das Excel-Importprogramm in Quality Management ausgeführt wird.
Die CFG-Datei (.cfg) kann wie folgt konfiguriert werden:
testcase.customAttributes.type="SMALL_STRING" //Datentyp für das angepasste Attribut festlegen
testcase.customAttributes.identifier=A //ID in die Excel-Spalte A stellen Die ID ist der Name des Attributs bei dessen Erstellung. Wenn Sie beispielsweise das Attribut customerAttribute mit dem Namen "name1" erstellen und diesen später in "name2" ändern, bleibt "name1" auf dem Quality-Management-Server als ID bestehen.
Wenn Sie die ID für das angepasste Attribut als Custom_attribute_number_ festlegen und das erste Attribut Custom_attribute_0_ und das zweite Custom_attribute_1_ ist, ist diese ID korrekt, wenn in die Excel-Zelle gestellt wird.
testcase.customAttributes.name=B //Attributnamen in Spalte B einfügen
testcase.customAttributes.value=C //Attributwert in Spalte C einfügen
Das Ergebnis sieht wie folgt aus:
<customAttributes>
<customAttribute type="SMALL_STRING">
<identifier>Custom_attribute_0_</identifier>
<name>testcaseCustomAttribute1</name>
<value>111111111111111111111111111</value>
</customAttribute>
<customAttribute type="SMALL_STRING">
<identifier>Custom_attribute_1_</identifier>
<name>testcaseCustomAttribute2</name>
<value>3333333333333333333333333</value>
</customAttribute>
</customAttributes>
Ein Beispiel, das angepasste Attribute enthält, ist
in folgenden Dateien enthalten: "TestCases 001 with custom attributes.xls" und "TestCases
001 with custom attributes.cfg" im Ordner mit den
Beispielen.
- Sie können unter Verwendung der folgenden Zeilen auf die Eigenschaften des Spreadsheets zugreifen, das Sie gerade
bearbeiten:
Außerdem sind drei weitere Eigenschaften verfügbar: “Name,” “Full Name” und “Location”.
Wurde die Eigenschaft nicht definiert oder unterstützt Excel die Eigenschaft nicht, gibt die Eigenschaft (“Eigenschaftsname”) die leere Zeichenfolge “” zurück.
Die zugehörigen XLS- und CFG-Beispieldateien tragen die Bezeichnung
Requirements001 using document properties.
- Zum Exportieren von Images aus Excel müssen Sie mit folgenden Aspekten der Images in
Spreadsheets vertraut sein:
Die Position von Images in Excel
entspricht der Zelle, die die linke obere Ecke des Image enthält. Selbst wenn ein Image über mehrere Zellen verteilt ist, müssen Sie zum Exportieren des
Image die Zelle angeben, die die linke obere Ecke des Image enthält. Zellen können eine unbegrenzte Zahl von Images enthalten. Wenn Sie die Zelle angeben, die
die linke obere Ecke aller Images enthält, werden alle Images exportiert.
In Excel können Sie Images auf zwei Arten exportieren. Die erste Methode besteht darin, die Imagefunktion zu verwenden. Das Image wird als
Funktion konfiguriert, die in einem Konfigurationsdateieintrag rechts vom
Gleichheitszeichen angegeben werden muss. Images können durch die Zelle oder Zeile angegeben werden. Die Imagefunktion fügt ein
Image in das Rich-Text-Feld ein, dem sie zugewiesen ist. Wenn das Attribut kein Rich-Text-Feld verwendet, wird die Imagefunktion ignoriert. Nachfolgend stehen Beispiele für die Imagefunktion:
- testscript.steps.expectedResult=image(G)
- testscript.steps.description=image(C4)
Bei der zweiten Methode wird das Attribut "attachment" verwendet:
- testcase.attachment=C4
- testcase.attachment=C
Das Attribut "attachment" fügt dem Artefakt
Images als Anhänge hinzu, anstatt das Image in Rich-Text-Felder einzufügen.
Die zugehörigen XLS- und CFG-Beispieldateien tragen
die Bezeichnung Test Cases made from scripts with
images bzw. Test Cases made from scripts with attachments.