[comment]: # ({38a58fd8-4df1faf7})
# 14 Host navigator

[comment]: # ({/38a58fd8-4df1faf7})

[comment]: # ({1c22a8ad-eca9765b})
### Опис

Ови параметри и могуће вредности својстава за одговарајуће објекте поља виџета контролне табле омогућавају конфигурисање
виџета [*Host navigator*](/manual/web_interface/frontend_sections/dashboards/widgets/host_navigator) у методама `dashboard.create` и `dashboard.update`.

::: noteimportant
Својства `fields` виџета се не проверавају током креирања или ажурирања контролне табле.
Ово омогућава корисницима да модификују [built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets) и креирају [custom widgets](/devel/modules/tutorials/widget), али такође уводи ризик од неправилног креирања или ажурирања виџета.
Да бисте осигурали успешно креирање или ажурирање виџета *Host navigator*, погледајте понашање параметара наведено у табелама испод.
:::

[comment]: # ({/1c22a8ad-eca9765b})

[comment]: # ({4d3dace7-1636ce04})
### Параметри

Следећи параметри су подржани за виџет *Хост навигатор*.

|Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|--------|--|--------|-------------------------------|
|*Refresh interval*|<|0|rf_rate|0 - Нема освежавања;<br>10 - 10 секунди;<br>30 - 30 секунди;<br>60 - *(подразумевано)* 1 минут;<br>120 - 2 минута;<br>600 - 10 минута;<br>900 - 15 минута.|
|*Host groups*|<|2|groupids.0|[Host group](/manual/api/reference/hostgroup/get) ID.<br><br>Напомена: Да бисте конфигурисали  више група домаћина, направите објекат поља виџета за сваку групу са увећаним бројем у имену својства.<br><br>Овај параметар није подржан ако се конфигурише виџет на [template dashboard](/manual/api/reference/templatedashboard/object).|
|<|*Host groups (Widget)*|1|groupids.\_reference|Уместо [Host group](/manual/api/reference/hostgroup/get) ID:<br>`ABCDE._hostgroupids` - поставите [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (са његовим параметром *Референца* постављеним на "`ABCDE`") као извор података за групе домаћина.<br><br>Овај параметар није подржан ако се виџет конфигурише на [template dashboard](/manual/api/reference/templatedashboard/object).|
|*Host patterns*|<|1|hosts.0|[Host](/manual/api/reference/host/get) име или образац.<br><br>Напомена: Да бисте конфигурисали више шаблона домаћина, направите објекат поља виџета за сваки шаблон домаћина са увећаним бројем у имену својства. За више шаблона домаћина, параметар *Група домаћина* уопште не мора бити конфигурисан или мора бити конфигурисан са најмање једном групом домаћина којој припадају домаћини који одговарају конфигурисаним обрасцима домаћина.<br><br>Овај параметар није подржан ако се конфигурише виџет на [template dashboard](/manual/api/reference/templatedashboard/object).|
|*Host status*|<|0|status|-1 - *(подразумевано)* Било који;<br>0 - Омогућено;<br>1 - Онемогућено.<br><br>Овај параметар није подржан ако се конфигурише виџет на [template dashboard](/manual/api/reference/templatedashboard/object).|
|*Host tags*|<|<|<|<|
|<|*Evaluation type*|0|host_tags_evaltype|0 - *(подразумевано)* И/Или;<бр>2 - Или.<br><br>Овај параметар није подржан ако се конфигурише виџет на [template dashboard](/manual/api/reference/templatedashboard/object).|
|^|*Tag name*|1|host_tags.0.tag|Било која вредност стринга.<br><br>Напомена: Број у имену својства упућује на редослед ознака у листи за процену ознака.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *обавезно* ако се конфигуришу *ознаке домаћина*<br><br>Овај параметар није подржан ако се виџет конфигурише на [template dashboard] (/manual/api/reference/templatedashboard/object).|
|^|*Operator*|0|host_tags.0.operator|0 - Садржи;<br>1 - Једнако;<br>2 - Не садржи;<br>3 - Није једнако;<br>4 - Постоји ;<br>5 – Не постоји.<br><br>Напомена: Број у називу својства упућује на редослед ознака на листи за процену ознака.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *обавезно* ако се конфигуришу *Ознаке домаћина*<br><br>Овај параметар није подржан ако се виџет конфигурише на [template dashboard](/manual/api/reference/templatedashboard/object).|
|^|*Tag value*|1|host_tags.0.value|Било која вредност стринга.<br><br>Напомена: Број у називу својства упућује на редослед ознака у листи за процену ознака.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *обавезно* ако се конфигуришу *ознаке домаћина*<br><br>Овај параметар није подржан ако се виџет конфигурише на [template dashboard] (/manual/api/reference/templatedashboard/object).|
*Host tags*<br><br>Овај параметар није подржан ако је конфигурисан виџет на [template dashboard](/manual/api/reference/templatedashboard/object).|
|*Severity*|<|0|severities.0|0 - Није класификовано;<br>1 - Информације;<br>2 - Упозорење;<br>3 - Просечно;<br>4 - Високо;<br>5 - Катастрофа.<br><br>Подразумевано: празно (све омогућено).<br><br>Напомена: Да бисте конфигурисали више вредности, креирајте објекат поља виџета контролне табле за сваку вредност са повећаним бројем у називу својства.|
|*Show hosts in maintenance*|<|0|maintenance|0 - *(подразумевано)* Онемогућено;<br>1 - Омогућено.|
|*Show problems*|<|0|show_problems|0 - Све;<br>1 - *(подразумевано)* Непотиснуто;<br>2 - Ништа.|
|*Group by*|<|<|<|<|
|<|*Attribute*|0|group_by.0.attribute|0 – Група домаћина;<br>1 – Вредност ознаке;<br>2 – Озбиљност.<br><br>Напомена: Број у референцама имена својства редослед атрибута на листи атрибута за груписање.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *обавезно* ако се конфигурише *Групиши по*|
|^|*Value*|1|group_by.0.tag_name|Било која вредност стринга.<br><br>Напомена: Број у називу својства упућује на атрибут груписања постављен у параметру *Атибут*.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *обавезно* ако је конфигурисање *Групиши по* и *Атрибут* постављено на "Вредност ознаке"|
|*Host limit*|<|0|show_lines|Могуће вредности су у распону од 1-9999.<br><br>Подразумевано: 100.<br><br>Овај параметар није подржан ако конфигуришете виџет на [template dashboard](/manual/api/reference/templatedashboard/object).|
|*Reference*|<|1|reference|Било која вредност низа која се састоји од 5 карактера (нпр. `ABCDE` или `JBPNL`). Ова вредност мора бити јединствена унутар контролне табле којој виџет припада.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *обавезно*|

[comment]: # ({/4d3dace7-1636ce04})

[comment]: # ({256a1b51-1d66ab00})
### Примери

Следећи примери имају за циљ само да опишу конфигурацију објеката поља виџета контролне табле за виџет *Host navigator*.
За више информација о конфигурисању контролне табле погледајте [`dashboard.create`](/manual/api/reference/dashboard/create).

[comment]: # ({/256a1b51-1d66ab00})

[comment]: # ({883c48d7-0e8f355d})
#### Конфигурисање виџета *Host navigator*

Конфигуришите виџет *Host navigator* који приказује домаћине груоисане према њиховој групи домаћина, затим, према вредности ознаке "city".

[Request](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": "30",
        "auto_start": "1",
        "pages": [
            {
                "widgets": [
                    {
                        "type": "hostnavigator",
                        "name": "Host navigator",
                        "x": "0",
                        "y": "0",
                        "width": "12",
                        "height": "5",
                        "view_mode": "0",
                        "fields": [
                            {
                                "type": 2,
                                "name": "groupids.0",
                                "value": 2
                            },
                            {
                                "type": 2,
                                "name": "groupids.1",
                                "value": 4
                            },
                            {
                                "type": 0,
                                "name": "group_by.0.attribute",
                                "value": 0
                            },
                            {
                                "type": 0,
                                "name": "group_by.1.attribute",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "group_by.1.tag_name",
                                "value": "city"
                            },
                            {
                                "type": 1,
                                "name": "reference",
                                "value": "SWKLB"
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}
```

Одговор:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "dashboardids": [
            "3"
        ]
    },
    "id": 1
}
```

[comment]: # ({/883c48d7-0e8f355d})

[comment]: # ({e9d30322-5c9cbeda})
### Погледајте такође

- [Dashboard widget field](/manual/api/reference/dashboard/object#dashboard-widget-field)
- [`dashboard.create`](/manual/api/reference/dashboard/create)
- [`dashboard.update`](/manual/api/reference/dashboard/update)

[comment]: # ({/e9d30322-5c9cbeda})