[comment]: # aside: 1
[comment]: # ({7bfc83a8-cdacabd4})
# Oggetto mappa
I seguenti oggetti sono direttamente correlati all'API `map`.
[comment]: # ({/7bfc83a8-cdacabd4})
[comment]: # ({fa1c81a6-62f73225})
### Map
L'oggetto map ha le seguenti proprietà.
|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|sysmapid|ID|ID della map.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *sola lettura*
- *obbligatorio* per le operazioni di aggiornamento|
|height|integer|Altezza della map in pixel.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *obbligatorio* per le operazioni di creazione|
|name|string|Nome della map.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *obbligatorio* per le operazioni di creazione|
|width|integer|Larghezza della map in pixel.
[Property behavior](/manual/api/reference_commentary#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](/manual/api/reference_commentary#property-behavior):
- *obbligatorio* se `label_type_host` è impostato su "custom"|
|label\_string\_hostgroup|string|Etichetta personalizzata per gli elementi host group.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *obbligatorio* se `label_type_hostgroup` è impostato su "custom"|
|label\_string\_image|string|Etichetta personalizzata per gli elementi immagine.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *obbligatorio* se `label_type_image` è impostato su "custom"|
|label\_string\_map|string|Etichetta personalizzata per gli elementi map.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *obbligatorio* se `label_type_map` è impostato su "custom"|
|label\_string\_trigger|string|Etichetta personalizzata per gli elementi trigger.
[Property behavior](/manual/api/reference_commentary#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](/manual/api/reference/trigger/object#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.|
[comment]: # ({/fa1c81a6-62f73225})
[comment]: # ({7e910fc4-c7b92dfc})
### Elemento della mappa
L'oggetto elemento della mappa definisce un oggetto visualizzato su una mappa. Ha le
seguenti proprietà.
|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|selementid|ID|ID dell'elemento della mappa.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *sola lettura*|
|elements|array|Oggetto dati [Element](#map-element-host).
[Property behavior](/manual/api/reference_commentary#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](/manual/api/reference_commentary#property-behavior):
- *obbligatorio*|
|iconid\_off|ID|ID dell'immagine usata per visualizzare l'elemento nello stato predefinito.
[Property behavior](/manual/api/reference_commentary#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](/manual/config/visualization/maps/map#adding-elements).
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](/manual/api/reference_commentary#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](/manual/api/reference_commentary#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](/manual/api/reference_commentary#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](/manual/api/reference_commentary#property-behavior):
- *sola lettura*|
|urls|array|URL dell'elemento della mappa.
L'oggetto URL dell'elemento della mappa è [descritto in dettaglio di seguito](object#map-element-url).|
|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.|
[comment]: # ({/7e910fc4-c7b92dfc})
[comment]: # ({850c4220-305dd3e0})
#### Elemento mappa Host
L'oggetto elemento mappa Host definisce un elemento host.
|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|hostid|ID|ID dell'host.|
[comment]: # ({/850c4220-305dd3e0})
[comment]: # ({d8f65e8c-e1118d67})
#### Elemento mappa Gruppo host
L'oggetto elemento mappa Gruppo host definisce un elemento di gruppo host.
|Proprietà|[Type](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|groupid|ID|ID del gruppo host.|
[comment]: # ({/d8f65e8c-e1118d67})
[comment]: # ({b29a15a2-2d745dcc})
#### Oggetto elemento mappa Mappa
L'oggetto elemento mappa Mappa definisce un elemento della mappa.
|Proprietà|[Type](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|sysmapid|ID|ID della mappa.|
[comment]: # ({/b29a15a2-2d745dcc})
[comment]: # ({d5e7bb17-0283fd46})
#### Elemento mappa Trigger
L'oggetto elemento mappa Trigger definisce uno o più elementi trigger.
|Proprietà|[Type](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|triggerid|ID|ID del trigger.|
[comment]: # ({/d5e7bb17-0283fd46})
[comment]: # ({1ac46cd0-a7495119})
#### Tag dell'elemento della mappa
L'oggetto Tag dell'elemento della mappa ha le seguenti proprietà.
|Proprietà|[Type](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|tag|string|Nome del tag dell'elemento della mappa.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *obbligatorio*|
|operator|integer|[Operatore](/manual/config/visualization/maps/map#adding-elements) 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.|
[comment]: # ({/1ac46cd0-a7495119})
[comment]: # ({2860936e-5a112b10})
#### 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](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|sysmapelementurlid|ID|ID dell'URL dell'elemento della mappa.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *sola lettura*|
|name|string|Didascalia del collegamento.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *obbligatorio*|
|url|string|URL del collegamento.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *obbligatorio*|
|selementid|ID|ID dell'elemento della mappa a cui appartiene l'URL.|
[comment]: # ({/2860936e-5a112b10})
[comment]: # ({c9655668-1e44fd2a})
### Link della mappa
L'oggetto link della mappa definisce un collegamento tra due elementi della mappa. Ha le
seguenti proprietà.
|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|linkid|ID|ID del link della mappa.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*|
|selementid1|ID|ID del primo elemento della mappa collegato a un'estremità.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required*|
|selementid2|ID|ID del primo elemento della mappa collegato all'altra estremità.
[Property behavior](/manual/api/reference_commentary#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](object#map-link-trigger).|
|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.|
[comment]: # ({/c9655668-1e44fd2a})
[comment]: # ({bdfb641c-219c2bce})
#### 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](/manual/api/reference_commentary#data-types)|Description|
|--|--|--|
|linktriggerid|ID|ID del trigger del collegamento della mappa.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*|
|triggerid|ID|ID del trigger usato come indicatore del collegamento.
[Property behavior](/manual/api/reference_commentary#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.|
[comment]: # ({/bdfb641c-219c2bce})
[comment]: # ({8b7be8a6-96c2bee0})
### 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](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|sysmapurlid|ID|ID dell'URL della mappa.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *sola lettura*|
|name|string|Didascalia del collegamento.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *obbligatoria*|
|url|string|URL del collegamento.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *obbligatoria*|
|elementtype|integer|Tipo di elemento della mappa per il quale l'URL sarà disponibile.
Fare riferimento alla [proprietà `type` dell'elemento della mappa](object#map-element) per un elenco dei tipi supportati.
Predefinito: 0.|
|sysmapid|ID|ID della mappa a cui appartiene l'URL.|
[comment]: # ({/8b7be8a6-96c2bee0})
[comment]: # ({385d7255-942f03ad})
### Utente della mappa
Elenco dei permessi della mappa in base agli utenti. Ha le seguenti proprietà:
|Proprietà|[Type](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|sysmapuserid|ID|ID dell'utente della mappa.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *sola lettura*|
|userid|ID|ID dell'utente.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *obbligatoria*|
|permission|integer|Tipo di livello di permesso.
Valori possibili:
2 - sola lettura;
3 - lettura-scrittura.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *obbligatoria*|
[comment]: # ({/385d7255-942f03ad})
[comment]: # ({adad1979-f6e63a8f})
### Gruppo utenti della mappa
Elenco dei permessi della mappa in base ai gruppi utenti. Ha le seguenti
proprietà:
|Proprietà|[Tipo](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|sysmapusrgrpid|ID|ID del gruppo utenti della mappa.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *sola lettura*|
|usrgrpid|ID|ID del gruppo utenti.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *obbligatoria*|
|permission|integer|Tipo di livello di permesso.
Valori possibili:
2 - sola lettura;
3 - lettura-scrittura.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *obbligatoria*|
[comment]: # ({/adad1979-f6e63a8f})
[comment]: # ({6cdb0526-9d0acde7})
### 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](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|sysmap\_shapeid|ID|ID dell'elemento forma della mappa.
[Property behavior](/manual/api/reference_commentary#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](/manual/api/reference_commentary#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.|
[comment]: # ({/6cdb0526-9d0acde7})
[comment]: # ({a3759606-b1536eee})
### Linee della mappa
L'oggetto linea della mappa definisce una linea visualizzata su una mappa. Ha le
seguenti proprietà:
|Proprietà|[Type](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|sysmap\_shapeid|ID|ID dell'elemento forma della mappa.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *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.|
[comment]: # ({/a3759606-b1536eee})