[comment]: # translation:outdated

[comment]: # ({36f834f7-36f834f7})
# תבנית.עדכון

[comment]: # ({/36f834f7-36f834f7})

[comment]: # ({dc0d289a-f8425904})
### תיאור

`object template.update(object/array templates)`

שיטה זו מאפשרת לעדכן תבניות קיימות.

::: noteclassic
שיטה זו זמינה רק ל-*Admin* ו-*Super Admin*
סוגי משתמשים. ניתן לבטל הרשאות לקרוא לשיטה בתפקיד משתמש
הגדרות. ראה [משתמש
תפקידים](/manual/web_interface/frontend_sections/administration/user_roles)
למידע נוסף.
:::

[comment]: # ({/dc0d289a-f8425904})

[comment]: # ({dba610a1-5d06cf34})
### פרמטרים

`(אובייקט/מערך)` מאפייני תבנית שיש לעדכן.

יש להגדיר את המאפיין 'templateid' עבור כל תבנית, כל השאר
נכסים הם אופציונליים. רק המאפיינים הנתונים יעודכנו, כולם
אחרים יישארו ללא שינוי.

בנוסף ל[מאפייני תבנית סטנדרטיים](אובייקט#תבנית), ה-
השיטה מקבלת את הפרמטרים הבאים.

|פרמטר|[סוג](/manual/api/reference_commentary#data_types)|תיאור|
|--|--|------|
|groups|object/array|מארח [קבוצות](/manual/api/reference/hostgroup/object) כדי להחליף את הקבוצות המארחות הנוכחיות שאליהן שייכות התבניות.<br><br>לקבוצות המארחות חייבות להיות המאפיין `groupid` מוגדר.|
|tags|object/array|תבנית [tags](/manual/api/reference/template/object#template_tag) כדי להחליף את תגי התבנית הנוכחיים.|
|macros|object/array|[פקודות מאקרו משתמש](/manual/api/reference/usermacro/object) כדי להחליף את פקודות המאקרו הנוכחיות של המשתמש בתבניות הנתונות.|
|templates|object/array|[Templates](/manual/api/reference/template/object) כדי להחליף את התבניות המקושרות כעת. תבניות שאינן עוברות מנותקות רק.<br><br>תבניות חייבות להיות מוגדרות המאפיין 'templateid'.|
|templates\_clear|object/array|[Templates](/manual/api/reference/template/object) כדי לבטל קישור ולנקות מהתבניות הנתונות.<br><br>לתבניות חייבות להיות מוגדרות המאפיין 'templateid'. |

[comment]: # ({/dba610a1-5d06cf34})

[comment]: # ({dcba01c8-dcba01c8})
### החזר ערכים

`(אובייקט)` מחזירה אובייקט המכיל את המזהים של התבניות המעודכנות
תחת המאפיין 'templateids'.

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

[comment]: # ({b41637d2-b41637d2})
### דוגמאות

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

[comment]: # ({d9f7855e-0080b19f})
#### שינוי שם של תבנית

שנה את שם התבנית ל-"Template OS Linux".

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "template.update",
     "params": {
         "templateid": "10086",
         "name": "תבנית OS Linux"
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

``` json
{
     "jsonrpc": "2.0",
     "תוצאה": {
         "templateids": [
             "10086"
         ]
     },
     "מזהה": 1
}
```

[comment]: # ({/d9f7855e-0080b19f})

[comment]: # ({54d6c911-e7972b69})
#### עדכון תגיות תבנית

החלף את כל תגי התבנית בתגיות חדשות.

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "template.update",
     "params": {
         "templateid": "10086",
         "תגים": [
             {
                 "tag": "שם מארח",
                 "value": "{HOST.NAME}"
             }
         ]
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

``` json
{
     "jsonrpc": "2.0",
     "תוצאה": {
         "hostids": [
             "10086"
         ]
     },
     "מזהה": 1
}
```

[comment]: # ({/54d6c911-e7972b69})

[comment]: # ({eb72cc1c-eb72cc1c})
### מקור

CTemplate::update()‎ בתוך *ui/include/classes/api/services/CTemplate.php*.

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