Oggetto mappa

I seguenti oggetti sono direttamente correlati all'API map.

Map

L'oggetto map ha le seguenti proprietà.

Property Type Description
sysmapid ID ID della map.

Property behavior:
- sola lettura
- obbligatorio per le operazioni di aggiornamento
height integer Altezza della map in pixel.

Property behavior:
- obbligatorio per le operazioni di creazione
name string Nome della map.

Property behavior:
- obbligatorio per le operazioni di creazione
width integer Larghezza della map in pixel.

Property behavior:
- obbligatorio per le operazioni di creazione
backgroundid ID ID dell'immagine usata come sfondo della map.
expand_macros integer Indica se espandere le macro nelle etichette durante la configurazione della map.

Valori possibili:
0 - (predefinito) non espandere le macro;
1 - espandere le macro.
expandproblem integer Indica se il trigger del problema verrà visualizzato per gli elementi con un singolo problema.

Valori possibili:
0 - visualizzare sempre il numero di problemi;
1 - (predefinito) visualizzare il trigger del problema se c'è un solo problema.
grid_align integer Indica se abilitare l'allineamento alla griglia.

Valori possibili:
0 - disabilitare l'allineamento alla griglia;
1 - (predefinito) abilitare l'allineamento alla griglia.
grid_show integer Indica se mostrare la griglia sulla map.

Valori possibili:
0 - non mostrare la griglia;
1 - (predefinito) mostrare la griglia.
grid_size integer Dimensione della griglia della map in pixel.

Valori supportati: 20, 40, 50, 75 e 100.

Predefinito: 50.
highlight integer Indica se l'evidenziazione delle icone è abilitata.

Valori possibili:
0 - evidenziazione disabilitata;
1 - (predefinito) evidenziazione abilitata.
iconmapid ID ID della icon map usata nella map.
label_format integer Indica se abilitare le etichette avanzate.

Valori possibili:
0 - (predefinito) disabilitare le etichette avanzate;
1 - abilitare le etichette avanzate.
label_location integer Posizione dell'etichetta dell'elemento della map.

Valori possibili:
0 - (predefinito) in basso;
1 - a sinistra;
2 - a destra;
3 - in alto.
label_string_host string Etichetta personalizzata per gli elementi host.

Property behavior:
- obbligatorio se label_type_host è impostato su "custom"
label_string_hostgroup string Etichetta personalizzata per gli elementi host group.

Property behavior:
- obbligatorio se label_type_hostgroup è impostato su "custom"
label_string_image string Etichetta personalizzata per gli elementi immagine.

Property behavior:
- obbligatorio se label_type_image è impostato su "custom"
label_string_map string Etichetta personalizzata per gli elementi map.

Property behavior:
- obbligatorio se label_type_map è impostato su "custom"
label_string_trigger string Etichetta personalizzata per gli elementi trigger.

Property behavior:
- obbligatorio se label_type_trigger è impostato su "custom"
label_type integer Tipo di etichetta per gli elementi della map.

Valori possibili:
0 - etichetta;
1 - indirizzo IP;
2 - (predefinito) nome dell'elemento;
3 - solo stato;
4 - niente.
label_type_host integer Tipo di etichetta per gli elementi host.

Valori possibili:
0 - etichetta;
1 - indirizzo IP;
2 - (predefinito) nome dell'elemento;
3 - solo stato;
4 - niente;
5 - personalizzato.
label_type_hostgroup integer Tipo di etichetta per gli elementi host group.

Valori possibili:
0 - etichetta;
2 - (predefinito) nome dell'elemento;
3 - solo stato;
4 - niente;
5 - personalizzato.
label_type_image integer Tipo di etichetta per gli elementi host group.

Valori possibili:
0 - etichetta;
2 - (predefinito) nome dell'elemento;
4 - niente;
5 - personalizzato.
label_type_map integer Tipo di etichetta per gli elementi map.

Valori possibili:
0 - etichetta;
2 - (predefinito) nome dell'elemento;
3 - solo stato;
4 - niente;
5 - personalizzato.
label_type_trigger integer Tipo di etichetta per gli elementi trigger.

Valori possibili:
0 - etichetta;
2 - (predefinito) nome dell'elemento;
3 - solo stato;
4 - niente;
5 - personalizzato.
markelements integer Indica se evidenziare gli elementi della map che hanno recentemente cambiato stato.

Valori possibili:
0 - (predefinito) non evidenziare gli elementi;
1 - evidenziare gli elementi.
severity_min integer Gravità minima dei trigger che verranno visualizzati sulla map.

Fare riferimento alla proprietà severity del trigger per un elenco delle gravità supportate per i trigger.
show_unack integer Modalità di visualizzazione dei problemi.

Valori possibili:
0 - (predefinito) visualizzare il conteggio di tutti i problemi;
1 - visualizzare solo il conteggio dei problemi non riconosciuti;
2 - visualizzare separatamente il conteggio dei problemi riconosciuti e non riconosciuti.
userid ID ID dell'utente proprietario della map.
private integer Tipo di condivisione della map.

Valori possibili:
0 - map pubblica;
1 - (predefinito) map privata.
show_suppressed integer Indica se i problemi soppressi vengono mostrati.

Valori possibili:
0 - (predefinito) nascondere i problemi soppressi;
1 - mostrare i problemi soppressi.

Elemento della mappa

L'oggetto elemento della mappa definisce un oggetto visualizzato su una mappa. Ha le seguenti proprietà.

Property Type Description
selementid ID ID dell'elemento della mappa.

Property behavior:
- sola lettura
elements array Oggetto dati Element.

Property behavior:
- obbligatorio se elementtype è impostato su "host", "map", "trigger" o "host group"
elementtype integer Tipo di elemento della mappa.

Valori possibili:
0 - host;
1 - map;
2 - trigger;
3 - host group;
4 - image.

Property behavior:
- obbligatorio
iconid_off ID ID dell'immagine usata per visualizzare l'elemento nello stato predefinito.

Property behavior:
- obbligatorio
areatype integer Modalità di visualizzazione degli host separati di un host group.

Valori possibili:
0 - (predefinito) l'elemento host group occuperà l'intera mappa;
1 - l'elemento host group avrà una dimensione fissa.
elementsubtype integer Modalità di visualizzazione di un elemento host group su una mappa.

Valori possibili:
0 - (predefinito) visualizza l'host group come un singolo elemento;
1 - visualizza separatamente ogni host del gruppo.
evaltype integer Metodo di valutazione della condizione di filtraggio dei tag dell'elemento della mappa evaluation method.

Valori possibili:
0 - (predefinito) And/Or;
2 - Or.
height integer Altezza dell'elemento host group a dimensione fissa in pixel.

Predefinito: 200.
iconid_disabled ID ID dell'immagine usata per visualizzare gli elementi della mappa disabilitati.

Property behavior:
- supportato se elementtype è impostato su "host", "map", "trigger" o "host group"
iconid_maintenance ID ID dell'immagine usata per visualizzare gli elementi della mappa in manutenzione.

Property behavior:
- supportato se elementtype è impostato su "host", "map", "trigger" o "host group"
iconid_on ID ID dell'immagine usata per visualizzare gli elementi della mappa con problemi.

Property behavior:
- supportato se elementtype è impostato su "host", "map", "trigger" o "host group"
label string Etichetta dell'elemento.
label_location integer Posizione dell'etichetta dell'elemento della mappa.

Valori possibili:
-1 - (predefinito) posizione predefinita;
0 - in basso;
1 - a sinistra;
2 - a destra;
3 - in alto.
permission integer Tipo di livello di autorizzazione.

Valori possibili:
-1 - nessuno;
2 - sola lettura;
3 - lettura-scrittura.
sysmapid ID ID della mappa a cui appartiene l'elemento.

Property behavior:
- sola lettura
urls array URL dell'elemento della mappa.

L'oggetto URL dell'elemento della mappa è descritto in dettaglio di seguito.
use_iconmap integer Indica se il mapping delle icone deve essere usato per gli elementi host.

Valori possibili:
0 - non usare il mapping delle icone;
1 - (predefinito) usare il mapping delle icone.
viewtype integer Algoritmo di posizionamento dell'elemento host group.

Valori possibili:
0 - (predefinito) griglia.
width integer Larghezza dell'elemento host group a dimensione fissa in pixel.

Predefinito: 200.
x integer Coordinata X dell'elemento in pixel.

Predefinito: 0.
y integer Coordinata Y dell'elemento in pixel.

Predefinito: 0.

Elemento mappa Host

L'oggetto elemento mappa Host definisce un elemento host.

Property Type Description
hostid ID ID dell'host.

Elemento mappa Gruppo host

L'oggetto elemento mappa Gruppo host definisce un elemento di gruppo host.

Proprietà Type Descrizione
groupid ID ID del gruppo host.

Oggetto elemento mappa Mappa

L'oggetto elemento mappa Mappa definisce un elemento della mappa.

Proprietà Type Descrizione
sysmapid ID ID della mappa.

Elemento mappa Trigger

L'oggetto elemento mappa Trigger definisce uno o più elementi trigger.

Proprietà Type Descrizione
triggerid ID ID del trigger.

Tag dell'elemento della mappa

L'oggetto Tag dell'elemento della mappa ha le seguenti proprietà.

Proprietà Type Descrizione
tag string Nome del tag dell'elemento della mappa.

Comportamento della proprietà:
- obbligatorio
operator integer Operatore della condizione del tag dell'elemento della mappa.

Valori possibili:
0 - (predefinito) Contiene;
1 - Uguale a;
2 - Non contiene;
3 - Diverso da;
4 - Esiste;
5 - Non esiste.
value string Valore del tag dell'elemento della mappa.

URL dell'elemento della mappa

L'oggetto URL dell'elemento della mappa definisce un collegamento cliccabile che sarà disponibile per uno specifico elemento della mappa. Ha le seguenti proprietà:

Property Type Description
sysmapelementurlid ID ID dell'URL dell'elemento della mappa.

Property behavior:
- sola lettura
name string Didascalia del collegamento.

Property behavior:
- obbligatorio
url string URL del collegamento.

Property behavior:
- obbligatorio
selementid ID ID dell'elemento della mappa a cui appartiene l'URL.

L'oggetto link della mappa definisce un collegamento tra due elementi della mappa. Ha le seguenti proprietà.

Property Type Description
linkid ID ID del link della mappa.

Property behavior:
- read-only
selementid1 ID ID del primo elemento della mappa collegato a un'estremità.

Property behavior:
- required
selementid2 ID ID del primo elemento della mappa collegato all'altra estremità.

Property behavior:
- required
color string Colore della linea come codice colore esadecimale.

Default: 000000.
drawtype integer Stile di disegno della linea del link.

Possible values:
0 - (default) line;
2 - bold line;
3 - dotted line;
4 - dashed line.
label string Etichetta del link.
linktriggers array Trigger del link della mappa da usare come indicatori di stato del link.

L'oggetto trigger del link della mappa è descritto in dettaglio di seguito.
permission integer Tipo di livello di autorizzazione.

Possible values:
-1 - none;
2 - read only;
3 - read-write.
sysmapid ID ID della mappa a cui appartiene il link.

Trigger del collegamento della mappa

L'oggetto trigger del collegamento della mappa definisce un indicatore di stato del collegamento della mappa basato sullo stato di un trigger. Ha le seguenti proprietà:

Property Type Description
linktriggerid ID ID del trigger del collegamento della mappa.

Property behavior:
- read-only
triggerid ID ID del trigger usato come indicatore del collegamento.

Property behavior:
- required
color string Colore dell'indicatore come codice colore esadecimale.

Default: DD0000.
drawtype integer Stile di disegno dell'indicatore.

Possible values:
0 - (default) line;
2 - bold line;
3 - dotted line;
4 - dashed line.
linkid ID ID del collegamento della mappa a cui appartiene il trigger del collegamento.

URL della mappa

L'oggetto URL della mappa definisce un collegamento cliccabile che sarà disponibile per tutti gli elementi di un tipo specifico sulla mappa. Ha le seguenti proprietà:

Proprietà Tipo Descrizione
sysmapurlid ID ID dell'URL della mappa.

Comportamento della proprietà:
- sola lettura
name string Didascalia del collegamento.

Comportamento della proprietà:
- obbligatoria
url string URL del collegamento.

Comportamento della proprietà:
- obbligatoria
elementtype integer Tipo di elemento della mappa per il quale l'URL sarà disponibile.

Fare riferimento alla proprietà type dell'elemento della mappa per un elenco dei tipi supportati.

Predefinito: 0.
sysmapid ID ID della mappa a cui appartiene l'URL.

Utente della mappa

Elenco dei permessi della mappa in base agli utenti. Ha le seguenti proprietà:

Proprietà Type Descrizione
sysmapuserid ID ID dell'utente della mappa.

Comportamento della proprietà:
- sola lettura
userid ID ID dell'utente.

Comportamento della proprietà:
- obbligatoria
permission integer Tipo di livello di permesso.

Valori possibili:
2 - sola lettura;
3 - lettura-scrittura.

Comportamento della proprietà:
- obbligatoria

Gruppo utenti della mappa

Elenco dei permessi della mappa in base ai gruppi utenti. Ha le seguenti proprietà:

Proprietà Tipo Descrizione
sysmapusrgrpid ID ID del gruppo utenti della mappa.

Comportamento della proprietà:
- sola lettura
usrgrpid ID ID del gruppo utenti.

Comportamento della proprietà:
- obbligatoria
permission integer Tipo di livello di permesso.

Valori possibili:
2 - sola lettura;
3 - lettura-scrittura.

Comportamento della proprietà:
- obbligatoria

Forme della mappa

L'oggetto forma della mappa definisce una forma geometrica (con o senza testo) visualizzata su una mappa. Ha le seguenti proprietà:

Property Type Description
sysmap_shapeid ID ID dell'elemento forma della mappa.

Property behavior:
- sola lettura
type integer Tipo dell'elemento forma della mappa.

Valori possibili:
0 - rettangolo;
1 - ellisse.

La proprietà è obbligatoria quando vengono create nuove forme.

Property behavior:
- obbligatoria
x integer Coordinate X della forma in pixel.

Predefinito: 0.
y integer Coordinate Y della forma in pixel.

Predefinito: 0.
width integer Larghezza della forma in pixel.

Predefinito: 200.
height integer Altezza della forma in pixel.

Predefinito: 200.
text string Testo della forma.
font integer Carattere del testo all'interno della forma.

Valori possibili:
0 - Georgia, serif
1 - "Palatino Linotype", "Book Antiqua", Palatino, serif
2 - "Times New Roman", Times, serif
3 - Arial, Helvetica, sans-serif
4 - "Arial Black", Gadget, sans-serif
5 - "Comic Sans MS", cursive, sans-serif
6 - Impact, Charcoal, sans-serif
7 - "Lucida Sans Unicode", "Lucida Grande", sans-serif
8 - Tahoma, Geneva, sans-serif
9 - "Trebuchet MS", Helvetica, sans-serif
10 - Verdana, Geneva, sans-serif
11 - "Courier New", Courier, monospace
12 - "Lucida Console", Monaco, monospace

Predefinito: 9.
font_size integer Dimensione del carattere in pixel.

Predefinito: 11.
font_color string Colore del carattere.

Predefinito: 000000.
text_halign integer Allineamento orizzontale del testo.

Valori possibili:
0 - centro;
1 - sinistra;
2 - destra.

Predefinito: 0.
text_valign integer Allineamento verticale del testo.

Valori possibili:
0 - centro;
1 - alto;
2 - basso.

Predefinito: 0.
border_type integer Tipo di bordo.

Valori possibili:
0 - nessuno;
1 - —————;
2 - ·····;
3 - - - -.

Predefinito: 0.
border_width integer Larghezza del bordo in pixel.

Predefinito: 0.
border_color string Colore del bordo.

Predefinito: 000000.
background_color string Colore di sfondo (colore di riempimento).

Predefinito: (vuoto).
zindex integer Valore utilizzato per ordinare tutte le forme e le linee (z-index).

Predefinito: 0.

Linee della mappa

L'oggetto linea della mappa definisce una linea visualizzata su una mappa. Ha le seguenti proprietà:

Proprietà Type Descrizione
sysmap_shapeid ID ID dell'elemento forma della mappa.

Comportamento della proprietà:
- sola lettura
x1 integer Coordinate X del punto 1 della linea in pixel.

Predefinito: 0.
y1 integer Coordinate Y del punto 1 della linea in pixel.

Predefinito: 0.
x2 integer Coordinate X del punto 2 della linea in pixel.

Predefinito: 200.
y2 integer Coordinate Y del punto 2 della linea in pixel.

Predefinito: 200.
line_type integer Tipo delle linee.

Valori possibili:
0 - nessuno;
1 - —————;
2 - ·····;
3 - - - -.

Predefinito: 0.
line_width integer Larghezza delle linee in pixel.

Predefinito: 0.
line_color string Colore della linea.

Predefinito: 000000.
zindex integer Valore utilizzato per ordinare tutte le forme e le linee (z-index).

Predefinito: 0.