Dieses Kapitel erläutert, welche Testkonfigurationsparameter Sie für API-Tests verwenden können und wie Sie Log-Informationen anzeigen.
Logging
Erstellen Sie den Testkonfigurationsparameter WebserviceEngineLogRequestResponse, um Requests und Responses als HTTP-Nachrichten in Textdateien zu speichern. Sie können diese Textdateien überprüfen, um Fehler zu identifizieren.
Wenn Sie den Testkonfigurationsparameter auf True setzen, speichert die Engine jeden Request und jede Response als Textdatei in dem Verzeichnis, das Sie in der Einstellung Request/Response log directory angeben. Das Standardverzeichnis ist: %APPDATA%\Tricentis\Tosca Testsuite\7.0.0\logs\Automation\WSE. Jede Textdatei verwendet das Namensformat <yyyyMMdd_hhmmssfff>_<Request|Response>.txt und zeigt den Sende- oder Empfangszeitpunkt, den HTTP-Header und den Nachrichteninhalt an.
Nach einem Testdurchlauf zeigt die Ausführungsliste im Bereich Execution in der Spalte Detail für die Ausführungseinträge Send und Receive den Pfad zur Log-Datei an.
Verwenden Sie die Module Save Request und Save Response in den Testschrittwerten Transform request und Transform response, um Requests und Responses in ihrem ursprünglichen Format zu speichern.
Timeout einstellen
Erstellen Sie den Testkonfigurationsparameter WebserviceEngineResponseTimeout, um den Response-Timeout für eine Ausführungsliste in Millisekunden festzulegen. Der Timeout gibt an, wie lange die Engine auf die Antwort eines Webservice wartet. Um den Timeout global zu ändern, verwenden Sie die Einstellung ResponseTimeout.
API-Nachrichten-Payloads automatisch formatieren
Erstellen Sie den Testkonfigurationsparameter ApiEngineAutoPrettyPrint, um API-Nachrichten in Ihrem Testfall automatisch zu formatieren. Dadurch formatiert Tosca Request- und Response-Payloads bei der Überprüfung einheitlich. So werden fälschliche Testfehler vermieden, die auftreten können, wenn Tosca formatierte und nicht formatierte JSON-Daten vergleicht.
Um diese Konfiguration global einzustellen, verwenden Sie die Einstellung Auto pretty print.
Details von API-Nachrichten protokollieren
Erstellen Sie den Testkonfigurationsparameter ApiEngineLogMessageDetails, um bei Testdurchläufen vollständige Details zu API-Nachrichten zu protokollieren und sie in der Spalte Detail Ihrer Ausführungslisten anzuzeigen. Wenn Sie diesen Parameter auf True setzen, speichert Tosca alle relevanten Request- und Response-Informationen wie Header, Eigenschaften, Payloads, Statuscodes und Zeitdaten in einem strukturierten Format. Dies bietet über das standardmäßige Request-/Response-Logging hinaus eine zuverlässige Möglichkeit, vollständige API-Interaktionen zu analysieren, zu debuggen und wiederzuverwenden.
Deaktivierte Testschrittwerte in die Payload aufnehmen
Standardmäßig entfernt Tosca deaktivierte Testschrittwerte aus der Payload des API-Moduls. Erstellen Sie den Testkonfigurationsparameter ApiEngineTreatDisabledNodesAsInactive und setzen Sie ihn auf false, um deaktivierte Testschrittwerte in der Payload beizubehalten.