Daten per XML-Import aufnehmen

by | 09.10.2015 | in-STEP BLUE anwenden

Mit in-STEP BLUE können Sie leicht Anforderungen und Änderungen, Tests oder Risiken, Ideen oder Projektanträge mit allen ihren Eigenschaften in Formularen verwalten. Einerseits können Sie Anforderungen & Co. per Knopfdruck in-STEP BLUE anlegen und verwalten, andererseits auch mittels XML-Import über den Taskmanager in in-STEP BLUE aufnehmen. Wie dieser Import funktioniert erfahren Sie nachfolgend.

Den Taskmanager einrichten

Um eine XML-Datei in in-STEP BLUE importieren zu können, muss der Taskmanager für Ihr Oracle-basiertes System auf dem in-STEP BLUE Server aktiviert werden. Melden Sie sich dazu auf Ihrem in-STEP BLUE Server an und öffnen Sie dort die in-STEP BLUE Serverkonfiguration. Auf dem Reiter Bereitgestelle Systeme wählen Sie nun das System, für welches Sie den Taskmanager aktivieren möchten. Sie finden im Menü System den Eintrag in-Step Taskmanager konfigurieren.

Daten per XML Import aufnehmen
Befehl zum Aufruf der Konfiguration des Taskmanagers

Aktivieren Sie bitte den Taskmanager und hinterlegen die Anmeldedaten des Users, mit dessen Kennung die Aufgaben ausgeführt werden. Damit der gewählte in-STEP BLUE User die Ausgaben ausführen kann, benötigt er natürlich entsprechende Berechtigungen.

Daten per XML Import aufnehmen
Der Dialog zur Konfiguration des Taskmanagers

Konfigurationsdatei auf dem in-STEP BLUE Server anpassen

Damit der XML-Import wie gewünscht klappt, muss auf dem in-STEP BLUE Server eine Kleinigkeit angepasst werden. Ergänzen Sie die Datei inStep.TaskManager.exe.config im Bereich supportedInstepTasks um folgende Zeilen:

Daten per XML Import aufnehmen
Angepasste Codezeilen

Die Datei finden Sie im Verzeichnis Assemblies. Dies ist ein Unterverzeichnis des in-STEP BLUE Server Installationsverzeichnisses.

XML-Datei vorbereiten

Damit XML-Dateien importiert werden können, müssen sie einem bestimmten Schema entsprechen. Eine Beispieldatei mit vielen erklärenden Kommentaren finden Sie als Anhang am Ende des Blogbeitrages. Die Datei besteht im Wesentlichen aus zwei Bereichen:

Konfigurationsbereich

Als Attribute des Eintrages parameter wird angegeben, in welches System und Projekt importiert werden soll.

Der Bereich inStepImportConfiguration enthält Informationen zum Produkttyp der anzulegenden Formulare und des Startzustandes.

Ebenso finden Sie hier die Informationen wie die Nutzdaten der Datei den Eigenschaften der angelegten Produkte zugeordnet werden sollen (propertyMapping).

Nutzdaten

Im Bereich data befinden sich die zu importierenden Daten.

Wo werden die Dateien abgelegt?

Für den Import der XML-Dateien benötigen Sie neben einem passenden Formular für die Informationen, die Sie importieren wollen (für Meldungen ein Meldungsformular, für Risiken ein Risikoformular, etc.) ein Verzeichnis ImportData, das Sie unterhalb des Datenverzeichnisses Ihres Zielsystems anlegen müssen. Das Datenverzeichnis können Sie über den Eigenschaftendialog des Systems in der in-STEP BLUE Server Konfiguration ermitteln.

Daten per XML Import aufnehmen
Datenverzeichnis ermitteln

Das Ergebnis nach dem XML-Import

Und wie sieht das Ergebnis nach erfolgreichem Import aus? In unserem Beispiel wurden drei neue Meldungen mit den Inhalten aus der beigefügten XML-Datei angelegt.

Daten per XML Import aufnehmen
Der erfolgreiche Import von Meldungen

Und ein Klick auf eine Meldung „M-00013“ zeigt die Informationen der importierten Meldung im Detail:

Daten per XML Import aufnehmen
Importierte Meldung im Formular angezeigt

Wäre beim Import ein Fehler aufgetreten, so wird die betroffene Datei in ein Verzeichnis Errors unterhalb des ImportData Verzeichnisses verschoben und um eine entsprechende Fehlermeldung ergänzt.

Fertig. Mit ein bisschen Übung ganz leicht, oder? Wenn Sie es selbst probieren wollen, finden Sie hier die benutzte XML-Datei des beschriebenen Beispiels. Und wenn Sie Fragen haben, stehen wir Ihnen sehr gerne unter [email protected] oder 030/467086-20 zur Verfügung.