[comment]: # ({0067e4a0-0067e4a0})
# מפה.צור

[comment]: # ({/0067e4a0-0067e4a0})

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

`object map.create(object/array maps)`

שיטה זו מאפשרת ליצור מפות חדשות.

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

[comment]: # ({/279559e4-279559e4})

[comment]: # ({5e5a27fe-73d879ea})
### פרמטרים

`(אובייקט/מערך)` מפות ליצירה.

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

|פרמטר|[סוג](/manual/api/reference_commentary#data_types)|תיאור|
|--|--|------|
|links|מערך|מפה [קישורים](/manual/api/reference/map/object#map_link) שתיווצר על המפה.|
|selements|מערך|מפה [אלמנטים](/manual/api/reference/map/object#map_element) שתיווצר במפה.|
|urls|array|מפה [כתובות אתרים](/manual/api/reference/map/object#map_url) שתיווצר על המפה.|
|users|array|מפה שיתופי [משתמש](/manual/api/reference/map/object#map_user) שייווצרו על המפה.|
|userGroups|מערך|מפה שיתופים של [קבוצת משתמשים](/manual/api/reference/map/object#map_user_group) שייווצרו במפה.|
|shapes|מערך|מפה [צורות](/manual/api/reference/map/object#map_shapes) שתיווצר על המפה.|
|lines|array|מפה [שורות](/manual/api/reference/map/object#map_lines) שתיווצר על המפה.|

::: הערה
כדי ליצור קישורי מפה תצטרך להגדיר רכיב מפה
`selementid` לערך שרירותי ולאחר מכן השתמש בערך זה כדי להתייחס
אלמנט זה במאפיינים 'selementid1' או 'selementid2'.
כאשר האלמנט נוצר, ערך זה יוחלף ב-
מזהה נכון שנוצר על ידי Zabbix. [לִרְאוֹת
דוגמה.](create#create_a_host_map)
:::

[comment]: # ({/5e5a27fe-73d879ea})

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

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

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

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

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

[comment]: # ({8a44725c-584ef8f6})
#### צור מפה ריקה

צור מפה ללא אלמנטים.

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "map.create",
     "params": {
         "name": "מפה",
         "רוחב": 600,
         "גובה": 600
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

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

[comment]: # ({/8a44725c-584ef8f6})

[comment]: # ({b7d9e933-e32540ab})
#### צור מפת מארח

צור מפה עם שני אלמנטים מארח וקישור ביניהם. שימו לב ל
שימוש בערכי "selementid1" ו-"selementid2" זמניים בקישור המפה
אובייקט להתייחס לרכיבי מפה.

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "map.create",
     "params": {
         "name": "מפת מארח",
         "רוחב": 600,
         "גובה": 600,
         "אלמנטים": [
             {
                 "selementid": "1",
                 "אלמנטים": [
                     {"hostid": "1033"}
                 ],
                 "elementtype": 0,
                 "iconid_off": "2"
             },

             {
                 "selementid": "2",
                 "אלמנטים": [
                     {"hostid": "1037"}
                 ],
                 "elementtype": 0,
                 "iconid_off": "2"
             }
         ],
         "קישורים": [
             {
                 "selementid1": "1",
                 "selementid2": "2"
             }
         ]
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

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

[comment]: # ({/b7d9e933-e32540ab})

[comment]: # ({7cfc7686-9a8ffa0d})
#### צור מפת טריגר

צור מפה עם אלמנט טריגר, שמכיל שני טריגרים.

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "map.create",
     "params": {
         "name": "מפת טריגר",
         "רוחב": 600,
         "גובה": 600,
         "אלמנטים": [
             {
                 "אלמנטים": [
                     {"triggerid": "12345"},
                     {"triggerid": "67890"}
                 ],
                 "elementtype": 2,
                 "iconid_off": "2"
             }
         ]
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

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

[comment]: # ({/7cfc7686-9a8ffa0d})

[comment]: # ({4ad215d4-d8024143})
#### שיתוף מפה

צור מפה עם שני סוגי שיתוף (משתמש וקבוצת משתמשים).

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "map.create",
     "params": {
         "name": "שיתוף מפה",
         "רוחב": 600,
         "גובה": 600,
         "משתמשים": [
             {
                 "userid": "4",
                 "permission": "3"
             }
         ],
         "קבוצות משתמש": [
             {
                 "usrgrpid": "7",
                 "permission": "2"
             }
         ]
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

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

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

[comment]: # ({1df5fc2f-2fa44a8b})
#### צורות מפה

צור מפה עם כותרת שם המפה.

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "map.create",
     "params": {
         "name": "מפת מארח",
         "רוחב": 600,
         "גובה": 600,
         "צורות": [
             {
                 "סוג": 0,
                 "x": 0,
                 "y": 0,
                 "רוחב": 600,
                 "גובה": 11,
                 "text": "{MAP.NAME}"
             }
         ]
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

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

[comment]: # ({/1df5fc2f-2fa44a8b})

[comment]: # ({5d76c251-5aa58242})
#### קווי מפה

צור קו מפה.

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "map.create",
     "params": {
         "name": "מיפוי קווי API",
         "רוחב": 500,
         "גובה": 500,
         "שורות": [
             {
                 "x1": 30,
                 "y1": 10,
                 "x2": 100,
                 "y2": 50,
                 "סוג_שורה": 1,
                 "רוחב_קו": 10,
                 "line_color": "009900"
             }
         ]
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

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

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

[comment]: # ({436079d5-436079d5})
### ראה גם

- [אלמנט מפה](object#map_element)
- [קישור מפה](object#map_link)
- [כתובת אתר של מפה](object#map_url)
- [משתמש במפה](object#map_user)
- [מפה קבוצת משתמשים](object#map_user_group)
- [צורת מפה](object#map_shapes)
- [שורת מפה](object#map_lines)

[comment]: # ({/436079d5-436079d5})

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

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

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