Table of Contents

Objeto de mapa

Objeto de mapa

Los siguientes objetos están directamente relacionados con la API map.

Mapa

El objeto mapa tiene las siguientes propiedades.

Propiedad	Tipo	Descripción
sysmapid	ID	ID del mapa. Comportamiento de la propiedad: - solo lectura - requerido para operaciones de actualización
height	entero	Altura del mapa en píxeles. Comportamiento de la propiedad: - requerido para operaciones de creación
name	cadena	Nombre del mapa. Comportamiento de la propiedad: - requerido para operaciones de creación
width	entero	Ancho del mapa en píxeles. Comportamiento de la propiedad: - requerido para operaciones de creación
backgroundid	ID	ID de la imagen utilizada como fondo del mapa.
background_scale	entero	Indica si se habilita el escalado proporcional de la imagen de fondo. Valores posibles: 0 - deshabilitar el escalado; 1 - (por defecto) habilitar el escalado de la imagen.
expand_macros	entero	Indica si se expanden las macros en las etiquetas al configurar el mapa. Valores posibles: 0 - (por defecto) no expandir macros; 1 - expandir macros.
expandproblem	entero	Indica si el disparador de problema se mostrará para elementos con un solo problema. Valores posibles: 0 - mostrar siempre el número de problemas; 1 - (por defecto) mostrar el disparador de problema si solo hay un problema.
grid_align	entero	Indica si se habilita la alineación a la cuadrícula. Valores posibles: 0 - deshabilitar la alineación a la cuadrícula; 1 - (por defecto) habilitar la alineación a la cuadrícula.
grid_show	entero	Indica si se muestra la cuadrícula en el mapa. Valores posibles: 0 - no mostrar la cuadrícula; 1 - (por defecto) mostrar la cuadrícula.
grid_size	entero	Tamaño de la cuadrícula del mapa en píxeles. Valores soportados: 20, 40, 50, 75 y 100. Por defecto: 50.
highlight	entero	Indica si la función de resaltado de iconos está habilitada. Valores posibles: 0 - resaltado deshabilitado; 1 - (por defecto) resaltado habilitado.
iconmapid	ID	ID del mapa de iconos utilizado en el mapa.
label_format	entero	Indica si se habilitan las etiquetas avanzadas. Valores posibles: 0 - (por defecto) deshabilitar etiquetas avanzadas; 1 - habilitar etiquetas avanzadas.
label_location	entero	Ubicación de la etiqueta del elemento del mapa. Valores posibles: 0 - (por defecto) abajo; 1 - izquierda; 2 - derecha; 3 - arriba.
label_string_host	cadena	Etiqueta personalizada para elementos de tipo host. Comportamiento de la propiedad: - requerido si `label_type_host` está establecido en "personalizado"
label_string_hostgroup	cadena	Etiqueta personalizada para elementos de tipo grupo de hosts. Comportamiento de la propiedad: - requerido si `label_type_hostgroup` está establecido en "personalizado"
label_string_image	cadena	Etiqueta personalizada para elementos de tipo imagen. Comportamiento de la propiedad: - requerido si `label_type_image` está establecido en "personalizado"
label_string_map	cadena	Etiqueta personalizada para elementos de tipo mapa. Comportamiento de la propiedad: - requerido si `label_type_map` está establecido en "personalizado"
label_string_trigger	cadena	Etiqueta personalizada para elementos de tipo disparador. Comportamiento de la propiedad: - requerido si `label_type_trigger` está establecido en "personalizado"
label_type	entero	Tipo de etiqueta del elemento del mapa. Valores posibles: 0 - etiqueta; 1 - dirección IP; 2 - (por defecto) nombre del elemento; 3 - solo estado; 4 - nada.
label_type_host	entero	Tipo de etiqueta para elementos de tipo host. Valores posibles: 0 - etiqueta; 1 - dirección IP; 2 - (por defecto) nombre del elemento; 3 - solo estado; 4 - nada; 5 - personalizado.
label_type_hostgroup	entero	Tipo de etiqueta para elementos de tipo grupo de hosts. Valores posibles: 0 - etiqueta; 2 - (por defecto) nombre del elemento; 3 - solo estado; 4 - nada; 5 - personalizado.
label_type_image	entero	Tipo de etiqueta para elementos de tipo imagen. Valores posibles: 0 - etiqueta; 2 - (por defecto) nombre del elemento; 4 - nada; 5 - personalizado.
label_type_map	entero	Tipo de etiqueta para elementos de tipo mapa. Valores posibles: 0 - etiqueta; 2 - (por defecto) nombre del elemento; 3 - solo estado; 4 - nada; 5 - personalizado.
label_type_trigger	entero	Tipo de etiqueta para elementos de tipo disparador. Valores posibles: 0 - etiqueta; 2 - (por defecto) nombre del elemento; 3 - solo estado; 4 - nada; 5 - personalizado.
markelements	entero	Indica si se resaltan los elementos del mapa que han cambiado recientemente su estado. Valores posibles: 0 - (por defecto) no resaltar elementos; 1 - resaltar elementos.
severity_min	entero	Gravedad mínima de los disparadores que se mostrarán en el mapa. Consulte la propiedad `severity` del disparador para ver una lista de las gravedades de disparador soportadas.
show_element_label	entero	Cómo mostrar las etiquetas de los elementos por defecto. Valores posibles: 0 - mostrar siempre; 1 - (por defecto) ocultar automáticamente.
show_link_label	entero	Cómo mostrar las etiquetas de los enlaces por defecto. Valores posibles: 0 - mostrar siempre; 1 - (por defecto) ocultar automáticamente.
show_unack	entero	Cómo se deben mostrar los problemas. Valores posibles: 0 - (por defecto) mostrar el recuento de todos los problemas; 1 - mostrar solo el recuento de problemas no reconocidos; 2 - mostrar el recuento de problemas reconocidos y no reconocidos por separado.
userid	ID	ID del usuario que es propietario del mapa.
private	entero	Tipo de compartición del mapa. Valores posibles: 0 - mapa público; 1 - (por defecto) mapa privado.
show_suppressed	entero	Indica si se muestran los problemas suprimidos. Valores posibles: 0 - (por defecto) ocultar problemas suprimidos; 1 - mostrar problemas suprimidos.

Elemento de mapa

El objeto elemento de mapa define un objeto mostrado en un mapa. Tiene las siguientes propiedades.

Propiedad	Tipo	Descripción
selementid	ID	ID del elemento de mapa. Comportamiento de la propiedad: - solo lectura
elements	array	Objeto de datos Elemento. Comportamiento de la propiedad: - requerido si `elementtype` está establecido en "host", "map", "trigger" o "host group"
elementtype	integer	Tipo de elemento de mapa. Valores posibles: 0 - host; 1 - map; 2 - trigger; 3 - host group; 4 - image. Comportamiento de la propiedad: - requerido
iconid_off	ID	ID de la imagen utilizada para mostrar el elemento en estado por defecto. Comportamiento de la propiedad: - requerido
areatype	integer	Cómo se deben mostrar los hosts del grupo de hosts por separado. Valores posibles: 0 - (por defecto) el elemento del grupo de hosts ocupará todo el mapa; 1 - el elemento del grupo de hosts tendrá un tamaño fijo.
elementsubtype	integer	Cómo se debe mostrar un elemento de grupo de hosts en un mapa. Valores posibles: 0 - (por defecto) mostrar el grupo de hosts como un solo elemento; 1 - mostrar cada host del grupo por separado.
evaltype	integer	Método de evaluación de la condición de filtrado de etiquetas del elemento de mapa. Valores posibles: 0 - (por defecto) AND / OR; 2 - OR.
height	integer	Altura del elemento de grupo de hosts de tamaño fijo en píxeles. Por defecto: 200.
iconid_disabled	ID	ID de la imagen utilizada para mostrar elementos de mapa deshabilitados. Comportamiento de la propiedad: - soportado si `elementtype` está establecido en "host", "map", "trigger" o "host group"
iconid_maintenance	ID	ID de la imagen utilizada para mostrar elementos de mapa en mantenimiento. Comportamiento de la propiedad: - soportado si `elementtype` está establecido en "host", "map", "trigger" o "host group"
iconid_on	ID	ID de la imagen utilizada para mostrar elementos de mapa con problemas. Comportamiento de la propiedad: - soportado si `elementtype` está establecido en "host", "map", "trigger" o "host group"
label	string	Etiqueta del elemento.
label_location	integer	Ubicación de la etiqueta del elemento de mapa. Valores posibles: -1 - (por defecto) ubicación por defecto; 0 - abajo; 1 - izquierda; 2 - derecha; 3 - arriba.
permission	integer	Tipo de nivel de permiso. Valores posibles: -1 - ninguno; 2 - solo lectura; 3 - lectura-escritura.
show_label	integer	Cómo mostrar la etiqueta del elemento. Valores posibles: -1 - (por defecto) por defecto del mapa; 0 - mostrar siempre; 1 - ocultar automáticamente.
sysmapid	ID	ID del mapa al que pertenece el elemento. Comportamiento de la propiedad: - solo lectura
urls	array	URLs del elemento de mapa. El objeto URL del elemento de mapa se describe en detalle más abajo.
use_iconmap	integer	Si se debe usar el mapeo de iconos para los elementos host. Valores posibles: 0 - no usar mapeo de iconos; 1 - (por defecto) usar mapeo de iconos.
viewtype	integer	Algoritmo de colocación del elemento grupo de hosts. Valores posibles: 0 - (por defecto) cuadrícula.
width	integer	Ancho del elemento de grupo de hosts de tamaño fijo en píxeles. Por defecto: 200.
x	integer	Coordenadas X del elemento en píxeles. Por defecto: 0.
y	integer	Coordenadas Y del elemento en píxeles. Por defecto: 0.
zindex	integer	Valor utilizado para ordenar los elementos del mapa (z-index). Por defecto: 0.

Elemento de mapa Equipo

El objeto de elemento de mapa Host define un elemento de equipo.

Propiedad	Tipo	Descripción
hostid	ID	ID del equipo.

Elemento de mapa grupo de equipos

El objeto de elemento de mapa de grupo de equipos define un elemento del grupo de equipos.

Propiedad	Tipo	Descripción
groupid	ID	ID del grupo de equipos

Elemento de mapa Mapa

El objeto de elemento de mapa define un elemento de mapa.

Propiedad	Tipo	Descripción
sysmapid	ID	ID de mapa.

Elemento de mapa Iniciador

El objeto iniciador del elemento de mapa define uno o más elementos de iniciador.

Propiedad	Tipo	Descripción
triggerid	ID	ID del iniciador

Etiqueta de elemento de mapa

El objeto Etiqueta de elemento de mapa tiene las siguientes propiedades.

Propiedad	Tipo	Descripción
tag	string	Nombre de la etiqueta del elemento de mapa. Comportamiento de la propiedad: - obligatorio
operator	integer	Operador de condición de la etiqueta del elemento de mapa. Valores posibles: 0 - (por defecto) Contiene; 1 - Es igual a; 2 - No contiene; 3 - No es igual a; 4 - Existe; 5 - No existe.
value	string	Valor de la etiqueta del elemento de mapa.

Elemento del mapa: URL

El objeto URL del elemento del mapa define un enlace en el que se puede hacer clic y que estará disponible para un elemento de mapa específico. Tiene las siguientes propiedades:

Propiedad	Tipo	Descripción
sysmapelementurlid	ID	ID del elemento del mapa URL. Comportamiento de la propiedad: - solo lectura
name	cadena	Título del enlace. Comportamiento de la propiedad: - obligatorio
url	cadena	URL del enlace. Comportamiento de la propiedad: - obligatorio
selementid	ID	ID del elemento del mapa al que pertenece la URL.

Enlace de mapa

El objeto de enlace de mapa define un enlace entre dos elementos del mapa. Tiene las siguientes propiedades.

Propiedad	Tipo	Descripción
linkid	ID	ID del enlace de mapa. Comportamiento de la propiedad: - solo lectura
sysmapid	ID	ID del mapa al que pertenece el enlace.
selementid1	ID	ID del primer elemento del mapa enlazado en un extremo. Comportamiento de la propiedad: - requerido
selementid2	ID	ID del primer elemento del mapa enlazado en el otro extremo. Comportamiento de la propiedad: - requerido
drawtype	entero	Estilo de dibujo de la línea de enlace. Valores posibles: 0 - (por defecto) línea; 2 - línea en negrita; 3 - línea punteada; 4 - línea discontinua.
color	cadena	Color de la línea como código de color hexadecimal. Por defecto: `000000`.
label	cadena	Etiqueta del enlace.
show_label	entero	Cómo mostrar la etiqueta del enlace. Valores posibles: -1 - (por defecto) valor por defecto del mapa; 0 - mostrar siempre; 1 - ocultar automáticamente.
indicator_type	entero	Seleccionar el tipo de indicador de enlace. Valores posibles: 0 - (por defecto) enlace estático; 1 - disparador; 2 - valor de elemento.
linktriggers	array	Disparadores de enlace de mapa a usar como indicadores de estado del enlace. El objeto de disparador de enlace de mapa se describe en detalle a continuación. Comportamiento de la propiedad: - requerido si `indicator_type` está establecido en "disparador" (1).
itemid	ID	ID del elemento. Comportamiento de la propiedad: - requerido si `indicator_type` está establecido en "valor de elemento" (2).
highlights	array	Resaltados de enlace de mapa a usar como indicadores de estado del enlace. El objeto de indicadores de enlace de mapa se describe en detalle a continuación. Comportamiento de la propiedad: - requerido si `indicator_type` está establecido en "valor de elemento" (2).
thresholds	array	Umbrales de enlace de mapa a usar como indicadores de estado del enlace. El objeto de indicadores de enlace de mapa se describe en detalle a continuación. Comportamiento de la propiedad: - requerido si `indicator_type` está establecido en "valor de elemento" (2).
permission	entero	Tipo de nivel de permiso. Valores posibles: -1 - ninguno; 2 - solo lectura; 3 - lectura-escritura.

Disparador de enlace de mapa

El objeto disparador de enlace de mapa define un indicador de estado de enlace de mapa basado en el estado de un disparador. Tiene las siguientes propiedades:

Propiedad	Tipo	Descripción
triggerid	ID	ID del disparador utilizado como indicador de enlace. Comportamiento de la propiedad: - obligatorio
color	string	Color del indicador como un código de color hexadecimal. Por defecto: `DD0000`.
drawtype	integer	Estilo de dibujo del indicador. Valores posibles: 0 - (por defecto) línea; 2 - línea en negrita; 3 - línea punteada; 4 - línea discontinua.

Indicadores de enlace de mapa

El objeto de indicadores de enlace de mapa define un indicador de estado de enlace de mapa basado en el valor del elemento. Tiene las siguientes propiedades:

Propiedad	Tipo	Descripción
pattern	string	Expresión regular para comparar. Disponible solo para resaltados.
sortorder	integer	Se utiliza para definir el orden de los resaltados. Disponible solo para resaltados.
threshold	string	Valor numérico para comparar. Disponible solo para umbrales.
drawtype	integer	Estilo de dibujo del indicador. Valores posibles: 0 - (por defecto) línea; 2 - línea en negrita; 3 - línea punteada; 4 - línea discontinua.
color	string	Color del indicador como código de color hexadecimal. Por defecto: `DD0000`. Comportamiento de la propiedad: - requerido

URL del mapa

El objeto URL del mapa define un enlace en el que se puede hacer clic y que estará disponible para todos los elementos de un tipo específico en el mapa. Tiene las siguientes propiedades:

Propiedad	Tipo	Descripción
sysmapurlid	ID	ID de la URL del mapa. Comportamiento de la propiedad: - solo lectura
name	cadena	Título del enlace. Comportamiento de la propiedad: - obligatorio
url	cadena	URL del enlace. Comportamiento de la propiedad: - obligatorio
elementtype	entero	Tipo de elemento de mapa para el cual la URL estará disponible. Consulte la propiedad `type` del elemento de mapa para obtener una lista de los tipos admitidos. < br>Predeterminado: 0.
sysmapid	ID	ID del mapa al que pertenece la URL.

Usuario del mapa

Lista de permisos de mapas basados en usuarios. Tiene las siguientes propiedades:

Propiedad	Tipo	Descripción
sysmapuserid	ID	ID del usuario del mapa. Comportamiento de la propiedad: - solo lectura
userid	ID	ID del usuario. Comportamiento de la propiedad: - obligatorio
permission	entero	Tipo de nivel de permiso. Valores posibles: 2 - solo lectura; 3 - lectura-escritura. Comportamiento de la propiedad: - obligatorio

Grupo de usuarios del mapa

Lista de permisos de mapas basados en grupos de usuarios. Tiene las siguientes propiedades:

Propiedad	Tipo	Descripción
sysmapusrgrpid	ID	ID del grupo de usuarios del mapa. Comportamiento de la propiedad: - solo lectura
usrgrpid	ID	ID de grupo de usuarios. Comportamiento de la propiedad: - obligatorio
permission	entero	Tipo de nivel de permiso. Valores posibles: 2 - solo lectura; 3 - lectura-escritura. Comportamiento de la propiedad: - obligatorio

Formas del mapa

El objeto de forma del mapa define una forma geométrica (con o sin texto) mostrada en un mapa. Tiene las siguientes propiedades:

Propiedad	Tipo	Descripción
sysmap_shapeid	ID	ID del elemento de forma del mapa. Comportamiento de la propiedad: - solo lectura
type	entero	Tipo de elemento de forma de mapa. Valores posibles: 0 - rectángulo; 1 - elipse. La propiedad es obligatoria cuando se crean nuevas formas.< br> Comportamiento de la propiedad: - obligatorio
x	entero	Coordenadas X de la forma en píxeles. Predeterminado: 0.
y	entero	Coordenadas Y de la forma en píxeles. Predeterminado: 0.
width	entero	Ancho de la forma en píxeles. Predeterminado: 200.
height	entero	Altura de la forma en píxeles. Predeterminado: 200.
text	cadena	Texto de la forma.
font	entero	Fuente del texto dentro de la forma. Valores posibles: 0 - Georgia, serif 1 - “Palatino Linotype”, “Book Antiqua”, Palatino, serif 2 - “Times New Roman”, Times, serif 3 - Arial, Helvetica, sans-serif 4 - “Arial Black”, Gadget, sans-serif 5 - “Comic Sans MS”, cursiva , sans-serif 6 - Impact, Charcoal, sans-serif 7 - “Lucida Sans Unicode”, “Lucida Grande”, sans-serif 8 - Tahoma, Ginebra, sans-serif 9 - “Trebuchet MS”, Helvetica, sans-serif 10 - Verdana, Ginebra, sans-serif 11 - “Courier New”, Courier, monoespaciado 12 - “Lucida Console”, Mónaco, monoespaciado Predeterminado: 9.
font_size	entero	Tamaño de fuente en píxeles. Predeterminado: 11.
font_color	cadena	Color de fuente. Predeterminado: `000000`.
text_halign	entero	Alineación horizontal del texto. Valores posibles: 0 - centro; 1 - izquierda; 2 - derecha. Predeterminado: 0.
text_valign	entero	Alineación vertical del texto. Valores posibles: 0 - medio; 1 - arriba; 2 - abajo. Predeterminado: 0.
border_type	integer	Tipo de borde. Valores posibles: 0 - ninguno; 1 - `—————`; 2 - `··· ··`; 3 - `- - -`. Predeterminado: 0.
border_width	entero	Ancho del borde en píxeles. Predeterminado: 0.
border_color	cadena	Color del borde. Predeterminado: `000000`.
background_color	cadena	Color de fondo (color de relleno). Predeterminado: `(vacío)`.
zindex	entero	Valor utilizado para ordenar todas las formas y líneas (índice z). Predeterminado: 0.

Líneas del mapa

El objeto de línea de mapa define una línea que se muestra en un mapa. Tiene las siguientes propiedades:

Propiedad	Tipo	Descripción
sysmap_shapeid	ID	ID del elemento de forma del mapa. Comportamiento de la propiedad: - solo lectura
x1	entero	Coordenadas X del punto de línea 1 en píxeles. Predeterminado: 0.
y1	entero	Coordenadas Y del punto de línea 1 en píxeles. Predeterminado: 0.
x2	entero	Coordenadas X del punto de línea 2 en píxeles. Predeterminado: 200.
y2	entero	Coordenadas Y del punto de línea 2 en píxeles. Predeterminado: 200.
line_type	entero	Tipo de las líneas. Valores posibles: 0 - ninguno; 1 - `—————`; 2 - `··· ··`; 3 - `- - -`. Predeterminado: 0.
line_width	entero	Ancho de las líneas en píxeles. Predeterminado: 0.
line_color	cadena	Color de línea. Predeterminado: `000000`.
zindex	entero	Valor utilizado para ordenar todas las formas y líneas (índice z). Predeterminado: 0.

Documentation