2 Zegar
Opis
Te parametry oraz możliwe wartości właściwości dla odpowiednich obiektów pól widżetu umożliwiają skonfigurowanie
widżetu Clock w metodach dashboard.create i dashboard.update.
Właściwości fields widżetu nie są walidowane podczas tworzenia ani aktualizacji pulpitu.
Pozwala to użytkownikom modyfikować wbudowane widżety i tworzyć własne widżety, ale jednocześnie wprowadza ryzyko nieprawidłowego tworzenia lub aktualizowania widżetów.
Aby zapewnić pomyślne utworzenie lub aktualizację widżetu Clock, zapoznaj się z zachowaniem parametrów opisanym 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
}