Documentation
Table of Contents
15 Texto sin formato
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 Texto sin formato 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 Texto sin formato, consulte los requisitos de parámetros descritos en las tablas siguientes.
Parámetros
Los siguientes parámetros son compatibles con el widget Texto sin formato.
| Parámetro | tipo | nombre | valor |
|---|---|---|---|
| Intervalo de actualización | 0 | rf_rate | 0 - Sin actualización; 10 - 10 segundos; 30 - 30 segundos; 60 - (predeterminado) 1 minuto; 120 - 2 minutos; 600 - 10 minutos; 900 - 15 minutos. |
| Métricas (obligatorio) |
4 | itemids | ID de métrica. Nota: Para configurar varias métricas, cree un objeto de campo de widget de tablero para cada métrica. |
| Ubicación de las métricas | 0 | style | 0 - (predeterminado) Izquierda; 1 - Arriba. |
| Mostrar líneas | 0 | show_lines | Los valores válidos oscilan entre 1 y 100. Predeterminado: 25. |
| Mostrar texto como HTML | 0 | show_as_html | 0 - (predeterminado) Deshabilitado; 1 - Habilitado. |
| Métrica dinámica | 0 | dynamic | 0 - (predeterminado) Deshabilitado; 1 - Habilitado. |
Ejemplos
Los siguientes ejemplos pretenden describir únicamente la configuración de los objetos de campo del widget del tablero para el widget Texto sin formato. Para obtener más información sobre cómo configurar un tablero, consulte dashboard.create.
Configuración de un widget de texto sin formato
Configure un widget de texto sin formato que muestre los datos más recientes para las métricas "42269" y "42253". Además, configure los nombres de las métricas para que se ubiquen en la parte superior de las columnas de datos y solo se muestren 15 líneas de datos.
Solicitud:
{
"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
}Respuesta: