Áú»¢¶Ä²©

dashboard.update

¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®

object dashboard.update(object/array dashboards)

Aquest m¨¨tode permet actualitzar taulers ja existents.

Aquest m¨¨tode ¨¦s disponible per a qualsevol mena d'usuaris. Els permisos per cridar al m¨¨tode es poden revocar a la configuraci¨® de rols d'usuaris. Per a m¨¦s informaci¨®, veieu Rols d'usuari.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ

(object/array) Tauler a actualitzar.

La propietat dashboardid s'ha de definir per a cada tauler, totes les altres propietats s¨®n opcionals. Nom¨¦s s'actualitzaran les propietats facilitades.

A m¨¦s de les [propietats del tauler de plantilla] est¨¤ndard (object#dashboard), el m¨¨tode admet els par¨¤metres seg¨¹ents.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð Tipus ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®
pages taula P¨¤gines del tauler substituint les p¨¤gines del tauler de control existents.

Les p¨¤gines del tauler de control s'actualitzen mitjan?ant la propietat dashboard_pageid. Es crearan p¨¤gines de tauler noves per als objectes sense una propietat dashboard_pageid i les p¨¤gines de tauler existents s'esborraran si no es reutilitzen. Les p¨¤gines del tauler s'ordenaran en el mateix ordre especificat. Nom¨¦s s'actualitzaran les propietats especificades de les p¨¤gines del tauler.
users taula Usuari del tauler per substituir els elements existents.
userGroups taula Grup d'usuaris del tauler per substituir els elements existents.

Valors de retorn

(object) Torna un objecte que contingui els IDs dels taulers actualitzats sota la propietat dashboardids.

Exemples

Reanomenant un tauler

Reanomenar el tauler com a "Estat del servidor SQL".

±Ê±ð³Ù¾±³¦¾±¨®:

{
           "jsonrpc": "2.0",
           "method": "dashboard.update",
           "params": {
               "dashboardid": "2",
               "name": "SQL server status"
           },
           "id": 1
       }

Resposta:

{
           "jsonrpc": "2.0",
           "result": {
               "dashboardids": [
                   "2"
               ]
           },
           "id": 1
       }

Actualitzar les p¨¤gines del tauler

Reanomenar la primera p¨¤gina del tauler, reempla?ar els ginys a la segona p¨¤gina i afegir una nova p¨¤gina com a tercera del tauler. Esborrar la resta de p¨¤gines del tauler.

±Ê±ð³Ù¾±³¦¾±¨®:

{
           "jsonrpc": "2.0",
           "method": "dashboard.update",
           "params": {
               "dashboardid": "2",
               "pages": [
                   {
                       "dashboard_pageid": 1,
                       "name": "Renamed Page"
                   },
                   {
                       "dashboard_pageid": 2,
                       "widgets": [
                           {
                               "type": "clock",
                               "x": 0,
                               "y": 0,
                               "width": 12,
                               "height": 3
                           }
                       ]
                   },
                   {
                       "display_period": 60
                   }
               ]
           },
           "id": 1
       }

Resposta:

{
           "jsonrpc": "2.0",
           "result": {
               "dashboardids": [
                   "2"
               ]
           },
           "id": 1
       }

Canviar el propietari del tauler

Disponible nom¨¦s per a admins i super admins.

±Ê±ð³Ù¾±³¦¾±¨®:

{
           "jsonrpc": "2.0",
           "method": "dashboard.update",
           "params": {
               "dashboardid": "2",
               "userid": "1"
           },
           "id": 1
       }

Resposta:

{
           "jsonrpc": "2.0",
           "result": {
               "dashboardids": [
                   "2"
               ]
           },
           "id": 1
       }

Veieu tam¨¦

Font

CDashboard::update() in ui/include/classes/api/services/CDashboard.php.