Documentation
Table of Contents
Објекат мапе
Следећи објекти су директно повезани са map API-јем.
Мапа
Објекат мапе има следећа својства.
| Property | Type | Description |
|---|---|---|
| sysmapid | ID | ID мапе. Понашање својства: - само за читање - потребно за операције ажурирања |
| height | integer | Висина мапе у пикселима. Понашање својства: - потребно за операције креирања |
| name | string | Назив мапе. Понашање својства: - обавезно за операције креирања |
| width | integer | Ширина мапе у пикселима. Понашање својства: - обавезно за операције креирања |
| backgroundid | ID | ID слике која се користи као позадина за мапу. |
| background_scale | integer | Да ли да се омогући пропорционално скалирање позадинске слике. Могуће вредности: 0 - онемогући скалирање; 1 - (подразумевано) омогући скалирање слике. |
| expand_macros | integer | Да ли проширити макрое у ознакама приликом конфигурисања мапе. Могуће вредности: 0 - (подразумевано) не проширивати макрое; 1 - проширити макрое. |
| expandproblem | integer | Да ли ће се окидач проблема приказивати за елементе са једним проблемом. Могуће вредности: 0 - увек приказивати број проблема; 1 - (подразумевано) приказати окидач проблема ако постоји само један проблем. |
| grid_align | integer | Да ли омогућити поравнање мреже. Могуће вредности: 0 - онемогућити поравнање мреже; 1 - (подразумевано) омогућити поравнање мреже. |
| grid_show | integer | Да ли да се мрежа прикаже на мапи. Могуће вредности: 0 - не приказуј мрежу; 1 - (подразумевано) прикажи мрежу. |
| grid_size | integer | Величина мреже мапе у пикселима. Подржане вредности: 20, 40, 50, 75 и 100. Подразумевано: 50. |
| highlight | integer | Да ли је истицање икона омогућено. Могуће вредности: 0 - истицање онемогућено; 1 - (подразумевано) истицање омогућено. |
| iconmapid | ID | ID мапе икона које се користе на мапи. |
| label_format | integer | Да ли да се омогуће напредне ознаке. Могуће вредности: 0 - (подразумевано) онемогући напредне ознаке; 1 - омогући напредне ознаке. |
| label_location | integer | Локација ознаке елемента мапе. Могуће вредности: 0 - (подразумевано) доле; 1 - лево; 2 - десно; 3 - горе. |
| label_string_host | string | Прилагођена ознака за елементе хоста. Понашање својства: - обавезно ако је label_type_host подешено на "прилагођено" |
| label_string_hostgroup | string | Прилагођена ознака за елементе групе хостова. Понашање својства: - обавезно ако је label_type_hostgroup подешено на "прилагођено" |
| label_string_image | string | Прилагођена ознака за елементе слике. Понашање својства: - обавезно ако је label_type_image подешено на "custom" |
| label_string_map | string | Прилагођена ознака за елементе мапе. Понашање својства: - обавезно ако је label_type_map подешено на "custom" |
| label_string_trigger | string | Прилагођена ознака за елементе окидача. Понашање својства: - обавезно ако је label_type_trigger подешено на "custom" |
| label_type | integer | Тип ознаке елемента мапе. Могуће вредности: 0 - ознака; 1 - IP адреса; 2 - (подразумевано) назив елемента; 3 - само статус; 4 - ништа. |
| label_type_host | integer | Тип ознаке за елементе хоста. Могуће вредности: 0 - ознака; 1 - IP адреса; 2 - (подразумевано) назив елемента; 3 - само статус; 4 - ништа; 5 - прилагођено. |
| label_type_hostgroup | integer | Тип ознаке за елементе групе хостова. Могуће вредности: 0 - ознака; 2 - (подразумевано) назив елемента; 3 - само статус; 4 - ништа; 5 - прилагођено. |
| label_type_image | integer | Тип ознаке за елементе групе хостова. Могуће вредности: 0 - ознака; 2 - (подразумевано) назив елемента; 4 - ништа; 5 - прилагођено. |
| label_type_map | integer | Тип ознаке за елементе мапе. Могуће вредности: 0 - ознака; 2 - (подразумевано) назив елемента; 3 - само статус; 4 - ништа; 5 - прилагођено. |
| label_type_trigger | integer | Тип ознаке за елементе окидача. Могуће вредности: 0 - ознака; 2 - (подразумевано) назив елемента; 3 - само статус; 4 - ништа; 5 - прилагођено. |
| markelements | integer | Да ли треба истаћи елементе мапе који су недавно променили свој статус. Могуће вредности: 0 - (подразумевано) не истичу елементе; 1 - истичу елементи. |
| severity_min | integer | Минимална озбиљност окидача који ће бити приказани на мапи. Погледајте својство trigger severity за листу подржаних озбиљности окидача. |
| show_element_label | integer | Како подразумевано приказати ознаке елемената. Могуће вредности: 0 - увек приказивати; 1 - (подразумевано) аутоматски сакривати. |
| show_link_label | integer | Како подразумевано приказати ознаке веза. Могуће вредности: 0 - увек приказивати; 1 - (подразумевано) аутоматски сакривати. |
| show_unack | integer | Како треба приказивати проблеме. Могуће вредности: 0 - (подразумевано) прикажи број свих проблема; 1 - прикажи само број непотврђених проблема; 2 - прикажи број потврђених и непотврђених проблема одвојено. |
| userid | ID | ID корисника који је власник мапе. |
| private | integer | Тип дељења мапе. Могуће вредности: 0 - јавна мапа; 1 - (подразумевано) приватна мапа. |
| show_suppressed | integer | Да ли се приказују потиснути проблеми. Могуће вредности: 0 - (подразумевано) сакриј потиснуте проблеме; 1 - прикажи потиснуте проблеме. |
Елемент мапе
Објекат елемента мапе дефинише објекат приказан на мапи. Има следећа својства.
| Property | Type | Description |
|---|---|---|
| selementid | ID | ID елемента мапе. Понашање својства: - само за читање |
| elements | array | Елемент објекат података. Понашање својства: - обавезно ако је elementtype подешено на "host", "map", "trigger" или "host group" |
| elementtype | integer | Тип елемента мапе. Могуће вредности: 0 - хост; 1 - мапа; 2 - окидач; 3 - група домаћина; 4 - слика. Понашање својства: - обавезно |
| iconid_off | ID | ID слике која се користи за приказивање елемента у подразумеваном стању. Понашање својства: - обавезно |
| areatype | integer | Како треба приказивати домаћине посебне групе домаћина. Могуће вредности: 0 - (подразумевано) елемент групе домаћина ће заузети целу мапу; 1 - елемент групе хостова ће имати фиксну величину. |
| elementsubtype | integer | Како елемент групе домаћина треба да се приказује на мапи. Могуће вредности: 0 - (подразумевано) прикажи групу хостова као један елемент; 1 - прикажи сваки хост у групи засебно. |
| evaltype | integer | Метод за процену услова филтрирања ознака елемента мапе. Могуће вредности: 0 - (подразумевано) И / ИЛИ; 2 - ИЛИ. |
| height | integer | Висина елемента групе домаћина фиксне величине у пикселима. Подразумевано: 200. |
| iconid_disabled | ID | ID слике која се користи за приказивање онемогућених елемената мапе. Понашање својства: - подржано ако је elementtype подешено на "host", "map", "trigger" или "host group" |
| iconid_maintenance | ID | ID слике која се користи за приказивање елемената мапе у одржавању. Понашање својства: - подржано ако је elementtype подешено на "host", "map", "trigger" или "host group" |
| iconid_on | ID | ID слике која се користи за приказивање елемената мапе са проблемима. Понашање својства: - подржано ако је elementtype подешено на "host", "map", "trigger" или "host group" |
| label | string | Ознака елемента. |
| label_location | integer | Локација ознаке елемента мапе. Могуће вредности: -1 - (подразумевано) подразумевана локација; 0 - доле; 1 - лево; 2 - десно; 3 - горе. |
| permission | integer | Тип нивоа дозволе. Могуће вредности: -1 - нема; 2 - само за читање; 3 - читање-писање. |
| show_label | integer | Како приказати ознаку елемента. Могуће вредности: -1 - (подразумевано) подразумевана локација мапе; 0 - увек приказуј; 1 - аутоматски сакриј. |
| sysmapid | ID | ID мапе којој елемент припада. Понашање својства: - само за читање |
| urls | array | URL-ови елемената мапе. Објекат URL-а елемента мапе је детаљно описан у наставку. |
| use_iconmap | integer | Да ли се мапирање икона мора користити за елементе домаћина. Могуће вредности: 0 - не користити мапирање икона; 1 - (подразумевано) користити мапирање икона. |
| viewtype | integer | Алгоритам за постављање елемената групе хостова. Могуће вредности: 0 - (подразумевано) мрежа. |
| width | integer | Ширина елемента групе хостова фиксне величине у пикселима. Подразумевано: 200. |
| x | integer | X-координате елемента у пикселима. Подразумевано: 0. |
| y | integer | Y-координате елемента у пикселима. Подразумевано: 0. |
| zindex | integer | Вредност која се користи за уређивање елемената мапе (z-index). Подразумевано: 0. |
Елемент мапе Домаћина
Објекат елемента мапе Домаћина дефинише један елемент домаћина.
| Property | Type | Description |
|---|---|---|
| hostid | ID | ID домаћина. |
Елемент мапе Група домаћина
Објекат елемента групе домаћина дефинише један елемент групе домаћина.
| Property | Type | Description |
|---|---|---|
| groupid | ID | ID групе домаћина. |
Елемент мапе Мапа
Објекат елемента мапе дефинише један елемент мапе.
| Property | Type | Description |
|---|---|---|
| sysmapid | ID | ID мапе. |
Елемент мапе Окидача
Објекат Окидача елемента мапе дефинише један или више елемената окидача.
| Property | Type | Description |
|---|---|---|
| triggerid | ID | ID окидача. |
Ознака елемента мапе
Објекат ознаке елемента мапе има следећа својства.
| Property | Type | Description |
|---|---|---|
| tag | string | Назив ознаке елемента мапе. Понашање својства: - обавезно |
| operator | integer | Оператор услова ознаке елемента мапе. Могуће вредности: 0 - (подразумевано) Садржи; 1 - Једнако; 2 - Не садржи;<br >3 – није једнако; 4 – постоји; 5 – не постоји. |
| value | string | Вредност ознаке елемента мапе. |
URL елемента мапе
URL објекат елемента мапе дефинише кликабилну везу која ће бити доступна за одређени елемент мапе. Има следећа својства:
| Property | Type | Description |
|---|---|---|
| sysmapelementurlid | ID | ID URL-а елемента мапе. Понашање својства: - само за читање |
| name | string | Наслов везе. Понашање својства: - обавезно |
| url | string | URL линка. Понашање својства: - обавезно |
| selementid | ID | ID елемента мапе коме URL припада. |
Линк мапе
Објекат везе мапе дефинише везу између два елемента mape. Има следећа својства.
| Property | Type | Description |
|---|---|---|
| linkid | ID | ID везе мапе. Понашање својства: - само за читање |
| selementid1 | ID | ID првог елемента мапе повезаног на крају. Понашање својства: - обавезно |
| selementid2 | ID | ID првог елемента мапе повезаног на другом крају. Понашање својства: - обавезно |
| color | string | Боја линије као хексадецимални код боје. Подразумевано: 000000. |
| дdrawtype | integer | Стил цртања линије везе. Могуће вредности: 0 - (подразумевано) линија; 2 - подебљана линија; 3 - тачкаста линија; 4 - испрекидана линија. |
| label | string | ознака везе. |
| linktriggers | array | Окидачи линкова мапе који се користе као индикатори статуса везе. Објекат окидача везе мапе је детаљно описан испод. |
| permission | integer | Тип нивоа дозволе. Могуће вредности: -1 - ниједна; 2 - само за читање; 3 - читање-писање. |
| sysmapid | ID | ID мапе којој веза припада. |
Окидач везе на мапи
Објекат окидача везе мапе дефинише индикатор статуса везе на мапи на основу стања окидача. Има следећа својства:
| Property | Type | Description |
|---|---|---|
| linktriggerid | ID | ID окидача везе мапе. Понашање својства: - само за читање |
| triggerid | ID | ID окидача који се користи као индикатор везе. Понашање својства: - обавезно |
| color | string | Боја индикатора као хексадецимални код боје. Подразумевано: DD0000. |
| drawtype | integer | Стил цртања индикатора. Могуће вредности: 0 - (подразумевано) линија; 2 - подебљана линија; 3 - тачкаста линија; 4 - испрекидана линија. |
| linkid | ID | ID везе мапе којој окидач везе припада. |
Индикатори линкова мапе
Објекат индикатора линкова мапе дефинише индикатор статуса линка мапе на основу вредности ставке. Има следећа својства:
| Property | Type | Description |
|---|---|---|
| pattern | string | Регуларни израз за поређење. Доступно само за истакнуте делове. |
| ortorder | integer | Користи се за дефинисање редоследа сортирања истакнутих делова. Доступно само за истакнуте делове. |
| threshold | string | Нумеричка вредност за поређење. Доступно само за прагове. |
| drawtype | integer | Стил цртања индикатора. Могуће вредности: 0 - (подразумевано) линија; 2 - подебљана линија; 3 - испрекидана линија; 4 - испрекидана линија. |
| color | string | Боја индикатора као хексадецимални код боје. Подразумевано: DD0000.Понашање својства: - обавезно |
URL мапе
URL објекат мапе дефинише кликабилну везу за коју ће бити доступни сви елементи одређеног типа на мапи. Има следећа својства:
| Property | Type | Description |
|---|---|---|
| sysmapurlid | ID | ID URL адресе мапе. Понашање својства: - само за читање |
| name | string | Наслов везе. Понашање својства: - обавезно |
| url | string | URL веза. Понашање својства: - обавезно |
| elementtype | integer | Тип елемента мапе за који ће URL бити доступан. Погледајте својство type елемента мапе за листу подржаних типова.Подразумевано: 0. |
| sysmapid | ID | ID мапе којој URL припада. |
Корисник мапе
Листа дозвола за мапу на основу корисника. Има следећа својства:
| Property | Type | Description |
|---|---|---|
| sysmapuserid | ID | ID корисника мапе. Понашање својства: - само за читање |
| userid | ID | ID корисника. Понашање својства: - обавезно |
| permission | integer | Тип нивоа дозволе. Могуће вредности: 2 - само за читање; 3 - читање-писање. Понашање својства: - обавезно |
Корисничка група мапе
Листа дозвола за мапу на основу корисничких група. Има следећа својства:
| Property | Type | Description |
|---|---|---|
| sysmapuserid | ID | ID корисничке групе мапе. Понашање својства: - само за читање |
| userid | ID | ID корисничке групњ. Понашање својства: - обавезно |
| permission | integer | Тип нивоа дозволе. Могуће вредности: 2 - само за читање; 3 - читање-писање. Понашање својства: - обавезно |
Облици мапе
Објекат облика мапе дефинише геометријски облик (са или без текста) приказан на мапи. Има следећа својства:
| Property | Type | Description |
|---|---|---|
| sysmap_shapeid | ID | ID елемента облика мапе. Понашање својства: - само за читање |
| type | integer | Тип елемента облика мапе. Могуће вредности: 0 - правоугаоник; 1 - елипса. Својство је потребно када се креирају нови облици. Понашање својства: - обавезно |
| x | integer | X-координате облика у пикселима. Подразумевано: 0. |
| y | integer | Y-координате облика у пикселима. Подразумевано: 0. |
| width | integer | Ширина облика у пикселима. Подразумевано: 200. |
| height | integer | Висина облика у пикселима. Подразумевано: 200. |
| text | string | Текст облика. |
| font | integer | Фонт текста унутар облика. Могуће вредности: 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 Подразумевано: 9. |
| font_size | integer | Величина фонта у пикселима. Подразумевано: 11. |
| font_color | string | Боја фонта. Подразумевано: 000000. |
| text_halign | integer | Хоризонтално поравнање текста. Могуће вредности: 0 - центар; 1 - лево; 2 - десно. Подразумевано: 0. |
| text_valign | integer | Вертикално поравнање текста. Могуће вредности: 0 - средина; 1 - горе; 2 - доле. Подразумевано: 0. |
| border_type | integer | Тип ивице. Могуће вредности: 0 - ниједна; 1 - —————;2 - ·····;3 - - - -.Подразумевано: 0. |
| border_width | integer | Ширина ивице у пикселима. Подразумевано: 0. |
| border_color | string | Боја ивице. Подразумевано: 000000. |
| background_color | string | Боја позадине (боја попуне). Подразумевано: (empty). |
| zindex | integer | Вредност која се користи за редослед свих облика и линија (з-индекс). Подразумевано: 0. |
Линије мапе
Објекат линије мапе дефинише линију приказану на мапи. Има следећа својства:
| Property | Type | Description |
|---|---|---|
| sysmap_shapeid | ID | ID елемента облика мапе. Понашање својства: - само за читање |
| x1 | integer | X-координате линије 1 у пикселима. Подразумевано: 0. |
| y1 | integer | Y-координате линије 1 у пикселима. Подразумевано: 0. |
| x2 | integer | X-координате линије 2 у пикселима. Подразумевано: 200. |
| y2 | integer | Y-координате линије 2 у пикселима. Подразумевано: 200. |
| line_type | integer | Тип линија. Могуће вредности: 0 - ниједна; 1 - —————;2 - ·····;3 - - - -.Подразумевано: 0. |
| line_width | integer | Ширина линија у пикселима. Подразумевано: 0. |
| line_color | string | Боја линије. Подразумевано: 000000. |
| zindex | integer | Вредност која се користи за редослед свих облика и линија (з-индекс). Подразумевано: 0. |