2 Orologio
Descrizione
Questi parametri e i possibili valori delle proprietà per i rispettivi oggetti campo del widget della dashboard consentono di configurare
il widget Orologio nei metodi dashboard.create e dashboard.update.
Le proprietà fields del widget non vengono convalidate durante la creazione o l'aggiornamento di una dashboard.
Questo consente agli utenti di modificare i widget built-in e creare widget personalizzati, ma comporta anche il rischio di creare o aggiornare i widget in modo errato.
Per garantire la corretta creazione o l'aggiornamento del widget Orologio, fare riferimento al comportamento dei parametri descritto nelle tabelle seguenti.
Parametri
I seguenti parametri sono supportati per il widget Clock.
| Parametro | type | name | value |
|---|---|---|---|
| Intervallo di aggiornamento | 0 | rf_rate | 0 - Nessun aggiornamento; 10 - 10 secondi; 30 - 30 secondi; 60 - 1 minuto; 120 - 2 minuti; 600 - 10 minuti; 900 - (predefinito) 15 minuti. |
| Tipo di ora | 0 | time_type | 0 - (predefinito) Ora locale; 1 - Ora del server; 2 - Ora del host. |
| Tipo di orologio | 0 | clock_type | 0 - (predefinito) Analogico; 1 - Digitale. |
I seguenti parametri sono supportati se Tipo di ora è impostato su "Ora del host".
| Parametro | type | name | value |
|---|---|---|---|
| Item | 4 | itemid.0 | ID item. Comportamento del parametro: - obbligatorio |
I seguenti parametri sono supportati se Tipo di orologio è impostato su "Digitale".
| Parametro | type | name | value |
|---|---|---|---|
| Mostra | 0 | show.0 | 1 - Data; 2 - (predefinito) Ora; 3 - Fuso orario. Nota: per configurare più valori, creare un oggetto campo widget della dashboard per ciascun valore con un numero incrementato nel nome della proprietà. |
Configurazione avanzata
I seguenti parametri di configurazione avanzata sono supportati se Clock type è impostato su "Digital".
| Parametro | type | name | value |
|---|---|---|---|
| Colore di sfondo | 1 | bg_color | Codice colore esadecimale (ad es. FF0000).Predefinito: "" (vuoto). |
Data
I seguenti parametri di configurazione avanzata sono supportati se Clock type è impostato su "Digital" e Show è impostato su "Date".
| Parametro | type | name | value |
|---|---|---|---|
| Grassetto | 0 | date_bold | 0 - (predefinito) Disabilitato; 1 - Abilitato. |
| Colore | 1 | date_color | Codice colore esadecimale (ad esempio FF0000).Predefinito: "" (vuoto). |
Ora
I seguenti parametri di configurazione avanzata sono supportati se Clock type è impostato su "Digital" e Show è impostato su "Time".
| Parameter | type | name | value |
|---|---|---|---|
| Grassetto | 0 | time_bold | 0 - (predefinito) Disabilitato; 1 - Abilitato. |
| Colore | 1 | time_color | Codice colore esadecimale (ad esempio FF0000).Predefinito: "" (vuoto). |
| Secondi | 0 | time_sec | 0 - Disabilitato; 1 - (predefinito) Abilitato. |
| Formato | 0 | time_format | 0 - (predefinito) 24 ore; 1 - 12 ore. |
Fuso orario
I seguenti parametri di configurazione avanzata sono supportati se Clock type è impostato su "Digital" e Show è impostato su "Time zone".
| Parametro | type | name | value |
|---|---|---|---|
| Grassetto | 0 | tzone_bold | 0 - (predefinito) Disabilitato; 1 - Abilitato. |
| Colore | 1 | tzone_color | Codice colore esadecimale (ad esempio FF0000).Predefinito: "" (vuoto). |
| Fuso orario | 1 | tzone_timezone | Stringa di fuso orario valida (ad esempio Europe/Riga, system, UTC, ecc.). Per l'elenco completo dei fusi orari supportati, fare riferimento alla documentazione PHP.Predefinito: local.Comportamento del parametro: - supportato se Time type è impostato su "Local time" o "Server time" |
| Formato | 0 | tzone_format | 0 - (predefinito) Breve; 1 - Completo. Comportamento del parametro: - supportato se Time type è impostato su "Local time" o "Server time" |
Esempi
Gli esempi seguenti mirano a descrivere solo la configurazione degli oggetti campo del widget del dashboard per il widget Orologio.
Per ulteriori informazioni sulla configurazione di un dashboard, vedere dashboard.create.
Configurazione di un widget Clock
Configurare un widget Clock che visualizza data, ora e fuso orario locali in un orologio digitale personalizzato.
{
"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
}Risposta:
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}