CoreProcess-Befehle in Formularen ausführen

Mit in-STEP BLUE können Sie leicht neue Artefakte per Kontextmenü oder als Aktion im Zustandsautomaten erzeugen. Nun wollen Sie aber neue Artefakte direkt per Knopfdruck aus einem Formular heraus erzeugen – auch das funktioniert. Um Ihnen diese neue Option zu erläutern, werde ich mich auf das Testmanagement-Beispiel aus dem letzten Beitrag beziehen und dieses erweitern. Ziel war es, für Ihr Testmanagement aus Testergebnissen Fehlermeldungen für die Entwicklung zu erzeugen. Dies sollte automatisch passieren und zwar immer dann, wenn das Testergebnis in den Zustand „Test nicht erfolgreich“ gelangte. Vielleicht möchten Sie aber gar keinen Automatismus verwenden, sondern selbst entscheiden, wann eine Fehlermeldung erzeugt wird. Am liebsten genau dann, wenn Sie ein Testergebnis geöffnet haben, also direkt aus dem Formular heraus.

Testmanagement erweitern – aber wie?

Diese Voraussetzungen müssen erfüllt sein: Die Komponente „Ausführen eines CoreProcess-Befehls“ muss in Ihrem Projekt registriert sein. Den neuen Produkttypen „Fehlermeldung“ und das dazugehörige Formular sollten Sie bereits definiert haben. Außerdem sollten Sie einen Ableite-Befehl festgelegt haben, der aus Testergebnissen Fehlermeldungen erzeugt.

So konfigurieren Sie den Befehl für die Verwendung in Formularen

In der Konfiguration dieses Ableite-Befehls muss nun die Aktivierung dieses Befehls in Formularen ergänzt werden. Im Komponentendialog (System/Komponenten) wählen Sie dazu den CommandServer „… für Produkte (CoreProcess)“ aus und klicken auf Konfigurieren. Hier muss in der Spalte „Formular“ ein Haken gesetzt werden, damit der Befehl in einem Formular verwendet werden kann.

Befehl konfigurieren für die Verwendung in Formularen

Den Namen des Befehls sollten Sie sich merken, denn Sie werden ihn später noch benötigen. In meinem Beispiel habe ich ihn „Fehlermeldungerzeugen“ genannt.

Und noch etwas sollten Sie sich merken: die ProgID der Komponente. Sie wird nach dem Schließen des Dialogs in der Komponentenübersicht angezeigt und lautet: „CoreProcExtension.CoreProcProductCS“. Beides benötigen Sie später für die Konfiguration der Schaltfläche im Formular. Mit dem Formular geht es dann auch gleich weiter. Mehr Vorbereitungen müssen nicht durchgeführt werden.

So erweitern Sie das Formular

Sie wollen Fehlermeldungen aus Testergebnissen erzeugen. Also müssen Sie das Formular der Testergebnisse anpassen. Dieses Formular soll eine Schaltfläche erhalten, mit der eine neue Fehlermeldung erzeugt werden kann. Um dies zu tun, wird die Formularvorlage für die Testergebnisse (Testresult) aus in-Step ausgeliehen und mit dem Formulareditor von in-STEP BLUE geöffnet.

Testmanagement – Formular erweitern

Im Formulareditor finden Sie links bei den möglichen Controls einen „isCmdButton“. Dieses Control wählen Sie aus und fügen es im Formular an passender Stelle ein. Auf der rechten Seite werden anschließend die Eigenschaften für das Control festgelegt. Als Überschrift (Caption) wählen Sie „Fehlermeldung erzeugen“. CmdName gibt den Namen des aufzurufenden Befehls an. Diesen hatten Sie sich beim Konfigurieren des Befehls ja gemerkt und tragen dort nun „Fehlermeldungerzeugen“ ein. Darunter wird die ProgID des CommandServers verlangt. Auch die kennen Sie und können nun als CmdServerProgID „CoreProcExtension.CoreProcProductCS“ eintragen.

Wichtig ist noch, die Eigenschaft EnsureFormIsNotCheckedOut auf „True“ zu setzen. Damit wird sichergestellt, dass alle im Formular vorgenommenen Änderungen bereits eingecheckt sind. Ist dies nicht der Fall, wird das Formular vor Ausführen des Kommandos zunächst automatisch eingecheckt und ggf. wieder ausgecheckt. Es empfiehlt sich also, diese Option zu setzen, da sonst neue im Testergebnis gemachte Änderungen nicht in die Fehlermeldung übernommen werden, wenn sie noch nicht durch Zurückgeben in der Datenbank gespeichert wurden.

Das Ganze sieht im Formulareditor am Ende so aus:

Formulareditor in in-STEP BLUE

Speichern Sie Ihre Änderungen und geben Sie die Formularvorlage in in-STEP BLUE zurück. Ein Doppelklick auf die Vorlage zeigt, wie die Änderungen aussehen würden. Um den Zusammenhang zwischen dem Testergebnis und den erzeugten Fehlermeldungen noch transparenter zu machen, wäre es doch eigentlich schön, die Fehlermeldungen gleich im Formular mit anzuzeigen.

Auch das lässt sich schnell umsetzen: Leihen Sie die Formularvorlage noch einmal aus und nehmen Sie die Ergänzungen im Formulareditor vor. Dort fügen Sie neben einem Label als Erklärung ein Control für ReferringObjects ein und zwar mit dem Property „BUG REPORT.Quelle (Testergebnis)“. Im Formular wird dann an dieser Stelle eine Liste der Fehlermeldungen angezeigt, die auf das Testergebnis verweisen.

Einstellungen im Formulareditor

Auch diese Änderungen speichern Sie und geben das Formular in in-STEP BLUE zurück.

Wenn Sie nun ein bestehendes Testergebnis öffnen, sieht das Formular so aus.

Das tatsächliche Formular

Ein Klick auf die Schaltfläche Fehlermeldung erzeugen erstellt eine neue Fehlermeldung. Ist das Formular ausgeliehen, wird die neue Fehlermeldung anschließend gleich in der Liste zugeordnete Fehlermeldungen angezeigt, da vorher automatisch ein Einchecken und erneutes Auschecken erfolgt. Ist das Formular nicht ausgeliehen, würden Sie die neu erzeugte Fehlermeldung erst nach einem erneuten Öffnen des Testergebnisses direkt im Formular sehen.

in-Step Formular mit neuen Bug Report Einträgen

Und nun ist nur noch Ihre Kreativität gefragt: Ergänzen Sie Ihre Formulare um geeignete Schaltflächen und machen Sie sich die Arbeit mit in-STEP BLUE noch leichter!