OpenStreetMap

Kompatibilität OTOBO ≥ 10.1.x, Znuny ≥ 7.0.x

Überblick

Das OpenStreetMap-Plugin visualisiert Konfigurationsobjekte (ConfigItems) und zugehörige Tickets auf einer interaktiven Karte. Es integriert das OpenStreetMap-Framework in verschiedene Bereiche von OTOBO:

• CMDB → Karte: Zeigt alle ConfigItems als Marker.
• Tickets → Ticket-Karte: Markiert Tickets anhand ihrer verbundenen ConfigItems.
• Dashboard-Widgets: Fügt Map-Widgets auf Agent- und Kunden-Dashboards hinzu.
• AgentITSMConfigItemZoom: Zeigt die Karte direkt im ConfigItem-Zoom an.

Damit erhältst du auf einen Blick geografische Zusammenhänge und kannst Standorte und Zustände leicht erfassen.

Installation

1. Paket-Manager

• Im OTOBO-Adminbereich unter Systemverwaltung → Paketverwaltung das Add-on OpenStreetMap suchen und installieren.

2. Manuelle Installation

• Archiv entpacken in Kernel/Config/Files/.
• Unter Systemverwaltung → Aktualisieren das Dateisystem neu laden.

Systemanforderungen

• Framework: OTOBO ≥ 10.1.x
• Packages: keine weiteren
• Third-Party: keine

Konfiguration (SysConfig)

Core::OpenStreetMap

Schlüssel	Beschreibung
OpenStreetMap::ShowForClasses	Klassen definieren, für die Karten angezeigt werden
OpenStreetMap::IncidentStateColors	Farben für Incident-Zustände auf der Karte
OpenStreetMap::IconOverride###BasicCIInfo01	Benutzerdefinierte Icons je Zustand

Core::OpenStreetMap::ActionConfig

Definiert, wie und wo Karten für Aktionen erscheinen:

• ActionConfig###001 … ###006 für verschiedene Menüpunkte (z. B. Dashboard, Ticket Zoom).

Core::OpenStreetMap::ClassConfig

Für jede Klasse (z. B. ConfigItem) festlegen:

• Latitude/Longitude-Attribute (Quelle der Geodaten)
• LineColor: Farbgebung (z. B. Hex-Code oder State-basiert)

Frontend-Modulregistrierungen

Pfad	Zweck
Frontend::Agent::ModuleRegistration::AgentOpenStreetMap	Map-Modul im Agenten-Menü
Frontend::Agent::ModuleRegistration::Loader::AgentDashboard###437-OSM	Dashboard-Widget aktivieren
Frontend::Customer::ModuleRegistration::CustomerDashboard###002-OpenStreetMap	Map-Widget im Kunden-Dashboard

Nutzung

1. CMDB-Karte öffnen: CMDB → Map zeigt alle ConfigItems georeferenziert an.
2. Ticket-Karte: Unter Tickets → Ticket Map werden Tickets auf der Karte dargestellt.
3. Widgets: Auf Dashboards per Drag-&-Drop verfügbar, konfigurierbar über Dashboard-Einstellungen.
4. ConfigItem-Zoom: Karte direkt im Zoom-Fenster betrachten.

Einschränkungen

• Versionsabhängigkeit: Funktion ab OTOBO 10.1.x verfügbar.
• Geo-Daten: ConfigItem-Klassen müssen Längen- und Breitengrade korrekt hinterlegen.
• Leistung: Viele Marker können die Ladezeit der Karte erhöhen.

Support & Weiterführendes

• Hersteller: Rother OSS GmbH
• Version: 11.0.1 (12.12.2024)
• Dokumentation: https://doc.otobo.org/
• Kontakt: hello@otobo.io