2 Uhr
Beschreibung
Mit diesen Parametern und den möglichen Eigenschaftswerten für die jeweiligen Feldobjekte des Dashboard-Widgets können Sie das Widget Uhr in den Methoden dashboard.create und dashboard.update konfigurieren.
Die Eigenschaften von fields des Widgets werden während der Erstellung oder Aktualisierung eines Dashboards nicht validiert.
Dies ermöglicht es Benutzern, integrierte Widgets zu ändern und benutzerdefinierte Widgets zu erstellen, birgt jedoch auch das Risiko, Widgets falsch zu erstellen oder zu aktualisieren.
Um die erfolgreiche Erstellung oder Aktualisierung des Widgets Uhr sicherzustellen, beachten Sie bitte das in den folgenden Tabellen beschriebene Parameterverhalten.
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
}