[comment]: # ({3a2a8d58-3a2a8d58})
# script.execute

[comment]: # ({/3a2a8d58-3a2a8d58})

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

`object script.execute(object parameters)`

שיטה זו מאפשרת להריץ סקריפט על מארח או אירוע.

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

[comment]: # ({/60a9dbe3-60a9dbe3})

[comment]: # ({962e590e-e4fa8ac7})
### פרמטרים

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

|פרמטר|[סוג](/manual/api/reference_commentary#data_types)|תיאור|
|--|--|------|
|**scriptid**<br>(נדרש)|מחרוזת|מזהה של הסקריפט להרצה.|
|hostid|string|מזהה המארח שעליו להפעיל את הסקריפט.|
|eventid|string|מזהה האירוע שעליו להפעיל את הסקריפט.|

[comment]: # ({/962e590e-e4fa8ac7})

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

`(object)` מחזירה את התוצאה של ביצוע סקריפט.

|Property|[Type](/manual/api/reference_commentary#data_types)|תיאור|
|--|--|------|
|response|string|האם הסקריפט הופעל בהצלחה.<br><br>ערך אפשרי - `הצלחה`.|
|value|string|פלט סקריפט.|
|debug|object|מכיל [debug object](/manual/api/reference/script/object#Debug) אם מבוצע סקריפט webhook. עבור סוגי סקריפט אחרים, הוא מכיל אובייקט ריק.|

[comment]: # ({/47d23fd5-dde54e60})

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

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

[comment]: # ({719944b8-03cb1cf3})
#### הפעל סקריפט webhook

הפעל סקריפט webhook ששולח בקשת HTTP לשירות חיצוני.

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "script.execute",
     "params": {
         "scriptid": "4",
         "hostid": "30079"
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

``` json
{
     "jsonrpc": "2.0",
     "תוצאה": {
         "response": "הצלחה",
         "value": "{\"status\":\"שלח\",\"חותמת זמן\":\"1611235391\"}",
         "לנפות": {
             "יומנים": [
                  {
                      "רמה 3,
                      "ms": 480,
                      "message": "[סקריפט Webhook] מצב HTTP: 200."
                  }
              ],
              "ms": 495
         }
     },
     "מזהה": 1
}
```

[comment]: # ({/719944b8-03cb1cf3})

[comment]: # ({36041e06-baebff97})
#### הפעל סקריפט מותאם אישית

הפעל סקריפט "פינג" על מארח.

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "script.execute",
     "params": {
         "scriptid": "1",
         "hostid": "30079"
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

``` json
{
     "jsonrpc": "2.0",
     "תוצאה": {
         "response": "הצלחה",
         "value": "PING 127.0.0.1 (127.0.0.1) 56(84) בתים של נתונים.\n64 בתים מ-127.0.0.1: icmp_req=1 ttl=64 time=0.074 ms\n64 בתים מ-127.0.0.0ic. 2 ttl=64 time=0.030 ms\n64 בתים מ-127.0.0.1: icmp_req=3 ttl=64 time=0.030 ms\n\n--- 127.0.0.1 סטטיסטיקות ping ---\n3 מנות שודרו, 3 התקבלו, 0 % אובדן מנות, זמן 1998ms\nrtt min/avg/max/mdev = 0.030/0.044/0.074/0.022 ms\n",
         "לנפות": []
     },
     "מזהה": 1
}
```

[comment]: # ({/36041e06-baebff97})

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

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

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