2 Uhr
Beschreibung
Diese Parameter und die möglichen Eigenschaftswerte für die jeweiligen Feldobjekte des Dashboard-Widgets ermöglichen die Konfiguration des Widgets Clock in den Methoden dashboard.create und dashboard.update.
Die Eigenschaften von Widget-fields werden bei der Erstellung oder Aktualisierung eines Dashboards nicht validiert.
Dies ermöglicht Benutzern, integrierte Widgets zu ändern und benutzerdefinierte Widgets zu erstellen, birgt jedoch auch das Risiko, Widgets fehlerhaft zu erstellen oder zu aktualisieren.
Um die erfolgreiche Erstellung oder Aktualisierung des Widgets Clock sicherzustellen, beachten Sie bitte das in den folgenden Tabellen beschriebene Verhalten der Parameter.
Parameter
Die folgenden Parameter werden für das Uhr-Widget unterstützt.
| Parameter | type | name | value |
|---|---|---|---|
| Aktualisierungsintervall | 0 | rf_rate | 0 - Keine Aktualisierung; 10 - 10 Sekunden; 30 - 30 Sekunden; 60 - 1 Minute; 120 - 2 Minuten; 600 - 10 Minuten; 900 - (Standard) 15 Minuten. |
| Zeittyp | 0 | time_type | 0 - (Standard) Lokale Zeit; 1 - Serverzeit; 2 - Host-Zeit. |
| Uhrtyp | 0 | clock_type | 0 - (Standard) Analog; 1 - Digital. |
Die folgenden Parameter werden unterstützt, wenn Zeittyp auf „Host-Zeit“ gesetzt ist.
| Parameter | type | name | value |
|---|---|---|---|
| Datenpunkt | 4 | itemid.0 | ID des Datenpunkts. Parameterverhalten: - erforderlich |
Die folgenden Parameter werden unterstützt, wenn Uhrtyp auf „Digital“ gesetzt ist.
| Parameter | type | name | value |
|---|---|---|---|
| Anzeigen | 0 | show.0 | 1 - Datum; 2 - (Standard) Uhrzeit; 3 - Zeitzone. Hinweis: Um mehrere Werte zu konfigurieren, erstellen Sie für jeden Wert ein Dashboard-Widget-Feldobjekt mit einer inkrementierten Nummer im Eigenschaftsnamen. |
Erweiterte Konfiguration
Die folgenden erweiterten Konfigurationsparameter werden unterstützt, wenn Clock type auf „Digital“ gesetzt ist.
| Parameter | type | name | value |
|---|---|---|---|
| Hintergrundfarbe | 1 | bg_color | Hexadezimaler Farbcode (z. B. FF0000).Standard: "" (leer). |
Datum
Die folgenden erweiterten Konfigurationsparameter werden unterstützt, wenn Clock type auf „Digital“ und Show auf „Date“ gesetzt ist.
| Parameter | type | name | value |
|---|---|---|---|
| Fett | 0 | date_bold | 0 - (Standard) Deaktiviert; 1 - Aktiviert. |
| Farbe | 1 | date_color | Hexadezimaler Farbcode (z. B. FF0000).Standard: "" (leer). |
Zeit
Die folgenden erweiterten Konfigurationsparameter werden unterstützt, wenn Clock type auf „Digital“ und Show auf „Time“ gesetzt ist.
| Parameter | type | name | value |
|---|---|---|---|
| Fett | 0 | time_bold | 0 - (Standard) Deaktiviert; 1 - Aktiviert. |
| Farbe | 1 | time_color | Hexadezimaler Farbcode (z. B. FF0000).Standard: "" (leer). |
| Sekunden | 0 | time_sec | 0 - Deaktiviert; 1 - (Standard) Aktiviert. |
| Format | 0 | time_format | 0 - (Standard) 24-Stunden-Format; 1 - 12-Stunden-Format. |
Zeitzone
Die folgenden erweiterten Konfigurationsparameter werden unterstützt, wenn Clock type auf „Digital“ und Show auf „Zeitzone“ gesetzt ist.
| Parameter | type | name | value |
|---|---|---|---|
| Fett | 0 | tzone_bold | 0 - (Standard) Deaktiviert; 1 - Aktiviert. |
| Farbe | 1 | tzone_color | Hexadezimaler Farbcode (z. B. FF0000).Standard: "" (leer). |
| Zeitzone | 1 | tzone_timezone | Gültige Zeitzonen-Zeichenfolge (z. B. Europe/Riga, system, UTC usw.). Eine vollständige Liste der unterstützten Zeitzonen finden Sie in der PHP-Dokumentation.Standard: local.Parameterverhalten: - unterstützt, wenn Time type auf „Local time“ oder „Server time“ gesetzt ist |
| Format | 0 | tzone_format | 0 - (Standard) Kurz; 1 - Vollständig. Parameterverhalten: - unterstützt, wenn Time type auf „Local time“ oder „Server time“ gesetzt ist |
Beispiele
Die folgenden Beispiele beschreiben nur die Konfiguration der Dashboard-Widget-Feldobjekte für das Clock-Widget. Weitere Informationen zur Konfiguration eines Dashboards finden Sie unter dashboard.create.
Konfigurieren eines Uhr-Widgets
Konfigurieren Sie ein Uhr-Widget, das lokales Datum, Uhrzeit und Zeitzone in einer angepassten digitalen Uhr anzeigt.
{
"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
}Antwort:
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}