[comment]: # translation:outdated

[comment]: # ({43e64f56-43e64f56})
# graphitem.get

[comment]: # ({/43e64f56-43e64f56})

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

`integer/array graphitem.get(object parameters)`

השיטה מאפשרת לשלוף פריטי גרף לפי הנתון
פרמטרים.

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

[comment]: # ({/af62b652-fe22ea70})

[comment]: # ({bbd4cbe5-d30698ba})
### פרמטרים

`(object)` פרמטרים המגדירים את הפלט הרצוי.

השיטה תומכת בפרמטרים הבאים.

|פרמטר|[סוג](/manual/api/reference_commentary#data_types)|תיאור|
|--|--|------|
|graphids|string/array|החזר רק פריטי גרף השייכים לגרפים הנתונים.|
|itemids|string/array|החזר רק פריטי גרף עם מזהי הפריטים הנתונים.|
|type|integer|החזר רק פריטי גרף עם הסוג הנתון.<br><br>עיין בדף [דף אובייקט פריט גרף](object#graph_item) לקבלת רשימה של סוגי פריטי גרף נתמכים.|
|selectGraphs|query|החזר מאפיין [graphs](/manual/api/reference/graph/object) עם מערך של גרפים שהפריט שייך אליו.|
|sortfield|string/array|מיין את התוצאה לפי המאפיינים הנתונים.<br><br>ערכים אפשריים הם: `gitemid`.|
|countOutput|boolean|הפרמטרים הללו הנפוצים לכל שיטות ה-'get' מתוארים בפירוט בדף [פרשנות הפניה](/manual/api/reference_commentary#common_get_method_parameters).|
|עריכה|בוליאנית|^|
|limit|מספר שלם|^|
|פלט|שאילתה|^|
|preservekeys|בולאני|^|
|sortorder|מחרוזת/מערך|^|

[comment]: # ({/bbd4cbe5-d30698ba})

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

`(מספר שלם/מערך)` מחזיר אחד:

- מערך של חפצים;
- ספירת האובייקטים שאוחזרו, אם יש לפרמטר `countOutput`
     נעשה שימוש.

[comment]: # ({/7223bab1-7223bab1})

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

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

[comment]: # ({64fadea0-37da5f20})
#### אחזור פריטי גרף מגרף

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

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "graphitem.get",
     "params": {
         "output": "להרחיב",
         "graphids": "387"
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

``` json
{
     "jsonrpc": "2.0",
     "תוצאה": [
         {
             "gitemid": "1242",
             "graphid": "387",
             "itemid": "22665",
             "drawtype": "1",
             "sortorder": "1",
             "color": "FF5555",
             "yaxisside": "0",
             "calc_fnc": "2",
             "type": "0",
             "key_": "system.cpu.util[,גניבה]",
             "hostid": "10001",
             "flags": "0",
             "host": "לינוקס"
         },
         {
             "gitemid": "1243",
             "graphid": "387",
             "itemid": "22668",
             "drawtype": "1",
             "sortorder": "2",
             "color": "55FF55",
             "yaxisside": "0",
             "calc_fnc": "2",
             "type": "0",
             "key_": "system.cpu.util[,softirq]",
             "hostid": "10001",
             "flags": "0",
             "host": "לינוקס"
         },
         {
             "gitemid": "1244",
             "graphid": "387",
             "itemid": "22671",
             "drawtype": "1",
             "sortorder": "3",
             "color": "009999",
             "yaxisside": "0",
             "calc_fnc": "2",
             "type": "0",
             "key_": "system.cpu.util[, interrupt]",
             "hostid": "10001",
             "flags": "0",
             "host": "לינוקס"
         }
     ],
     "מזהה": 1
}
```

[comment]: # ({/64fadea0-37da5f20})

[comment]: # ({09a26e71-09a26e71})
### מידע נוסף

-   [תרשים](/manual/api/reference/graph/object#graph)

[comment]: # ({/09a26e71-09a26e71})

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

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

[comment]: # ({/8d13cada-8d13cada})