Áú»¢¶Ä²©

map.create

Opis

object map.create(object/array maps)

Ta metoda umo?liwia tworzenie nowych map.

Ta metoda jest dost?pna dla u?ytkownik¨®w dowolnego typu. Uprawnienia do jej wywo?ania mog? zosta? cofni?te w ustawieniach r¨®l u?ytkownika. Zobacz Role u?ytkownik¨®w , aby uzyska? wi?cej informacji.

Parametry

(object/array) Mapy do utworzenia.

°¿±è°ù¨®³¦³ú standardowych w?a?ciwo?ci mapy, metoda akceptuje nast?puj?ce parametry.

Parametr Typ Opis
links array Po??czenia mapy do utworzenia na mapie.
selements array Elementy mapy do utworzenia na mapie.
urls array Adresy URL mapy do utworzenia na mapie.
users array U?ytkownicy wsp¨®?dzielenia mapy do utworzenia na mapie.
userGroups array Grupy u?ytkownik¨®w wsp¨®?dzielenia mapy do utworzenia na mapie.
shapes array Kszta?ty mapy do utworzenia na mapie.
lines array Linie mapy do utworzenia na mapie.

Aby utworzy? po??czenia mapy, musisz ustawi? element mapy selementid na dowoln? warto??, a nast?pnie u?y? tej warto?ci do odwo?ania si? do tego elementu w w?a?ciwo?ciach po??czenia selementid1 lub selementid2. Gdy element zostanie utworzony, ta warto?? zostanie zast?piona przez poprawne ID wygenerowane przez Áú»¢¶Ä²©. Zobacz przyk?ad.

Zwracane warto?ci

(object) Zwraca obiekt zawieraj?cy identyfikatory utworzonych map we w?a?ciwo?ci sysmapids. Kolejno?? zwr¨®conych identyfikator¨®w zgadza si? z kolejno?ci? przekazanych map.

Przyk?ady

Utw¨®rz pust? map?

Utw¨®rz map? bez element¨®w.

Zapytanie:

{
           "jsonrpc": "2.0",
           "method": "map.create",
           "params": {
               "name": "Map",
               "width": 600,
               "height": 600
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Odpowied?:

{
           "jsonrpc": "2.0",
           "result": {
               "sysmapids": [
                   "8"
               ]
           },
           "id": 1
       }

Utw¨®rz map? hosta

Utw¨®rz map? z dwoma elementami typu host i po??czeniem mi?dzy nimi. Zauwa? u?ycie tymczasowych warto?ci "selementid1" i "selementid2" w obiekcie po??czenia mapy do odwo?ania si? do element¨®w mapy.

Zapytanie:

{
           "jsonrpc": "2.0",
           "method": "map.create",
           "params": {
               "name": "Host map",
               "width": 600,
               "height": 600,
               "selements": [
                   {
                       "selementid": "1",
                       "elements": [
                           {"hostid": "1033"}
                       ],
                       "elementtype": 0,
                       "iconid_off": "2"
                   },
       
                   {
                       "selementid": "2",
                       "elements": [
                           {"hostid": "1037"}
                       ],
                       "elementtype": 0,
                       "iconid_off": "2"
                   }
               ],
               "links": [
                   {
                       "selementid1": "1",
                       "selementid2": "2"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Odpowied?:

{
           "jsonrpc": "2.0",
           "result": {
               "sysmapids": [
                   "9"
               ]
           },
           "id": 1
       }

Utw¨®rz map? wyzwalaczy

Utw¨®rz map? z elementem wyzwalacza, kt¨®ry zawiera dwa wyzwalacze.

Zapytanie:

{
           "jsonrpc": "2.0",
           "method": "map.create",
           "params": {
               "name": "Trigger map",
               "width": 600,
               "height": 600,
               "selements": [
                   {
                       "elements": [
                           {"triggerid": "12345"},
                           {"triggerid": "67890"}
                       ],
                       "elementtype": 2,
                       "iconid_off": "2"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Odpowied?:

{
           "jsonrpc": "2.0",
           "result": {
               "sysmapids": [
                   "10"
               ]
           },
           "id": 1
       }

Udost?pnianie mapy

Utw¨®rz map? z dwoma rodzajami wsp¨®?dzielenia (u?ytkownik i grupa u?ytkownik¨®w).

Zapytanie:

{
           "jsonrpc": "2.0",
           "method": "map.create",
           "params": {
               "name": "Map sharing",
               "width": 600,
               "height": 600,
               "users": [
                   {
                       "userid": "4",
                       "permission": "3"
                   }
               ],
               "userGroups": [
                   {
                       "usrgrpid": "7",
                       "permission": "2"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Odpowied?:

{
           "jsonrpc": "2.0",
           "result": {
               "sysmapids": [
                   "9"
               ]
           },
           "id": 1
       }

Kszta?ty mapy

Utw¨®rz map? z tytu?em nazwy mapy.

Zapytanie:

{
           "jsonrpc": "2.0",
           "method": "map.create",
           "params": {
               "name": "Host map",
               "width": 600,
               "height": 600,
               "shapes": [
                   {
                       "type": 0,
                       "x": 0,
                       "y": 0,
                       "width": 600,
                       "height": 11,
                       "text": "{MAP.NAME}"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Odpowied?:

{
           "jsonrpc": "2.0",
           "result": {
               "sysmapids": [
                   "10"
               ]
           },
           "id": 1
       }

Linie mapy

Utw¨®rz lini? mapy.

Zapytanie:

{
           "jsonrpc": "2.0",
           "method": "map.create",
           "params": {
               "name": "Map API lines",
               "width": 500,
               "height": 500,
               "lines": [
                   {
                       "x1": 30,
                       "y1": 10,
                       "x2": 100,
                       "y2": 50,
                       "line_type": 1,
                       "line_width": 10,
                       "line_color": "009900"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Odpowied?:

{
           "jsonrpc": "2.0",
           "result": {
               "sysmapids": [
                   "11"
               ]
           },
           "id": 1
       }

Zobacz tak?e

?°ù¨®»å?´Ç

CMap::create() w ui/include/classes/api/services/CMap.php.