[comment]: # translation:outdated

[comment]: # ({41154bde-41154bde})
# > אובייקט מפת ערך

האובייקטים הבאים קשורים ישירות ל-'valuemap' API.

[comment]: # ({/41154bde-41154bde})

[comment]: # ({71528aa6-65471f47})
### מפת ערך

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

|Property|[Type](/manual/api/reference_commentary#data_types)|תיאור|
|--|--|------|
|valuemapid|string|*(לקריאה בלבד)* מזהה של מפת הערך.|
|**hostid**<br>(נדרש)|id|מזהה מארח מפת ערך או תבנית.|
|**שם**<br>(חובה)|מחרוזת|שם מפת הערך.|
|**מיפויים**<br>(חובה)|מערך|מיפויי ערכים עבור מפת ערך נוכחי. אובייקט המיפוי הוא [מתואר בפירוט למטה](object#value_mappings).|
|uuid|string|מזהה ייחודי אוניברסלי, המשמש לקישור מפות ערכים מיובאות למפות שכבר קיימות. משמש רק למפות ערכים בתבניות. נוצר אוטומטית, אם לא ניתן.|

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

[comment]: # ({/71528aa6-65471f47})

[comment]: # ({5b45f38f-145a9918})
### מיפויי ערכים

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

|Property|[Type](/manual/api/reference_commentary#data_types)|תיאור|
|--|--|------|
|type|מספר שלם|סוג התאמה למיפוי. עבור סוג שווה 0,1,2,3,4 השדה 'ערך' לא יכול להיות ריק, עבור סוג 5 השדה 'ערך' צריך להיות ריק.<br><br>ערכים אפשריים:<br>0 - (ברירת מחדל) התאמה מדויקת ;<br>1 - המיפוי יוחל אם הערך גדול או שווה ל^1^;<br>2 - המיפוי יוחל אם הערך קטן או שווה^1^;<br>3 - המיפוי יוחל אם הערך נמצא בטווח (הטווחים כוללים), אפשר להגדיר טווחים מרובים המופרדים באמצעות תו פסיק^1^;<br>4 - מיפוי יוחל אם הערך תואם לביטוי רגולרי^2^;<br>5 - ערך ברירת המחדל, המיפוי יהיה בטווח יוחל אם לא נמצאה התאמה אחרת.|
|**ערך**<br>(חובה)|מחרוזת|ערך מקורי.<br><br>לא נדרש למיפוי מסוג "ברירת מחדל".|
|**newvalue**<br>(חובה)|string|ערך שאליו ממופה הערך המקורי.|

^1^ נתמך רק עבור פריטים בעלי סוג הערך "נומרי לא חתום",
"צף מספרי".\
^2^ נתמך רק עבור פריטים בעלי סוג ערך "תו".\

[comment]: # ({/5b45f38f-145a9918})