# Beschreibung des Automap-Konfigurationsformats

## Allgemeine Information

Das NagVis-Automap-Konfigurationsformat gleicht dem Map-Konfigurationsformat mit kleinen Unterschieden bei den verfügbaren Parametern.

## Objekttypen

- Global

## Beschreibung der Objekttypen

### Global

Die erste Definition in jeder Konfigurationsdatei sollte vom speziellen Typ "global" sein. Optionen in diesem Paragraph gelten für die gesamte Map und werden auf andere Typen vererbt, die nachfolgend definiert werden.

Beispiel mit allen Optionen, die gesetzt werden müssen:

    define global {
        map_image=lan.png
        }

Wert | Default | Beschreibung
--- | --- | ---
alias | Map-Name | Der Alias ist das Label für jede Map. Wenn definiert, wird es überall im NagVis-Frontend und WUI angezeigt
backend_id | vererbt (nagvis.ini.php) | Die in der Hauptkonfigurationsdatei definierte Backend-ID, die angibt, wo NagVis nach Objektzuständen suchen soll. Wenn dieser Parameter nicht angegeben wird, wird das in der Hauptkonfigurationsdatei unter "defaultbackend" angegebene Backend benutzt.
background_color | vererbt (nagvis.ini.php) | Hintergrundfarbe dieser Map. Falls dieser Wert nicht gesetzt wird, wird die Hintergrundfarbe aus der Hauptkonfigurationsdatei genommen.
context_menu | vererbt (nagvis.ini.php) | Aktivieren/deaktivieren des Kontext-Menüs auf Ihren Map-Objekten.
context_template | vererbt (nagvis.ini.php) | Default Context-Template, das auf dieser Map benutzt werden soll
default_params | vererbt (nagvis.ini.php) | zu benutzende Default-Parameter, wenn keine per URL übergeben wurden. Das Format ist wie bei dem URL, z.B. `&childLayers=2`. Gültige Optionen finden Sie hier.
event_background | vererbt (nagvis.ini.php) | Aktivieren/deaktivieren der sich ändernden Hintergrundfarbe bei Statusänderungen (die konfigurierte Farbe wird angezeigt, wenn der Gesamtstatus PENDING, OK oder UP ist).
event_highlight | vererbt (nagvis.ini.php) | Aktivieren/deaktivieren der Hervorhebung des sich ändernden Objekts durch eine blinkende Umrandung.
event_highlight_duration | vererbt (nagvis.ini.php) | Setzt die Dauer der Hervorhebung in Millisekunden.
event_highlight_interval | vererbt (nagvis.ini.php) | Setzt die Dauer des Hervorhebungs-Intervalls in Millisekunden.
event_log | vererbt (nagvis.ini.php) | Aktivieren/deaktivieren des Eventlogs im neuen JavaScript-Backend. Das Eventlog protokolliert wichtige Aktionen und Informationen.
event_log_level | vererbt (nagvis.ini.php) | Loglevel des Eventlogs (verfügbar: debug, info, warning, critical).
event_log_height | vererbt (nagvis.ini.php) | Höhe des JavaScript-Eventlogs in Pixeln.
event_log_hidden | vererbt (nagvis.ini.php) | Verstecken/zeigen des JavaScript-Eventlogs während des Map-Ladens.
event_scroll | vererbt (nagvis.ini.php) | Aktivieren/deaktivieren des Fokussierens auf das Icon, das den Zustand verändert hat, wenn dieses außerhalb des sichtbaren Bereichs ist.
event_sound | vererbt (nagvis.ini.php) | Aktivieren/deaktivieren von Sound-Signalen bei Statusänderungen.
header_menu | vererbt (nagvis.ini.php) | aktivieren/deaktivieren des Header-Menüs
header_template | vererbt (nagvis.ini.php) | header template für diese Map
hover_menu | vererbt (nagvis.ini.php) | aktivieren/deaktivieren von Hover-Menüs
hover_delay | vererbt (nagvis.ini.php) | Verzögerung der Anzeige des Hover-Menus in Sekunden
hover_template | vererbt (nagvis.ini.php) | Default hover template für diese Map
hover_childs_limit | vererbt (nagvis.ini.php) | max. Anzahl von Child-Objekten
hover_childs_order | vererbt (nagvis.ini.php) | Reihenfolge von Child-Objekten ("asc"=aufsteigend, "desc"=absteigend)
hover_childs_show | vererbt (nagvis.ini.php) | Anzeigen von Child-Objekten in Hover-Menüs
hover_childs_sort | vererbt (nagvis.ini.php) | Sortierreihenfolge von Child-Objekten ("s"=Status, "a"=Alphabet)
iconset | vererbt (nagvis.ini.php) | Iconset, das als Standard für alle auf der Map platzierten Objekte benutzt werden soll. Kann für jedes Objekt überschrieben werden. Im Beispiel wird "std_small" benutzt, was bedeutet, dass ein OK-Zustand das Icon "std_small_ok.png", benutzt, ein CRITICAL-Zustand "std_small_critical.png" usw.
in_maintenance | 0 | aktiviert/deaktiviert den Wartungsmodus. Wenn eine Map im Wartungsmodus ist, wird statt der Map lediglich ein Hinweis angezeigt
label_show | 0 | Labelanzeige für die Map-Objekte aktivieren/deaktivieren
label_x | -20 | x-Position der Label in Pixeln (mit Vorzeichen +/- relativ zur linken, oberen Ecke der Icons, sonst absolute Position)
label_y | +20 | y-Position der Label in Pixeln (mit Vorzeichen +/- relativ zur linken, oberen Ecke der Icons, sonst absolute Position)
label_width | auto | Default-Breite der Label in Pixeln
label_background | transparent | Default-Hintergrundfarbe der Label. Die Farbe sollte als Hexcode angegeben werden, kann aber auch "transparent" sein.
label_border | #000000 | Default-Rahmenfarbe der Label. Die Farbe sollte als Hexcode angegeben werden, kann aber auch "transparent" sein.
label_style |  | Benutzerdefiniertes Aussehen des Label-Textes im Format von HTML-Style-Attributen, z.B. `font-family:sans;font-weight:bold;`.
line_arrow | forward | Dies definiert die Pfeile am Linienende. Bisher wird dieses Attribut nur für die Linien zwischen Hosts in der Automap benutzt. Mögliche Werte: forward, back, both, none.
line_type |  | Gibt den Linientyp an, wenn view_type=line. Gültige Werte sind: "11" für Linien mit einem Pfeil am Linienende. "10" für Linien mit zwei Pfeilen, die in der Linienmitte aufeinander zeigen. "12" für Linien ohne Pfeil(e).
line_width | 3 | Dies definiert die Linienbreite in px, wenn dieses Objekt als Linie angezeigt wird.
only_hard_states | vererbt (nagvis.ini.php) | Gibt an, ob Soft-Zustände ignoriert werden sollen. Default ist 0.

recognize_services

vererbt (nagvis.ini.php)

Definiert, ob die Services des Hosts den angezeigten Status beeinflussen. Wenn auf "1" gesetzt, wird ein Service im Status CRITICAL auch den HOST als CRITICAL anzeigen. Wenn auf "0" gesetzt, wird nur der Host-Zustand (UP oder DOWN) angezeigt und der Status der Services ignoriert. Ist dieser Wert nicht in der Konfiguration angegeben, wird er auf 1 gesetzt.

show_in_lists | vererbt (nagvis.ini.php) | Map-Anzeige in Listenformat (Dropdowns, Indexseite, ...)
stylesheet | vererbt (nagvis.ini.php) | Dateiname des benutzerdefinierten Stylesheets zur Verwendung in den Maps. Die Datei muss im share/nagvis/style-Verzeichnis abgelegt sein.
url_target | _self | Ziel des Icon-Links, diese Option passt <a target=""> an (_self ist das gleiche Fenster)