test beginnen, umm bei der Ausführung als Testfall
erkannt zu werden. Umgekehrt bedeutet dies, das Prozeduren, die keine Testfälle
darstellen und trotzdem mit test beginnen, vermieden werden sollten,
zumindest aber nicht exportiert werden dürfen.
Um die RPGUnit Funktionen nutzen zu können, muss das Modul mit den Testfällen
das copy book TESTCASE einbinden:
Für Quellenteildateien:
/include qinclude,TESTCASE iRPGUnit Test Suite
/include qinclude/TESTCASE iRPGUnit Test Suite
Beispiele für Testfälle
Die Prozeduren(n) werden dann in einem Modul zu einer Test Suite
zusammengefasst und mit dem Befehl RUCRTRPG zu einem Serviceprogramm
kompiliert.
RUCRTRPG TSTPGM(RPGUNIT/RUPLUGINT1) SRCFILE(QEXAMPLE)
Ein Beispiel für eine RPGUnit Test Suite enthält die Teildatei QTEMPLATE.RPG. Bei der
Ausführung dieser Test Suite wird eine Druckausgabe mit einer Darstellung des Programmablaufs
erstellt.
| Hinweis: Um das Ergebnis einer Umwandlung in RDi zu erhalten, muss der Parameter COPTION
die Option *EVENTF enthalten. Ausserdem muss der Parameter SRCMBR die Quellenteildatei
bennen, damit RDi die Umwandlungsergebnisse laden kann. Zum Beispiel:
Weiterhin wird empfohlen *SRCSTMT anzugeben, um direkt mit einem Doppelclick aus der RPGUnit Ansicht an die fehlerhafte Programmzeile springen zu können. |
RUCALLTST ausgeführt werden.
Standardmäßig werden alle in der Test Suite enthaltenen Test Cases ausgeführt. Mit
dem Parameter TSTPRC kann ein einzelner Test Case zur Ausführung ausgewählt
werden.
RUCALLTST TSTPGM(RUPLUGINT1)
RUCALLTST TSTPGM(RUPLUGINT1) TSTPRC(TESTALLOK_2)
Das Ergebnis des Testlaufs erscheint sodann in der 'RPGUnit' View:
Das Kontextmenü stellt folgende Aktionen zur Verfügung:
| Bekanntes Problem: Der Editor für Datenstromdateien kann nicht auf die Zeile mit dem Unit Test Fehler positioniert werden, welches im LPEX Editor für Quellenteildateien möglich ist. |
Werte im Kopfbereich:
| Testläufe | : | Anzahl zuletzt ausgeführter Testfälle / Anzahl Testfälle in der Ansicht |
| Fehler | : | Anzahl Fehler in der Ansicht |
| Fehlgeschlagen | : | Anzahl fehlgeschlagener Testfälle in der Ansicht |
| Zusicherungen | : | Anzahl geprüfter Zusicherungen in der Ansicht |
Ergebnis eines fehlgeschlagenen Testlaufs:
Die Eigenschaften einer ausgewählten Zeile lassen sich auch in einem Eigenschaftsfenster in Tabellenform anzeigen:
Button einblenden.
| Tipp: Deaktivieren sie die Voreinstellung Anzeigen Ergebnissicht, um nach einem Testlauf den Focus auf der Ansicht zu halten, von der aus der Unit Test gestartet worden ist. Die RPGUnit Ergebnissicht visualisiert das Ergebnis eines Testlauf mit einem grünen oder roten Icon auf dem Tab der Sicht. |
 | Zeigt an, dass der Unit Test erfolgreich abgeschossen wurde. | |
 | Zeigt an, dass der Unit Test mit Fehlern geendet hat. Wechseln sie zur Ergebnissicht, um die Details zu prüfen. | |
 | Zeigt an, dass alle Unit Tests vom Benutzer abgebrochen worden sind. Wechseln sie zur Ergebnissicht, um die Details zu prüfen. |
Im Fall eines unerwarteten Programmabbruchs kann es hilfreich sein die Nachrichten im Jobprotokoll einsehen zu können. Verwenden sie die Voreinstellungen oder das Menü der Ansicht, um den Umfang der aufgezeichneten Nachrichten einzustellen:
| Keine Nachrichten | - | Es werden keine Nachrichten aus dem Jobprotokoll aufgezeichnet. |
| Abbruchnachrichten bei einem Programmabbruch | - | Bei einem unerwarteten Programmabbruch werden alle Abbruchnachrichten (*ESCAPE) des Jobprotokolls aufgezeichnet. |
| Alle Nachrichten bei einem Programmabbruch | - | Bei einem unerwarteten Programmabbruch werden alle Nachrichten des Jobprotokolls aufgezeichnet. |
| Alle Einträge | - | Alle Nachrichten des Jobprotokolls werden aufgezeichnet. |
| Formatieren Joblogeinträge | - | Gibt an, ob Joblogeinträge formatiert in der Befehlsprotokoll Ansicht dargestellt werden. |
| Einblenden Vergleichsanzeige | - | Öffnet/verbirgt die Vergleichsanzeige des erwarteten und tatsächlichen Werts. |
| Anzeigen Eigenschaften | - | Öffnet die Ansicht zur Anzeige der Eigenschaften eines Eintrags der RPGUnit Ansicht. |
Die aufgezeichneten Nachrichten des Jobprotokolls werden in der Befehlsprotokoll Ansicht angezeigt.
Das '«' Zeichen kennzeichnet das Ende eines Wertes, um nachfolgende Leerzeichen besser erkennen zu können.
Der Inhalt der Vergleichsanzeige kann wie folgt horizontal verschoben werden:
Die Unterschiede werden in der Farbe Farbe für Konflikt verursachende Änderung, konfiguriert unter Preferences - Colors and Fonts, angezeigt.
Die Schaltfläche neben den Erwartet und Tatsächlich Beschriftungen kopiert den Wert in die Zwischenablage. Das Verhalten kann wie folgt beeinflusst werden:
