Skip to content
OTOBO Community Guide

OpenStreetMap

OpenStreetMap

Section titled “OpenStreetMap”

Compatibility OTOBO ≥ 10.1.x, Znuny ≥ 7.0.x

Overview

Section titled “Overview”

The OpenStreetMap plugin visualizes Configuration Items (ConfigItems) and associated tickets on an interactive map. It integrates the OpenStreetMap framework into various areas of OTOBO:

  • CMDB → Map: Displays all ConfigItems as markers.
  • Tickets → Ticket Map: Marks tickets based on their linked ConfigItems.
  • Dashboard Widgets: Adds map widgets to agent and customer dashboards.
  • AgentITSMConfigItemZoom: Displays the map directly in the ConfigItem zoom view.

This allows you to see geographical relationships at a glance and easily grasp locations and statuses.

Installation

Section titled “Installation”
  1. Package Manager
  • In the OTOBO admin area under System Administration → Package Manager, search for and install the OpenStreetMap add-on.
  1. Manual Installation
  • Unpack the archive into Kernel/Config/Files/.
  • Under System Administration → Update, reload the file system.

System Requirements

Section titled “System Requirements”
  • Framework: OTOBO ≥ 10.1.x
  • Packages: none additional
  • Third-Party: none

Configuration (SysConfig)

Section titled “Configuration (SysConfig)”

Core::OpenStreetMap

Section titled “Core::OpenStreetMap”
KeyDescription
OpenStreetMap::ShowForClassesDefine classes for which maps are displayed
OpenStreetMap::IncidentStateColorsColors for incident states on the map
OpenStreetMap::IconOverride###BasicCIInfo01Custom icons per state

Core::OpenStreetMap::ActionConfig

Section titled “Core::OpenStreetMap::ActionConfig”

Defines how and where maps appear for actions:

  • ActionConfig###001 … ###006 for various menu items (e.g., Dashboard, Ticket Zoom).

Core::OpenStreetMap::ClassConfig

Section titled “Core::OpenStreetMap::ClassConfig”

For each class (e.g., ConfigItem), define:

  • Latitude/Longitude attributes (source of geo-data)
  • LineColor: Coloring (e.g., hex code or state-based)

Frontend Module Registrations

Section titled “Frontend Module Registrations”
PathPurpose
Frontend::Agent::ModuleRegistration::AgentOpenStreetMapMap module in the agent menu
Frontend::Agent::ModuleRegistration::Loader::AgentDashboard###437-OSMEnable dashboard widget
Frontend::Customer::ModuleRegistration::CustomerDashboard###002-OpenStreetMapMap widget in customer dashboard

Usage

Section titled “Usage”
  1. Open CMDB Map: CMDB → Map displays all ConfigItems georeferenced.
  2. Ticket Map: Under Tickets → Ticket Map, tickets are displayed on the map.
  3. Widgets: Available on dashboards via drag-and-drop, configurable via dashboard settings.
  4. ConfigItem Zoom: View the map directly in the zoom window.

Limitations

Section titled “Limitations”
  • Version dependency: Functionality available from OTOBO 10.1.x.
  • Geo-data: ConfigItem classes must have latitude and longitude correctly stored.
  • Performance: Many markers can increase the map loading time.

Support & Further Information

Section titled “Support & Further Information”