Table of Contents
2 Relógio
Descrição
Esses parâmetros e os possíveis valores de propriedade para os respectivos objetos de campo do widget de dashboard permitem configurar o widget Relógio nos métodos dashboard.create e dashboard.update.
As propriedades fields do widget não são validadas durante a criação ou atualização de um dashboard. Isso permite que os usuários modifiquem widgets internos e criem widgets personalizados, mas também introduz o risco de criar ou atualizar widgets incorretamente. Para garantir a criação ou atualização bem-sucedida do widget Relógio, consulte o comportamento dos parâmetros descrito nas tabelas abaixo.
Parâmetros
Os seguintes parâmetros são suportados para o widget Relógio.
| Parâmetro | tipo | nome | valor |
|---|---|---|---|
| Intervalo de atualização | 0 | rf_rate | 0 - Sem atualização; 10 - 10 segundos; 30 - 30 segundos; 60 - 1 minuto; 120 - 2 minutos; 600 - 10 minutos; 900 - (padrão) 15 minutos. |
| Tipo de hora | 0 | time_type | 0 - (padrão) Hora local; 1 - Hora do server; 2 - Hora do host. |
| Tipo de relógio | 0 | clock_type | 0 - (padrão) Analógico; 1 - Digital. |
Os seguintes parâmetros são suportados se o Tipo de hora estiver definido como "Hora do host".
| Parâmetro | tipo | nome | valor |
|---|---|---|---|
| Item | 4 | itemid.0 | ID do item. Comportamento do parâmetro: - obrigatório |
Os seguintes parâmetros são suportados se o Tipo de relógio estiver definido como "Digital".
| Parâmetro | tipo | nome | valor |
|---|---|---|---|
| Mostrar | 0 | show.0 | 1 - Data; 2 - (padrão) Hora; 3 - Fuso horário. Nota: Para configurar vários valores, crie um objeto de campo de widget de dashboard para cada valor com um número incrementado no nome da propriedade. |
Configuração avançada
Os seguintes parâmetros de configuração avançada são suportados se o Tipo de relógio estiver definido como "Digital".
| Parâmetro | tipo | nome | valor |
|---|---|---|---|
| Cor de fundo | 1 | bg_color | Código de cor hexadecimal (por exemplo, FF0000).Padrão: "" (vazio). |
Data
Os seguintes parâmetros de configuração avançada são suportados se o Tipo de relógio estiver definido como "Digital" e Mostrar estiver definido como "Data".
| Parâmetro | tipo | nome | valor |
|---|---|---|---|
| Negrito | 0 | date_bold | 0 - (padrão) Desabilitado; 1 - Habilitado. |
| Cor | 1 | date_color | Código de cor hexadecimal (por exemplo, FF0000).Padrão: "" (vazio). |
Hora
Os seguintes parâmetros de configuração avançada são suportados se o Tipo de relógio estiver definido como "Digital" e Mostrar estiver definido como "Hora".
| Parâmetro | tipo | nome | valor |
|---|---|---|---|
| Negrito | 0 | time_bold | 0 - (padrão) Desabilitado; 1 - Habilitado. |
| Cor | 1 | time_color | Código de cor hexadecimal (por exemplo, FF0000).Padrão: "" (vazio). |
| Segundos | 0 | time_sec | 0 - Desabilitado; 1 - (padrão) Habilitado. |
| Formato | 0 | time_format | 0 - (padrão) 24 horas; 1 - 12 horas. |
Fuso horário
Os seguintes parâmetros de configuração avançada são suportados se o Tipo de relógio estiver definido como "Digital" e Mostrar estiver definido como "Fuso horário".
| Parâmetro | tipo | nome | valor |
|---|---|---|---|
| Negrito | 0 | tzone_bold | 0 - (padrão) Desabilitado; 1 - Habilitado. |
| Cor | 1 | tzone_color | Código de cor hexadecimal (por exemplo, FF0000).Padrão: "" (vazio). |
| Fuso horário | 1 | tzone_timezone | String de fuso horário válida (por exemplo, Europe/Riga, system, UTC, etc.). Para a lista completa de fusos horários suportados, consulte a documentação do PHP.Padrão: local.Comportamento do parâmetro: - suportado se o Tipo de hora estiver definido como "Hora local" ou "Hora do servidor" |
| Formato | 0 | tzone_format | 0 - (padrão) Curto; 1 - Completo. Comportamento do parâmetro: - suportado se o Tipo de hora estiver definido como "Hora local" ou "Hora do servidor" |
Exemplos
Os exemplos a seguir têm como objetivo apenas descrever a configuração dos objetos de campo do widget do dashboard para o widget Clock. Para obter mais informações sobre como configurar um dashboard, consulte dashboard.create.
Configurando um widget Clock
Configure um widget Clock que exibe a data, hora e fuso horário local em um relógio 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": 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
}Resposta: