Eigene Zerlegung entwickeln

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:

Open

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.

Open

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.

1. Klicken Sie in Eclipse auf "File" → "Export"
   
   

2. Klicken Sie dann auf "Java"→ "JAR file" und dann auf "Next"
   
   

3. Deaktivieren Sie alle Checkboxen

4. Aktivieren Sie nur folgende Checkboxen:
   
   

5. Wählen Sie einen Speicherort für Ihre exportierte Datei aus:
   
   

6. Lassen Sie alle anderen Optionen auf Standardeinstellungen und klicken Sie auf "Finish"

7. Sollten Warnmeldungen erscheinen, können Sie diese ignorieren.

8. 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

9. Melden Sie sich anschließend in FE2 an.

10. Navigieren Sie zu der Liste der Einheiten und klicken dort auf „Einstellungen“

11. 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.