[comment]: # aside: 2

[comment]: # translation:outdated

[comment]: # ({c179cb27-c179cb27})
# dashboard.create

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

[comment]: # ({62480fae-00970602})
### Description

`object dashboard.create(object/array dashboards)`

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

::: noteclassic
Cette méthode est disponible pour les utilisateurs de tout type. Les autorisations
d'appeler 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]: # ({/62480fae-00970602})

[comment]: # ({db685496-df2301b4})
### Paramètres

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

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

|Paramètre|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|pages|array|[Pages du tableau de bord](object#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 des paramètres](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatoire*|
|users|array|Partages [d'utilisateur du tableau de bord](object#dashboard-user) à créer sur le tableau de bord.|
|userGroups|array|Partages de [groupe d'utilisateurs du tableau de bord](object#dashboard-user-group) à créer sur le tableau de bord.|

[comment]: # ({/db685496-df2301b4})

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

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

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

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

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

[comment]: # ({edddc7a0-b33dc2ee})
#### Création d’un tableau de bord

Créez un tableau de bord nommé "My dashboard" avec un widget Problems comportant
des tags et en utilisant deux types de partage (groupe d’utilisateurs et utilisateur) sur une seule
page de tableau de bord.

[Requête](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "problems",
                        "x": 0,
                        "y": 0,
                        "width": 36,
                        "height": 5,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 1,
                                "name": "tags.0.tag",
                                "value": "service"
                            },
                            {
                                "type": 0,
                                "name": "tags.0.operator",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "tags.0.value",
                                "value": "zabbix_server"
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": "7",
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": "4",
                "permission": 3
            }
        ]
    },
    "id": 1
}
```

Réponse :

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

[comment]: # ({/edddc7a0-b33dc2ee})

[comment]: # ({9c4ba6ce-299ae089})
### Voir aussi

-   [Page de tableau de bord](object#dashboard-page)
-   [Widget de tableau de bord](object#dashboard-widget)
-   [Champ de widget de tableau de bord](object#dashboard-widget-field)
-   [Utilisateur du tableau de bord](object#dashboard-user)
-   [Groupe d'utilisateurs du tableau de bord](object#dashboard-user-group)

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

[comment]: # ({7d488f32-7d488f32})
### Source

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

[comment]: # ({/7d488f32-7d488f32})