OpenStreetMap

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

Overview

The OpenStreetMap plugin visualizes Configuration Items (ConfigItems) and their 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 gives you an at-a-glance overview of geographical relationships, making it easy to grasp locations and statuses.

Installation

1. Package Manager

• In the OTOBO admin area, navigate to System Administration → Package Management, search for the OpenStreetMap add-on, and install it.

2. Manual Installation

• Unpack the archive into Kernel/Config/Files/.
• Under System Administration → Update, reload the file system.

System Requirements

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

Configuration (SysConfig)

Core::OpenStreetMap

Key	Description
OpenStreetMap::ShowForClasses	Define the classes for which maps should be displayed
OpenStreetMap::IncidentStateColors	Colors for incident states on the map
OpenStreetMap::IconOverride###BasicCIInfo01	Custom icons per state

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

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

• Latitude/Longitude Attributes (source of geodata)
• LineColor: Color scheme (e.g., hex code or state-based)

Frontend Module Registrations

Path	Purpose
Frontend::Agent::ModuleRegistration::AgentOpenStreetMap	Map module in the agent menu
Frontend::Agent::ModuleRegistration::Loader::AgentDashboard###437-OSM	Activate dashboard widget
Frontend::Customer::ModuleRegistration::CustomerDashboard###002-OpenStreetMap	Map widget in the customer dashboard

Usage

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

Limitations

• Version Dependency: Functionality is available from OTOBO 10.1.x onwards.
• Geo-Data: ConfigItem classes must have correctly stored latitude and longitude values.
• Performance: A large number of markers can increase the map's loading time.

Support & Further Information

• Author: Rother OSS GmbH
• Version: 11.0.1 (12/12/2024)
• Documentation: https://doc.otobo.org/
• Contact: hello@otobo.io