Oggetto mappa

I seguenti oggetti sono direttamente correlati all'API map.

Mappa

L'oggetto mappa ha le seguenti proprietà.

Proprietà Tipo Descrizione
sysmapid ID ID della mappa.

Comportamento della proprietà:
- sola lettura
- obbligatoria per le operazioni di aggiornamento
height integer Altezza della mappa in pixel.

Comportamento della proprietà:
- obbligatoria per le operazioni di creazione
name string Nome della mappa.

Comportamento della proprietà:
- obbligatoria per le operazioni di creazione
width integer Larghezza della mappa in pixel.

Comportamento della proprietà:
- obbligatoria per le operazioni di creazione
backgroundid ID ID dell'immagine utilizzata come sfondo della mappa.
background_scale integer Indica se abilitare il ridimensionamento proporzionale dell'immagine di sfondo.

Valori possibili:
0 - disabilita il ridimensionamento;
1 - (predefinito) abilita il ridimensionamento dell'immagine.
expand_macros integer Indica se espandere le macro nelle etichette durante la configurazione della mappa.

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 solo problema.

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

Valori possibili:
0 - disabilita l'allineamento alla griglia;
1 - (predefinito) abilita l'allineamento alla griglia.
grid_show integer Indica se mostrare la griglia sulla mappa.

Valori possibili:
0 - non mostrare la griglia;
1 - (predefinito) mostrare la griglia.
grid_size integer Dimensione della griglia della mappa 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 mappa icone utilizzata nella mappa.
label_format integer Indica se abilitare le etichette avanzate.

Valori possibili:
0 - (predefinito) disabilita le etichette avanzate;
1 - abilita le etichette avanzate.
label_location integer Posizione dell'etichetta dell'elemento della mappa.

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.

Comportamento della proprietà:
- obbligatoria se label_type_host è impostato su "custom"
label_string_hostgroup string Etichetta personalizzata per gli elementi del gruppo host.

Comportamento della proprietà:
- obbligatoria se label_type_hostgroup è impostato su "custom"
label_string_image string Etichetta personalizzata per gli elementi immagine.

Comportamento della proprietà:
- obbligatoria se label_type_image è impostato su "custom"
label_string_map string Etichetta personalizzata per gli elementi mappa.

Comportamento della proprietà:
- obbligatoria se label_type_map è impostato su "custom"
label_string_trigger string Etichetta personalizzata per gli elementi trigger.

Comportamento della proprietà:
- obbligatoria se label_type_trigger è impostato su "custom"
label_type integer Tipo di etichetta dell'elemento della mappa.

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 - personalizzata.
label_type_hostgroup integer Tipo di etichetta per gli elementi del gruppo host.

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

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

Valori possibili:
0 - etichetta;
2 - (predefinito) nome dell'elemento;
3 - solo stato;
4 - niente;
5 - personalizzata.
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 - personalizzata.
markelements integer Indica se evidenziare gli elementi della mappa che hanno cambiato di recente il proprio stato.

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

Fare riferimento alla proprietà severity del trigger per un elenco delle gravità dei trigger supportate.
show_element_label integer Come visualizzare per impostazione predefinita le etichette degli elementi.

Valori possibili:
0 - visualizza sempre;
1 - (predefinito) nascondi automaticamente.
show_link_label integer Come visualizzare per impostazione predefinita le etichette dei collegamenti.

Valori possibili:
0 - visualizza sempre;
1 - (predefinito) nascondi automaticamente.
show_unack integer Come devono essere visualizzati i problemi.

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

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

Valori possibili:
0 - (predefinito) nascondi i problemi soppressi;
1 - mostra i problemi soppressi.

Elemento della mappa

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

Proprietà Type Descrizione
selementid ID ID dell'elemento della mappa.

Comportamento della proprietà:
- sola lettura
elements array Oggetto dati Element.

Comportamento della proprietà:
- obbligatoria 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 - immagine.

Comportamento della proprietà:
- obbligatoria
iconid_off ID ID dell'immagine utilizzata per visualizzare l'elemento nello stato predefinito.

Comportamento della proprietà:
- obbligatoria
areatype integer Come devono essere visualizzati i singoli host 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 Come un elemento host group deve essere visualizzato su una mappa.

Valori possibili:
0 - (predefinito) visualizza l'host group come un singolo elemento;
1 - visualizza separatamente ciascun host nel gruppo.
evaltype integer Condizione di filtraggio dei tag dell'elemento della mappa metodo di valutazione.

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

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

Comportamento della proprietà:
- supportata se elementtype è impostato su "host", "map", "trigger" o "host group"
iconid_maintenance ID ID dell'immagine utilizzata per visualizzare gli elementi della mappa in manutenzione.

Comportamento della proprietà:
- supportata se elementtype è impostato su "host", "map", "trigger" o "host group"
iconid_on ID ID dell'immagine utilizzata per visualizzare gli elementi della mappa con problemi.

Comportamento della proprietà:
- supportata 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.
show_label integer Come visualizzare l'etichetta dell'elemento.

Valori possibili:
-1 - (predefinito) valore predefinito della mappa;
0 - visualizza sempre;
1 - nascondi automaticamente.
sysmapid ID ID della mappa a cui appartiene l'elemento.

Comportamento della proprietà:
- 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 la mappatura delle icone deve essere utilizzata per gli elementi host.

Valori possibili:
0 - non utilizzare la mappatura delle icone;
1 - (predefinito) utilizza la mappatura delle icone.
viewtype integer Algoritmo di posizionamento dell'elemento host group.

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

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

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

Predefinito: 0.
zindex integer Valore utilizzato per ordinare gli elementi della mappa (z-index).

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.

Collegamento della mappa

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

Proprietà Type Descrizione
linkid ID ID del collegamento della mappa.

Comportamento della proprietà:
- sola lettura
sysmapid ID ID della mappa a cui appartiene il collegamento.
selementid1 ID ID del primo elemento della mappa collegato a un'estremità.

Comportamento della proprietà:
- obbligatorio
selementid2 ID ID del primo elemento della mappa collegato all'altra estremità.

Comportamento della proprietà:
- obbligatorio
drawtype integer Stile di disegno della linea del collegamento.

Valori possibili:
0 - (predefinito) linea;
2 - linea in grassetto;
3 - linea puntinata;
4 - linea tratteggiata.
color string Colore della linea come codice colore esadecimale.

Predefinito: 000000.
label string Etichetta del collegamento.
show_label integer Come visualizzare l'etichetta del collegamento.

Valori possibili:
-1 - (predefinito) valore predefinito della mappa;
0 - visualizza sempre;
1 - nascondi automaticamente.
indicator_type integer Seleziona il tipo di indicatore del collegamento.

Valori possibili:
0 - (predefinito) collegamento statico;
1 - trigger;
2 - valore dell'item.
linktriggers array Trigger del collegamento della mappa da utilizzare come indicatori di stato del collegamento.

L'oggetto trigger del collegamento della mappa è descritto in dettaglio di seguito.

Comportamento della proprietà:
- obbligatorio se indicator_type è impostato su "trigger" (1).
itemid ID ID dell'item.

Comportamento della proprietà:
- obbligatorio se indicator_type è impostato su "valore dell'item" (2).
highlights array Evidenziazioni del collegamento della mappa da utilizzare come indicatori di stato del collegamento.

L'oggetto indicatori del collegamento della mappa è descritto in dettaglio di seguito.

Comportamento della proprietà:
- obbligatorio se indicator_type è impostato su "valore dell'item" (2).
thresholds array Soglie del collegamento della mappa da utilizzare come indicatori di stato del collegamento.

L'oggetto indicatori del collegamento della mappa è descritto in dettaglio di seguito.

Comportamento della proprietà:
- obbligatorio se indicator_type è impostato su "valore dell'item" (2).
permission integer Tipo di livello di autorizzazione.

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

Trigger del collegamento della mappa

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

Proprietà Tipo Descrizione
triggerid ID ID del trigger utilizzato come indicatore del collegamento.

Comportamento della proprietà:
- obbligatorio
color string Colore dell'indicatore come codice colore esadecimale.

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

Valori possibili:
0 - (predefinito) linea;
2 - linea in grassetto;
3 - linea puntinata;
4 - linea tratteggiata.

Indicatori dei collegamenti della mappa

L'oggetto degli indicatori dei collegamenti della mappa definisce un indicatore di stato del collegamento della mappa in base al valore dell'item. Ha le seguenti proprietà:

Proprietà Type Descrizione
pattern string Espressione regolare con cui confrontare. Disponibile solo per le evidenziazioni.
sortorder integer Utilizzato per definire l'ordine di ordinamento delle evidenziazioni. Disponibile solo per le evidenziazioni.
threshold string Valore numerico con cui confrontare. Disponibile solo per le soglie.
drawtype integer Stile di disegno dell'indicatore.

Valori possibili:
0 - (predefinito) linea;
2 - linea in grassetto;
3 - linea puntinata;
4 - linea tratteggiata.
color string Colore dell'indicatore come codice colore esadecimale.

Predefinito: DD0000.

Comportamento della proprietà:
- obbligatorio

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à:

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

Property behavior:
- read-only
type integer Tipo dell'elemento forma della mappa.

Valori possibili:
0 - rettangolo;
1 - ellisse.

La proprietà è obbligatoria quando vengono create nuove forme.

Property behavior:
- required
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.