Table of Contents

> עצם מפה

> עצם מפה

העצמים הבאים קשורים ישירות ל־API‏ map.

מפה

לאובייקט המפה יש את המאפיינים הבאים.

Property	Type	תיאור
sysmapid	string	(לקריאה בלבד) מזהה המפה.
גובה (נדרש)	מספר שלם	גובה המפה בפיקסלים.
שם (חובה)	מחרוזת	שם המפה.
רוחב (נדרש)	מספר שלם	רוחב המפה בפיקסלים.
backgroundid	string	מזהה של התמונה המשמשת כרקע למפה.
expand_macros	integer	האם להרחיב פקודות מאקרו בתוויות בעת הגדרת המפה. ערכים אפשריים: 0 - (ברירת מחדל) אין להרחיב פקודות מאקרו; 1 - הרחבת פקודות מאקרו.
expandproblem	integer	האם טריגר הבעיה יוצג עבור אלמנטים עם בעיה בודדת. ערכים אפשריים: 0 - הצג תמיד את מספר הבעיות; 1 - (ברירת מחדל) הצג את טריגר הבעיה אם יש רק בעיה אחת.
grid_align	integer	האם לאפשר יישור רשת. ערכים אפשריים: 0 - השבת יישור רשת; 1 - (ברירת מחדל) אפשר יישור רשת.
grid_show	integer	האם להציג את הרשת על המפה. ערכים אפשריים: 0 - אין להציג את הרשת; 1 - (ברירת מחדל) להציג את הרשת.
grid_size	integer	גודל רשת המפה בפיקסלים. ערכים נתמכים: 20, 40, 50, 75 ו-100. ברירת מחדל: 50.
highlight	integer	האם הדגשת סמלים מופעלת. ערכים אפשריים: 0 - הדגשה מושבתת; 1 - (ברירת מחדל) הדגשה מופעלת.
iconmapid	string	מזהה של מפת הסמלים המשמשת במפה.
label_format	integer	האם להפעיל תוויות מתקדמות. ערכים אפשריים: 0 - (ברירת מחדל) השבת תוויות מתקדמות; 1 - אפשר תוויות מתקדמות.
label_location	integer	מיקום של תווית רכיב המפה. ערכים אפשריים: 0 - (ברירת מחדל) למטה; 1 - שמאל; 2 - ימין;< br>3 - למעלה.
label_string_host	string	תווית מותאמת אישית עבור רכיבי מארח. נדרש עבור מפות עם סוג תווית מארח מותאמת אישית.
label_string_hostgroup	string	תווית מותאמת אישית עבור רכיבי קבוצת מארח. נדרשת עבור מפות עם סוג תווית מותאם אישית של קבוצת מארח.
label_string_image	string	תווית מותאמת אישית עבור רכיבי תמונה. נדרש עבור מפות עם סוג תווית תמונה מותאמת אישית.
label_string_map	string	תווית מותאמת אישית עבור רכיבי מפה. נדרש עבור מפות עם סוג תווית מפה מותאמת אישית.
label_string_trigger	string	תווית מותאמת אישית עבור רכיבי טריגר. נדרש עבור מפות עם סוג תווית טריגר מותאם אישית.
label_type	integer	סוג תווית רכיב מפה. ערכים אפשריים: 0 - תווית; 1 - כתובת IP; 2 - (ברירת מחדל) שם רכיב;< br>3 - סטטוס בלבד; 4 - כלום.
label_type_host	integer	סוג תווית עבור רכיבי מארח. ערכים אפשריים: 0 - תווית; 1 - כתובת IP; 2 - אלמנט (ברירת מחדל) שם; 3 - סטטוס בלבד; 4 - כלום; 5 - מותאם אישית.
label_type_hostgroup	integer	סוג תווית עבור רכיבי קבוצת מארח. ערכים אפשריים: 0 - תווית; 2 - (ברירת מחדל) שם רכיב; 3 - סטטוס בלבד; 4 - כלום; 5 - מותאם אישית.
תווית_type_image	מספר שלם	סוג תווית עבור רכיבי קבוצת מארח. ערכים אפשריים: 0 - תווית; 2 - (ברירת מחדל) שם רכיב; 4 - כלום; 5 - מותאם אישית.
label_type_map	integer	סוג תווית עבור רכיבי מפה. ערכים אפשריים: 0 - תווית; 2 - (ברירת מחדל) שם רכיב; 3 - סטטוס רק; 4 - כלום; 5 - מותאם אישית.
label_type_trigger	integer	סוג תווית עבור רכיבי טריגר. ערכים אפשריים: 0 - תווית; 2 - (ברירת מחדל) שם רכיב; 3 - סטטוס רק; 4 - כלום; 5 - מותאם אישית.
markelements	integer	האם להדגיש רכיבי מפה ששינו לאחרונה את הסטטוס שלהם. ערכים אפשריים: 0 - (ברירת מחדל) אין להדגיש אלמנטים; 1 - הדגשת אלמנטים.
severity_min	integer	חומרה מינימלית של הטריגרים שיוצגו במפה. עיין במאפיין trigger "severity" לרשימה של חומרות טריגרים נתמכות.
show_unack	integer	כיצד יש להציג בעיות. ערכים אפשריים: 0 - (ברירת מחדל) הצג את ספירת כל הבעיות; 1 - הצג רק את ספירת הבעיות הבלתי מאושרות בעיות; 2 - הצג את ספירת הבעיות שאושרו ובלתי מאושרות בנפרד.
userid	string	מזהה משתמש בעל המפה.
private	integer	סוג שיתוף המפה. ערכים אפשריים: 0 - מפה ציבורית; 1 - (ברירת מחדל) מפה פרטית.
show_suppressed	מספר שלם	האם מוצגות בעיות מודחקות. ערכים אפשריים: 0 - (ברירת מחדל) הסתר בעיות מודחקות; 1 - הצג בעיות מודחקות.

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

רכיב מפה

אובייקט אלמנט המפה מגדיר אובייקט המוצג במפה. יש לו את המאפיינים הבאים.

Property	Type	תיאור
selementid	string	(לקריאה בלבד) מזהה רכיב המפה.
אלמנטים (נדרש)	מערך	אובייקט נתוני אלמנט. נדרש עבור רכיבי מארח, קבוצת מארח, טריגר וסוג מפה.
סוג אלמנט (נדרש)	מספר שלם	סוג רכיב המפה. ערכים אפשריים: 0 - מארח; 1 - מפה; 2 - טריגר; 3 - קבוצה מארח; 4 - תמונה.
iconid_off (נדרש)	מחרוזת	מזהה של התמונה המשמשת להצגת האלמנט במצב ברירת מחדל.
areatype	integer	כיצד יש להציג מארחים נפרדים של קבוצות מארח. ערכים אפשריים: 0 - (ברירת מחדל) רכיב הקבוצה המארחת יתפוס את כל המפה; 1 - ה- לרכיב הקבוצה המארחת יהיה גודל קבוע.
elementsubtype	integer	כיצד יש להציג רכיב של קבוצת מארח במפה. ערכים אפשריים: 0 - (ברירת מחדל) הצג את הקבוצה המארחת כאלמנט בודד; 1 - הצג כל מארח בקבוצה בנפרד.
evaltype	integer	שיטת הערכה של מצב סינון תג של רכיב מפה. ערכים אפשריים: 0 - (ברירת מחדל) AND / OR; 2 - OR.
height	integer	גובה של רכיב קבוצת המארח בגודל קבוע בפיקסלים. ברירת מחדל: 200.
iconid_disabled	string	מזהה של התמונה המשמשת להצגת רכיבי מפה מושבתים. לא בשימוש עבור רכיבי תמונה.
iconid_maintenance	string	מזהה של התמונה המשמשת להצגת רכיבי מפה בתחזוקה. לא בשימוש עבור רכיבי תמונה.
iconid_on	string	מזהה של התמונה המשמשת להצגת רכיבי מפה עם בעיות. לא בשימוש עבור רכיבי תמונה.
label	string	תווית של האלמנט.
label_location	integer	מיקום של תווית רכיב המפה. ערכים אפשריים: -1 - (ברירת מחדל) מיקום ברירת מחדל; 0 - למטה; 1 - משמאל ; 2 - מימין; 3 - למעלה.
permission	integer	סוג רמת ההרשאה. ערכים אפשריים: -1 - none; 2 - read only; 3 - read-write.
sysmapid	string	(readonly) מזהה המפה שאליה שייך האלמנט.
urls	array	כתובות אתרים של רכיבי מפה. אובייקט URL של רכיב המפה הוא מתואר בפירוט למטה.
use_iconmap	integer	האם יש להשתמש במיפוי סמלים עבור רכיבי מארח. ערכים אפשריים: 0 - אל תשתמש במיפוי סמלים; 1 - (ברירת מחדל) השתמש במיפוי סמלים .
viewtype	integer	אלגוריתם של הצבת רכיבי קבוצת מארח. ערכים אפשריים: 0 - (ברירת מחדל) רשת.
width	integer	רוחב רכיב קבוצת המארח בגודל קבוע בפיקסלים. ברירת מחדל: 200.
x	מספר שלם	קואורדינטות X של האלמנט בפיקסלים. ברירת מחדל: 0.
y	מספר שלם	קואורדינטות Y של האלמנט בפיקסלים. ברירת מחדל: 0.

רכיב מפה מארח

אלמנט המפה מארח מגדיר אלמנט מארח אחד.

Property	Type	תיאור
hostid	string	מזהה מארח

רכיב מפה קבוצה מארח

רכיב המפה אובייקט קבוצת מארח מגדיר רכיב קבוצת מארח אחד.

Property	Type	תיאור
groupid	string	מזהה קבוצת מארח

רכיב מפה מפה

רכיב המפה אובייקט מפה מגדיר רכיב מפה אחד.

Property	Type	תיאור
sysmapid	string	מזהה מפה

רכיב מפה טריגר

רכיב ההפעלה של המפה מגדיר רכיב טריגר אחד או יותר.

Property	Type	תיאור
triggerid	string	מזהה טריגר

תג רכיב מפה

לאובייקט תג רכיב המפה יש את המאפיינים הבאים.

Property	Type	תיאור
תג (נדרש)	מחרוזת	שם תג רכיב מפה.
operator	string	אופפרטור מצב תג של רכיב מפה. ערכים אפשריים: 0 - (ברירת מחדל) מכיל; 1 - שווה; 2 - אינו מכיל;<br >3 - לא שווה; 4 - קיים; 5 - לא קיים.
value	string	ערך תג רכיב מפה.

כתובת האתר של רכיב המפה

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

Property	Type	תיאור
sysmapelementurlid	string	(לקריאה בלבד) מזהה כתובת האתר של רכיב המפה.
שם (חובה)	מחרוזת	כיתוב קישור.
כתובת אתר (חובה)	מחרוזת	כתובת אתר של קישור.
selementid	string	מזהה של רכיב המפה שאליו שייכת כתובת האתר.

קישור למפה

אובייקט קישור המפה מגדיר קישור בין שני רכיבי מפה. יש לו את המאפיינים הבאים.

Property	Type	תיאור
linkid	string	(לקריאה בלבד) מזהה קישור המפה.
selementid1 (חובה)	מחרוזת	מזהה של רכיב המפה הראשון המקושר בקצה אחד.
selementid2 (נדרש)	מחרוזת	מזהה של רכיב המפה הראשון המקושר בקצה השני.
color	string	צבע קו כקוד צבע הקסדצימלי. ברירת מחדל: `000000`.
drawtype	integer	סגנון ציור קו קישור. ערכים אפשריים: 0 - (ברירת מחדל) שורה; 2 - קו מודגש; 3 - קו מנוקד; 4 - קו מקווקו.
label	string	תווית קישור.
linktriggers	מערך	מפעילי קישור מפה לשימוש כמחווני סטטוס קישור. אובייקט טריגר קישור המפה הוא מתואר בפירוט למטה.
permission	integer	סוג רמת ההרשאה. ערכים אפשריים: -1 - none; 2 - read only; 3 - read-write.
sysmapid	string	מזהה המפה שאליה שייך הקישור.

מפעיל קישור מפה

אובייקט ההדק של קישור מפה מגדיר מחוון מצב קישור מפה על סמך מצב של טריגר. יש לו את המאפיינים הבאים:

Property	Type	תיאור
linktriggerid	string	(לקריאה בלבד) מזהה של טריגר קישור המפה.
triggerid (נדרש)	מחרוזת	מזהה הטריגר המשמש כמחוון קישור.
color	string	צבע מחוון כקוד צבע הקסדצימלי. ברירת מחדל: `DD0000`.
drawtype	integer	אינדיקטור סגנון ציור. ערכים אפשריים: 0 - (ברירת מחדל) שורה; 2 - קו מודגש; 3 - קו מנוקד; 4 - קו מקווקו.
linkid	string	מזהה של קישור המפה שאליו שייך טריגר הקישור.

כתובת אתר של מפה

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

Property	Type	תיאור
sysmapurlid	string	(לקריאה בלבד) מזהה כתובת האתר של המפה.
שם (חובה)	מחרוזת	כיתוב קישור.
כתובת אתר (חובה)	מחרוזת	כתובת אתר של קישור.
elementtype	integer	סוג רכיב המפה שכתובת האתר תהיה זמינה עבורו. עיין במאפיין רכיב מפה "type" לקבלת רשימה של סוגים נתמכים. < br>ברירת מחדל: 0.
sysmapid	string	מזהה המפה שאליה שייכת כתובת האתר.

משתמש במפה

רשימת הרשאות המפה מבוססת על משתמשים. יש לו את המאפיינים הבאים:

Property	Type	תיאור
sysmapuserid	string	(לקריאה בלבד) מזהה משתמש המפה.
userid (נדרש)	מחרוזת	מזהה משתמש.
הרשאה (נדרש)	מספר שלם	סוג רמת ההרשאה. ערכים אפשריים: 2 - לקריאה בלבד; 3 - קריאה-כתיבה;

מפה קבוצת משתמשים

רשימת הרשאות המפה מבוססת על קבוצות משתמשים. יש לו את הדברים הבאים נכסים:

Property	Type	תיאור
sysmapusrgrpid	string	(לקריאה בלבד) מזהה קבוצת המשתמשים במפה.
usrgrpid (נדרש)	string	מזהה קבוצת משתמשים.
הרשאה (נדרש)	מספר שלם	סוג רמת ההרשאה. ערכים אפשריים: 2 - לקריאה בלבד; 3 - קריאה-כתיבה;

צורות מפה

אובייקט צורת המפה מגדיר צורה גיאומטרית (עם או בלי טקסט) מוצג על מפה. יש לו את המאפיינים הבאים:

Property	Type	תיאור
sysmap_shapeid	string	(לקריאה בלבד) מזהה של אלמנט צורת המפה.
סוג (נדרש)	מספר שלם	סוג אלמנט צורת המפה. ערכים אפשריים: 0 - מלבן; 1 - אליפסה. הנכס נדרש כאשר נוצרות צורות חדשות.
x	מספר שלם	קואורדינטות X של הצורה בפיקסלים. ברירת מחדל: 0.
y	מספר שלם	קואורדינטות Y של הצורה בפיקסלים. ברירת מחדל: 0.
width	integer	רוחב הצורה בפיקסלים. ברירת מחדל: 200.
height	integer	גובה הצורה בפיקסלים. ברירת מחדל: 200.
טקסט	מחרוזת	טקסט של הצורה.
font	integer	גופן הטקסט בתוך הצורה. ערכים אפשריים: 0 - Georgia, serif 1 - "Palatino Linotype", "Book Antiqua", Palatino, serif 2 - "Times New Roman", Times, serif 3 - Arial, Helvetica, sans-serif 4 - "Arial Black", גאדג'ט, sans-serif 5 - "Comic Sans MS", כתבה , sans-serif 6 - השפעה, פחם, sans-serif 7 - "Lucida Sans Unicode", "Lucida Grande", sans-serif 8 - Tahoma, Geneva, sans-serif 9 - "Trebuchet MS", Helvetica, sans-serif 10 - ורדנה, ז'נבה, sans-serif 11 - "Courier New", Courier, monospace 12 - "Lucida Console", מונקו, monospace ברירת מחדל: 9.
font_size	integer	גודל גופן בפיקסלים. ברירת מחדל: 11.
font_color	string	צבע גופן. ברירת מחדל: '000000'.
text_halign	integer	יישור אופקי של טקסט. ערכים אפשריים: 0 - מרכז; 1 - שמאל; 2 - ימין. ברירת מחדל: 0.
text_valign	integer	יישור אנכי של טקסט. ערכים אפשריים: 0 - אמצע; 1 - למעלה; 2 - למטה. ברירת מחדל: 0.
border_type	integer	סוג הגבול. ערכים אפשריים: 0 - none; 1 - `—————`; 2 - `··· ··`; 3 - `- - -`. ברירת מחדל: 0.
border_width	מספר שלם	רוחב הגבול בפיקסלים. ברירת מחדל: 0.
border_color	string	צבע גבול. ברירת מחדל: '000000'.
background_color	string	צבע רקע (צבע מילוי). ברירת מחדל: `(ריק)`.
zindex	integer	ערך המשמש לסדר את כל הצורות והקווים (z-index). ברירת מחדל: 0.

קווי מפה

אובייקט קו המפה מגדיר קו המוצג על המפה. יש לו את המאפיינים הבאים:

Property	Type	תיאור
sysmap_shapeid	string	(לקריאה בלבד) מזהה של אלמנט צורת המפה.
x1	מספר שלם	קואורדינטות X של נקודת הקו 1 בפיקסלים. ברירת מחדל: 0.
y1	מספר שלם	קואורדינטות Y של נקודת הקו 1 בפיקסלים. ברירת מחדל: 0.
x2	מספר שלם	קואורדינטות X של נקודת הקו 2 בפיקסלים. ברירת מחדל: 200.
y2	מספר שלם	קואורדינטות Y של נקודת הקו 2 בפיקסלים. ברירת מחדל: 200.
line_type	integer	סוג השורות. ערכים אפשריים: 0 - none; 1 - `—————`; 2 - `··· ··`; 3 - `- - -`. ברירת מחדל: 0.
line_width	מספר שלם	רוחב הקווים בפיקסלים. ברירת מחדל: 0.
line_color	string	צבע קו. ברירת מחדל: '000000'.
zindex	integer	ערך המשמש לסדר את כל הצורות והקווים (z-index). ברירת מחדל: 0.

Documentation