Ansteuerung Einsatzexport

Die Ansteuerung Einsatzexport ermöglicht das Verschicken verschiedener Einsatzdaten an bereitgestellte Schnittstellen anderer Systeme. Die Einsatzdaten werden dabei in vordefinierten JSON-Vorlagen verschickt.

✔ = Die Schnittstelle unterstützt diese Funktion. ✘ = die Schnittstelle unterstützt diese Funktion nicht. (Leer) = Entfällt.

Die Konfiguration der Ansteuerung geschieht mit dem Programm EDPKonfig.exe unter dem Punkt Ansteuerungen. Nach dem Klicken auf den Bearbeiten-Knopf erscheint folgendes Fenster, in dem alle Einstellungen der Ansteuerung vorgenommen werden:

Zuerst muss eine Systemvorlage gewählt werden, dabei sind einige Systeme bereits hinterlegt. Falls das gewünschte System noch nicht hinterlegt ist, kann die Vorlage „Benutzerdefiniert“ gewählt werden. Bei Auswahl eines bereits hinterlegten Systems werden die Server- und JSON-Einstellungen vorausgefüllt und es muss nur noch die Authentifizierung nach Vorgaben des angesteuerten Systems eingestellt werden.

Nach Auswahl der richtigen Systemvorlage muss nur noch die Authentifizierung ausgefüllt werden. Dafür muss sich auf der Website von FF-Agent angemeldet werden und über Einstellungen → Alarmierung → Schnittstellen zum Abschnitt EDP navigiert werden. Dort können der API-Token und das API-Secret ausgelesen werden.

Beim Anlegen einer Aufgabe zum Einsatzexport an FF-Agent kann als Wert eine Liste an Organisationen übergeben werden, die in FF-Agent zugeordnet werden.

Hierfür muss zuerst die Serveradresse und die Adresse des API-Endpoints ausgefüllt werden. Danach kann mit der Authentifizierung fortgefahren werden.

Die Authentifizierung geschieht primär über ein Access-Token, das von dem anzusteuernden Programm zur Verfügung gestellt werden muss. Dieses Token wird bei einer Anfrage im Header als Authorization übergeben. Als weitere Authentifizierungs- und Sicherheitsfunktion kann ein hmac der http-Request erstellt werden. Dafür muss ein API-Secret hinterlegt werden. Mithilfe dieses Secrets wird ein hash über [API-Token][Request-Body] erstellt und als hmac im Header übergeben.

Es können verschiedene Einsatzdaten als JSON verschickt werden, die über eine Vorlage ausgewählt werden. Diese JSON-Vorlagen haben folgende Strukturen:

einsatzexport.json

{
  "einsatzdaten": {
    "STARTZEIT": 1676368852,
    "ENDE": 1676370284,
    "EINSATZNUMMER": 2023000006,
    "INTERNE_NUMMER": "1234",
    "EXTERNE_ID": "1234"
  },
  "einsatzanlass": {
    "EINSATZART": "H",
    "STICHWORT": "1",
    "STICHWORT_KLARTEXT": "TH Klein",
    "MELDUNG": "Verkehrsunfall"
  },
  "einsatzort": {
    "ORT": "Musterhausen",
    "ORTSTEIL": "Musterberg",
    "STRASSE": "Musterweg",
    "HAUSNUMMER": "1"
  },
  "mitteiler": {
    "MELDENDER": "Max Mustermann",
    "MELDEWEG_TELEFON": "110"
  },
  "einsatzmittel": [
    {
      "RUFNAME": "1-11-1",
      "STATUS_3": 1676369902,
      "STATUS_4": 1676369908,
      "STATUS_1": 1676370279,
      "STATUS_2": 1676370284,
      "BESATZUNG_ZF": 1,
      "BESATZUNG_GF": 0,
      "BESATZUNG_MANNSCHAFT": 1,
      "BESATZUNG_GES": 2,
      "AKTIV": 0,
      "OPTA": "1-ELW-01"
    },
    {
      "RUFNAME": "1-46",
      "STATUS_3": 1676369905,
      "STATUS_4": 1676369911,
      "STATUS_1": 1676370282,
      "STATUS_2": 1676370286,
      "BESATZUNG_ZF": 0,
      "BESATZUNG_GF": 1,
      "BESATZUNG_MANNSCHAFT": 5,
      "BESATZUNG_GES": 6,
      "BESATZUNG_PA": 4,
      "AKTIV": 0,
      "OPTA": "1-HLF-01"
    }
  ],
  "dokumentation": [
    {
      "UHRZEIT": 1676369980,
      "NUTZER": "admin",
      "VON": "1-11-1",
      "MELDWEG": "Tetra",
      "EINTRAG": "Ein verunfallter PKW in Straßengraben\r\nNachforderung: Ölbindemittel zur Einsatzstelle",
      "ART": "Rueckmeldung"
    },
    {
      "UHRZEIT": 1676370011,
      "NUTZER": "admin",
      "EINTRAG": "Polizei informiert",
      "ART": "Massnahme"
    },
    {
      "UHRZEIT": 1676370029,
      "NUTZER": "admin",
      "EINTRAG": "Ölbindemittel zur Einsatzstelle alarmiert",
      "ART": "Massnahme"
    },
    {
      "UHRZEIT": 1676370147,
      "NUTZER": "admin",
      "TYP": "Dokumentation",
      "VON": "1-11-1",
      "AN": "",
      "EINTRAG": "Fahrer des PKWs: Maximilian Mustermann",
      "ART": "ETB-Eintrag"
    },
    {
      "UHRZEIT": 1676370197,
      "NUTZER": "admin",
      "TYP": "Lagemeldung",
      "VON": "1-11-1",
      "AN": "Leitstelle",
      "EINTRAG": "Auslaufende Betriebsstoffe aufgenommen\r\nDie Feuerwehr rückt ab",
      "ART": "ETB-Eintrag"
    },
    {
      "UHRZEIT": 1676370223,
      "NUTZER": "admin",
      "VON": "1-11-1",
      "MELDWEG": "Tetra",
      "EINTRAG": "Arbeiten der Feuerwehr beendet",
      "ART": "Rueckmeldung"
    },
    {
      "UHRZEIT": 1676370356,
      "NUTZER": "admin",
      "EINTRAG": "Ignoriert: EinsatzExport",
      "ART": "Massnahme"
    }
  ],
  "helfer": [
    {
      "NAME": "Mustermann",
      "VORNAME": "Erika",
      "GEBDATUM": "01.01.2000",
      "ORGANISATION": "Feuerwehr Musterhausen",
      "AUSBILDUNG": "Zugführer",
      "FUNKTION": "EL",
      "EM": "1-11-1",
      "BEGINN": 1676369612,
      "ENDE": 1676372400,
      "BEMERKUNG": "",
      "HELFER_ID": "112",
      "EM_OPTA": "1-ELW-01",
      "EM_BEGINN": 1676369902,
      "EM_ENDE": 1676370284
    },
    {
      "NAME": "Mustermann",
      "VORNAME": "Max",
      "GEBDATUM": "10.10.2000",
      "ORGANISATION": "Feuerwehr Musterhausen",
      "AUSBILDUNG": "Gruppenführer",
      "FUNKTION": "Fü",
      "EM": "1-46",
      "BEGINN": 1676369613,
      "ENDE": 1676372400,
      "BEMERKUNG": "",
      "HELFER_ID": "113",
      "EM_OPTA": "1-HLF-01",
      "EM_BEGINN": 1676369905,
      "EM_ENDE": 1676370286
    }
  ]
}