Documentation
Table of Contents
12 Wartość pozycji
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 w metodach dashboard.create i dashboard.update.
Właściwości widżetu fields nie są walidowane podczas tworzenia lub aktualizacji pulpitu. Pozwala to użytkownikom modyfikować wbudowane widżety i tworzyć niestandardowe widżety, 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.
Parametry
Poniższe parametry są obsługiwane dla widżetu Wartość pozycji.
| Parametr | typ | 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. |
| 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. |
Zaawansowana konfiguracja
Poniższe parametry są obsługiwane, jeśli Zaawansowana konfiguracja jest ustawiona na "Włączone".
| Parametr | typ | nazwa | wartość | |
|---|---|---|---|---|
| Kolor tła | 1 | bg_color | Szesnastkowy kod koloru (np. FF0000).Domyślnie: "" (puste). |
|
Opis
Poniższe parametry są obsługiwane, jeśli Zaawansowana konfiguracja jest ustawiona na "Włączone", a Pokaż jest ustawione na "Opis".
| Parametr | typ | 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 samejPozycji 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). |
Wartość
Poniższe parametry są obsługiwane, jeśli Zaawansowana konfiguracja jest ustawiona na "Włączone", a Pokaż jest ustawione na "Wartość".
| Parametr | typ | 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). |
|
Czas
Poniższe parametry są obsługiwane, jeśli Zaawansowana konfiguracja jest ustawiona na "Włączone", a Pokaż jest ustawione na "Czas".
| Parametr | typ | 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). |
|
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 | 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). |
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.
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:
{
"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ź: