Obiekt mapy

Następujące obiekty są bezpośrednio powiązane z API map.

Mapa

Obiekt mapy ma następujące właściwości.

Property Type Description
sysmapid ID ID mapy.

Zachowanie właściwości:
- tylko do odczytu
- wymagane dla operacji aktualizacji
height integer Wysokość mapy w pikselach.

Zachowanie właściwości:
- wymagane dla operacji tworzenia
name string Nazwa mapy.

Zachowanie właściwości:
- wymagane dla operacji tworzenia
width integer Szerokość mapy w pikselach.

Zachowanie właściwości:
- wymagane dla operacji tworzenia
backgroundid ID ID obrazu używanego jako tło mapy.
expand_macros integer Określa, czy rozwijać makra w etykietach podczas konfigurowania mapy.

Możliwe wartości:
0 - (domyślnie) nie rozwijaj makr;
1 - rozwijaj makra.
expandproblem integer Określa, czy wyzwalacz problemu będzie wyświetlany dla elementów z pojedynczym problemem.

Możliwe wartości:
0 - zawsze wyświetlaj liczbę problemów;
1 - (domyślnie) wyświetlaj wyzwalacz problemu, jeśli występuje tylko jeden problem.
grid_align integer Określa, czy włączyć wyrównywanie do siatki.

Możliwe wartości:
0 - wyłącz wyrównywanie do siatki;
1 - (domyślnie) włącz wyrównywanie do siatki.
grid_show integer Określa, czy wyświetlać siatkę na mapie.

Możliwe wartości:
0 - nie wyświetlaj siatki;
1 - (domyślnie) wyświetlaj siatkę.
grid_size integer Rozmiar siatki mapy w pikselach.

Obsługiwane wartości: 20, 40, 50, 75 i 100.

Domyślnie: 50.
highlight integer Określa, czy włączone jest podświetlanie ikon.

Możliwe wartości:
0 - podświetlanie wyłączone;
1 - (domyślnie) podświetlanie włączone.
iconmapid ID ID mapy ikon używanej na mapie.
label_format integer Określa, czy włączyć zaawansowane etykiety.

Możliwe wartości:
0 - (domyślnie) wyłącz zaawansowane etykiety;
1 - włącz zaawansowane etykiety.
label_location integer Położenie etykiety elementu mapy.

Możliwe wartości:
0 - (domyślnie) dół;
1 - lewo;
2 - prawo;
3 - góra.
label_string_host string Niestandardowa etykieta dla elementów host.

Zachowanie właściwości:
- wymagane jeśli label_type_host ma ustawioną wartość "custom"
label_string_hostgroup string Niestandardowa etykieta dla elementów grupy hostów.

Zachowanie właściwości:
- wymagane jeśli label_type_hostgroup ma ustawioną wartość "custom"
label_string_image string Niestandardowa etykieta dla elementów obrazu.

Zachowanie właściwości:
- wymagane jeśli label_type_image ma ustawioną wartość "custom"
label_string_map string Niestandardowa etykieta dla elementów mapy.

Zachowanie właściwości:
- wymagane jeśli label_type_map ma ustawioną wartość "custom"
label_string_trigger string Niestandardowa etykieta dla elementów wyzwalacza.

Zachowanie właściwości:
- wymagane jeśli label_type_trigger ma ustawioną wartość "custom"
label_type integer Typ etykiety elementu mapy.

Możliwe wartości:
0 - etykieta;
1 - adres IP;
2 - (domyślnie) nazwa elementu;
3 - tylko status;
4 - nic.
label_type_host integer Typ etykiety dla elementów host.

Możliwe wartości:
0 - etykieta;
1 - adres IP;
2 - (domyślnie) nazwa elementu;
3 - tylko status;
4 - nic;
5 - niestandardowa.
label_type_hostgroup integer Typ etykiety dla elementów grupy hostów.

Możliwe wartości:
0 - etykieta;
2 - (domyślnie) nazwa elementu;
3 - tylko status;
4 - nic;
5 - niestandardowa.
label_type_image integer Typ etykiety dla elementów grupy hostów.

Możliwe wartości:
0 - etykieta;
2 - (domyślnie) nazwa elementu;
4 - nic;
5 - niestandardowa.
label_type_map integer Typ etykiety dla elementów mapy.

Możliwe wartości:
0 - etykieta;
2 - (domyślnie) nazwa elementu;
3 - tylko status;
4 - nic;
5 - niestandardowa.
label_type_trigger integer Typ etykiety dla elementów wyzwalacza.

Możliwe wartości:
0 - etykieta;
2 - (domyślnie) nazwa elementu;
3 - tylko status;
4 - nic;
5 - niestandardowa.
markelements integer Określa, czy podświetlać elementy mapy, które niedawno zmieniły swój status.

Możliwe wartości:
0 - (domyślnie) nie podświetlaj elementów;
1 - podświetlaj elementy.
severity_min integer Minimalny poziom ważności wyzwalaczy, które będą wyświetlane na mapie.

Zapoznaj się z właściwością trigger severity, aby uzyskać listę obsługiwanych poziomów ważności wyzwalaczy.
show_unack integer Sposób wyświetlania problemów.

Możliwe wartości:
0 - (domyślnie) wyświetlaj liczbę wszystkich problemów;
1 - wyświetlaj tylko liczbę niepotwierdzonych problemów;
2 - wyświetlaj osobno liczbę potwierdzonych i niepotwierdzonych problemów.
userid ID ID użytkownika będącego właścicielem mapy.
private integer Typ udostępniania mapy.

Możliwe wartości:
0 - mapa publiczna;
1 - (domyślnie) mapa prywatna.
show_suppressed integer Określa, czy wyświetlane są wyciszone problemy.

Możliwe wartości:
0 - (domyślnie) ukryj wyciszone problemy;
1 - wyświetl wyciszone problemy.

Element mapy

Obiekt elementu mapy definiuje obiekt wyświetlany na mapie. Ma on następujące właściwości.

Property Type Description
selementid ID ID elementu mapy.

Zachowanie właściwości:
- tylko do odczytu
elements array Obiekt danych Element.

Zachowanie właściwości:
- wymagane jeśli elementtype jest ustawione na "host", "map", "trigger" lub "host group"
elementtype integer Typ elementu mapy.

Możliwe wartości:
0 - host;
1 - map;
2 - trigger;
3 - host group;
4 - image.

Zachowanie właściwości:
- wymagane
iconid_off ID ID obrazu używanego do wyświetlania elementu w stanie domyślnym.

Zachowanie właściwości:
- wymagane
areatype integer Sposób wyświetlania oddzielnych hostów grupy hostów.

Możliwe wartości:
0 - (domyślnie) element grupy hostów zajmie całą mapę;
1 - element grupy hostów będzie miał stały rozmiar.
elementsubtype integer Sposób wyświetlania elementu grupy hostów na mapie.

Możliwe wartości:
0 - (domyślnie) wyświetl grupę hostów jako pojedynczy element;
1 - wyświetl każdy host w grupie osobno.
evaltype integer Metoda oceny warunku filtrowania tagów elementu mapy evaluation method.

Możliwe wartości:
0 - (domyślnie) And/Or;
2 - Or.
height integer Wysokość elementu grupy hostów o stałym rozmiarze w pikselach.

Domyślnie: 200.
iconid_disabled ID ID obrazu używanego do wyświetlania wyłączonych elementów mapy.

Zachowanie właściwości:
- obsługiwane jeśli elementtype jest ustawione na "host", "map", "trigger" lub "host group"
iconid_maintenance ID ID obrazu używanego do wyświetlania elementów mapy w trybie maintenance.

Zachowanie właściwości:
- obsługiwane jeśli elementtype jest ustawione na "host", "map", "trigger" lub "host group"
iconid_on ID ID obrazu używanego do wyświetlania elementów mapy z problemami.

Zachowanie właściwości:
- obsługiwane jeśli elementtype jest ustawione na "host", "map", "trigger" lub "host group"
label string Etykieta elementu.
label_location integer Położenie etykiety elementu mapy.

Możliwe wartości:
-1 - (domyślnie) położenie domyślne;
0 - dół;
1 - lewo;
2 - prawo;
3 - góra.
permission integer Typ poziomu uprawnień.

Możliwe wartości:
-1 - brak;
2 - tylko do odczytu;
3 - odczyt i zapis.
sysmapid ID ID mapy, do której należy element.

Zachowanie właściwości:
- tylko do odczytu
urls array Adresy URL elementu mapy.

Obiekt URL elementu mapy jest opisany szczegółowo poniżej.
use_iconmap integer Czy mapowanie ikon musi być używane dla elementów hostów.

Możliwe wartości:
0 - nie używaj mapowania ikon;
1 - (domyślnie) używaj mapowania ikon.
viewtype integer Algorytm rozmieszczania elementu grupy hostów.

Możliwe wartości:
0 - (domyślnie) siatka.
width integer Szerokość elementu grupy hostów o stałym rozmiarze w pikselach.

Domyślnie: 200.
x integer Współrzędna X elementu w pikselach.

Domyślnie: 0.
y integer Współrzędna Y elementu w pikselach.

Domyślnie: 0.

Element mapy Host

Obiekt elementu mapy Host definiuje jeden element hosta.

Właściwość Typ Opis
hostid ID ID hosta.

Element mapy Grupa hostów

Obiekt elementu mapy Grupa hostów definiuje jeden element grupy hostów.

Właściwość Typ Opis
groupid ID ID grupy hostów.

Obiekt elementu mapy Map

Obiekt elementu mapy Map definiuje jeden element mapy.

Właściwość Type Opis
sysmapid ID ID mapy.

Wyzwalacz elementu mapy

Obiekt wyzwalacza elementu mapy definiuje jeden lub więcej elementów wyzwalacza.

Właściwość Type Opis
triggerid ID ID wyzwalacza.

Tag elementu mapy

Obiekt Tag elementu mapy ma następujące właściwości.

Właściwość Typ Opis
tag string Nazwa tagu elementu mapy.

Zachowanie właściwości:
- wymagane
operator integer Warunek operatora tagu elementu mapy.

Możliwe wartości:
0 - (domyślnie) Zawiera;
1 - Równa się;
2 - Nie zawiera;
3 - Nie równa się;
4 - Istnieje;
5 - Nie istnieje.
value string Wartość tagu elementu mapy.

URL elementu mapy

Obiekt URL elementu mapy definiuje klikalny link, który będzie dostępny dla określonego elementu mapy. Ma następujące właściwości:

Właściwość Typ Opis
sysmapelementurlid ID ID URL elementu mapy.

Zachowanie właściwości:
- tylko do odczytu
name string Podpis linku.

Zachowanie właściwości:
- wymagane
url string URL linku.

Zachowanie właściwości:
- wymagane
selementid ID ID elementu mapy, do którego należy URL.

Obiekt linku mapy definiuje połączenie między dwoma elementami mapy. Ma on następujące właściwości.

Property Type Description
linkid ID ID linku mapy.

Property behavior:
- read-only
selementid1 ID ID pierwszego elementu mapy połączonego na jednym końcu.

Property behavior:
- required
selementid2 ID ID pierwszego elementu mapy połączonego na drugim końcu.

Property behavior:
- required
color string Kolor linii jako kod koloru szesnastkowego.

Domyślnie: 000000.
drawtype integer Styl rysowania linii linku.

Possible values:
0 - (default) line;
2 - bold line;
3 - dotted line;
4 - dashed line.
label string Etykieta linku.
linktriggers array Wyzwalacze linku mapy używane jako wskaźniki stanu linku.

Obiekt wyzwalacza linku mapy jest opisany szczegółowo poniżej.
permission integer Typ poziomu uprawnień.

Possible values:
-1 - none;
2 - read only;
3 - read-write.
sysmapid ID ID mapy, do której należy link.

Wyzwalacz łącza mapy

Obiekt wyzwalacza łącza mapy definiuje wskaźnik stanu łącza mapy na podstawie stanu wyzwalacza. Ma on następujące właściwości:

Property Type Description
linktriggerid ID ID wyzwalacza łącza mapy.

Property behavior:
- read-only
triggerid ID ID wyzwalacza używanego jako wskaźnik łącza.

Property behavior:
- required
color string Kolor wskaźnika jako szesnastkowy kod koloru.

Domyślnie: DD0000.
drawtype integer Styl rysowania wskaźnika.

Possible values:
0 - (default) line;
2 - bold line;
3 - dotted line;
4 - dashed line.
linkid ID ID łącza mapy, do którego należy wyzwalacz łącza.

URL mapy

Obiekt URL mapy definiuje klikalny link, który będzie dostępny dla wszystkich elementów określonego typu na mapie. Ma następujące właściwości:

Właściwość Typ Opis
sysmapurlid ID ID URL mapy.

Zachowanie właściwości:
- tylko do odczytu
name string Podpis linku.

Zachowanie właściwości:
- wymagane
url string URL linku.

Zachowanie właściwości:
- wymagane
elementtype integer Typ elementu mapy, dla którego URL będzie dostępny.

Listę obsługiwanych typów można znaleźć we właściwości type elementu mapy.

Domyślnie: 0.
sysmapid ID ID mapy, do której należy URL.

Użytkownik mapy

Lista uprawnień do mapy na podstawie użytkowników. Ma następujące właściwości:

Właściwość Typ Opis
sysmapuserid ID ID użytkownika mapy.

Zachowanie właściwości:
- tylko do odczytu
userid ID ID użytkownika.

Zachowanie właściwości:
- wymagane
permission integer Typ poziomu uprawnień.

Możliwe wartości:
2 - tylko do odczytu;
3 - odczyt-zapis.

Zachowanie właściwości:
- wymagane

Grupa użytkowników mapy

Lista uprawnień do mapy opartych na grupach użytkowników. Ma następujące właściwości:

Właściwość Type Opis
sysmapusrgrpid ID ID grupy użytkowników mapy.

Property behavior:
- tylko do odczytu
usrgrpid ID ID grupy użytkowników.

Property behavior:
- wymagane
permission integer Typ poziomu uprawnień.

Możliwe wartości:
2 - tylko do odczytu;
3 - odczyt-zapis.

Property behavior:
- wymagane

Kształty mapy

Obiekt kształtu mapy definiuje kształt geometryczny (z tekstem lub bez) wyświetlany na mapie. Ma następujące właściwości:

Właściwość Type Opis
sysmap_shapeid ID ID elementu kształtu mapy.

Zachowanie właściwości:
- tylko do odczytu
type integer Typ elementu kształtu mapy.

Możliwe wartości:
0 - prostokąt;
1 - elipsa.

Właściwość jest wymagana podczas tworzenia nowych kształtów.

Zachowanie właściwości:
- wymagane
x integer Współrzędne X kształtu w pikselach.

Domyślnie: 0.
y integer Współrzędne Y kształtu w pikselach.

Domyślnie: 0.
width integer Szerokość kształtu w pikselach.

Domyślnie: 200.
height integer Wysokość kształtu w pikselach.

Domyślnie: 200.
text string Tekst kształtu.
font integer Czcionka tekstu wewnątrz kształtu.

Możliwe wartości:
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

Domyślnie: 9.
font_size integer Rozmiar czcionki w pikselach.

Domyślnie: 11.
font_color string Kolor czcionki.

Domyślnie: 000000.
text_halign integer Wyrównanie poziome tekstu.

Możliwe wartości:
0 - środek;
1 - do lewej;
2 - do prawej.

Domyślnie: 0.
text_valign integer Wyrównanie pionowe tekstu.

Możliwe wartości:
0 - środek;
1 - góra;
2 - dół.

Domyślnie: 0.
border_type integer Typ obramowania.

Możliwe wartości:
0 - brak;
1 - —————;
2 - ·····;
3 - - - -.

Domyślnie: 0.
border_width integer Szerokość obramowania w pikselach.

Domyślnie: 0.
border_color string Kolor obramowania.

Domyślnie: 000000.
background_color string Kolor tła (kolor wypełnienia).

Domyślnie: (puste).
zindex integer Wartość używana do porządkowania wszystkich kształtów i linii (z-index).

Domyślnie: 0.

Linie mapy

Obiekt linii mapy definiuje linię wyświetlaną na mapie. Ma następujące właściwości:

Właściwość Typ Opis
sysmap_shapeid ID ID elementu kształtu mapy.

Zachowanie właściwości:
- tylko do odczytu
x1 integer Współrzędne X punktu 1 linii w pikselach.

Domyślnie: 0.
y1 integer Współrzędne Y punktu 1 linii w pikselach.

Domyślnie: 0.
x2 integer Współrzędne X punktu 2 linii w pikselach.

Domyślnie: 200.
y2 integer Współrzędne Y punktu 2 linii w pikselach.

Domyślnie: 200.
line_type integer Typ linii.

Możliwe wartości:
0 - brak;
1 - —————;
2 - ·····;
3 - - - -.

Domyślnie: 0.
line_width integer Szerokość linii w pikselach.

Domyślnie: 0.
line_color string Kolor linii.

Domyślnie: 000000.
zindex integer Wartość używana do porządkowania wszystkich kształtów i linii (z-index).

Domyślnie: 0.