Testdaten-Matrix¶
Die geführte Matrix wird im Web bedient. Ihre Ergebnisse sind normale Testfallvarianten und können auch in Windows verwendet werden.
Mit der Testdaten-Matrix erzeugen Sie gezielt Kombinationen vorhandener Variantenwerte für einen Testfall der Bibliothek. Beispielsweise ergeben zwei Browser, zwei Rollen und zwei Datensätze acht Kombinationen:
| Dimension | Ausgewählte Werte |
|---|---|
| Browser | Chromium, Firefox |
| Rolle | Kunde, Administrator |
| Datensatz | Standard, Sonderzeichen |
Ein „Datensatz“ in dieser Kombinationstabelle ist ein benannter Variantenwert. Ergänzend können Sie strukturierte Testdatensätze mit Spalten und Zeilen pflegen und deren Werte ausdrücklich in Testtexte übernehmen. Testumgebungen bleiben davon getrennt: Sie gruppieren ganze Testläufe.
Voraussetzungen¶
Das Projekt muss Testvarianten verwenden. Die gewünschten Dimensionen und Werte müssen bereits in der Variantenverwaltung angelegt sein. Zum Ergänzen benötigen Sie Schreibzugriff auf den betroffenen Bibliothekstestfall. Mit Leserechten können Sie die Vorschau prüfen; zum Ergänzen der Varianten ist weiterhin Schreibzugriff erforderlich.
Kombinationen auswählen und übernehmen¶
- Öffnen Sie den gewünschten Testfall in der Web-Testfallbibliothek und wählen Sie im Testfallkopf Testdaten-Matrix. Der Einstieg steht auch im Kontextmenü des ausgewählten Testfalls im Bibliotheksbaum zur Verfügung.
- Markieren Sie die gewünschten Werte je Dimension. Eine Dimension wird nur dann Teil der Matrix, wenn Sie mindestens einen ihrer Werte auswählen.
- Wählen Sie Kombinationen vorschauen. Die Anwendung kombiniert die ausgewählten Werte jeder beteiligten Dimension miteinander. Es entstehen ausschließlich Kombinationen der tatsächlichen Werte; eine zusätzliche leere Auswahl wird nicht ergänzt.
- Prüfen Sie, welche Kombinationen bereits als Testfallvarianten vorhanden sind. Markieren Sie nur die fehlenden Kombinationen, die Sie hinzufügen möchten.
- Wählen Sie Ausgewählte Kombinationen ergänzen und bestätigen Sie die Übernahme. Öffnen Sie anschließend die normalen Testfallvarianten und prüfen beziehungsweise ergänzen Sie die fachlichen Inhalte.
Bestehende Varianten behalten ihre Inhalte. Auch bereits vorhandene Kombinationen werden nicht erneut angelegt. Die Vorschau umfasst höchstens 200 Kombinationen; eine niedrigere konfigurierte Variantengrenze des Projekts begrenzt sie zusätzlich. Auch die Gesamtzahl aus vorhandenen und neu ergänzten Varianten muss innerhalb der geltenden Grenze bleiben. Verkleinern Sie die Auswahl, wenn die Anwendung eine Grenze meldet.
Ändert sich der Testfall oder seine Varianten zwischen Vorschau und Übernahme, wird die veraltete Vorschau abgewiesen. Erstellen Sie dann eine neue Vorschau und prüfen Sie Ihre Auswahl erneut.
Auswirkungen auf Inhalte und Planung¶
Neue Kombinationen verwenden das vorhandene Variantenmodell. Prüfen Sie insbesondere die geerbten Testschritte und erwarteten Ergebnisse, bevor Sie die Varianten einplanen. Bei Quick-Testfällen werden die Quick-Zeilen der primären Variante nur kopiert, wenn die entsprechende Projekteinstellung aktiviert ist. Die Matrix führt für Quick-Testfälle keine zusätzliche Versionshistorie ein.
Bereits geplante Testfälle, laufende Testläufe und Ergebnisse werden nicht automatisch aktualisiert. Verwenden Sie die neuen Varianten bei der nächsten bewussten Testplanung. Die Matrix startet keinen Testlauf und erzeugt kein Testergebnis.
MCP und REST¶
ztm_project_test_data_matrix liest mit operation: "context" und testCaseId die verfügbare Auswahl. Mit operation: "preview", derselben testCaseId und valueIds erhalten Sie die Vorschau. Verwenden Sie die IDs der vorhandenen Werte aus dem Kontext.
Änderungen erfolgen über ztm_project_action_prepare und ztm_project_action_commit mit der Capability project.test-data-matrix.apply. Die Argumente sind testCaseId, selectedCombinations (ein Array von Arrays mit Werte-IDs) und expectedFingerprint aus der aktuellen Vorschau. Übergeben Sie nur die bewusst ausgewählten fehlenden Kombinationen. Vorbereiten allein speichert nichts; prüfen und bestätigen Sie die Vorschau vor dem Commit.
REST stellt dieselben Operationen unter /api/v1/operations/{operationId} bereit. Beide API-Zugänge verwenden dieselben Rechte, Grenzen und Konfliktprüfungen wie das Web. Ein Projekt-API-Schlüssel benötigt die passenden Lese- beziehungsweise Schreib-Scopes; auch mit Schreib-Scope bleiben die Testfallrechte maßgeblich.
Strukturierte Testdatensätze¶
Öffnen Sie in der Testdaten-Matrix den Bereich Testdatensätze. Für eine Zuordnung zu einem Testfall wählen Sie dort zunächst die Testfallvariante und Testdaten auswählen. Die Verwaltung erfolgt im Web; angewendete Texte sind auch in Windows verwendbar.
- Einen neuen Datensatz anlegen, benennen und einer Testeinheit zuordnen. Die Rechte dieser Testeinheit bestimmen, wer den Datensatz lesen oder bearbeiten darf.
- Spaltenschlüssel festlegen, einen je Zeile. Ein Schlüssel beginnt mit einem Buchstaben und enthält nur ASCII-Buchstaben, Ziffern und Unterstriche, beispielsweise
AccountoderExpectedMessage. - Datenzeilen ergänzen, Werte eintragen und Datensatz speichern wählen. Es sind höchstens 30 Spalten, 1.000 Zeilen und 32.767 Zeichen je Zelle erlaubt; zusätzlich gilt eine Gesamtgrenze von 2 MiB für den Dateninhalt. Leere Zellen sind gültige Werte.
Die Tabelle zeigt die Werte kompakt. Klicken Sie zum Bearbeiten in eine Zelle; Enter fügt einen Zeilenumbruch ein, Tab wechselt weiter. Datensatz speichern übernimmt auch den noch aktiven Zelleneditor. Sortierung und Seitenwechsel verändern weder die Zeilen-IDs noch die gespeicherte Reihenfolge. Die Aktion zum Entfernen einer Zeile bleibt rechts sichtbar und fragt vor dem Entfernen nach. Zahlenähnliche Werte wie 0007 bleiben Text.
Datensätze sind normale Projektinhalte und kein Geheimnisspeicher. Verwenden Sie synthetische Testwerte statt produktiver Kennwörter oder personenbezogener Daten.
XLSX importieren und exportieren¶
XLSX exportieren erstellt eine Arbeitsmappe mit einem Arbeitsblatt. Die erste Spalte _RowId enthält die stabilen Zeilen-IDs; danach folgen die Spaltenschlüssel. Bestehende IDs beim Bearbeiten beibehalten, für neue Zeilen leer lassen. Spaltennamen dürfen nicht leer oder doppelt sein.
Nach XLSX-Import prüfen zeigt der Editor die eingelesenen Daten. Erst Datensatz speichern ersetzt den bestehenden Inhalt. Fehlende bisherige Zeilen werden dabei entfernt; bereits gebundene Zeilen können nicht entfernt werden. Hat sich der Datensatz seit der Vorschau geändert, wird das Speichern abgewiesen.
Formeln, Makros und externe Verknüpfungen werden nicht übernommen. In Excel stattdessen Werte einfügen. Exporte schreiben alle Werte als Text, sodass führende Nullen, mehrzeilige Texte und mit = beginnende Werte erhalten bleiben. Hochgeladene Dateien dürfen höchstens 4 MiB groß sein; zusätzlich werden die entpackte Größe und die Inhaltsgrenzen geprüft.
Werte in Testtexte übernehmen¶
Im Testtext bezeichnet {{data:Account}} den Wert der Spalte Account. Wählen Sie für die gewünschte Variante einen Datensatz und eine Zeile und anschließend Ersetzung prüfen. Unbekannte Spalten und ungeeignete Positionen, etwa ein Platzhalter in einer HTML-Adresse, verhindern die Übernahme. Werte werden nicht als HTML oder als weitere Platzhalter ausgeführt.
Diese Werte anwenden speichert die geprüften Texte und die zugehörigen Werte an der Variante. Die ursprünglichen Vorlagentexte bleiben für ein späteres ausdrückliches Neuanwenden erhalten. Nichtprimäre Varianten können eigene Daten verwenden, auch wenn ihr Ausgangstext von der Primärvariante stammt. Wiederverwendbare Schrittabschnitte und Quick-Test-Zellen werden ebenfalls berücksichtigt.
Spätere Änderungen am Datensatz aktualisieren keine Testtexte automatisch. Auch eine neue Planung verwendet den zuletzt ausdrücklich angewendeten Variantenstand. Bereits bestehende Testläufe behalten ihre gespeicherten Inhalte. Bindung lösen, Text behalten entfernt die Zuordnung und lässt die zuletzt angewendeten Texte stehen.
Die Testfall-Versionierung berücksichtigt die Bindung und ihre gespeicherten Werte. Die Wiederherstellung einer älteren Revision verwendet deren damaligen Stand, nicht die inzwischen geänderten Daten. Ein noch von Bibliotheksvarianten verwendeter Datensatz beziehungsweise eine verwendete Zeile kann nicht gelöscht werden.
Einstieg aus Windows¶
Klicken Sie in der Windows-Testfallbibliothek mit der rechten Maustaste auf einen gespeicherten Testfall und wählen Sie Testdaten-Matrix im Web öffnen. Der Testfall wird im Browser vorgewählt; dies gilt auch für Quick-Tests.
Die bestätigte Windows-Sitzung meldet Sie automatisch an. Nur wenn die Übergabe nicht gelingt, erscheint die Anmeldung; das Ziel bleibt erhalten.