OpenStreetMap

Kompatybilność OTOBO ≥ 10.1.x, Znuny ≥ 7.0.x

Przegląd

Wtyczka OpenStreetMap wizualizuje obiekty konfiguracyjne (ConfigItems) i powiązane z nimi zgłoszenia na interaktywnej mapie. Integruje ona framework OpenStreetMap z różnymi obszarami OTOBO:

• CMDB → Mapa: Wyświetla wszystkie ConfigItems jako znaczniki.
• Zgłoszenia → Mapa zgłoszeń: Oznacza zgłoszenia na podstawie powiązanych z nimi ConfigItems.
• Widżety pulpitu: Dodaje widżety mapy do pulpitów agentów i klientów.
• AgentITSMConfigItemZoom: Wyświetla mapę bezpośrednio w widoku powiększenia ConfigItem.

Dzięki temu można uzyskać przegląd powiązań geograficznych i łatwo ocenić lokalizacje i statusy.

Instalacja

1. Menedżer pakietów
   • W obszarze administracyjnym OTOBO, w sekcji Zarządzanie systemem → Menedżer pakietów, wyszukaj i zainstaluj dodatek OpenStreetMap.
2. Instalacja ręczna
   • Rozpakuj archiwum do katalogu Kernel/Config/Files/.
   • W sekcji Zarządzanie systemem → Aktualizacja przeładuj system plików.

Wymagania systemowe

• Framework: OTOBO ≥ 10.1.x
• Pakiety: Brak dodatkowych
• Strony trzecie: Brak

Konfiguracja (SysConfig)

Core::OpenStreetMap

Klucz	Opis
OpenStreetMap::ShowForClasses	Definiuje klasy, dla których mają być wyświetlane mapy
OpenStreetMap::IncidentStateColors	Kolory dla stanów zgłoszeń na mapie
OpenStreetMap::IconOverride###BasicCIInfo01	Niestandardowe ikony w zależności od stanu

Core::OpenStreetMap::ActionConfig

Definiuje, jak i gdzie mapy mają się pojawiać w akcjach:

• ActionConfig###001 … ###006 dla różnych pozycji menu (np. Pulpit, Powiększenie zgłoszenia).

Core::OpenStreetMap::ClassConfig

Dla każdej klasy (np. ConfigItem) należy określić:

• Atrybuty szerokości/długości geograficznej (źródło danych geolokalizacyjnych)
• LineColor: Kolorystyka (np. kod szesnastkowy lub oparty na stanie)

Rejestracje modułów frontend

Ścieżka	Cel
Frontend::Agent::ModuleRegistration::AgentOpenStreetMap	Moduł mapy w menu agenta
Frontend::Agent::ModuleRegistration::Loader::AgentDashboard###437-OSM	Aktywacja widżetu pulpitu
Frontend::Customer::ModuleRegistration::CustomerDashboard###002-OpenStreetMap	Widżet mapy na pulpicie klienta

Użycie

1. Otwórz mapę CMDB: CMDB → Mapa wyświetla wszystkie ConfigItems z danymi georeferencyjnymi.
2. Mapa zgłoszeń: W sekcji Zgłoszenia → Mapa zgłoszeń zgłoszenia są prezentowane na mapie.
3. Widżety: Dostępne na pulpitach poprzez funkcję przeciągnij i upuść, konfigurowalne w ustawieniach pulpitu.
4. Powiększenie ConfigItem: Przeglądaj mapę bezpośrednio w oknie powiększenia.

Ograniczenia

• Zależność od wersji: Funkcjonalność dostępna od OTOBO 10.1.x.
• Dane geograficzne: Klasy ConfigItem muszą poprawnie przechowywać dane dotyczące szerokości i długości geograficznej.
• Wydajność: Duża liczba znaczników może zwiększyć czas ładowania mapy.

Wsparcie i dalsze informacje

• Producent: Rother OSS GmbH
• Wersja: 11.0.1 (12.12.2024)
• Dokumentacja: https://doc.otobo.org/
• Kontakt: hello@otobo.io