Esses parâmetros e os possíveis valores de propriedade para os respectivos objetos de campo do widget de dashboard permitem configurar o widget Plain text nos métodos dashboard.create
e dashboard.update
/
As propriedades do widget fields
não são validadas durante a criação e atualização de um dashboard. Isso permite que os usuários modifiquem os Widgets integrados built-in widgets e criem Widgets personalizados custom widgets, mas também introduz o risco de criar e atualizar Widgets de forma incorreta. Para garantir a criação ou atualização bem-sucedida do widget Texto simples, consulte os requisitos de parâmetros delineados nas tabelas abaixo.
Os seguintes parâmetros são suportados para o widget Texto simples.
Parâmetro | type | nome | valor |
---|---|---|---|
Intervalo de atualziação | 0 | rf_rate | 0 - Sem atualização; 10 - 10 segundos; 30 - 30 segundos; 60 - (padrão) 1 minuto; 120 - 2 minutos; 600 - 10 minutos; 900 - 15 minutos. |
Itens (obrigatório) |
4 | itemids | ID do Item. Observe: Para configurar vários itens, crie um objeto de campo de widget de dashboard para cada item. |
Localização dos itens | 0 | style | 0 - (padrão) Esquerda; 1 - Superior. |
Mostrar linhas | 0 | show_lines | Valores válidos variam de 1-100. Padrão: 25. |
Mostrar texto como HTML | 0 | show_as_html | 0 - (padrão) Desativado; 1 - Habilitado. |
Item dinâmico | 0 | dynamic | 0 - (padrão) Desativado; 1 - habilitado. |
Os seguintes exemplos têm como objetivo apenas descrever a configuração dos objetos de campo do widget de dashboard para o widget Texto simples. Para obter mais informações sobre a configuração de um dashboard, consulte dashboard.create
.
Configure um widget Texto Simples que exibe os dados mais recentes para os itens "42269" e "42253". Além disso, configure os nomes dos itens para serem localizados no topo das colunas de dados e exiba apenas 15 linhas de dados.
Solicitação:
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "plaintext",
"name": "Plain text",
"x": 0,
"y": 0,
"width": 6,
"height": 3,
"view_mode": 0,
"fields": [
{
"type": 4,
"name": "itemids",
"value": 42269
},
{
"type": 4,
"name": "itemids",
"value": 42253
},
{
"type": 0,
"name": "style",
"value": 1
},
{
"type": 0,
"name": "show_lines",
"value": 15
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}
Resposta: