server:schnittstelle:katsys [Einsatzleitsoftware EDP]

Diese Seite ist nicht editierbar. Sie können den Quelltext sehen, jedoch nicht verändern. Kontaktieren Sie den Administrator, wenn Sie glauben, dass hier ein Fehler vorliegt.
====== Schnittstelle "KatSys" ======


Über die Schnittstelle "katsys" können Sie EDP mit dem System katsys und Handyalarm über die WebAPI verbinden und die in der Tabelle dargestellten Funktionen zu nutzen. 

^ Funktion ^ Daten senden ^ Daten empfangen |
| Einsatzdaten (Ab EDP Version 4.9.0.3) | ✔| ✔  |
| Statusmeldungen| | ✔|

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

===== Konfiguration =====

{{ :server:schnittstelle:konfig_katsys.jpg |}}

In der Konfiguration der Schnittstelle für Katsys können Sie folgende Funktionen der Schnittstelle über das Setzen der entsprechenden Haken aktivieren / deaktivieren:

  * Empfangen von Statusmeldungen
  * Empfangen von Einsatzdaten
  * Senden von Einsatzdaten an Katsys / Handyalarm

Für das Empfangen von Statusmeldungen und / oder Einsatzdaten ist die Angabe von Masterkey und Subkey erforderlich. Diese erhalten Sie von der Herstellerfirma Frey. Weiterhin sollte Ihnen in diesem Zusammenhang eine Zertifikatsdatei ausgehändigt worden sein. Diese Datei muss unter dem Namen "katsys-cloud.pem" im gleichen Ordner wie die Anwendungsdatei der Schnittstelle abgelegt sein.

Zum Senden von Einsatzdaten an Katsys / Handyalarm muss ein Inboundkey hinterlegt werden. Auch diesen erhalten von der Herstellerfirma Frey.

===== Zuordnung von empfangenen Statusmeldungen zu Einsatzmitteln =====

Damit eine korrekte Zuordnung der Daten zu den Einsatzmitteln in EDP möglich ist, müssen zu den Einsatzmitteln die ISSIs der Funkgeräte hinterlegt werden. Eine Anleitung hierzu finden Sie [[edp:tetra|hier]].

===== Empfang von Einsatzdaten =====

Beim Empfang von Einsatzdaten (wenn in der Einstellung der Schnittstelle aktiviert) werden die folgenden Daten übernommen. Dabei muss die Bezeichnung der jeweiligen Felder wie in der Liste genannt sein:

  * "objekt" -> Für das EDP-Datenfeld OBJEKTNAME
  * "ort" -> Für das EDP-Datenfeld ORT
  * "ortsteil" -> Für das EDP-Datenfeld ORTSTEIL
  * "hausnummer" -> Für das EDP-Datenfeld HAUSNUMMER
  * "strasse" -> Für das EDP-Datenfeld STRASSE
  * "schlagwort" -> Für das EDP-Datenfeld SCHLAGWORT (in der Maske zumeist als Meldebild bezeichnet)
  * "stichwort" -> Für das EDP-Datenfeld STICHWORT_KLARTEXT (die Felder EINSATZART und STICHWORT werden automatisch von EDP auf Basis des Stichwort-Klartextes ermittelt)
  * "bemerkung" -> Für das EDP-Datenfeld MELDUNG
  * "einsatznummer" -> Für das EDP-Datenfeld INTERNE_NUMMER

===== Versand von Einsatzdaten =====

Um einen Einsatz von EDP aus an Katsys zu senden, muss eine Aufgabe von Typ Ansteuerung erstellt werden. In der Aufgabe ist Ansteuerung die Katsys-Schnittstelle auszuwählen. Damit dies insgesamt erfolgen kann, muss ein Inboundkey in der Koniguration hinterlegt und das Senden von Einsatzdaten in der Konfig aktivert worden sein.

Die Aufgabe kann dann innerhalb eines Einsatzes ausgelöst und damit an Katsys übermittelt werden.

Folgende Parameter werden von EDP an Katsys gesendet:

  * EINSATZNUMMER -> Einsatznummer aus EDP
  * ORT 
  * ORTSTEIL
  * STRASSE
  * HAUSNUMMER
  * OBJEKTNAME
  * STICHWORT
  * STICHWORT_KLARTEXT
  * EINSATZART
  * SCHLAGWORT
  * MELDUNG
  * MELDENDER
  * TELEFON
  * BEMERKUNG
  * KOORDX
  * KOORDY
  * SENDER -> Fest mit Wert "EDP"
  * SYSTEM -> Organisationsname aus der EDP-Lizenz