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 Tarja 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 modificar els 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 Tarja d'element, consulteu el comportament dels paràmetres que es descriuen a les taules següents.
El giny Tarja d'element admet els paràmetres següents.
| Paràmetre | type | name | value | |
|---|---|---|---|---|
| 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 | ID de l'element. Comportament del paràmetre: - obligatori si Element (Giny) no és definit | |
| Item (Widget) | 1 | itemid._reference | En lloc de Item ID: ABCDE._itemid- estableix un widget compatible (amb el seu paràmetre Reference definit com a "ABCDE") com a font de dades per a l'element.Comportament del paràmetre: - obligatori si element no és definit | |
| Mostra | 0 | seccions.0 | 0 - Descripció; 1 - Text d'error; 2 - Mètriques; 3 - Dades més recents; 4 - Tipus d'informació; 5 - Activadors; 6 - Interfície d'equip; 7 - Tipus; 8 - Inventari d'equip; 9 - Etiquetes. Nota: El nombre del nom de la propietat fa referència a l'ordre de les seccions a la llista de seccions. Per configurar diverses seccions, creeu un objecte de camp del giny del tauler de control per a cada secció amb un nombre incremental al nom de la propietat. | |
Els paràmetres següents són compatibles si Veure és definit a "Dades més recents".
| Paràmetre | tipus | nom | valor | |
|---|---|---|---|---|
| Amplada | 0 | sparkline.width | Els valors possibles ballen entre 0 i 10. Per defecte: 1. | |
| Emplenar | 0 | sparkline.fill | Els valors possibles ballen entre 0 i 10. Per defecte: 3. | |
| Color | 1 | sparkline.color | Codi de color hexadecimal (per exemple, FF0000).Per defecte: 42A5F5. | |
| Període de temps | 1 | sparkline.time_period._reference | DASHBOARD._timeperiod- defineix el selector Període de temps com a font de dades;ABCDE._timeperiod- defineix un giny compatible (amb el seu paràmetrereferenceigual aABCDE) com a font de dades.Per defecte: ""(buit)Alternativament, només podeu definir el període de temps als paràmetres Des de i Fins a. | |
Dades de l'historial|<|0|sparkline.history|0 - (per defecte) Automàtic;
1 - Historial;
2 - Tendències.|
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 Tarja d'element. Per obtindre més informació sobre la configuració d'un tauler, veieu dashboard.create.
Configura un giny Tarja d'element que ensenyi aquestes seccions: "Descripció", "Dades més recents", "Triggers" i "Tags".
{
           "jsonrpc": "2.0",
           "method": "dashboard.create",
           "params": {
               "name": "My dashboard",
               "display_period": 30,
               "auto_start": 1,
               "pages": [
                   {
                       "widgets": [
                           {
                               "type": "itemcard",
                               "name": "Item card",
                               "x": 0,
                               "y": 0,
                               "width": 14,
                               "height": 7,
                               "view_mode": 0,
                               "fields": [
                                   {
                                       "type": 4,
                                       "name": "itemid.0",
                                       "value": 42257
                                   },
                                   {
                                       "type": 0,
                                       "name": "sections.0",
                                       "value": 0
                                   },
                                   {
                                       "type": 0,
                                       "name": "sections.1",
                                       "value": 3
                                   },
                                   {
                                       "type": 0,
                                       "name": "sections.2",
                                       "value": 5
                                   },
                                   {
                                       "type": 0,
                                       "name": "sections.3",
                                       "value": 9
                                   }
                               ]
                           }
                       ]
                   }
               ],
               "userGroups": [
                   {
                       "usrgrpid": 7,
                       "permission": 2
                   }
               ],
               "users": [
                   {
                       "userid": 1,
                       "permission": 3
                   }
               ]
           },
           "id": 1
       }Resposta: