Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Esta página fue traducida automáticamente. Si detectas un error, selecciónalo y presiona Ctrl+Enter para informarlo a los editores.

2 Reloj

Descripción

Estos parámetros y los posibles valores de las propiedades para los respectivos objetos de campo de widget de panel permiten configurar el widget Reloj en los métodos dashboard.create y dashboard.update.

Las propiedades fields del widget no se validan durante la creación o actualización de un panel. 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 a continuación.

Parámetros

Los siguientes parámetros son compatibles para 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 - (por defecto) 15 minutos.
Tipo de hora 0 time_type 0 - (por defecto) Hora local;
1 - Hora del servidor;
2 - Hora del equipo.
Tipo de reloj 0 clock_type 0 - (por defecto) Analógico;
1 - Digital.

Los siguientes parámetros son compatibles si Tipo de hora está configurado como "Hora del equipo".

Parámetro tipo nombre valor
Métrica 4 itemid.0 ID de la métrica.

Comportamiento del parámetro:
- obligatorio

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

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

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

Configuración avanzada

Se admiten los siguientes parámetros de configuración avanzada si el Tipo de reloj está establecido en "Digital".

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

Por defecto: "" (vacío).
Fecha

Se admiten los siguientes parámetros de configuración avanzada si el Tipo de reloj está configurado en "Digital" y Mostrar está configurado en "Fecha".

Parámetro tipo nombre valor
Negrita 0 date_bold 0 - (por defecto) Deshabilitado;
1 - Habilitado.
Color 1 date_color Código de color hexadecimal (por ejemplo, FF0000).

Por defecto: "" (vacío).
Hora

Se admiten los siguientes parámetros de configuración avanzada si Tipo de reloj está configurado como "Digital" y Mostrar está configurado como "Hora".

Parámetro tipo nombre valor
Negrita 0 time_bold 0 - (por defecto) Deshabilitado;
1 - Habilitado.
Color 1 time_color Código de color hexadecimal (por ejemplo, FF0000).

Por defecto: "" (vacío).
Segundos 0 time_sec 0 - Deshabilitado;
1 - (por defecto) Habilitado.
Formato 0 time_format 0 - (por defecto) 24 horas;
1 - 12 horas.
Zona horaria

Se admiten los siguientes parámetros de configuración avanzada si Tipo de reloj está establecido en "Digital" y Mostrar está establecido en "Zona horaria".

Parámetro tipo nombre valor
Negrita 0 tzone_bold 0 - (por defecto) Deshabilitado;
1 - Habilitado.
Color 1 tzone_color Código de color hexadecimal (por ejemplo, FF0000).

Por defecto: "" (vacío).
Zona horaria 1 tzone_timezone Cadena de zona horaria válida (por ejemplo, Europe/Riga, system, UTC, etc.). Para la lista completa de zonas horarias admitidas, consulte la documentación de PHP.

Por defecto: local.

Comportamiento del parámetro:
- admitido si Tipo de hora está establecido en "Hora local" o "Hora del servidor"
Formato 0 tzone_format 0 - (por defecto) Corto;
1 - Completo.

Comportamiento del parámetro:
- admitido si Tipo de hora está establecido en "Hora local" o "Hora del servidor"

Ejemplos

Los siguientes ejemplos tienen como objetivo describir únicamente la configuración de los objetos de campo del widget de panel para el widget Reloj. Para obtener más información sobre la configuración de un panel, 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": "Mi panel",
               "display_period": 30,
               "auto_start": 1,
               "pages": [
                   {
                       "widgets": [
                           {
                               "type": "clock",
                               "name": "Reloj",
                               "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
       }

Respuesta:

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

Véase también