Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
server:ansteuerungen:einsatzexport [2023/02/14 17:33] – [JSON-Vorlagen] patrickserver:ansteuerungen:einsatzexport [2024/03/01 09:25] (aktuell) – [Export an FF-Agent] patrick
Zeile 12: Zeile 12:
 {{:server:ansteuerungen:anst_einsatzexport.jpg}} {{:server:ansteuerungen:anst_einsatzexport.jpg}}
  
-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 hinterlegtem Systems werden die Server- und JSON-Einstellungen vorausgefüllt und es muss nur noch die Authentifizierung nach Vorgaben des angesteuerten Systems eingestellt 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. 
 + 
 +===== Export an FF-Agent ===== 
 + 
 +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. 
 + 
 +{{:server:ansteuerungen:einsatzexport_aufgabe.png?600|}}
  
 ===== Export an benutzerdefiniertes System ===== ===== Export an benutzerdefiniertes System =====
Zeile 20: Zeile 28:
 ==== Authentifizierung ==== ==== Authentifizierung ====
  
-Die Authentifizierung kann über verschiedene Verfahren durchgeführt werden. Klassischerweise lässt sich über das angesteuerte System ein Access-Token generierender bei der Post-Anfrage im Header als Authorization übergeben wirdAußerdem kann ein hmac Hashwert übergeben werden, falls dies gewünscht ist.+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.
  
 ==== JSON-Vorlagen ==== ==== JSON-Vorlagen ====
Zeile 30: Zeile 38:
 <file txt einsatzexport.json> <file txt einsatzexport.json>
 { {
-  "EINSATZDATEN": { +  "einsatzdaten": { 
-    "EROEFF": "14.02.2023 10:00:52"+    "STARTZEIT": 1676368852
-    "ENDE": "14.02.2023 11:02:48",+    "ENDE": 1676370284,
     "EINSATZNUMMER": 2023000006,     "EINSATZNUMMER": 2023000006,
-    "EXTERNAL_ID": "LST Musterhausen", +    "INTERNE_NUMMER": "1234", 
-    "INTERNE_NUMMER": "LST MUH +    "EXTERNE_ID": "1234"
   },   },
-  "EINSATZANLASS": { +  "einsatzanlass": { 
-      "EINSATZART": "H", +    "EINSATZART": "H", 
-      "STICHWORT": "1", +    "STICHWORT": "1", 
-      "STICHWORT_KLARTEXT": "TH Klein", +    "STICHWORT_KLARTEXT": "TH Klein", 
-      "SCHLAGWORT": "TH VU", +    "MELDUNG": "Verkehrsunfall" 
-      "MELDUNG": "Verkehrsunfall", +  }, 
-      "BEMERKUNG": "Pkw im Straßengraben" +  "einsatzort": { 
-    }, +    "ORT": "Musterhausen", 
-  "EINSATZORT": { +    "ORTSTEIL": "Musterberg", 
-      "ORT": "Musterhausen", +    "STRASSE": "Musterweg", 
-      "ORTSTEIL": "Musterberg", +    "HAUSNUMMER": "1" 
-      "STRASSE": "Musterweg", +  }, 
-      "HAUSNUMMER": "1", +  "mitteiler": { 
-      "OBJEKTNAME": "Großes Parkhaus am Musterpark", +    "MELDENDER": "Max Mustermann", 
-      "PLZ": "10101" +    "MELDEWEG_TELEFON": "110" 
-    }, +  }, 
-  "MITTEILER": { +  "einsatzmittel": [
-      "MELDENDER": "Max Mustermann", +
-      "MELDEWEG_TELEFON": "110" +
-    }, +
-  "EINSATZMITTEL": [+
     {     {
       "RUFNAME": "1-11-1",       "RUFNAME": "1-11-1",
-      "STATUS_3": "14.02.2023 10:18:22"+      "STATUS_3": 1676369902
-      "STATUS_4": "14.02.2023 10:18:28"+      "STATUS_4": 1676369908
-      "STATUS_1": "14.02.2023 10:24:39"+      "STATUS_1": 1676370279
-      "STATUS_2": "14.02.2023 10:24:44",+      "STATUS_2": 1676370284,
       "BESATZUNG_ZF": 1,       "BESATZUNG_ZF": 1,
       "BESATZUNG_GF": 0,       "BESATZUNG_GF": 0,
       "BESATZUNG_MANNSCHAFT": 1,       "BESATZUNG_MANNSCHAFT": 1,
       "BESATZUNG_GES": 2,       "BESATZUNG_GES": 2,
-      "BESATZUNG_PA": 0, 
       "AKTIV": 0,       "AKTIV": 0,
       "OPTA": "1-ELW-01"       "OPTA": "1-ELW-01"
Zeile 74: Zeile 77:
     {     {
       "RUFNAME": "1-46",       "RUFNAME": "1-46",
-      "STATUS_3": "14.02.2023 10:18:25"+      "STATUS_3": 1676369905
-      "STATUS_4": "14.02.2023 10:18:31"+      "STATUS_4": 1676369911
-      "STATUS_1": "14.02.2023 10:24:42"+      "STATUS_1": 1676370282
-      "STATUS_2": "14.02.2023 10:24:46",+      "STATUS_2": 1676370286,
       "BESATZUNG_ZF": 0,       "BESATZUNG_ZF": 0,
       "BESATZUNG_GF": 1,       "BESATZUNG_GF": 1,
Zeile 87: Zeile 90:
     }     }
   ],   ],
-  "EINSATZVERLAUF": [+  "dokumentation": [
     {     {
-      "UHRZEIT": "14.02.2023 10:20:11", +      "UHRZEIT": 1676369980, 
-      "NUTZER": "Fernmelder",+      "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",       "EINTRAG": "Polizei informiert",
-      "ART": "MASSNAHME"+      "ART": "Massnahme"
     },     },
     {     {
-      "UHRZEIT": "14.02.2023 10:20:29"+      "UHRZEIT": 1676370029
-      "NUTZER": "Fernmelder",+      "NUTZER": "admin",
       "EINTRAG": "Ölbindemittel zur Einsatzstelle alarmiert",       "EINTRAG": "Ölbindemittel zur Einsatzstelle alarmiert",
-      "ART": "MASSNAHME"+      "ART": "Massnahme"
     },     },
     {     {
-      "UHRZEIT": "14.02.2023 10:25:56", +      "UHRZEIT": 1676370147
-      "NUTZER": "Fernmelder", +      "NUTZER": "admin",
-      "EINTRAG": "Ausgeführt: EinsatzExport", +
-      "ART": "MASSNAHME" +
-    }, +
-    { +
-      "UHRZEIT": "14.02.2023 10:19:40", +
-      "NUTZER": "Fernmelder", +
-      "MELDENDER": "1-11-1", +
-      "MELDEWEG": "Tetra", +
-      "MELDUNG": "Ein verunfallter PKW in Straßengraben\r\nNachforderung: Ölbindemittel zur Einsatzstelle", +
-      "ART": "RUECKMELDUNG" +
-    }, +
-    { +
-      "UHRZEIT": "14.02.2023 10:23:43", +
-      "NUTZER": "Fernmelder", +
-      "MELDENDER": "1-11-1", +
-      "MELDEWEG": "Tetra", +
-      "MELDUNG": "Arbeiten der Feuerwehr beendet", +
-      "ART": "RUECKMELDUNG" +
-    }, +
-    { +
-      "UHRZEIT": "14.02.2023 10:22:27"+
-      "NUTZER": "Fernmelder",+
       "TYP": "Dokumentation",       "TYP": "Dokumentation",
       "VON": "1-11-1",       "VON": "1-11-1",
       "AN": "",       "AN": "",
       "EINTRAG": "Fahrer des PKWs: Maximilian Mustermann",       "EINTRAG": "Fahrer des PKWs: Maximilian Mustermann",
-      "ART": "ETB-EINTRAG"+      "ART": "ETB-Eintrag"
     },     },
     {     {
-      "UHRZEIT": "14.02.2023 10:23:17"+      "UHRZEIT": 1676370197
-      "NUTZER": "Fernmelder",+      "NUTZER": "admin",
       "TYP": "Lagemeldung",       "TYP": "Lagemeldung",
       "VON": "1-11-1",       "VON": "1-11-1",
       "AN": "Leitstelle",       "AN": "Leitstelle",
       "EINTRAG": "Auslaufende Betriebsstoffe aufgenommen\r\nDie Feuerwehr rückt ab",       "EINTRAG": "Auslaufende Betriebsstoffe aufgenommen\r\nDie Feuerwehr rückt ab",
-      "ART": "ETB-EINTRAG"+      "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": [+  "helfer": [
     {     {
-      "ID": "4", 
       "NAME": "Mustermann",       "NAME": "Mustermann",
       "VORNAME": "Erika",       "VORNAME": "Erika",
Zeile 151: Zeile 153:
       "FUNKTION": "EL",       "FUNKTION": "EL",
       "EM": "1-11-1",       "EM": "1-11-1",
-      "BEGINN": "14.02.2023 10:13:32"+      "BEGINN": 1676369612
-      "ENDE": "14.02.2023 11:00:00", +      "ENDE": 1676372400,
-      "EINSATZNUMMER": 2023000006,+
       "BEMERKUNG": "",       "BEMERKUNG": "",
       "HELFER_ID": "112",       "HELFER_ID": "112",
       "EM_OPTA": "1-ELW-01",       "EM_OPTA": "1-ELW-01",
-      "EM_BEGINN": "14.02.2023 10:18:22"+      "EM_BEGINN": 1676369902
-      "EM_ENDE": "14.02.2023 10:24:44"+      "EM_ENDE": 1676370284
     },     },
     {     {
-      "ID": "5", 
       "NAME": "Mustermann",       "NAME": "Mustermann",
       "VORNAME": "Max",       "VORNAME": "Max",
Zeile 169: Zeile 169:
       "FUNKTION": "Fü",       "FUNKTION": "Fü",
       "EM": "1-46",       "EM": "1-46",
-      "BEGINN": "14.02.2023 10:13:33"+      "BEGINN": 1676369613
-      "ENDE": "14.02.2023 11:00:00", +      "ENDE": 1676372400,
-      "EINSATZNUMMER": 2023000006,+
       "BEMERKUNG": "",       "BEMERKUNG": "",
       "HELFER_ID": "113",       "HELFER_ID": "113",
       "EM_OPTA": "1-HLF-01",       "EM_OPTA": "1-HLF-01",
-      "EM_BEGINN": "14.02.2023 10:18:25"+      "EM_BEGINN": 1676369905
-      "EM_ENDE": "14.02.2023 10:24:46"+      "EM_ENDE": 1676370286
     }     }
   ]   ]