Documentation
Table of Contents
17 Valor de l'element
¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®
Aquests par¨¤metres i els possibles valors de propietat per als objectes de camp del giny del tauler de control respectius permeten configurar el giny Valor d'element als m¨¨todes dashboard.create i dashboard.update.
Les propietats dels camps del giny no es validen pas durant la creaci¨® o actualitzaci¨® d'un tauler. Aix¨° permet als usuaris modificarels ginys integrats i crear ginys personalitzats, per¨° tamb¨¦ afegeix el risc de creaci¨® o actualitzaci¨® incorrectes dels ginys. Per garantir la creaci¨® o actualitzaci¨® correcta del giny Valor d'element, consulteu el comportament dels par¨¤metres que es descriuen a les taules seg¨¹ents.
±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ
S'admeten els par¨¤metres seg¨¹ents per al giny Valor d'element.
| ±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð | tipus | nom | |
|---|---|---|---|
| Interval d'actualitzaci¨® | 0 | rf_rate | 0 - Sense actualitzaci¨®; 10 - 10 segons; 30 - 30 segons; 60 - (per defecte) 1 minut; 120 - 2 minuts; 600 - 10 minuts; 900 - 15 minuts. |
| Element | 4 | itemid.0 | |
| Element (Giny) | 1 | itemid._reference | |
| Veure | 0 | show.0 | |
| Substitueix l'equip | 1 | override_hostid._reference | |
°ä´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨® avan?ada
Els par¨¤metres seg¨¹ents s'admeten si la °ä´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨® avan?ada ¨¦s establerta a "Habilitada".
El nombre del nom de propietat Llindars (p. ex., thresholds.color.0) fa refer¨¨ncia al lloc del llindar en una llista, en ordre ascendent. Tanmateix, si els llindars es configuren en un ordre diferent, els valors s'ordenaran en ordre ascendent despr¨¦s d'actualitzar la configuraci¨® del giny a la interf¨ªcie de Áú»¢¶Ä²© (p. ex., "threshold.threshold.0":"5" ¡ú "threshold.threshold.0":"1"; "threshold.threshold.1":"1" ¡ú "threshold.threshold. 1": "5").
| ±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð | tipus | nom | valor | |
|---|---|---|---|---|
| Color de fons | 1 | bg_color | Codi de color hexadecimal (p.e. FF0000).Per defecte: "" (buit). |
|
| Llindars | ||||
| Color | 1 | thresholds.color.0 | Codi de color hexadecimal (p.e. FF0000). |
|
| Llindar | 1 | thresholds.threshold.0 | Qualsevol valor de cadena. | |
| Funci¨® d'agregaci¨® | 0 | ´Ú³Ü²Ô³¦¾±¨®³å²¹²µ°ù±ð²µ²¹»å²¹ | 0 - (per defecte) no emprada; 1 - m¨ªn; 2 - m¨¤xim; 3 - mitjana; 4 - recompte; 5 - suma; 6 - primer; 7 - darrer. |
|
¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®
Els par¨¤metres seg¨¹ents de configuraci¨® avan?ada s'admeten si Veure ¨¦s establert a "¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®".
| ±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð | tipus | nom | valor |
|---|---|---|---|
| ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® | 1 | »å±ð²õ³¦°ù¾±±è³¦¾±¨® | Qualsevol valor de cadena, incloses les macros. Macros admeses: {HOST.*}, {ITEM.*}, {INVENTORY.*}, macros d'usuari. < br>Per defecte: {ITEM.NAME}. |
| ±Ê´Ç²õ¾±³¦¾±¨® horitzontal | 0 | desc_h_pos | 0 - Esquerra; 1 - (per defecte) Centre; 2 - Dreta. Dos o m¨¦s elements (¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®, Valor, Hora) no poden pas tindre la mateixa ±Ê´Ç²õ¾±³¦¾±¨® horitzontal i ±Ê´Ç²õ¾±³¦¾±¨® vertical. |
| ±Ê´Ç²õ¾±³¦¾±¨® vertical | 0 | desc_v_pos | 0 - Damunt; 1 - ²Ñ¾±³ÙÂᨤ; 2 - (per defecte) Sota. Dos o m¨¦s elements (¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®, Valor, Temps) no poden pas tindre la mateixa ±Ê´Ç²õ¾±³¦¾±¨® horitzontal i ±Ê´Ç²õ¾±³¦¾±¨® vertical. |
| Mida | 0 | desc_size | Valors v¨¤lids dins el rang 1-100. Per defecte: 15. |
| Ngreta | 0 | desc_bold | 0 - (per defecte) Deshabilitat; 1 - Habilitat. |
| Color | 1 | desc_color | Codi de color hexadecimal (p.e. FF0000).Per defecte: "" (buit). |
Valor
Els par¨¤metres seg¨¹ents de configuraci¨® avan?ada s'admeten si Veure ¨¦s establert a "Valor".
|±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð|<|tipus|nom|valor| |-|--------|--|---------|---------------------------- -----| |Llocs decimals|<|<|<|<| |<|Llocs decimals|0|Llocs_decimals|Els valors v¨¤lids van d'1 a 10.
Per defecte: 2.| |^|Mida|0|mida_decimal|Els valors v¨¤lids oscil¡¤len entre 1 i 100.
Per defecte: 35.| |±Ê´Ç²õ¾±³¦¾±¨®|<|<|<|<| |<|±Ê´Ç²õ¾±³¦¾±¨® horitzontal|0|value_h_pos|0 - Esquerra;
1 - (per defecte) Centre;
2 - Dreta.
Dos o m¨¦s elements (¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®, Valor, Temps) no poden pas tindre la mateixa ±Ê´Ç²õ¾±³¦¾±¨® horitzontal i ±Ê´Ç²õ¾±³¦¾±¨® vertical.| |^|±Ê´Ç²õ¾±³¦¾±¨® vertical|0|value_v_pos|0 - Amunt;
1 - (per defecte) ²Ñ¾±³ÙÂᨤ;
2 - A baix.
Dos o m¨¦s elements (¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®, Valor, Temps) no poden pas tindre la mateixa ±Ê´Ç²õ¾±³¦¾±¨® horitzontal i ±Ê´Ç²õ¾±³¦¾±¨® vertical.| |^|Mida|0|mida_valor|Els valors v¨¤lids oscil¡¤len entre 1 i 100.
Per defecte: 45.| |^|Negreta|0|value_bold|0 - Inhabilitat;
1 - (per defecte) Activat.| |^|Color|1|valor_color|Codi de color hexadecimal (p. ex., FF0000).
Per defecte: "" (buit).| |Unitats|<|<|<|<| |<|Unitats (casilla de selecci¨®)|0|unitats_mostra|0 - Inhabilitat;
1 - (per defecte) Activat.| |^|Unitats (valor)|1|unitats|Qualsevol valor de cadena.| |^|±Ê´Ç²õ¾±³¦¾±¨®|0|units_pos|0 - Abans del valor;
1 - Per sobre del valor;
2 - (per defecte) Despr¨¦s del valor;
3 - Per sota del valor.| |^|Mida|0|mida_unitats|Els valors v¨¤lids oscil¡¤len entre 1 i 100.
Per defecte: 35.| |^|Negreta|0|units_bold|0 - Inhabilitat;
1 - (per defecte) Activat.| |^|Color|1|unitats_color|Codi de color hexadecimal (p. ex., FF0000).
Per defecte: "" (buit).|
Hora
Els par¨¤metres seg¨¹ents de configuraci¨® avan?ada s'admeten si Veure ¨¦s establert a "Hora".
| ±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð | tipus | nom | |
|---|---|---|---|
| ±Ê´Ç²õ¾±³¦¾±¨® horitzontal | 0 | value_h_pos | |
| ±Ê´Ç²õ¾±³¦¾±¨® vertical | 0 | value_v_pos | |
| Mida | 0 | mida_valor | |
| Negreta | 0 | value_bold | |
| Color | 1 | valor_color | |
Indicador de canvi
Els par¨¤metres seg¨¹ents de configuraci¨® avan?ada s'admeten si Veure ¨¦s establert a "Indicador de canvi".
| ±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð | tipus | nom | |
|---|---|---|---|
| Indicador de canvi ¡ü color | 1 | up_color | Codi de color hexadecimal (p. ex., FF0000).Per defecte: "" (buit). |
| Indicador de canvi ¡ý color | 1 | down_color | Codi de color hexadecimal (p. ex., FF0000).Per defecte: "" (buit). |
| Indicador de canvi ? color | 1 | updown_color | Codi de color hexadecimal (p. ex., FF0000).Per defecte: "" (buit). |
Sparkline
Els seg¨¹ents par¨¤metres de configuraci¨® avan?ada s¨®n compatibles si Mostra est¨¤ establert a "Sparkline".
|±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð|<|tipus|nom|valor| |-|--------|--|---------|---------------------------- -----| |Amplada|<|0|sparkline.width|Els valors possibles oscil¡¤len entre 0 i 10.
Per defecte: 1.| |Emplenar|<|0|sparkline.fill|Els valors possibles oscil¡¤len entre 0 i 10.
Per defecte: 3.| |Color|<|1|sparkline.color|Codi de color hexadecimal (p. ex., FF0000).
Per defecte: 42A5F5.| |Per¨ªode de temps|<|1|sparkline.time_period._reference|DASHBOARD._timeperiod - estableix la tria de Per¨ªode de temps com a font de dades;ABCDE ._timeperiod - estableix un giny compatible (amb el seu par¨¤metre reference igual a ABCDE) com a font de dades.
Per defecte: DASHBOARD._timeperiod< br>
Com alternativa, podeu establir el per¨ªode de temps nom¨¦s als par¨¤metres De i A.| |<|Des de|1|sparkline.time_period.from|Cadena de temps v¨¤lida en la sintaxi temporal absoluta (AAAA-MM-DD hh:mm:ss) o relativa (ara, ara/d, ara/w-1w, etc.).| |^|Fins a|1|sparkline.time_period.to|Cadena de temps v¨¤lida en sintaxi de temps absoluta (AAAA-MM-DD hh:mm:ss) o relativa (ara, ara/d, ara/w-1w, etc.).| |Dades de l'historial|<|0|sparkline.history|0 - (per defecte) ´¡³Ü³Ù´Ç³¾¨¤³Ù¾±³¦;
1 - Historial;
2 - Tend¨¨ncies.|
Exemples
Els exemples seg¨¹ents nom¨¦s tenen com a objectiu descriure la configuraci¨® dels objectes de camp del giny del tauler de control per al giny Valor d'element. Per obtindre m¨¦s informaci¨® sobre la configuraci¨® d'un tauler, veieu dashboard.create.
Configurar el giny Valor d'element
Configura un giny Valor d'element que mostra el valor de l'element "42266" (disponibilitat de l'agent Áú»¢¶Ä²© ). A m¨¦s, visualment afina el giny amb m¨¦s opcions avan?ades, fins i tot amb un color de fons din¨¤mic que canvia en base a l'estat de disponibilitat de l'agent Áú»¢¶Ä²©.
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "El meu tauler",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "item",
"name": "Item value",
"x": 0,
"y": 0,
"width": 4,
"height": 3,
"view_mode": 0,
"fields": [
{
"type": 4,
"name": "itemid",
"value": 42266
},
{
"type": 0,
"name": "show",
"value": 1
},
{
"type": 0,
"name": "show",
"value": 2
},
{
"type": 0,
"name": "show",
"value": 3
},
{
"type": 0,
"name": "adv_conf",
"value": 1
},
{
"type": 1,
"name": "description",
"value": "Agent status"
},
{
"type": 0,
"name": "desc_h_pos",
"value": 0
},
{
"type": 0,
"name": "desc_v_pos",
"value": 0
},
{
"type": 0,
"name": "desc_bold",
"value": 1
},
{
"type": 1,
"name": "desc_color",
"value": "F06291"
},
{
"type": 0,
"name": "value_h_pos",
"value": 0
},
{
"type": 0,
"name": "value_size",
"value": 25
},
{
"type": 1,
"name": "value_color",
"value": "FFFF00"
},
{
"type": 0,
"name": "units_show",
"value": 0
},
{
"type": 0,
"name": "time_h_pos",
"value": 2
},
{
"type": 0,
"name": "time_v_pos",
"value": 2
},
{
"type": 0,
"name": "time_size",
"value": 10
},
{
"type": 0,
"name": "time_bold",
"value": 1
},
{
"type": 1,
"name": "time_color",
"value": "9FA8DA"
},
{
"type": 1,
"name": "thresholds.color.0",
"value": "E1E1E1"
},
{
"type": 1,
"name": "thresholds.threshold.0",
"value": "0"
},
{
"type": 1,
"name": "thresholds.color.1",
"value": "D1C4E9"
},
{
"type": 1,
"name": "thresholds.threshold.1",
"value": "1"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Resposta: