Eigene Zerlegung entwickeln
- Simon Scherer
- Simon Wheeler
- Svenja Stöber
Auf dieser Seite erklären wir Ihnen, wie Sie eine eigene Zerlegung implementieren können
Hinweis
Für diese Funktion sind Java-Programmierkenntnisse erforderlich und eine Java-Entwicklungsumgebung (z. B. Eclipse)
Sie können hier ein Demo-Projekt herunterladen, welches die Projektstruktur vorgibt und die erste Einrichtung erleichert.
Zerlegung V1
Importieren Sie das Demo-Projekt in Ihre Entwicklungsumgebung. Sie sollten anschließend folgende Dateistruktur haben:
Die wichtigen Dateien sind
ZerlegungDemo.javai
info.properties
Optional können UnitTests durchgeführt werden, dafür wird die ZerlegungDemoTest.java verwendet.
info.properties
In dieser Datei werden die Metadaten der Zerlegung definiert, die innerhalb FE2 angezeigt werden.
ZerlegungDemo.java
In dieser Datei wird die eigentliche Zerlegung durchgeführt. Der Alarmtext wird von FE2 als String übergeben und kann dann mit Ersetzungen, Zerlegung,... selbst aufgeilt werden. Beispiele dazu finden Sie im Beispielprojekt.
ZerlegungDemoTest.java
Hier können Sie Tests durchführen lassen, um Ihre Zerlegung gegen mehrere verschiedene Alarmtexte zeitgleich zu testen. Bauen Sie hier Ihre Testfälle auf und führen Sie dann anschließend die ZerlegungDemoTest.java über den Ausführen-Button in Ihrer Entwicklungsumgebung aus.
Wenn ein Fehler auftritt, wird das im Reiter "JUnit" dargestellt. Sie sehen dann auch sofort, was erwartet wurde (erster Wert => B 3 PERSON) und was durch die Zerlegung ermittelt wurde (zweiter Wert ⇒ B 3 PE).
Sollte alles erfolgreich sein, werden keine Fehler angezeigt und der rote Balken wird grün dargestellt.
Export für die Verwendung mit FE2
Natürlich muss die Zerlegung nun für die Verwendung mit FE2 exportiert werden.
Wichtig
Folgen Sie dazu Schritt für Schritt dieser Anleitung, da FE2 ansonsten mit der exportieren Datei nicht umgehen kann
Klicken Sie in Eclipse auf "File" → "Export"
Klicken Sie dann auf "Java"→ "JAR file" und dann auf "Next"
Deaktivieren Sie alle Checkboxen
Aktivieren Sie nur folgende Checkboxen:
Wählen Sie einen Speicherort für Ihre exportierte Datei aus:
Lassen Sie alle anderen Optionen auf Standardeinstellungen und klicken Sie auf "Finish"
Sollten Warnmeldungen erscheinen, können Sie diese ignorieren.
Navigieren Sie anschließend in den Ordner "FE2\Config\data\extern" und fügen Sie dort die soeben erstellte Datei ein. Wo sich der Config-Ordner befindet, ist auf folgender Seite erklärt: Ordnerstruktur der Installation
Melden Sie sich anschließend in FE2 an.
Navigieren Sie zu der Liste der Einheiten und klicken dort auf „Einstellungen“
Nun können Sie für die gewünschte Einheit die soeben erstellte Zerlegung auswählen.
Zerlegung V2 (ab FE2 2.26)
Importieren Sie das Demo-Projekt-V2 in Ihre Entwicklungsumgebung. Sie sollten anschließend folgende Dateistruktur haben:
Die wichtigen Dateien sind
ZerlegungV2Example.java
info.properties
Optional können UnitTests durchgeführt werden, dafür wird die ZerlegungV2Example.java verwendet.
info.properies
In dieser Datei werden die Metadaten der Zerlegung definiert, die innerhalb FE2 angezeigt werden.
ZerlegungV2Example.java
In dieser Datei wird die eigentliche Zerlegung durchgeführt. Der Alarmtext wird von FE2 für die V2 als Map übergeben und kann dann mit Ersetzungen, Zerlegung,... selbst aufgeilt werden. Als Rückgabe für FE2 dient das Objekt ExtractorObject. Dieses enthält die zerlegten Parameter, sowie ein Status der bestimmt, ob die Zerlegung erfolgreich durchgeführt wurde. Beispiele dazu finden Sie im Beispielprojekt.
ZerlegungV2ExampleTest.java
Hier können Sie Tests durchführen lassen, um Ihre Zerlegung gegen mehrere verschiedene Alarmtexte zeitgleich zu testen. Bauen Sie hier Ihre Testfälle auf und führen Sie dann anschließend die ZerlegungV2ExampleTest.java über den Ausführen-Button in Ihrer Entwicklungsumgebung aus.
Export für die Verwendung mit FE2
Diese Schritte sind analog zu V1 für Eclipse durchzuführen.