[comment]: # translation:outdated

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

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

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

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

Mit dieser Methode können neue Vorlagen-Dashboards erstellt werden.

::: noteclassic
Diese Methode ist nur für die Benutzertypen *Admin* und *Super admin*
verfügbar. Die Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle
entzogen werden. Weitere Informationen finden Sie unter [Benutzerrollen](/manual/web_interface/frontend_sections/users/user_roles).
:::

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

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

`(object/array)` Zu erstellende Vorlagen-Dashboards.

Zusätzlich zu den [Standard-Eigenschaften von Vorlagen-Dashboards](object#template-dashboard) akzeptiert die Methode die folgenden Parameter.

|Parameter|[Type](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|pages|array|Zu erstellende [Vorlagen-Dashboard-Seiten](/manual/api/reference/templatedashboard/object#template-dashboard-page) für das Dashboard. Die Dashboard-Seiten werden in derselben Reihenfolge angeordnet, wie sie angegeben sind.<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *erforderlich*|

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

[comment]: # ({4bfe9ed0-4bfe9ed0})
### Rückgabewerte

`(object)` Gibt ein Objekt zurück, das die IDs der erstellten Vorlagen-Dashboards in der Eigenschaft `dashboardids` enthält. Die Reihenfolge der zurückgegebenen IDs entspricht der Reihenfolge der übergebenen Vorlagen-Dashboards.

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

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

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

[comment]: # ({41c665c3-49684d2f})
#### Erstellen eines Vorlagen-Dashboards

Erstellen Sie ein Vorlagen-Dashboard mit dem Namen „Graphs“ mit einem Graph-Widget auf einer einzelnen Dashboard-Seite.

[Anfrage](/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
}
```

Antwort:

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

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

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

-   [Vorlagen-Dashboard-Seite](object#template-dashboard-page)
-   [Vorlagen-Dashboard-Widget](object#template-dashboard-widget)
-   [Vorlagen-Dashboard-Widget-Feld](object#template-dashboard-widget-field)

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

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

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

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