[comment]: # ({d220a982-0158bee8})
# 12 Wartość pozycji
[comment]: # ({/d220a982-0158bee8})
[comment]: # ({f0bf3b77-90997d6a})
### Opis
Te parametry i możliwe wartości właściwości dla odpowiednich obiektów pola widżetu pulpitu pozwalają skonfigurować widżet [*Wartość pozycji*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/clock) w metodach `dashboard.create` i `dashboard.update`.
::: noteimportant
Właściwości widżetu `fields` nie są walidowane podczas tworzenia lub aktualizacji pulpitu.
Pozwala to użytkownikom modyfikować [wbudowane widżety](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) i tworzyć [niestandardowe widżety](/manual/modules#developing-modules), ale wprowadza również ryzyko nieprawidłowego tworzenia lub aktualizacji widżetów.
Aby zapewnić pomyślne utworzenie lub aktualizację widżetu *Wartość pozycji*, należy odwołać się do wymagań dotyczących parametrów przedstawionych w poniższych tabelach.
:::
[comment]: # ({/f0bf3b77-90997d6a})
[comment]: # ({7ebf36a4-c637d90d})
### Parametry
Poniższe parametry są obsługiwane dla widżetu *Wartość pozycji*.
|Parametr|[typ](/manual/api/reference/dashboard/object#dashboard-widget-field)|nazwa|wartość|
|-----|-|-----|-------------------|
|*Interwał odświeżania*|0|rf_rate|0 - Brak odświeżania;
10 - 10 sekund;
30 - 30 sekund;
60 - *(domyślne)* 1 minuta;
120 - 2 minuty;
600 - 10 minut;
900 - 15 minut.|
|***Pozycja***
(wymagane)|4|itemid|ID [pozycji](/manual/api/reference/item/get).|
|*Wyświetl*|0|show|1 - Opis;
2 - Wartość;
3 - Czas;
4 - Wskaźnik zmiany.
Domyślnie: 1, 2, 3, 4 (wszystkie włączone).
Uwaga: Aby skonfigurować wiele wartości, utwórz obiekt pola widżetu dla każdej wartości.|
|*Dynamiczna pozycja*|0|dynamic|0 - *(domyślne)* Wyłączone;
1 - Włączone.|
|*Zaawansowana konfiguracja*|0|adv_conf|0 - *(domyślne)* Wyłączone;
1 - Włączone.|
[comment]: # ({/7ebf36a4-c637d90d})
[comment]: # ({6c4a776f-db4b24d9})
#### Zaawansowana konfiguracja
Poniższe parametry są obsługiwane, jeśli *Zaawansowana konfiguracja* jest ustawiona na "Włączone".
|Parametr|<|[typ](/manual/api/reference/dashboard/object#dashboard-widget-field)|nazwa|wartość|
|-|--------|--|--------|-------------------------------|
|*Kolor tła*|<|1|bg_color|Szesnastkowy kod koloru (np. `FF0000`).
Domyślnie: `""` (puste).|
[comment]: # ({/6c4a776f-db4b24d9})
[comment]: # ({afead1c7-078914fc})
##### Opis
Poniższe parametry są obsługiwane, jeśli *Zaawansowana konfiguracja* jest ustawiona na "Włączone", a *Pokaż* jest ustawione na "Opis".
|Parametr|[typ](/manual/api/reference/dashboard/object#dashboard-widget-field)|nazwa|wartość|
|-----|-|-----|-------------------|
|*Opis*|1|description|Dowolna wartość tekstowa, w tym makra.
Obsługiwane makra: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, makra użytkownika.
Domyślnie: {ITEM.NAME}.|
|*Pozycja horyzontalna*|0|desc_h_pos|0 - Z lewej;
1 - *(domyślne)* Środek;
2 - Z prawej.
Dwa lub więcej elementów (Opis, Wartość, Czas) nie mogą mieć tej samej *Pozycji horyzontalnej* i *Pozycji wertykalnej*.|
|*Pozycja wertykalna*|0|desc_v_pos|0 - Na górze;
1 - Środek;
2 - *(domyślne)* Na dole.
Dwa lub więcej elementów (Opis, Wartość, Czas) nie mogą mieć tej samej*Pozycji horyzontalnej* i *Pozycji wertykalnej*.|
|*Rozmiar*|0|desc_size|Dopuszczalne wartości od 1 do 100.
Domyślnie: 15.|
|*Pogrubienie*|0|desc_bold|0 - *(domyślne)* Wyłączone;
1 - Włączone.|
|*Kolor*|1|desc_color|Szesnastkowy kod koloru (np. `FF0000`).
Domyślnie: `""` (puste).|
[comment]: # ({/afead1c7-078914fc})
[comment]: # ({1c933529-ef72e1ef})
##### Wartość
Poniższe parametry są obsługiwane, jeśli *Zaawansowana konfiguracja* jest ustawiona na "Włączone", a *Pokaż* jest ustawione na "Wartość".
|Parametr|<|[typ](/manual/api/reference/dashboard/object#dashboard-widget-field)|nazwa|wartość|
|-|--------|--|--------|-------------------------------|
|*Miejsca dziesiętne*|<|<|<|<|
|<|*Miejsca po przecinku*|0|decimal_places|Dopuszczalne wartości od 1 do 10.
Domyślnie: 2.|
|^|*Rozmiar*|0|decimal_size|Dopuszczalne wartości od 1 do 100.
Domyślnie: 35.|
|*Pozycja*|<|<|<|<|
|<|*Pozycja horyzontalna*|0|value_h_pos|0 - Z lewej;
1 - *(domyślne)* Środek;
2 - Z prawej.
Dwa lub więcej elementów (Opis, Wartość, Czas) nie mogą mieć tej samej *Pozycji horyzontalnej* i *Pozycji wertykalnej*.|
|^|*Pozycja wertykalna*|0|value_v_pos|0 - Na górze;
1 - *(domyślne)* Środek;
2 - Na dole.
Dwa lub więcej elementów (Opis, Wartość, Czas) nie mogą mieć tej samej *Pozycji horyzontalnej* i *Pozycji wertykalnej*.|
|^|*Rozmiar*|0|value_size|Dopuszczalne wartości od 1 do 100.
Domyślnie: 45.|
|^|*Pogrubienie*|0|value_bold|0 - Wyłączone;
1 - *(domyślne)* Włączone.|
|^|*Kolor*|1|value_color|Kod koloru heksadecymalny (np. `FF0000`).
Domyślnie: `""` (puste).|
|*Jednostki*|<|<|<|<|
|<|*Jednostki* (pole wyboru)|0|units_show|0 - Wyłączone;
1 - *(domyślne)* Włączone.|
|^|*Jednostki* (wartość)|1|units|Dowolna wartość tekstowa.|
|^|*Pozycja*|0|units_pos|0 - Wartość przed;
1 - Powyżej wartości;
2 - *(domyślne)* Wartość po;
3 - Poniżej wartości.|
|^|*Rozmiar*|0|units_size|Dopuszczalne wartości od 1 do 100.
Domyślnie: 35.|
|^|*Pogrubienie*|0|units_bold|0 - Wyłączone;
1 - *(domyślne)* Włączone.|
|^|*Kolor*|1|units_color|Szesnastkowy kod koloru (np. `FF0000`).
Domyślnie: `""` (puste).|
[comment]: # ({/1c933529-ef72e1ef})
[comment]: # ({2562b521-1504e2d4})
##### Czas
Poniższe parametry są obsługiwane, jeśli *Zaawansowana konfiguracja* jest ustawiona na "Włączone", a *Pokaż* jest ustawione na "Czas".
|Parametr|<|[typ](/manual/api/reference/dashboard/object#dashboard-widget-field)|nazwa|wartość|
|-|--------|--|--------|-------------------------------|
|*Pozycja horyzontalna*|0|time_h_pos|0 - Z lewej;
1 - *(domyślne)* Środek;
2 - Z prawej.
Dwa lub więcej elementów (Opis, Wartość, Czas) nie mogą mieć tej samej *Pozycji horyzontalnej* i *Pozycji wertykalnej*.|
|*Pozycja wertykalna*|0|time_v_pos|0 - *(domyślne)* Na górze;
1 - Środek;
2 - Na dole.
Dwa lub więcej elementów (Opis, Wartość, Czas) nie mogą mieć tej samej *Pozycji horyzontalnej* i *Pozycji wertykalnej*.|
|*Rozmiar*|0|time_size|Dopuszczalne wartości od 1 do 100.
Domyślnie: 15.|
|*Pogrubienie*|0|time_bold|0 - *(domyślne)* Wyłączone;
1 - Włączone.|
|*Kolor*|1|time_color|Szesnastkowy Kod koloru (np. `FF0000`).
Domyślnie: `""` (puste).|
[comment]: # ({/2562b521-1504e2d4})
[comment]: # ({effbeabd-071114d8})
##### Wskaźnik zmiany
Poniższe parametry są obsługiwane, jeśli *Zaawansowana konfiguracja* jest ustawiona na "Włączone", a *Pokaż* jest ustawione na "Wskaźnik zmiany".
|Parametr|[typ](/manual/api/reference/dashboard/object#dashboard-widget-field)|nazwa|wartość|
|-|--------|--|--------|-------------------------------|
|*Kolor wskaźnika zmiany ↑*|1|up_color|Szesnastkowy Kod koloru (np. `FF0000`).
Domyślnie: `""` (puste).|
|*Kolor wskaźnika zmiany ↓*|1|down_color|Szesnastkowy Kod koloru (np. `FF0000`).
Domyślnie: `""` (puste).|
|*Kolor wskaźnika zmiany ↕*|1|updown_color|Szesnastkowy Kod koloru (np. `FF0000`).
Domyślnie: `""` (puste).|
[comment]: # ({/effbeabd-071114d8})
[comment]: # ({fd9ac7eb-2dce34b2})
### Przykłady
Poniższe przykłady mają na celu jedynie opisanie konfiguracji obiektów pól widżetu pulpitu dla widżetu *Wartość pozycji*.
Aby uzyskać więcej informacji na temat konfigurowania pulpitu nawigacyjnego, zobacz [`dashboard.create`](/manual/api/reference/dashboard/create).
[comment]: # ({/fd9ac7eb-2dce34b2})
[comment]: # ({ac4bca74-98b4043e})
#### Konfiguracja widżetu *Wartość pozycji*
Skonfiguruj widżet *Wartość pozycji*, który wyświetla wartość pozycji dla pozycji "42266" (Dostępność agenta Zabbix).
Dodatkowo, wizualnie dostrój widżet za pomocą wielu zaawansowanych opcji.
Zapytanie:
```json
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "item",
"name": "Item value",
"x": 0,
"y": 0,
"width": 4,
"height": 3,
"view_mode": 0,
"fields": [
{
"type": 4,
"name": "itemid",
"value": 42266
},
{
"type": 0,
"name": "show",
"value": 1
},
{
"type": 0,
"name": "show",
"value": 2
},
{
"type": 0,
"name": "show",
"value": 3
},
{
"type": 0,
"name": "adv_conf",
"value": 1
},
{
"type": 1,
"name": "bg_color",
"value": "D1C4E9"
},
{
"type": 1,
"name": "description",
"value": "Agent status"
},
{
"type": 0,
"name": "desc_h_pos",
"value": 0
},
{
"type": 0,
"name": "desc_v_pos",
"value": 0
},
{
"type": 0,
"name": "desc_bold",
"value": 1
},
{
"type": 1,
"name": "desc_color",
"value": "F06291"
},
{
"type": 0,
"name": "value_h_pos",
"value": 0
},
{
"type": 0,
"name": "value_size",
"value": 25
},
{
"type": 1,
"name": "value_color",
"value": "FFFF00"
},
{
"type": 0,
"name": "units_show",
"value": 0
},
{
"type": 0,
"name": "time_h_pos",
"value": 2
},
{
"type": 0,
"name": "time_v_pos",
"value": 2
},
{
"type": 0,
"name": "time_size",
"value": 10
},
{
"type": 0,
"name": "time_bold",
"value": 1
},
{
"type": 1,
"name": "time_color",
"value": "9FA8DA"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}
```
Odpowiedź:
```json
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}
```
[comment]: # ({/ac4bca74-98b4043e})
[comment]: # ({e9d30322-0dc1c2d5})
### Zobacz także
- [Pole widżetu pulpitu](/manual/api/reference/dashboard/object#dashboard-widget-field)
- [`dashboard.create`](/manual/api/reference/dashboard/create)
- [`dashboard.update`](/manual/api/reference/dashboard/update)
[comment]: # ({/e9d30322-0dc1c2d5})