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

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

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

`object template.massupdate(אובייקט פרמטרים)`

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

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

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

[comment]: # ({b2e67223-1f7d5759})
### פרמטרים

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

השיטה מקבלת את הפרמטרים הבאים.

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

[comment]: # ({/b2e67223-1f7d5759})

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

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

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

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

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

[comment]: # ({fbe72d1c-0ecefb75})
#### החלפת קבוצות מארחות

בטל את הקישור ונקה את התבנית "10091" מהתבניות הנתונות.

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "template.massupdate",
     "params": {
         "תבניות": [
             {
                 "templateid": "10085"
             },
             {
                 "templateid": "10086"
             }
         ],
         "נקה": [
             {
                 "templateid": "10091"
             }
         ]
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

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

[comment]: # ({/fbe72d1c-0ecefb75})

[comment]: # ({5d283e35-5d283e35})
#### החלפת קבוצות מארחות

בטל את הקישור ונקה את התבנית "10091" מהתבניות הנתונות.

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "template.massupdate",
     "params": {
         "תבניות": [
             {
                 "templateid": "10085"
             },
             {
                 "templateid": "10086"
             }
         ],
         "נקה": [
             {
                 "templateid": "10091"
             }
         ]
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

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

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

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

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

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