{"id":1073,"date":"2023-07-03T14:51:15","date_gmt":"2023-07-03T12:51:15","guid":{"rendered":"https:\/\/handbuch.alarmiator.de\/?post_type=docs&p=1073"},"modified":"2023-07-07T13:02:48","modified_gmt":"2023-07-07T11:02:48","password":"","slug":"anbindung-von-bosmon","status":"publish","type":"docs","link":"https:\/\/handbuch.alarmiator.de\/?docs=anbindung-von-bosmon","title":{"rendered":"Anbindung von BosMon"},"content":{"rendered":"\n

Vielen Dank an Josh<\/a> aus der ALARMiator Community f\u00fcr die hervorragende Zusammenstellung dieses Guides.<\/p>\n\n\n\n

Bitte beachte, dass zur Nutzung dieser Funktion eine vollwertige, kostenpflichtige Bosmon-Version notwendig ist, da nur dort die Ereignisfunktion \u201eProgramm ausf\u00fchren\u201c genutzt werden kann. <\/p>\n\n\n\n

Zus\u00e4tzlich m\u00fcssen in den Konfigurationen der Bosmon-Instanz die Alarmierungs-Daten so bearbeitet werden, dass diese die Meldungen korrekt nach den Adressen sowie Stichw\u00f6rtern aufschl\u00fcsselt so wie hier: <\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Eine genaue Erkl\u00e4rung dieser Einstellungen ist innerhalb der Dokumentation von Bosmon ersichtlich: https:\/\/www.bosmon.de\/doc\/bosmon\/1.5\/cfg\/adresse.html<\/a><\/p>\n\n\n\n

Um die spezifischen Variablen der Meldung nun zum ALARMiator-Server zu \u00fcbertragen, nutzen wir eine sogenannte Batchdatei. Diese wird einfach mittels eines Texteditors deiner Wahl erstellt und anschlie\u00dfend mit der Endung \u201e.bat\u201c gespeichert.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Der Inhalt dieser Textdatei enth\u00e4lt dabei folgenden Code:<\/p>\n\n\n\n

@echo off\ncurl -G \"https:\/\/{{example.com}}\/api\/operations\/sendAlarm\" --data-urlencode\n\"token={{deintoken}}\" --data-urlencode \"subject=%~1\" --data-urlencode \"ils=Leitstelle\"\n--data-urlencode \"location=%~3\" --data-urlencode \"street=%~2\" --data-urlencode\n\"lat=%~4\" --data-urlencode \"lon=%~5\" --data-urlencode \"zveis=%~6\"<\/code><\/pre>\n\n\n\n
Hier wird https benutzt und mit \/api\/ wird implizit die Nutzung unseres Standardsetups mit Reverse Proxy vorrausgesetzt. Solltest du diesen nicht benutzen musst du selber deinen Api Port entsprechend deiner Konfiguration ansprechen. Wir empfehlen wie immer deutlich die Nutzung von HTTPS!<\/p>\n\n\n\n
Die in {{  }} geschriebene Inputs sind dabei f\u00fcr deinen Server entsprechend abzu\u00e4ndern.
Die IP enth\u00e4lt die \u00fcbliche Server-Adresse und das Token muss vorab im ALARMiator Adminmen\u00fc unter \u201eAPI-Token\u201c angelegt werden. <\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Die jeweiligen Variablen werden dabei durch Platzhalter mit der Nummerierung z.B. \u201e%~1\u201c \u00fcbergeben. Dies kann je nach Konfiguration der Einstellungen jedoch beliebig abge\u00e4ndert werden. Die genaue Aufschl\u00fcsselung dieser Platzhalter wird dabei in Bosmon direkt erledigt, was
im folgenden noch erl\u00e4utert wird. Zus\u00e4tzlich k\u00f6nnen ebenso weitere Variablen in der Batchdatei \u00fcbergeben werden, welche hier aufgelistet sind:<\/p>\n\n\n\n
https:\/\/community.alarmiator.de\/t\/neu-alarmierung-ueber-rest-api\/102\/11<\/a><\/p>\n\n\n\n
Bei einem Eingang einer entsprechend neuen Meldung muss dazu in Bosmon unter den Ereignissen ein neues Event angelegt werden, welches den \u00dcbergabeprozess startet. Dazu werden zun\u00e4chst die jeweiligen Filter gesetzt sowie als Aktion ein Programm ausgef\u00fchrt.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Das Programm zum Ausf\u00fchren muss dabei auf den Pfad der Batchdatei deuten. Im Beispiel oben lautet der Pfad:<\/p>\n\n\n\n
\"C:\\Users\\XXX\\Desktop\\Systemstart\\BosMon\\Send_to_ALARMiator.bat\"<\/code><\/pre>\n\n\n\n
Mit diesem Ereignis wird die Batchdatei aufgerufen. Nun m\u00fcssen jedoch noch die ausgewerteten Variablendaten \u00fcbergeben werden. Dies wird dabei ebenfalls im Pfad der Ereignisdatei hinterlegt. Im Beispiel wird an den o.g. Pfad somit die folgende Zusatzinfo mit einer Leerstelle getrennt eingetragen:<\/p>\n\n\n\n
\"C:\\Users\\XXX\\Desktop\\Systemstart\\BosMon\\Send_to_ALARMiator.bat\"\n\"%stichwort.kurz%\",\n\"%koordinaten.strasse% %koordinaten.hausnummer%\",\n\"%koordinaten.stadt%\",\n\"%koordinaten.latitude%\",\n\"%koordinaten.longitude%\",\n\"%telegramm.adresse%\u201c<\/code><\/pre>\n\n\n\n
Je nachdem, an welcher Stelle die Variable hier angeordnet ist, wird sie auch in der Batchdatei bei der \u00dcbertragung eingepflegt. Das Stichwort kurz wird an der 1. Stelle unter dem \u201eSubject\u201c \u00fcbertragen, die \u201elocation=%~3\u201c steht oben an der dritten Stelle der Variablen, welche immer mit einem Komma getrennt werden m\u00fcssen. Die Strasse und die Hausnummer werden direkt in einer Variable \u00fcbergeben, um mehrere Platzhalter zu erm\u00f6glichen.<\/p>\n\n\n\n
Die in der \u201e%telegramm.adresse%\u201c hinterlegte Schleifennummer muss zus\u00e4tzlich im ALARMiator-Server als Schleife hinterlegt sein (Schleifen anlegen Doku<\/a>) sowie ein Alarmierungsprofil daf\u00fcr erstellt werden (Doku Alarmierungsprofil<\/a>), welche die jeweilige Gruppe per ALARMiator alarmiert. Die zu \u00fcbermittelnden Daten an die Einsatzkr\u00e4fte auf Schleifenebene kann nat\u00fcrlich im ALARMiator in der Alarmdatenmatrix eingestellt werden (Doku Alarmdatenmatrix<\/a>), um die Menge an eingehenden Einsatzinfos und die Menge an \u00fcbermittelten Einsatzinfos an Einsatzkr\u00e4fte einzustellen.<\/p>\n\n\n\n
Um die Karten- sowie Navigationsfunktion nutzen zu k\u00f6nnen ist es wichtig, dass in Bosmon direkt die Adresserkennung aktiviert ist und ordnungsgem\u00e4\u00df funktioniert. Dabei werden die ausgewerteten Adressdaten als Koordinaten \u00fcbergeben (im oberen Beispiel latitude sowie longitude), welche im ALARMiator-Server dann weiter verarbeitet werden.<\/p>\n\n\n\n
Insgesamt k\u00f6nnen bis zu neun Variablen von Bosmon an den ALARMiator-Server \u00fcbergeben werden. Eine genaue Liste aller m\u00f6glichen Variablen in Bosmon ist hier ersichtlich:<\/p>\n\n\n\n
https:\/\/www.bosmon.de\/doc\/bosmon\/1.5\/howto\/variablen.html<\/a><\/p>\n\n\n\n
Ob die \u00dcbertragung problemlos funktioniert, kann mittels einer Testalarmierung \u00fcber das Zusatzprogramm \u201eBosmonDial\u201c gepr\u00fcft werden. Dort einfach einen bekannten Meldungstext und die zu testende Schleife manuell eintragen und testweise alarmieren lassen.<\/p>\n","protected":false},"excerpt":{"rendered":"
Vielen Dank an Josh aus der ALARMiator Community f\u00fcr die hervorragende Zusammenstellung dieses Guides. Bitte beachte, dass zur Nutzung dieser Funktion eine vollwertige, kostenpflichtige Bosmon-Version notwendig ist, da nur dort die Ereignisfunktion \u201eProgramm ausf\u00fchren\u201c genutzt werden kann. Zus\u00e4tzlich m\u00fcssen in den Konfigurationen der Bosmon-Instanz die Alarmierungs-Daten so bearbeitet werden, dass diese die Meldungen korrekt nach […]<\/p>\n","protected":false},"author":4,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[15,53],"doc_tag":[30],"class_list":["post-1073","docs","type-docs","status-publish","hentry","doc_category-alarmierung","doc_category-walkthroughs","doc_tag-alarmierung"],"year_month":"2026-05","word_count":684,"total_views":0,"reactions":{"happy":0,"normal":0,"sad":0},"author_info":{"name":"Darren F\u00fcrst","author_nicename":"dfuerst","author_url":"https:\/\/handbuch.alarmiator.de\/?author=4"},"doc_category_info":[{"term_name":"Alarmierung","term_url":"https:\/\/handbuch.alarmiator.de\/?doc_category=alarmierung"},{"term_name":"Walkthroughs","term_url":"https:\/\/handbuch.alarmiator.de\/?doc_category=walkthroughs"}],"doc_tag_info":[{"term_name":"Alarmierung","term_url":"https:\/\/handbuch.alarmiator.de\/?doc_tag=alarmierung"}],"jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/handbuch.alarmiator.de\/index.php?rest_route=\/wp\/v2\/docs\/1073","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/handbuch.alarmiator.de\/index.php?rest_route=\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/handbuch.alarmiator.de\/index.php?rest_route=\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/handbuch.alarmiator.de\/index.php?rest_route=\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/handbuch.alarmiator.de\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=1073"}],"version-history":[{"count":29,"href":"https:\/\/handbuch.alarmiator.de\/index.php?rest_route=\/wp\/v2\/docs\/1073\/revisions"}],"predecessor-version":[{"id":1135,"href":"https:\/\/handbuch.alarmiator.de\/index.php?rest_route=\/wp\/v2\/docs\/1073\/revisions\/1135"}],"wp:attachment":[{"href":"https:\/\/handbuch.alarmiator.de\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=1073"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/handbuch.alarmiator.de\/index.php?rest_route=%2Fwp%2Fv2%2Fdoc_category&post=1073"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/handbuch.alarmiator.de\/index.php?rest_route=%2Fwp%2Fv2%2Fdoc_tag&post=1073"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}