[comment]: # ({2aef6e95-2aef6e95})
# templatedashboard.create

[comment]: # ({/2aef6e95-2aef6e95})

[comment]: # ({9231e0c6-8072f2f2})
### Descrição

`object templatedashboard.create(object/array templateDashboards)`

Este método permite criar novos dashboards de template.

::: noteclassic
Este método está disponível apenas para os tipos de usuário *Admin* e *Super admin*. As permissões para chamar o método podem ser revogadas nas configurações de função de usuário. Veja [Funções de usuário](/manual/web_interface/frontend_sections/users/user_roles) para mais informações.
:::

[comment]: # ({/9231e0c6-8072f2f2})

[comment]: # ({3479d924-1caae149})
### Parâmetros

`(object/array)` Dashboards de template a serem criados.

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

|Parâmetro|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|pages|array|[Páginas de dashboard de template](/manual/api/reference/templatedashboard/object#template-dashboard-page) a serem criadas para o dashboard. As páginas do dashboard serão ordenadas na mesma ordem especificada.<br><br>[Comportamento do parâmetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obrigatório*|

[comment]: # ({/3479d924-1caae149})

[comment]: # ({4bfe9ed0-4bfe9ed0})
### Valores de retorno

`(object)` Retorna um objeto contendo os IDs dos dashboards de template criados na propriedade `dashboardids`. A ordem dos IDs retornados corresponde à ordem dos dashboards de template passados.

[comment]: # ({/4bfe9ed0-4bfe9ed0})

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

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

[comment]: # ({41c665c3-49684d2f})
#### Criando um dashboard de template

Crie um dashboard de template chamado “Graphs” com um widget de Gráfico em uma única página de dashboard.

[Requisição](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "templatedashboard.create",
    "params": {
        "templateid": "10318",
        "name": "Graphs",
        "pages": [
            {
                "widgets": [
                    {
                        "type": "graph",
                        "x": 0,
                        "y": 0,
                        "width": 12,
                        "height": 5,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 6,
                                "name": "graphid",
                                "value": "1123"
                            }
                        ]
                    }
                ]

            }
        ]
    },
    "id": 1
}
```

Resposta:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "dashboardids": [
            "32"
        ]
    },
    "id": 1
}
```

[comment]: # ({/41c665c3-49684d2f})

[comment]: # ({930bd864-1171cc63})
### Veja também

-   [Página do dashboard do template](object#template-dashboard-page)
-   [Widget do dashboard do template](object#template-dashboard-widget)
-   [Campo do widget do dashboard do template](object#template-dashboard-widget-field)

[comment]: # ({/930bd864-1171cc63})

[comment]: # ({78c6e281-78c6e281})
### Fonte

CTemplateDashboard::create() em
*ui/include/classes/api/services/CTemplateDashboard.php*.

[comment]: # ({/78c6e281-78c6e281})