NagVis 1.3 Formatbeschreibung der Map-Konfiguration

Allgemeine Informationen

Das NagVis-Konfigurationsdateiformat ist sehr ähnlich zu dem Format, das von Nagios(TM) benutzt wird.
Konfigurationsanweisungen beginnen mit dem Schlüsselwort "define" gefolgt von einem Typfeld und einer öffnenden geschweiften Klammer ({). Jede folgende Zeile definiert Variablen-Werte-Paare, getrennt durch ein Gleichheitszeichen ( = ), bis zu einer schließenden geschweiften Klammer (}).
Hashes (#) werden benutzt, um Kommentare zu markieren. Beachten Sie, dass eine Kommentarzeile mit einem Hash-Zeichen beginnen MUSS, alle anderen Zeichen (auch "Whitespaces") sind ungültig!

Beschreibung der Objekttypen

global

Die erste Definition in jeder Konfigurationsdatei sollte vom Typ "global" sein. Optionen in diesem Abschnitt gelten für die gesamte Map und werden an andere Typen vererbt, die später definiert werden.

Beispiel mit allen Optionen, die gesetzt werden müssen:
define global {
  allowed_user=EVERYONE
  allowed_for_config=nagiosadmin
  map_image=lan.png
}
WertDefaultBeschreibung
allowed_user Kommaseparierte List von Nagios-Benutzern, die berechtigt sind, diese Maps anzusehen. EVERYONE erlaubt jedem den Zugriff
allowed_for_config Kommaseparierte Liste von Nagios-Benutzern, die diese Map editieren dürfen. EVERYONE erlaubt jedem den Zugriff
map_image Das Bild, das als Hintergrund der NagVis-Map angezeigt werden soll (z.B. eine Visio (TM)-Zeichnung).
aliasMap-NameDer Alias ist das Label für jede Map. Wenn definiert, wird es überall im NagVis-Frontend und WUI angezeigt
backend_idvererbt (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_colorvererbt (nagvis.ini.php)Hintergrundfarbe dieser Map. Falls dieser Wert nicht gesetzt wird, wird die Hintergrundfarbe aus der Hauptkonfigurationsdatei genommen.
header_templatevererbt (nagvis.ini.php)header template für diese Map
hover_menuvererbt (nagvis.ini.php)aktivieren/deaktivieren von Hover-Menüs (neu in 1.3)
hover_delayvererbt (nagvis.ini.php)Verzögerung der Anzeige des Hover-Menus in Sekunden
hover_templatevererbt (nagvis.ini.php)Default hover template für diese Map
hover_timeoutvererbt (nagvis.ini.php)Default-Timeout (in Sekunden) bei Ajax-Abfragen in Hover-Menüs (neu in 1.3)
hover_childs_showvererbt (nagvis.ini.php)Anzeigen von Child-Objekten in Hover-Menüs (neu in 1.3)
hover_childs_sortvererbt (nagvis.ini.php)Sortierreihenfolge von Child-Objekten ("s"=Status, "a"=Alphabet) (neu in 1.3)
hover_childs_ordervererbt (nagvis.ini.php)Reihenfolge von Child-Objekten ("asc"=aufsteigend, "desc"=absteigend) (neu in 1.3)
hover_childs_limitvererbt (nagvis.ini.php)max. Anzahl von Child-Objekten (neu in 1.3)
iconsetvererbt (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_maintenance0aktiviert/deaktiviert den Wartungsmodus. Wenn eine Map im Wartungsmodus ist, wird statt der Map lediglich ein Hinweis angezeigt
label_show0Labelanzeige für die Map-Objekte aktivieren/deaktivieren
label_x-20x-Position der Label in Pixeln (mit Vorzeichen +/- relativ zur linken, oberen Ecke der Icons, sonst absolute Position)
label_y+20y-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_backgroundtransparentDefault-Hintergrundfarbe der Label
label_border#000000Default-Rahmenfarbe der Label
only_hard_statesvererbt (nagvis.ini.php)Gibt an, ob Soft-Zustände ignoriert werden sollen. Default ist 0.
recognize_servicesvererbt (nagvis.ini.php)Definiert, ob die Services des Hosts den angezeigten Status beieinflussen. 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_listsvererbt (nagvis.ini.php)Map-Anzeige in Listenformat (Dropdowns, Indexseite, ...)
url_target _selfZiel des Icon-Links, diese Option passt <a target=""> an (_self ist das gleiche Fenster)
usegdlibsvererbt (nagvis.ini.php)Aktiviert die Benutzung der GD-Libs für diese Map (Linien können nur benutzt werden, wenn die GD-Libs aktiviert sind)

host

Beispiel mit allen Optionen, die gesetzt werden müssen (beachten Sie, dass Optionen nicht gesetzt werden müssen, wenn sie bereits im global-Abschnitt definiert wurden):
define host {
  host_name=localhost
  x=100
  y=200
}
WertDefaultBeschreibung
host_name Name des Hosts wie in Nagios definiert
x X-Koordinate
y Y-Koordinate
backend_idvererbt (global) 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.
hover_menuvererbt (nagvis.ini.php)aktivieren/deaktivieren von Hover-Menüs (neu in 1.3)
hover_delayvererbt (nagvis.ini.php)Verzögerung der Anzeige des Hover-Menus in Sekunden
hover_templatevererbt (nagvis.ini.php)Default hover template für diese Map
hover_timeoutvererbt (nagvis.ini.php)Default-Timeout (in Sekunden) bei Ajax-Abfragen in Hover-Menüs (neu in 1.3)
hover_url URL, der im Hover-Menu statt der Standard-Informationen angezeigt werden soll
hover_childs_showvererbt (nagvis.ini.php)Anzeigen von Child-Objekten in Hover-Menüs (neu in 1.3)
hover_childs_sortvererbt (nagvis.ini.php)Sortierreihenfolge von Child-Objekten ("s"=Status, "a"=Alphabet) (neu in 1.3)
hover_childs_ordervererbt (nagvis.ini.php)Reihenfolge von Child-Objekten ("asc"=aufsteigend, "desc"=absteigend) (neu in 1.3)
hover_childs_limitvererbt (nagvis.ini.php)max. Anzahl von Child-Objekten (neu in 1.3)
iconsetvererbt (global)Spezielles Iconset. Wird vom global-Paragraph vererbt, falls es hier nicht angegeben wird.
label_showvererbt (global) Labelanzeige für die Map-Objekte aktivieren/deaktivieren
label_text[name]Text des Labels
label_xvererbt (global) x-Position der Label in Pixeln (mit Vorzeichen +/- relativ zur linken, oberen Ecke der Icons, sonst absolute Position)
label_yvererbt (global) y-Position der Label in Pixeln (mit Vorzeichen +/- relativ zur linken, oberen Ecke der Icons, sonst absolute Position)
label_widthvererbt (global) Breite des Labels in Pixeln
label_backgroundvererbt (global) Hintergrundfarbe des Labels
label_bordervererbt (global) Rahmenfarbe des Labels
line_type URL, auf den das Icon verweisen soll. Default ist ein Verweis auf die Nagios-CGIs.
only_hard_statesvererbt (global) Gibt an, ob Soft-Zustände ignoriert werden sollen. Default ist 0.
recognize_servicesvererbt (global)Definiert, ob die Services des Hosts den angezeigten Status beieinflussen. 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.
url URL, auf den das Icon verweisen soll. Default ist ein Verweis auf die Nagios-CGIs.
url_target_selfZiel des Icon-Links, diese Option passt <a target=""> an (_self ist das gleiche Fenster)
use Kommaseparierte Liste von zu benutzenden Objekt-Templates. Details zu template
z1Die z-Option definiert die Reihenfolge, in der die Icons aufeinander gestapelt werden. Das Icon mit dem höchsten Wert wird auf der Spitze dargestellt. Das Hintergrundbild hat den Wert 0, so dass gültige Werte 1 oder größer sein müssen.

Service

Beispiel mit allen Optionen, die gesetzt werden müssen (beachten Sie, dass Optionen nicht gesetzt werden müssen, wenn sie bereits im global-Abschnitt definiert wurden):
define service {
  host_name=localhost
  service_description=ping
  iconset=std_big
  x=100
  y=200
}
WertDefaultBeschreibung
host_name Name des Hosts wie in Nagios definiert
service_description Name des Service wie in Nagios definiert
x X-Koordinate
y Y-Koordinate
backend_idvererbt (global) 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.
hover_menuvererbt (nagvis.ini.php)aktivieren/deaktivieren von Hover-Menüs (neu in 1.3)
hover_url URL, der im Hover-Menu statt der Standard-Informationen angezeigt werden soll
hover_templatevererbt (global) Hover template für dieses Objekt
hover_timeoutvererbt (nagvis.ini.php)Default-Timeout (in Sekunden) bei Ajax-Abfragen in Hover-Menüs (neu in 1.3)
hover_delayvererbt (nagvis.ini.php)Verzögerung der Anzeige des Hover-Menus in Sekunden
hover_childs_showvererbt (nagvis.ini.php)Anzeigen von Child-Objekten in Hover-Menüs (neu in 1.3)
hover_childs_sortvererbt (nagvis.ini.php)Sortierreihenfolge von Child-Objekten ("s"=Status, "a"=Alphabet) (neu in 1.3)
hover_childs_ordervererbt (nagvis.ini.php)Reihenfolge von Child-Objekten ("asc"=aufsteigend, "desc"=absteigend) (neu in 1.3)
hover_childs_limitvererbt (nagvis.ini.php)max. Anzahl von Child-Objekten (neu in 1.3)
iconsetvererbt (global) Spezielles Iconset. Wird vom global-Paragraph vererbt, falls es hier nicht angegeben wird
label_showvererbt (global) Labelanzeige für die Map-Objekte aktivieren/deaktivieren
label_text[name][service_description]Text des Labels
label_xvererbt (global) x-Position der Label in Pixeln (mit Vorzeichen +/- relativ zur linken, oberen Ecke der Icons, sonst absolute Position)
label_yvererbt (global) y-Position der Label in Pixeln (mit Vorzeichen +/- relativ zur linken, oberen Ecke der Icons, sonst absolute Position)
label_widthvererbt (global) Breite des Labels in Pixeln
label_backgroundvererbt (global) Hintergrundfarbe des Labels
label_bordervererbt (global) Rahmenfarbe des Labels
line_type Wenn gesetzt, wird das Objekt als Linie angezeigt.
only_hard_statesvererbt (global) Gibt an, ob Soft-Zustände ignoriert werden sollen. Default ist 0.
url URL, auf den das Icon verweisen soll. Default ist ein Verweis auf die Nagios-CGIs.
url_target_selfZiel des Icon-Links, diese Option passt <a target=""> an (_self ist das gleiche Fenster)
use Kommaseparierte Liste von zu benutzenden Objekt-Templates. Details zu template
z1Die z-Option definiert die Reihenfolge, in der die Icons aufeinander gestapelt werden. Das Icon mit dem höchsten Wert wird auf der Spitze dargestellt. Das Hintergrundbild hat den Wert 0, so dass gültige Werte 1 oder größer sein müssen.

Hostgroup

Beispiel mit allen Optionen, die gesetzt werden müssen (beachten Sie, dass Optionen nicht gesetzt werden müssen, wenn sie bereits im global-Abschnitt definiert wurden):
define hostgroup {
  hostgroup_name=servers
  x=100
  y=200
}
WertDefaultBeschreibung
hostgroup_name Name der Hostgroup wie in Nagios definiert
x X-Koordinate
y Y-Koordinate
backend_idvererbt (global) 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.
hover_menuvererbt (nagvis.ini.php)aktivieren/deaktivieren von Hover-Menüs (neu in 1.3)
hover_url URL, der im Hover-Menu statt der Standard-Informationen angezeigt werden soll
hover_templatevererbt (global) Hover template für dieses Objekt
hover_timeoutvererbt (nagvis.ini.php)Default-Timeout (in Sekunden) bei Ajax-Abfragen in Hover-Menüs (neu in 1.3)
hover_delayvererbt (nagvis.ini.php)Verzögerung der Anzeige des Hover-Menus in Sekunden
hover_childs_showvererbt (nagvis.ini.php)Anzeigen von Child-Objekten in Hover-Menüs (neu in 1.3)
hover_childs_sortvererbt (nagvis.ini.php)Sortierreihenfolge von Child-Objekten ("s"=Status, "a"=Alphabet) (neu in 1.3)
hover_childs_ordervererbt (nagvis.ini.php)Reihenfolge von Child-Objekten ("asc"=aufsteigend, "desc"=absteigend) (neu in 1.3)
hover_childs_limitvererbt (nagvis.ini.php)max. Anzahl von Child-Objekten (neu in 1.3)
iconsetvererbt (global) Spezielles Iconset. Wird vom global-Paragraph vererbt, falls es hier nicht angegeben wird
label_showvererbt (global) Labelanzeige für die Map-Objekte aktivieren/deaktivieren
label_text[name]Text des Labels, verfügbare Makros: [name] und [output]
label_xvererbt (global)x-Position der Label in Pixeln (mit Vorzeichen +/- relativ zur linken, oberen Ecke der Icons, sonst absolute Position)
label_yvererbt (global) y-Position der Label in Pixeln (mit Vorzeichen +/- relativ zur linken, oberen Ecke der Icons, sonst absolute Position)
label_widthvererbt (global) Breite des Labels in Pixeln
label_backgroundvererbt (global) Hintergrundfarbe des Labels
line_type Wenn gesetzt, wird das Objekt als Linie angezeigt.
only_hard_statesvererbt (global) Gibt an, ob Soft-Zustände ignoriert werden sollen. Default ist 0.
recognize_servicesvererbt (global) Definiert, ob die Services des Hosts den angezeigten Status beieinflussen. 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.
url URL, auf den das Icon verweisen soll. Default ist ein Verweis auf die Nagios-CGIs.
url_target_selfZiel des Icon-Links, diese Option passt <a target=""> an (_self ist das gleiche Fenster)
use Kommaseparierte Liste von zu benutzenden Objekt-Templates. Details zu template
z1Die z-Option definiert die Reihenfolge, in der die Icons aufeinander gestapelt werden. Das Icon mit dem höchsten Wert wird auf der Spitze dargestellt. Das Hintergrundbild hat den Wert 0, so dass gültige Werte 1 oder größer sein müssen.

Servicegroup

Beispiel mit allen Optionen, die gesetzt werden müssen (beachten Sie, dass Optionen nicht gesetzt werden müssen, wenn sie bereits im global-Abschnitt definiert wurden):
define servicegroup {
  servicegroup_name=servicegroup1
  x=100
  y=200
}
WertDefaultBeschreibung
servicegroup_name Name der Servicegroup wie in Nagios definiert.
x X-Koordinate
y Y-Koordinate
backend_idvererbt (global) 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.
hover_menuvererbt (nagvis.ini.php)aktivieren/deaktivieren von Hover-Menüs (neu in 1.3)
hover_url URL, der im Hover-Menu statt der Standard-Informationen angezeigt werden soll
hover_templatevererbt (global) Hover template für dieses Objekt
hover_timeoutvererbt (nagvis.ini.php)Default-Timeout (in Sekunden) bei Ajax-Abfragen in Hover-Menüs (neu in 1.3)
hover_delayvererbt (nagvis.ini.php)Verzögerung der Anzeige des Hover-Menus in Sekunden
hover_childs_showvererbt (nagvis.ini.php)Anzeigen von Child-Objekten in Hover-Menüs (neu in 1.3)
hover_childs_sortvererbt (nagvis.ini.php)Sortierreihenfolge von Child-Objekten ("s"=Status, "a"=Alphabet) (neu in 1.3)
hover_childs_ordervererbt (nagvis.ini.php)Reihenfolge von Child-Objekten ("asc"=aufsteigend, "desc"=absteigend) (neu in 1.3)
hover_childs_limitvererbt (nagvis.ini.php)max. Anzahl von Child-Objekten (neu in 1.3)
iconsetvererbt (global) Spezielles Iconset. Wird vom global-Paragraph vererbt, falls es hier nicht angegeben wird
label_showvererbt (global) Labelanzeige für die Map-Objekte aktivieren/deaktivieren
label_text[name]Text des Labels, verfügbare Makros: [name] und [output]
label_xvererbt (global)x-Position der Label in Pixeln (mit Vorzeichen +/- relativ zur linken, oberen Ecke der Icons, sonst absolute Position)
label_yvererbt (global) y-Position der Label in Pixeln (mit Vorzeichen +/- relativ zur linken, oberen Ecke der Icons, sonst absolute Position)
label_widthvererbt (global) Breite des Labels in Pixeln
label_backgroundvererbt (global) Hintergrundfarbe des Labels
line_type Wenn gesetzt, wird das Objekt als Linie angezeigt.
only_hard_statesvererbt (global) Gibt an, ob Soft-Zustände ignoriert werden sollen. Default ist 0.
recognize_servicesvererbt (global) Definiert, ob die Services des Hosts den angezeigten Status beieinflussen. 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.
url URL, auf den das Icon verweisen soll. Default ist ein Verweis auf die Nagios-CGIs.
url_target_selfZiel des Icon-Links, diese Option passt <a target=""> an (_self ist das gleiche Fenster)
use Kommaseparierte Liste von zu benutzenden Objekt-Templates. Details zu template
z1Die z-Option definiert die Reihenfolge, in der die Icons aufeinander gestapelt werden. Das Icon mit dem höchsten Wert wird auf der Spitze dargestellt. Das Hintergrundbild hat den Wert 0, so dass gültige Werte 1 oder größer sein müssen.

Map

Beispiel mit allen Optionen, die gesetzt werden müssen (beachten Sie, dass Optionen nicht gesetzt werden müssen, wenn sie bereits im global-Abschnitt definiert wurden):
define map {
  map_name=webserver
  x=77
  y=156
}
WertDefaultBeschreibung
map_name Name der Map-Konfigurationsdatei (ohne .cfg-Erweiterung)
x X-Koordinate
y Y-Koordinate
hover_menuvererbt (nagvis.ini.php)aktivieren/deaktivieren von Hover-Menüs (neu in 1.3)
hover_url URL, der im Hover-Menu statt der Standard-Informationen angezeigt werden soll
hover_templatevererbt (global) Hover template für dieses Objekt
hover_delayvererbt (nagvis.ini.php)Verzögerung der Anzeige des Hover-Menus in Sekunden
hover_timeoutvererbt (nagvis.ini.php)Default-Timeout (in Sekunden) bei Ajax-Abfragen in Hover-Menüs (neu in 1.3)
hover_childs_showvererbt (nagvis.ini.php)Anzeigen von Child-Objekten in Hover-Menüs (neu in 1.3)
hover_childs_sortvererbt (nagvis.ini.php)Sortierreihenfolge von Child-Objekten ("s"=Status, "a"=Alphabet) (neu in 1.3)
hover_childs_ordervererbt (nagvis.ini.php)Reihenfolge von Child-Objekten ("asc"=aufsteigend, "desc"=absteigend) (neu in 1.3)
hover_childs_limitvererbt (nagvis.ini.php)max. Anzahl von Child-Objekten (neu in 1.3)
iconsetvererbt (global) Spezielles Iconset. Wird vom global-Paragraph vererbt, falls es hier nicht angegeben wird
label_showvererbt (global) Labelanzeige für die Map-Objekte aktivieren/deaktivieren
label_text[name]Text des Labels, verfügbare Makros: [name] und [output]
label_xvererbt (global)x-Position der Label in Pixeln (mit Vorzeichen +/- relativ zur linken, oberen Ecke der Icons, sonst absolute Position)
label_yvererbt (global) y-Position der Label in Pixeln (mit Vorzeichen +/- relativ zur linken, oberen Ecke der Icons, sonst absolute Position)
label_widthvererbt (global) Breite des Labels in Pixeln
label_backgroundvererbt (global) Hintergrundfarbe des Labels
only_hard_statesvererbt (global) Gibt an, ob Soft-Zustände ignoriert werden sollen. Default ist 0.
url URL, auf den das Icon verweisen soll. Default ist ein Verweis auf die Nagios-CGIs.
url_target_selfZiel des Icon-Links, diese Option passt <a target=""> an (_self ist das gleiche Fenster)
use Kommaseparierte Liste von zu benutzenden Objekt-Templates. Details zu template
z1Die z-Option definiert die Reihenfolge, in der die Icons aufeinander gestapelt werden. Das Icon mit dem höchsten Wert wird auf der Spitze dargestellt. Das Hintergrundbild hat den Wert 0, so dass gültige Werte 1 oder größer sein müssen.

Textbox

Beispiel mit allen möglichen Optionen:
define textbox {
  text="This is an informative text wich is free placeable on the map, HTML can also used for formating purposes"
  x=200
  y=100
  w=200
}
WertDefaultBeschreibung
text Ihr eigener Text, HTML ist möglich. Es gibt das Makro [refresh_counter], das die Zeit bis zur nächsten Aktualisierung/Rotation anzeigt.
w Breite der Textbox
x X-Koordinate
y Y-Koordinate
background_color#C0C0C0Hintergrundfarbe der Textbox, kann auch transparent sein
border_color#000000Rahmenfarbe der Textbox, kann auch transparent sein (neu in 1.3)
use Kommaseparierte Liste von zu benutzenden Objekt-Templates. Details zu template
z1Die z-Option definiert die Reihenfolge, in der die Icons aufeinander gestapelt werden. Das Icon mit dem höchsten Wert wird auf der Spitze dargestellt. Das Hintergrundbild hat den Wert 0, so dass gültige Werte 1 oder größer sein müssen.

Shape

Beispiel mit allen Werten, die gesetzt werden müssen:
define shape {
  icon="test"
  x=200
  y=100
}
WertDefaultBeschreibung
Icon Dateiname des Shapes. Shapes müssen im shape-Verzeichnis abgelegt werden (Default: nagvis/images/shapes)
x X-Koordinate
y Y-Koordinate
hover_url URL, der beim Schweben über dem Bild anzuzeigen ist. Normalerweise gibt es keine Aktion während des Schwebens.
hover_delayvererbt (nagvis.ini.php)Verzögerung der Anzeige des Hover-Menus in Sekunden
url URL, auf den das Icon verweisen soll. Normalerweise gibt es keinen Verweis.
url_target_selfZiel des Icon-Links, diese Option passt <a target=""> an (_self ist das gleiche Fenster)
use Kommaseparierte Liste von zu benutzenden Objekt-Templates. Details zu template
z1Die z-Option definiert die Reihenfolge, in der die Icons aufeinander gestapelt werden. Das Icon mit dem höchsten Wert wird auf der Spitze dargestellt. Das Hintergrundbild hat den Wert 0, so dass gültige Werte 1 oder größer sein müssen.

Template

Seit Nagvis 1.2 gibt es eine neue Objektart namens template. Mit diesem Objekt haben Sie die Möglichkeit, alle optionalen Werte in einem Objekt zu definieren, das für viele andere gilt. Sie können alle Attribute auf die Werte setzen, die Sie benötigen und diese mit dem use-Attribut an andere Objekte vererben.

Zur Zeit müssen die Templates direkt in den Dateien definiert werden, weil die WUI die Definition nicht unterstützt. Wahrscheinlich wird dies in folgenden Versionen möglich sein.

Beispiel mit allen Werten, die gesetzt werden müssen:
define template {
  name=generic-template
}
WertDefaultBeschreibung
name Template-Name (einfache Zeichenkette ohne Leerzeichen – muss in der Map eindeutig sein)
... Alle Werte, die in den Objekten verfügbar sind, die dieses Template erben