yaml
description: 'Instalación y configuración del plugin OpenStreetMap'
---
# OpenStreetMap
> **Compatibilidad**
> OTOBO ≥ 10.1.x, Znuny ≥ 7.0.x
## Resumen
El plugin **OpenStreetMap** visualiza objetos de configuración (ConfigItems) y tickets asociados en un mapa interactivo. Integra el framework de OpenStreetMap en varias áreas de OTOBO:
* **CMDB → Mapa**: Muestra todos los ConfigItems como marcadores.
* **Tickets → Mapa de Tickets**: Marca tickets basándose en sus ConfigItems vinculados.
* **Widgets de Panel**: Añade widgets de mapa a los paneles de Agente y Cliente.
* **AgentITSMConfigItemZoom**: Muestra el mapa directamente en el zoom de ConfigItem.
Esto proporciona una visión general de las relaciones geográficas y facilita la comprensión de ubicaciones y estados.
## Instalación
1. **Gestor de Paquetes**
* En el área de administración de OTOBO, bajo **Gestión del Sistema → Gestor de Paquetes**, busca e instala el add-on **OpenStreetMap**.
2. **Instalación Manual**
* Extrae el archivo en `Kernel/Config/Files/`.
* Bajo **Gestión del Sistema → Actualizar**, recarga el sistema de archivos.
## Requisitos del Sistema
* **Framework**: OTOBO ≥ 10.1.x
* **Paquetes**: Ninguno adicional
* **Terceros**: Ninguno
## Configuración (SysConfig)
### Core::OpenStreetMap
| Clave | Descripción |
| --------------------------------------- | -------------------------------------------------- |
| OpenStreetMap::ShowForClasses | Define las clases para las que se mostrarán los mapas |
| OpenStreetMap::IncidentStateColors | Colores para los estados de incidente en el mapa |
| OpenStreetMap::IconOverride###BasicCIInfo01 | Iconos personalizados por estado |
### Core::OpenStreetMap::ActionConfig
Define cómo y dónde aparecen los mapas para las acciones:
* `ActionConfig###001` … `###006` para diferentes elementos del menú (p. ej., Panel, Zoom de Ticket).
### Core::OpenStreetMap::ClassConfig
Para cada clase (p. ej., ConfigItem), define:
* **Atributos de Latitud/Longitud** (fuente de los datos geográficos)
* **LineColor**: Coloración (p. ej., código hexadecimal o basado en estado)
### Registros de Módulos Frontend
| Ruta | Propósito |
| ----------------------------------------------------------------------------- | ---------------------------------- |
| Frontend::Agent::ModuleRegistration::AgentOpenStreetMap | Módulo de Mapa en el menú de Agente |
| Frontend::Agent::ModuleRegistration::Loader::AgentDashboard###437-OSM | Activa el widget del panel |
| Frontend::Customer::ModuleRegistration::CustomerDashboard###002-OpenStreetMap | Widget de Mapa en el panel de Cliente |
## Uso
1. **Abrir Mapa CMDB**: `CMDB → Mapa` muestra todos los ConfigItems georreferenciados.
2. **Mapa de Tickets**: Bajo `Tickets → Mapa de Tickets`, los tickets se representan en el mapa.
3. **Widgets**: Disponibles en los paneles mediante arrastrar y soltar, configurables a través de la configuración del panel.
4. **Zoom de ConfigItem**: Visualiza el mapa directamente en la ventana de zoom.
## Limitaciones
* **Dependencia de Versión**: Funcionalidad disponible a partir de OTOBO 10.1.x.
* **Datos Geo**: Las clases de ConfigItem deben almacenar latitud y longitud correctamente.
* **Rendimiento**: Muchos marcadores pueden aumentar el tiempo de carga del mapa.
## Soporte y Más Información
* **Fabricante**: Rother OSS GmbH
* **Versión**: 11.0.1 (12.12.2024)
* **Documentación**: [https://doc.otobo.org/](https://doc.otobo.org/)
* **Contacto**: [hello@otobo.io](mailto:hello@otobo.io)
<!-- Fin del artículo -->