2 Horloge
Description
Ces paramètres et les valeurs de propriété possibles pour les objets de champ du widget de tableau de bord correspondants permettent de configurer le widget Clock dans les méthodes dashboard.create et dashboard.update.
Les propriétés fields du widget ne sont pas validées lors de la création ou de la mise à jour d’un tableau de bord.
Cela permet aux utilisateurs de modifier les widgets intégrés et de créer des widgets personnalisés, mais introduit également le risque de créer ou de mettre à jour des widgets de manière incorrecte.
Pour garantir la réussite de la création ou de la mise à jour du widget Clock, veuillez vous référer au comportement des paramètres décrit dans les tableaux ci-dessous.
Paramètres
Les paramètres suivants sont pris en charge pour le widget Horloge.
| Paramètre | type | name | value |
|---|---|---|---|
| Intervalle d’actualisation | 0 | rf_rate | 0 - Pas d’actualisation ; 10 - 10 secondes ; 30 - 30 secondes ; 60 - 1 minute ; 120 - 2 minutes ; 600 - 10 minutes ; 900 - (par défaut) 15 minutes. |
| Type d’heure | 0 | time_type | 0 - (par défaut) Heure locale ; 1 - Heure du serveur ; 2 - Heure de l’hôte. |
| Type d’horloge | 0 | clock_type | 0 - (par défaut) Analogique ; 1 - Numérique. |
Les paramètres suivants sont pris en charge si Type d’heure est défini sur "Heure de l’hôte".
| Paramètre | type | name | value |
|---|---|---|---|
| Élément | 4 | itemid.0 | ID de l’élément. Comportement du paramètre : - obligatoire |
Les paramètres suivants sont pris en charge si Type d’horloge est défini sur "Numérique".
| Paramètre | type | name | value |
|---|---|---|---|
| Afficher | 0 | show.0 | 1 - Date ; 2 - (par défaut) Heure ; 3 - Fuseau horaire. Remarque : pour configurer plusieurs valeurs, créez un objet de champ de widget de tableau de bord pour chaque valeur avec un numéro incrémenté dans le nom de la propriété. |
Configuration avancée
Les paramètres de configuration avancée suivants sont pris en charge si le Type d'horloge est défini sur « Numérique ».
| Paramètre | type | name | value |
|---|---|---|---|
| Couleur d’arrière-plan | 1 | bg_color | Code couleur hexadécimal (par ex. FF0000).Par défaut : "" (vide). |
Date
Les paramètres de configuration avancés suivants sont pris en charge si Clock type est défini sur « Digital » et Show sur « Date ».
| Parameter | type | name | value |
|---|---|---|---|
| Gras | 0 | date_bold | 0 - (par défaut) Désactivé ; 1 - Activé. |
| Couleur | 1 | date_color | Code couleur hexadécimal (par exemple, FF0000).Par défaut : "" (vide). |
Heure
Les paramètres de configuration avancés suivants sont pris en charge si Type d’horloge est défini sur « Digital » et Afficher sur « Heure ».
| Paramètre | type | name | value |
|---|---|---|---|
| Gras | 0 | time_bold | 0 - (par défaut) Désactivé; 1 - Activé. |
| Couleur | 1 | time_color | Code couleur hexadécimal (par ex. FF0000).Par défaut : "" (vide). |
| Secondes | 0 | time_sec | 0 - Désactivé; 1 - (par défaut) Activé. |
| Format | 0 | time_format | 0 - (par défaut) 24 heures; 1 - 12 heures. |
Fuseau horaire
Les paramètres de configuration avancée suivants sont pris en charge si Type d’horloge est défini sur « Digital » et Afficher est défini sur « Fuseau horaire ».
| Paramètre | type | name | value |
|---|---|---|---|
| Gras | 0 | tzone_bold | 0 - (par défaut) Désactivé; 1 - Activé. |
| Couleur | 1 | tzone_color | Code couleur hexadécimal (par ex. FF0000).Par défaut : "" (vide). |
| Fuseau horaire | 1 | tzone_timezone | Chaîne de fuseau horaire valide (par ex. Europe/Riga, system, UTC, etc.). Pour la liste complète des fuseaux horaires pris en charge, veuillez consulter la documentation PHP.Par défaut : local.Comportement du paramètre : - pris en charge si Type d’heure est défini sur « Heure locale » ou « Heure du serveur » |
| Format | 0 | tzone_format | 0 - (par défaut) Court; 1 - Complet. Comportement du paramètre : - pris en charge si Type d’heure est défini sur « Heure locale » ou « Heure du serveur » |
Exemples
Les exemples suivants visent à décrire uniquement la configuration des objets de champ du widget de tableau de bord pour le widget Horloge.
Pour plus d'informations sur la configuration d'un tableau de bord, consultez dashboard.create.
Configuration d’un widget Clock
Configurez un widget Clock qui affiche la date locale, l’heure et le fuseau horaire dans une horloge numérique personnalisée.
{
"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
}Réponse :
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}