Documentation
Table of Contents
> עצם תחזוקה
העצמים הבאים קשורים ישירות ל־API maintenance.
תחזוקה
לאובייקט התחזוקה יש את המאפיינים הבאים.
| Property | Type | תיאור |
|---|---|---|
| maintenanceid | string | (קריאה בלבד) מזהה התחזוקה. |
| שם (נדרש) |
מחרוזת | שם התחזוקה. |
| פעיל_מאז (חובה) |
חותמת זמן | זמן שבו התחזוקה הופכת לפעילה. הערך הנתון יעוגל כלפי מטה לדקות. |
| פעיל_עד (חובה) |
חותמת זמן | זמן שבו תחזוקה מפסיקה להיות פעילה. הערך הנתון יעוגל כלפי מטה לדקות. |
| description | string | תיאור התחזוקה. |
| maintenance_type | integer | סוג תחזוקה. ערכים אפשריים: 0 - (ברירת מחדל) עם איסוף נתונים; 1 - ללא איסוף נתונים. |
| tags_evaltype | integer | שיטת הערכת תג בעיה. ערכים אפשריים: 0 - (ברירת מחדל) ו/או; 2 - או. |
שימו לב שעבור שיטות מסוימות (עדכון, מחק) שילוב הפרמטרים הנדרש/אופציונלי שונה.
תקופת זמן
אובייקט פרק הזמן משמש להגדרת תקופות שבהן התחזוקה חייב להיכנס לתוקף. יש לו את המאפיינים הבאים.
| Property | Type | תיאור |
|---|---|---|
| period | integer | משך תקופת האחזקה בשניות. הערך הנתון יעוגל כלפי מטה לדקות. ברירת מחדל: 3600. |
| timeperiod_type | integer | סוג פרק זמן. ערכים אפשריים: 0 - (ברירת מחדל) פעם אחת בלבד; 2 - יומי; 3 - שבועי;< br>4 - חודשי. |
| start_date | timestamp | תאריך שבו תקופת התחזוקה חייבת להיכנס לתוקף. בשימוש לפרקי זמן בודדים בלבד. הערך הנתון יעוגל כלפי מטה לדקות. < br>ברירת מחדל: תאריך נוכחי. |
| start_time | integer | שעה ביום שבה התחזוקה מתחילה תוך שניות. משמש לתקופות יומיות, שבועיות וחודשיות. הערך הנתון יעוגל כלפי מטה לדקות.<br ברירת מחדל: 0. |
| every | integer | משמש לתקופות יומיות, שבועיות וחודשיות. עבור תקופות יומיות ושבועיות 'כל' מגדיר מרווחי ימים או שבוע שבהם תחזוקה חייבת להיכנס לתוקף. ברירת מחדל: 1. עבור תקופות חודשיות, אם הנכס dayofweek מכיל לפחות יום נבחר אחד בשבוע, הנכס כל מגדיר את השבוע בחודש שבו תחזוקה חייבת להיכנס לתוקף.<br >ערכים אפשריים: 1 - (ברירת מחדל) שבוע ראשון; 2 - שבוע שני; 3 - שבוע שלישי; 4 - שבוע רביעי; 5 - שבוע שעבר. |
| dayofweek | מספר שלם | ימי השבוע שבהם התחזוקה חייבת להיכנס לתוקף. ימים מאוחסנים בצורה בינארית כאשר כל ביט מייצג את היום המתאים. לדוגמה, 4 שווה ל-100 בבינארי ופירושו שהתחזוקה תופעל ביום רביעי. משמש לתקופות זמן שבועיות וחודשיות. נדרש רק לתקופות זמן שבועיות. יש לציין לפחות יום בשבוע או יום אחד עבור תקופות זמן חודשיות. |
| day | integer | היום בחודש שבו תחזוקה חייבת להיכנס לתוקף. משמש רק לפרקי זמן חודשיים. יש לציין לפחות יום בשבוע או יום אחד עבור פרקי זמן חודשיים. |
| חודש | מספר שלם | חודשים שבהם תחזוקה חייבת להיכנס לתוקף. חודשים מאוחסנים בצורה בינארית כאשר כל ביט מייצג את החודש המתאים. לדוגמה, 5 שווה ל-101 בבינארי ופירושו שהתחזוקה תופעל בינואר ומרץ. נדרש רק לתקופות זמן חודשיות. |
תג בעיה
אובייקט תג הבעיה משמש כדי להגדיר אילו בעיות חייבות להיות נדחק כאשר התחזוקה נכנסת לתוקף. יש לו את הדברים הבאים נכסים.
| Property | Type | תיאור |
|---|---|---|
| תג (חובה) |
מחרוזת | שם תג בעיה. |
| operator | integer | אופרטור תנאי. ערכים אפשריים: 0 - שווה; 2 - (ברירת מחדל) מכיל. |
| value | string | ערך תג בעיה. |
ניתן לציין תגיות רק לתקופות תחזוקה עם איסוף נתונים ("maintenance_type":0).