Konfigurationsdateien für den Export von Excel-Testartefakten erstellen

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:
  1. Eine Spalten- oder Zellendefinition, z. B. D or D4
  2. Eine Literalzeichenfolge, z. B. "execution"
  3. 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:
    • Geben Sie über das Schlüsselwort XLSArtifactID für jede Exportoperation eine eindeutige externe ID an.
    • Ändern Sie den Namen der Excel-Datei bzw. des Excel-Arbeitsblatt bei jedem Export.
    • Verwenden Sie zu Beginn des Exportprozesses die Option In Datei exportieren, ändern Sie den Namen von XML-Dateien und importieren Sie die XML-Dateien dann in die Anwendung Quality Management: Melden Sie sich an der Anwendung Quality Management an und klicken Sie auf eine der folgenden Optionen:
      • Planung > Testpläne importieren
      • Erstellung > Testfälle importieren
      • Erstellung > Test-Scripts importieren
      Tipp: Mit der oben genannten Methode können Sie nur Testpläne, Testfälle und Test-Scripts importieren.
  • 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.

Vorgehensweise


Feedback