[comment]: # translation:outdated

[comment]: # ({66fb9690-66fb9690})
# dashboard.update (atualização de dashboard)

[comment]: # ({/66fb9690-66fb9690})

[comment]: # ({becba6de-f235159f})
### Descrição

`painel de objetos.update(painéis de objetos/matrizes)`

Este método permite atualizar os painéis existentes.

::: noteclassic
Este método está disponível para usuários de qualquer tipo. Permissões
para chamar o método pode ser revogado nas configurações de função do usuário. Veja [Usuário
funções](/manual/web_interface/frontend_sections/administration/user_roles)
Para maiores informações.
:::

[comment]: # ({/becba6de-f235159f})

[comment]: # ({7cd8c481-62947aa0})
### Parâmetros

`(object/array)` Propriedades do painel a serem atualizadas.

A propriedade `dashboardid` deve ser especificada para cada painel, todos
outras propriedades são opcionais. Somente as propriedades especificadas serão
Atualizada.

Além das [propriedades padrão do painel](object#dashboard),
o método aceita os seguintes parâmetros.

|Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição|
|---------|----------------------------------- ------------|-----------|
|pages|array|Painel [páginas](object#dashboard_page) para substituir as páginas do painel existentes.<br><br>As páginas do painel são atualizadas pela propriedade `dashboard_pageid`. Novas páginas de painel serão criadas para objetos sem a propriedade `dashboard_pageid` e as páginas de painel existentes serão excluídas se não forem reutilizadas. As páginas do painel serão ordenadas na mesma ordem especificada. Somente as propriedades especificadas das páginas do painel serão atualizadas. Pelo menos um objeto de página do painel é necessário para a propriedade `pages`.|
|users|array|Dashboard [user](object#dashboard_user) compartilha para substituir os elementos existentes.|
|userGroups|array|Dashboard [grupo de usuários](object#dashboard_user_group) compartilha para substituir os elementos existentes.|

[comment]: # ({/7cd8c481-62947aa0})

[comment]: # ({28e89b38-28e89b38})
### Valores de retorno

`(object)` Retorna um objeto contendo os IDs do
painéis sob a propriedade `dashboardids`.

[comment]: # ({/28e89b38-28e89b38})

[comment]: # ({b41637d2-b41637d2})
#### Exemplos

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({81ae70f1-7fcf7de4})
#### Renomeando um painel

Renomeie um painel para "status do servidor SQL".

Solicitação:

``` {.java}
{
    "jsonrpc": "2.0",
    "método": "dashboard.update",
    "parâmetros": {
        "dashboardid": "2",
        "name": "status do servidor SQL"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Resposta:

``` {.java}
{
    "jsonrpc": "2.0",
    "resultado": {
        "dashboardids": [
            "2"
        ]
    },
    "id": 1
}
```

[comment]: # ({/81ae70f1-7fcf7de4})

[comment]: # ({50539232-b8348b8a})
#### Atualizando páginas do painel

Renomeie a primeira página do painel, substitua os widgets no segundo painel
página e adicione uma nova página como a terceira. Excluir todos os outros painéis
Páginas.

Solicitação:

``` {.java}
{
    "jsonrpc": "2.0",
    "método": "dashboard.update",
    "parâmetros": {
        "dashboardid": "2",
        "Páginas": [
            {
                "dashboard_pageid": 1,
                "name": 'Página renomeada'
            },
            {
                "dashboard_pageid": 2,
                "widgets": [
                    {
                        "tipo": "relógio",
                        "x": 0,
                        "y": 0,
                        "largura": 4,
                        "altura": 3
                    }
                ]
            },
            {
                "display_period": 60
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Resposta:

``` {.java}
{
    "jsonrpc": "2.0",
    "resultado": {
        "dashboardids": [
            "2"
        ]
    },
    "id": 2
}
```

[comment]: # ({/50539232-b8348b8a})

[comment]: # ({92060972-e4a57dd3})
#### Alterar o proprietário do painel

Disponível apenas para administradores e superadministradores.

Solicitação:

``` {.java}
{
    "jsonrpc": "2.0",
    "método": "dashboard.update",
    "parâmetros": {
        "dashboardid": "2",
        "userid": "1"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 2
}
```

Resposta:

``` {.java}
{
    "jsonrpc": "2.0",
    "resultado": {
        "dashboardids": [
            "2"
        ]
    },
    "id": 2
}
```

[comment]: # ({/92060972-e4a57dd3})

[comment]: # ({299ae089-299ae089})
### Veja também

- [Página do painel](object#dashboard_page)
- [Widget do painel](object#dashboard_widget)
- [Campo de widget do painel](object#dashboard_widget_field)
- [usuário do painel](object#dashboard_user)
- [grupo de usuários do painel](object#dashboard_user_group)

[comment]: # ({/299ae089-299ae089})

[comment]: # ({456ac32b-456ac32b})
### Fonte

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

[comment]: # ({/456ac32b-456ac32b})