description: 'Installation & Configuration of the OpenStreetMap Plugin'

OpenStreetMap

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

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: Shows the map directly in the ConfigItem zoom view.

This provides a quick overview of geographical relationships, making it easy to grasp locations and statuses.

Installation

1. Package Manager
   • In the OTOBO admin area, navigate to Administration → Package Manager, search for the OpenStreetMap add-on, and install it.
2. Manual Installation
   • Extract the archive into Kernel/Config/Files/.
   • Reload the file system under Administration → Update.

System Requirements

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

Configuration (SysConfig)

Core::OpenStreetMap

Key	Description
OpenStreetMap::ShowForClasses	Define classes for which maps are 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), specify:

• Latitude/Longitude Attributes (source of geodata)
• LineColor: Coloring (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 shown on the map.
3. Widgets: Available on dashboards via drag-and-drop, configurable through dashboard settings.
4. ConfigItem Zoom: View the map directly within the zoom window.

Limitations

• Version Dependency: Functionality available from OTOBO 10.1.x.
• Geo Data: ConfigItem classes must correctly store latitude and longitude.
• Performance: Many markers can increase map loading time.

Support & Further Information

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