Documentation
Table of Contents
Објекат мапе
Следећи објекти су директно повезани са map API-јем.
Мапа
Објекат мапе има следећа својства.
| Property | Type | Description |
|---|---|---|
| sysmapid | ID | ID мапе. Понашање својства: - само за читање - обавезно за операције ажурирања |
| height | integer | Висина мапе у пикселима. Понашање својства: - потребно за операције креирања |
| name | string | Назив мапе. Понашање својства: - потребно за операције креирања |
| width | integer | Ширина мапе у пикселима. Понашање својства: - потребно за операције креирања |
| backgroundid | ID | ID слике која се користи као позадина за мапу. |
| 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 - десно;< br>3 - горе. |
| label_string_host | string | Прилагођена ознака за елементе домаћина. Понашање својства: - обавезно ако је label_type_host постављен на "прилагођено" |
| label_string_hostgroup | string | Прилагођена ознака за елементе групе домаћина. Понашање својства: - обавезно ако је label_type_host подешено на "прилагођено" |
| label_string_image | string | Прилагођена ознака за елементе слике. Понашање својства: - обавезно ако је label_type_image постављено на "прилагођено" |
| label_string_map | string | Прилагођена ознака за елементе мапе. Понашање својства: - обавезно ако је label_type_map постављено на "прилагођено" |
| label_string_trigger | string | Прилагођена ознака за елементе окидача. Понашање својства: - обавезно ако је label_type_trigger постављено на "прилагођено" |
| 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 | Минимална озбиљност окидача који ће бити приказани на мапи. Погледајте особина severity окидача за листу подржаних озбиљности окидача. |
| 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 подешен на "домаћин", "мапа", "окидач" или "група домаћина" |
| elementtype | integer | Тип елемента мапе. Могуће вредности: 0 - домаћин; 1 - мапа; 2 - окидач; 3 - група домаћина;<br >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 подешен на "домаћин", "мапа", "окидач" или "група домаћина" |
| iconid_maintenance | ID | ID слике која се користи за приказ елемената мапе у одржавању. Понашање својства: - подржано ако elementtype је подешен на "домаћин", "мапа", "окидач" или "група домаћина" |
| iconid_on | ID | ID слике која се користи за приказ елемената мапе са проблемима. Понашање својства: - подржано ако elementtype подешен на "домаћин", "мапа", "окидач" или "група домаћина" |
| label | string | Ознака елемента. |
| label_location | integer | Локација ознаке елемента мапе. Могуће вредности: -1 - (подразумевано) подразумевана локација; 0 - доле; 1 - лево ; 2 - десно; 3 - горе. |
| permission | integer | Тип нивоа дозволе. Могуће вредности: -1 - ниједна; 2 - само за читање; 3 - читање-писање. |
| 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. |
Елемент мапе Домаћина
Објекат елемента мапе Домаћина дефинише један елемент домаћина.
| 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 везе мапе којој окидач везе припада. |
Map link indicators
The map link indicators object defines a map link status indicator based on the item value. It has the following properties:
| Property | Type | Description |
|---|---|---|
| pattern | string | Regular expression to compare against. Available only for highlights. |
| sortorder | integer | Used for defining the sort order of highlights. Available only for highlights. |
| threshold | string | Numeric value to compare against. Available only for thresholds. |
| drawtype | integer | Indicator draw style. Possible values: 0 - (default) line; 2 - bold line; 3 - dotted line; 4 - dashed line. |
| color | string | Indicator color as a hexadecimal color code. Default: DD0000.Property behavior: - required |
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. |