Documentation
Table of Contents
2 Reloj
Descripción
Estos parámetros y los posibles valores de la propiedad para los respectivos objetos de campo del widget del tablero permiten configurar el widget Reloj en los métodos dashboard.create y dashboard.update.
Las propiedades de los "campos" del widget no se validan durante la creación o actualización de un tablero. Esto permite a los usuarios modificar los widgets integrados y crear widgets personalizados, pero también introduce el riesgo de crear o actualizar widgets. incorrectamente. Para garantizar la creación o actualización exitosa del widget Reloj, consulte el comportamiento de los parámetros descrito en las tablas siguientes.
Parámetros
Los siguientes parámetros son compatibles con el widget Reloj.
| Parámetro | tipo | nombre | valor |
|---|---|---|---|
| Intervalo de actualización | 0 | rf_rate | 0 - Sin actualización; 10 - 10 segundos; 30 - 30 segundos; 60 - 1 minuto; 120 - 2 minutos; 600 - 10 minutos; 900 - (predeterminado) 15 minutos. |
| Tipo de hora | 0 | time_type | 0 - (predeterminado) Hora local; 1 - Hora del servidor; 2 - Hora del host. |
| Tipo de reloj | 0 | clock_type | 0 - (predeterminado) Analógico; 1 - Digital. |
Los siguientes parámetros son compatibles si Tipo de hora está configurado en "Hora del equipo".
| Parámetro | tipo | nombre | valor |
|---|---|---|---|
| Métrica | 4 | itemid | Métrica ID. Comportamiento del parámetro:< br>- obligatorio |
Los siguientes parámetros son compatibles si Tipo de reloj está configurado en "Digital".
| Parámetro | tipo | nombre | valor | |
|---|---|---|---|---|
| Mostrar | 0 | show | 1 - Fecha; 2 - (predeterminado) Hora; 3 - Zona horaria. Nota: Para configurar varios valores, cree un objeto de campo del widget del panel para cada valor. |
|
| Configuración avanzada | 0 | adv_conf | 0 - (predeterminado) Deshabilitado; 1 - Habilitado. El parámetro Configuración avanzada debe establecerse en "Habilitado" para configurar Fondo color y todas las opciones para Fecha, Hora y Zona horaria. |
|
| Color de fondo | 1 | bg_color | Código de color hexadecimal (por ejemplo, FF0000).Predeterminado: "" (vacío). |
|
| Fecha | ||||
| Tamaño | 0 | date_size | Los valores válidos oscilan entre 1 y 100. Predeterminado: 20. |
|
| Negrita | 0 | date_bold | 0 - (predeterminado) Deshabilitado; 1 - Habilitado. |
|
| Color | 1 | date_color | Código de color hexadecimal (por ejemplo, FF0000).Predeterminado: "" (vacío). |
|
| Hora | ||||
| Tamaño | 0 | time_size | Los valores válidos oscilan entre 1 y 100. Predeterminado: 30. |
|
| Negrita | 0 | time_bold | 0 - (predeterminado) Deshabilitado; 1 - Habilitado. |
|
| Color | 1 | time_color | Código de color hexadecimal (por ejemplo, FF0000).Predeterminado: "" (vacío). |
|
| Segundos | 0 | time_sec | 0 - Deshabilitado; 1 - (predeterminado) Habilitado. |
|
| Formato | 0 | time_format | 0 - (predeterminado) 24 horas; 1 - 12 horas. |
|
| Zona horaria | ||||
| Tamaño | 0 | tzone_size | Los valores válidos oscilan entre 1 y 100. Predeterminado: 20. |
|
| Negrita | 0 | tzone_bold | 0 - (predeterminado) Deshabilitado; 1 - Habilitado. |
|
| Color | 1 | tzone_color | Código de color hexadecimal (por ejemplo, FF0000).Predeterminado: "" (vacío). |
|
| Zona horaria | 1 | tzone_timezone | Cadena de zona horaria válida (por ejemplo, Europa/Riga, system, UTC, etc.). Para obtener la lista completa de zonas horarias admitidas, consulte la documentación de PHP.Predeterminado: local.El parámetro Zona horaria no está disponible si Tipo de hora está configurado en "Hora del host". |
|
| Formato | 0 | tzone_format | 0 - (predeterminado) Corto; 1 - Completo. El parámetro Formato no está disponible si Tipo de hora está configurado en "Hora del host ". |
|
Ejemplos
Los siguientes ejemplos pretenden describir únicamente la configuración de los objetos de campo del widget del tablero para el widget Reloj. Para obtener más información sobre cómo configurar un tablero, consulte dashboard.create.
Configuración de un widget Reloj
Configure un widget Reloj que muestre la fecha, hora y zona horaria local en un reloj digital personalizado.
{
"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": 4,
"height": 3,
"view_mode": 0,
"fields": [
{
"type": 0,
"name": "clock_type",
"value": 1
},
{
"type": 0,
"name": "show",
"value": 1
},
{
"type": 0,
"name": "show",
"value": 2
},
{
"type": 0,
"name": "show",
"value": 3
},
{
"type": 0,
"name": "adv_conf",
"value": 1
},
{
"type": 0,
"name": "date_size",
"value": 20
},
{
"type": 1,
"name": "date_color",
"value": "E1E1E1"
},
{
"type": 0,
"name": "time_bold",
"value": 1
},
{
"type": 0,
"name": "tzone_size",
"value": 10
},
{
"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
}Respuesta: