[comment]: # translation:outdated

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

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

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

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

Cette méthode permet de créer de nouveaux tableaux de bord de modèle.

::: noteclassic
Cette méthode est disponible uniquement pour les types d’utilisateurs *Admin* et *Super admin*. Les autorisations d’appel de la méthode peuvent être révoquées dans les paramètres du rôle utilisateur. Voir [User
roles](/manual/web_interface/frontend_sections/users/user_roles)
pour plus d’informations.
:::

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

[comment]: # ({3479d924-1caae149})
### Paramètres

`(object/array)` Tableaux de bord de modèle à créer.

En plus des [propriétés standard des tableaux de bord de modèle](object#template-dashboard), la méthode accepte les paramètres suivants.

|Paramètre|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|pages|array|[Pages de tableau de bord de modèle](/manual/api/reference/templatedashboard/object#template-dashboard-page) à créer pour le tableau de bord. Les pages du tableau de bord seront ordonnées dans le même ordre que celui spécifié.<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatoire*|

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

[comment]: # ({4bfe9ed0-4bfe9ed0})
### Valeurs retournées

`(object)` Retourne un objet contenant les ID des modèles de tableaux de bord créés dans la propriété `dashboardids`. L'ordre des ID retournés correspond à l'ordre des modèles de tableaux de bord transmis.

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

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

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

[comment]: # ({41c665c3-49684d2f})
#### Création d’un tableau de bord de modèle

Créez un tableau de bord de modèle nommé « Graphs » avec un widget Graph sur une
seule page de tableau de bord.

[Requête](/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
}
```

Réponse :

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

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

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

-   [Page de tableau de bord du modèle](object#template-dashboard-page)
-   [Widget de tableau de bord du modèle](object#template-dashboard-widget)
-   [Champ de widget de tableau de bord du modèle](object#template-dashboard-widget-field)

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

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

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

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