[comment]: # ({d052d97c-b1d00045})
# 16 Навигатор ставки

[comment]: # ({/d052d97c-b1d00045})

[comment]: # ({8f5d8398-a8620fa9})
### Опис

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

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

[comment]: # ({/8f5d8398-a8620fa9})

[comment]: # ({7bff23dc-43b2c246})
### Параметри

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

|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|ID [Host group](/manual/api/reference/hostgroup/get).<br><br>Напомена: Да бисте конфигурисали више група домаћина, креирајте објекат поља виџета за сваку групу домаћина са повећаним бројем у имену својства.<br><br>Овај параметар није подржан ако конфигуришете виџет на [template dashboard](/manual/api/reference/tempdedashboard/object).|
|<|*Host groups (Widget)*|1|groupids.\_reference|Уместо ID-ија од [Host group](/manual/api/reference/hostgroup/get):<br>`ABCDE._hostgroupids` - подесите [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (са његовим параметром *Референца* подешеним на "`ABCDE`") као извор података за групе домаћина.<br><br>Овај параметар није подржан ако конфигуришете виџет на [template dashboard](/manual/api/reference/tempdedashboard/object).|
|*Hosts*|<|3|hostids.0|ID од [Host](/manual/api/reference/host/get).<br><br>Напомена: Да бисте конфигурисали више домаћина, креирајте објекат поља виџета за сваког домаћина са повећаним бројем у имену својства. За више домаћина, параметар *Групе домаћина* мора бити или неподешен уопште или подешен са најмање једном групом домаћина којој домаћини припадају.<br><br>Овај параметар није подржан ако конфигуришете виџет на [template dashboard] (/manual/api/reference/tempdedashboard/object).|
|<|*Hosts (Widget/Dashboard)*|1|hostids.\_reference|Уместо ID-ија [ [Host]](/manual/api/reference/host/get):<br>`DASHBOARD.hostid` - подесите [*Host* selector](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) као извор података за домаћине;<br>`ABCDE._hostid` - подесите [compatible widget](/manual/web_interface/frontend_sections /dashboards/widgets#widget-compatibility) (са параметром *Референца* подешеним на "`ABCDE`") као извор података за домаћине.<br><br>Овај параметар није подржан ако конфигуришете виџет на [template dashboard](/manual/api/reference/tempdedashboard/object).|
|*Host tags*|<|<|<|<|
|<|*Evaluation type*|0|host_tags_evaltype|0 - *(подразумевано)* И/Или;<br>2 - Или.<br><br>Овај параметар није подржан ако конфигуришете виџет на [template dashboard](/manual/api/reference/tempdedashboard/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/tempdedashboard/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).|
|*Item patterns*|<|1|items.0|[Item](/manual/api/reference/item/get) назив или образац.<br><br>Напомена: За конфигурисање више образаца ставки, креирајте објекат поља виџета на контролној табли за сваки образац ставке са повећаним бројем у имену својства.|
|*Item tags*|<|<|<|<|
|<|*Evaluation type*|0|item_tags_evaltype|0 - *(подразумевано)* И/Или;<br>2 - Или.|
|^|*Tag name*|1|item_tags.0.tag|Било која вредност стринга.<br><br>Напомена: Број у називу својства односи се на редослед ознака у листи евалуације ознака.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *обавезно* ако конфигуришете *Ознаке ставки*|
|^|*Operator*|0|item_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>- *обавезно* ако конфигуришете *Ознаке ставки*|
 |^|*Tag value*|1|item_tags.0.value|Било која вредност стринга.<br><br>Напомена: Број у називу својства односи се на редослед ознака у листи евалуације ознака.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *обавезно* ако конфигуришете *Ознаке ставки*|
|*State*|<|0|state|-1 - *(обавезно)* Сви;<br>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>3 - Вредност ознаке ставке.<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>- *обавезно* ако конфигуришете *Групиши по* и *Атрибут* је постављен на "Вредност ознаке домаћина" или "Вредност ознаке ставке"|
|*Item limit*|<|0|show_lines|Могуће вредности у опсегу од 1-9999.<br><br>Подразумевано: 100.|
|*Reference*|<|1|reference|Било која вредност стринга која се састоји од 5 карактера (нпр. `ABCDE` или `JBPNL`). Ова вредност мора бити јединствена у оквиру контролне табле којој виџет припада.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *обавезно*|

[comment]: # ({/7bff23dc-43b2c246})

[comment]: # ({ffdf4230-d96958ab})
### Примери

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

[comment]: # ({/ffdf4230-d96958ab})

[comment]: # ({437d3f78-ae3ed50a})
#### Конфигурисање виџета *Навигатор ставки*

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

[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": "itemnavigator",
                        "name": "Item navigator",
                        "x": "0",
                        "y": "0",
                        "width": "12",
                        "height": "5",
                        "view_mode": "0",
                        "fields": [
                            {
                                "type": 0,
                                "name": "group_by.0.attribute",
                                "value": 0
                            },
                            {
                                "type": 0,
                                "name": "group_by.1.attribute",
                                "value": 3
                            },
                            {
                                "type": 1,
                                "name": "group_by.1.tag_name",
                                "value": "component"
                            },
                            {
                                "type": 0,
                                "name": "show_lines",
                                "value": 1000
                            },
                            {
                                "type": 1,
                                "name": "reference",
                                "value": "DFNLK"
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}
```

Одговор:

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

[comment]: # ({/437d3f78-ae3ed50a})

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

- [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-813ec286})