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 equipo.
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.0 ID de métrica.

Comportamiento del parámetro :
- obligatorio

Los siguientes parámetros son compatibles si Tipo de reloj está configurado en "Digital".

Parámetro tipo nombre valor
Mostrar 0 show.0 1 - Fecha;
2 - (predeterminado) Hora;
3 - Zona horaria.

Nota: Para configurar varios valores, cree un objeto de campo del widget del tablero para cada valor con un número incrementado en el nombre de la propiedad.

Configuración avanzada

Los siguientes parámetros de configuración avanzada son compatibles si Tipo de reloj está configurado en "Digital".

Parámetro tipo nombre valor
Color de fondo 1 bg_color Código de color hexadecimal (por ejemplo, FF0000).

Predeterminado: "" (vacío).
Fecha

Los siguientes parámetros de configuración avanzada son compatibles si Tipo de reloj está configurado en "Digital" y Mostrar está configurado en "Fecha".

Parámetro tipo nombre valor
Tamaño 0 date_size Los valores posibles 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).
Tiempo

Los siguientes parámetros de configuración avanzada son compatibles si Tipo de reloj está configurado en "Digital" y Mostrar está configurado en "Hora".

Parámetro tipo nombre valor
Tamaño 0 time_size Los valores posibles 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

Los siguientes parámetros de configuración avanzada son compatibles si Tipo de reloj está configurado en "Digital" y Mostrar está configurado en "Zona horaria".

Parámetro tipo nombre valor
Tamaño 0 tzone_size Los valores posibles 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.

Comportamiento de parámetros:
- compatible si Tipo de hora está configurado en "Hora local" o "Hora del servidor"
Formato 0 tzone_format 0 - (predeterminado) Corto;
1 - Completo.

Comportamiento de parámetros:<br >- compatible si Tipo de hora está configurado en "Hora local" o "Hora del servidor"

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.

Solicitud:

{
           "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.0",
                                       "value": 1
                                   },
                                   {
                                       "type": 0,
                                       "name": "show.1",
                                       "value": 2
                                   },
                                   {
                                       "type": 0,
                                       "name": "show.2",
                                       "value": 3
                                   },
                                   {
                                       "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:

{
           "jsonrpc": "2.0",
           "result": {
               "dashboardids": [
                   "3"
               ]
           },
           "id": 1
       }

Ver también