Áú»¢¶Ä²©

map.create

¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®

object map.create(object/array maps)

Aquest m¨¨tode permet crear mapes nous.

Aquest m¨¨tode ¨¦s disponible per a qualsevol mena d'usuaris. Els permisos per cridar al m¨¨tode es poden revocar a la configuraci¨® de rols d'usuaris. Per a m¨¦s informaci¨®, veieu Rols d'usuari.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ

(object/array) Mapes a crear.

A m¨¦s de les [propietats d'objecte de mapa est¨¤ndard] (object#map), el m¨¨tode admet els par¨¤metres seg¨¹ents.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð Tipus ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®
links array Enlla?os de mapes per crear al mapa.
selements array Elements del mapa per crear al mapa.
urls array URL del mapa per crear al mapa.
users array Recursos d'usuari compartits del mapa per crear al mapa.
userGroups array Recursos compartits de grups d'usuaris del mapa per crear al mapa.
shapes array Formes del mapa per crear al mapa.
lines array L¨ªnies de mapa per crear al mapa.

Per crear enlla?os de mapa, cal establir un element de mapa selementid amb un valor arbitrari i despr¨¦s emprar aquest valor per fer refer¨¨ncia a aquest element a les propietats d'enlla? selementid1 o selementid2. En crear l'element, aquest valor ser¨¤ substitu?t per l'identificador correcte generat per Áú»¢¶Ä²©. Veieu exemple.

Valors de retorn

(object) Retorna un objecte amb els IDs dels mapes creats segons la propietat sysmapids. L'ordre dels IDs retornats correspon a l'ordre dels mapes donats.

Exemples

Crear un mapa buit

Crear un mapa sense elements.

±Ê±ð³Ù¾±³¦¾±¨®:

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

Resposta:

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

Crear un mapa d'equips

Crear un mapa amb dos equips i un enlla? entre ells. Tindre en compte que emprar els valors temporals "selementid1" i "selementid2" dins l'objecte vinculat del mapa pot fer refer¨¨ncia els elements del mapa.

±Ê±ð³Ù¾±³¦¾±¨®:

{
           "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"
                   }
               ]
           },
           "id": 1
       }

Resposta:

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

Crear un mapa de triggers

Crear un mapa un element de trigger, que contenen dos triggers.

±Ê±ð³Ù¾±³¦¾±¨®:

{
           "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"
                   }
               ]
           },
           "id": 1
       }

Resposta:

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

compartir un mapa

Crear un mapa amb dos tipus de compartici¨® (usuari i grup d'usuaris).

±Ê±ð³Ù¾±³¦¾±¨®:

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

Resposta:

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

Formes de mapa

Crear un mapa amb un t¨ªtol.

±Ê±ð³Ù¾±³¦¾±¨®:

{
           "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}"
                   }
               ]
           },
           "id": 1
       }

Resposta:

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

L¨ªnies de mapes

Crear una l¨ªnia de mapa.

±Ê±ð³Ù¾±³¦¾±¨®:

{
           "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"
                   }
               ]
           },
           "id": 1
       }

Resposta:

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

Veieu tamb¨¦

Font

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