====== Fernauslösung per Weblink ====== Unter Weblink verstehen wir URL-Requests, welche alle nötigen Informationen beinhalten, um Alarmvorlagen, Drehbücher und/oder Konferenzvorlagen fern auszulösen. Weblink ist besonders für automatische, technische Schnittstellen ohne menschliche Interaktion geeignet. In GroupAlarm pro sind keine besonderen Konfigurationen notwendig, um per Weblink Alarme auslösen zu können. Gerade für Drittsysteme welche über Weblink alarmieren macht es aber Sinn, einen eigenen Mitbenutzer mit Login und Passwort zu definieren. Dadurch erhöht sich die Nachvollziehbarkeit der Alarme in den Protokollen und Statistiken, weil man dann explizit nach Alarmen von diesem Auslöser suchen kann. ===== Verbindungstest ===== ==== Aufruf ==== Es gilt folgende URL-Syntax für den Verbindungstest (https ist zwingend) per Weblink: https://pro.groupalarm.de/webin.php?log_user=user&log_epass=epass Folgende Parameter werden dabei berücksichtigt: ^ Parameter | Beschreibung | ^ log_user | Benutzername | ^ log_epass | Kodiertes Passwort (QuickLogin-Bookmark) | ==== Rückmeldung ==== Verbindung ok, Logindaten ok: OK: Ping event processed Verbindung ok, Logindaten not_ok: Not_OK: Falsche oder nicht existierende Anmeldedaten. Verbindung not_ok: [Standard-Browser-Timeout-Meldung] ===== Auslösung ===== ==== Aufruf ==== Es gilt folgende URL-Syntax für die Auslösung (https ist zwingend) per Weblink: https://pro.groupalarm.de/webin.php?log_user=user&log_epass=epass&template=XXX&text=9 Folgende Parameter werden dabei berücksichtigt: ^ Parameter | Beschreibung | ^ log_user | Benutzername | ^ log_epass | Kodiertes Passwort (QuickLogin-Bookmark) | ^ template | Auslösecode der zu alarmierenden Alarmvorlage | ^ scenario | Auslösecode des zu alarmierenden Drehbuchs | ^ conference | Auslösecode der zu alarmierenden Konferenzvorlage | ^ event | Auslösecode des zu alarmierenden Ereignisses | ^ dtfree | deutscher Freitext | ^ frfree | französischer Freitext | ^ itfree | italienischer Freitext | ^ enfree | englischer Freitext | ^ text | Der Code des zu verwendenden Alarmtextes, welcher per Checkbox für die auszulösende Vorlage zugelassen sein muss. Fehlt der Parameter, wird ein Freitext gesendet. Steht der Code auf 0, wird der Standard-Text versendet (Radio-Button). | ^ duration | Zeit nach welcher der Alarm automatisch beendet werden soll in Minuten. Wird dieser Parameter nicht gesetzt, so bleibt ein Alarm offen bis die global definierte Dauer erreicht ist bzw. wenn diese nicht konfiguriert wurde, bis der Alarm manuell terminiert wird. | ^ dryrun | Gibt an ob es sich um einen DRY-RUN handelt, falls ja dann sollte der Wert „1“ gesetzt sein | ^ koord | Koordinaten die für die Alarmierung notwendig sind. | ==== Rückgabe ==== Folgende Feedbacks kommen als Antworten auf den Auslöse-Weblink-Request zurück: __erfolgreicher__ Alarm: OK: Alarm '[Name der ausgelösten Einheit]' erfolgreich ausgelöst Text: [Alarmtext] Teilnehmer: [Anzahl Teilnehmer] alarmiert. (AKEY-[Alarm_ID]) __erfolgreicher__ Drehbuch: OK: Scenario activated successfully. (BKEY-[Alarm_ID]) __erfolgreicher__ Konferenz: OK: Conference activated successfully. (CKEY-[Raum_PIN]) (TRAVERSE) __nicht__ erfolgreiche Auslösung: Not_OK: [Fehlermeldung] (z.B. “Template, Conference or Scenario not found“) ===== Feedback ===== ==== Aufruf ==== Bei Bedarf kann über Weblink auch der Alarm-Status anhand des zurückgegebenen AKey (bzw. für Drehbücher den BKey und für Konferenzen den CKey) verfolgt werden: Es gilt folgende URL-Syntax für das Feedback (https ist zwingend) per Weblink: http://pro.groupalarm.de/in_remote_feedback.php?log_user=user&log_epass=epass&akey=1234567890123456789012 Folgende Parameter werden dabei berücksichtigt: ^ Parameter | Beschreibung | ^ log_user | Benutzername | ^ AKey | Alarm-ID | ^ BKey | Drehbuch-ID | ^ CKey | Konferenz-ID | ==== Rückgabe ==== === Alarmvorlagen === Alarm-Status: laufend OK: Alert 9924e4681bbb9291d2a91bfeff8949c8 still running. Alarm-Status: erfolgreich beendet (d.h. durch ein Abbruchkriterium frühzeitig beendet) OK: Alert 9924e4681bbb9291d2a91bfeff8949c8 completed with success. Alarm-Status: nicht erfolgreich beendet (d.h. bis ans Ende durchgelaufen, ohne dass ein Abbruchkriterium erreicht wurde) OK: Alert 9924e4681bbb9291d2a91bfeff8949c8 completed abort. **Bemerkung**: „erfolgreich beendet“ heisst, dass der Alarm ein definiertes Alarmabbruchkriterium (Alarmoptionen) erreicht hat, bevor der Alarm per Timeout beendet wurde. Läuft die Alarmdauer aus bevor ein Abbruchkriterium erreicht wird, dann gilt der Alarm als „nicht erfolgreich beendet“. === Drehbücher === Alarm-Status: laufend OK: Scenario e0b291d6fc27f1114d260d16cdd46290 still running. Alarm-Status: erfolgreich beendet (d.h. durch ein Abbruchkriterium frühzeitig beendet) OK: Scenario e0b291d6fc27f1114d260d16cdd46290 completed with success. Alarm-Status: nicht erfolgreich beendet (d.h. bis ans Ende durchgelaufen, ohne dass ein Abbruchkriterium erreicht wurde) OK: Scenario 91c65900d5e1467c62d6cff212a8dacb completed abort. **Bemerkung**: Falls ein Drehbuch „nicht erfolgreich beendet“ sein sollte, dann sind die Eskalationsszenarien allesamt abgelaufen und trotzdem wurde das Abbruchkriterium nicht erreicht. Für GroupAlarm pro ist dieser Alarm dann beendet. (Je nach Definition der Eskalation kann als letztes im Szenario eine bestimmte Person darüber informiert werden, dass der Alarm nicht erfolgreich beendet wurde.) === Konferenzvorlagen === Konferenz-Status: laufend (d.h. es sind noch Teilnehmer aktiv in der Konferenz) OK: Conference 123_1234 still running. Konferenz-Status: erfolgreich beendet (d.h. es waren zwischenzeitlich mehr als 1 Teilnehmer aktiv in der Konferenz) OK: Conference 123_1234 completed with success. Konferenz-Status: nicht erfolgreich beendet (d.h. die Konferenz hat Ihr Timeout erreicht bevor mindestens 2 Teilnehmer aktiv verbunden waren). OK: Conference 123_1234 completed abort.