2 Zegar
Opis
Te parametry i możliwe wartości właściwości odpowiednich obiektów pól widgetu pulpitu nawigacyjnego umożliwiają skonfigurowanie widgetu Zegar w metodach dashboard.create i dashboard.update.
Właściwości fields widgetu nie są sprawdzane podczas tworzenia ani aktualizowania pulpitu nawigacyjnego.
Umożliwia to użytkownikom modyfikowanie wbudowanych widgetów i tworzenie niestandardowych widgetów, ale wiąże się również z ryzykiem nieprawidłowego utworzenia lub zaktualizowania widgetów.
Aby zapewnić pomyślne utworzenie lub zaktualizowanie widgetu Zegar, należy zapoznać się z opisem działania parametrów przedstawionym w poniższych tabelach.
Parametry
Następujące parametry są obsługiwane dla widżetu Clock.
| Parametr | type | name | value |
|---|---|---|---|
| Interwał odświeżania | 0 | rf_rate | 0 - Bez odświeżania; 10 - 10 sekund; 30 - 30 sekund; 60 - 1 minuta; 120 - 2 minuty; 600 - 10 minut; 900 - (domyślnie) 15 minut. |
| Typ czasu | 0 | time_type | 0 - (domyślnie) Czas lokalny; 1 - Czas serwera; 2 - Czas hosta. |
| Typ zegara | 0 | clock_type | 0 - (domyślnie) Analogowy; 1 - Cyfrowy. |
Następujące parametry są obsługiwane, jeśli Typ czasu jest ustawiony na „Czas hosta”.
| Parametr | type | name | value |
|---|---|---|---|
| Pozycja | 4 | itemid.0 | ID pozycji. Zachowanie parametru: - wymagane |
Następujące parametry są obsługiwane, jeśli Typ zegara jest ustawiony na „Cyfrowy”.
| Parametr | type | name | value |
|---|---|---|---|
| Pokaż | 0 | show.0 | 1 - Data; 2 - (domyślnie) Czas; 3 - Strefa czasowa. Uwaga: Aby skonfigurować wiele wartości, utwórz obiekt pola widżetu pulpitu dla każdej wartości z inkrementowanym numerem w nazwie właściwości. |
Konfiguracja zaawansowana
Następujące zaawansowane parametry konfiguracji są obsługiwane, jeśli Typ zegara jest ustawiony na „Cyfrowy”.
| Parametr | type | name | value |
|---|---|---|---|
| Kolor tła | 1 | bg_color | Szesnastkowy kod koloru (np. FF0000).Domyślnie: "" (puste). |
Data
Następujące zaawansowane parametry konfiguracji są obsługiwane, jeśli Clock type jest ustawiony na „Digital”, a Show jest ustawione na „Date”.
| Parametr | type | name | value |
|---|---|---|---|
| Pogrubienie | 0 | date_bold | 0 - (domyślnie) Wyłączone; 1 - Włączone. |
| Kolor | 1 | date_color | Szesnastkowy kod koloru (np. FF0000).Domyślnie: "" (puste). |
Czas
Następujące zaawansowane parametry konfiguracji są obsługiwane, jeśli Typ zegara jest ustawiony na „Cyfrowy”, a Pokaż jest ustawiony na „Czas”.
| Parametr | typ | nazwa | wartość |
|---|---|---|---|
| Pogrubienie | 0 | time_bold | 0 - (domyślnie) Wyłączone; 1 - Włączone. |
| Kolor | 1 | time_color | Kod koloru szesnastkowego (np. FF0000).Domyślnie: "" (puste). |
| Sekundy | 0 | time_sec | 0 - Wyłączone; 1 - (domyślnie) Włączone. |
| Format | 0 | time_format | 0 - (domyślny) 24-godzinny; 1 - 12-godzinny. |
Strefa czasowa
Następujące zaawansowane parametry konfiguracyjne są obsługiwane, jeśli Clock type jest ustawiony na „Digital”, a Show jest ustawione na „Time zone”.
| Parametr | type | name | value |
|---|---|---|---|
| Pogrubienie | 0 | tzone_bold | 0 - (domyślnie) Wyłączone; 1 - Włączone. |
| Kolor | 1 | tzone_color | Szesnastkowy kod koloru (np. FF0000).Domyślnie: "" (puste). |
| Strefa czasowa | 1 | tzone_timezone | Prawidłowy ciąg strefy czasowej (np. Europe/Riga, system, UTC itd.). Pełną listę obsługiwanych stref czasowych można znaleźć w dokumentacji PHP.Domyślnie: local.Zachowanie parametru: - obsługiwany, jeśli Time type jest ustawiony na „Local time” lub „Server time” |
| Format | 0 | tzone_format | 0 - (domyślnie) Krótki; 1 - Pełny. Zachowanie parametru: - obsługiwany, jeśli Time type jest ustawiony na „Local time” lub „Server time” |
Przykłady
Poniższe przykłady mają na celu jedynie opisanie konfiguracji obiektów pól widżetu pulpitu dla widżetu Zegara.
Aby uzyskać więcej informacji na temat konfigurowania pulpitu nawigacyjnego, zobacz dashboard.create.
Konfigurowanie widżetu Clock
Skonfiguruj widżet Clock, który wyświetla lokalną datę, godzinę i strefę czasową w dostosowanym zegarze cyfrowym.
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "clock",
"name": "Clock",
"x": 0,
"y": 0,
"width": 12,
"height": 3,
"view_mode": 0,
"fields": [
{
"type": 0,
"name": "clock_type",
"value": 1
},
{
"type": 0,
"name": "show.0",
"value": 1
},
{
"type": 0,
"name": "show.1",
"value": 2
},
{
"type": 0,
"name": "show.2",
"value": 3
},
{
"type": 1,
"name": "date_color",
"value": "E1E1E1"
},
{
"type": 0,
"name": "time_bold",
"value": 1
},
{
"type": 1,
"name": "tzone_color",
"value": "E1E1E1"
},
{
"type": 1,
"name": "tzone_timezone",
"value": "Europe/Riga"
},
{
"type": 0,
"name": "tzone_format",
"value": 1
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Odpowiedź:
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}