היסטוריה.קבל

תיאור

integer/array history.get(אובייקט פרמטרים)

השיטה מאפשרת לשלוף נתוני היסטוריה בהתאם לנתון פרמטרים.

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

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

פרמטרים

(object) פרמטרים המגדירים את הפלט הרצוי.

השיטה תומכת בפרמטרים הבאים.

פרמטר	סוג	תיאור
היסטוריה	מספר שלם	סוגי אובייקטים בהיסטוריה להחזרה. ערכים אפשריים: 0 - צף מספרי; 1 - תו; 2 - יומן; 3 - מספרי ללא סימן; 4 - טקסט. ברירת מחדל: 3.
hostids	string/array	החזר רק היסטוריה מהמארחים הנתונים.
itemids	string/array	החזר רק היסטוריה מהפריטים הנתונים.
time_from	timestamp	החזר רק ערכים שהתקבלו לאחר או בזמן הנתון.
time_till	timestamp	החזר רק ערכים שהתקבלו לפני או בזמן הנתון.
sortfield	string/array	מיין את התוצאה לפי המאפיינים הנתונים. ערכים אפשריים הם: `itemid` ו`clock`.
countOutput	boolean	הפרמטרים הללו הנפוצים לכל שיטות ה-'get' מתוארים בפירוט בדף פרשנות הפניה.
עריכה	בוליאנית
excludeSearch	בולאני
filter	object
limit	מספר שלם
פלט	שאילתה
חיפוש	אובייקט
searchByAny	boolean
searchWildcardsEnabled	boolean
sortorder	מחרוזת/מערך
startSearch	boolean

החזר ערכים

(מספר שלם/מערך) מחזיר אחד:

מערך של חפצים;
ספירת האובייקטים שאוחזרו, אם יש לפרמטר countOutput נעשה שימוש.

דוגמאות

מאחזר נתוני היסטוריית פריטים

החזר 10 ערכים אחרונים שהתקבלו מפריט מספרי (צף).

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "history.get",
            "params": {
                "output": "להרחיב",
                "היסטוריה": 0,
                "itemids": "23296",
                "sortfield": "שעון",
                "sortorder": "DESC",
                "מגבלה": 10
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

{
            "jsonrpc": "2.0",
            "תוצאה": [
                {
                    "itemid": "23296",
                    "שעון": "1351090996",
                    "value": "0.085",
                    "ns": "563157632"
                },
                {
                    "itemid": "23296",
                    "שעון": "1351090936",
                    "value": "0.16",
                    "ns": "549216402"
                },
                {
                    "itemid": "23296",
                    "שעון": "1351090876",
                    "value": "0.18",
                    "ns": "537418114"
                },
                {
                    "itemid": "23296",
                    "שעון": "1351090816",
                    "value": "0.21",
                    "ns": "522659528"
                },
                {
                    "itemid": "23296",
                    "שעון": "1351090756",
                    "value": "0.215",
                    "ns": "507809457"
                },
                {
                    "itemid": "23296",
                    "שעון": "1351090696",
                    "value": "0.255",
                    "ns": "495509699"
                },
                {
                    "itemid": "23296",
                    "שעון": "1351090636",
                    "value": "0.36",
                    "ns": "477708209"
                },
                {
                    "itemid": "23296",
                    "שעון": "1351090576",
                    "value": "0.375",
                    "ns": "463251343"
                },
                {
                    "itemid": "23296",
                    "שעון": "1351090516",
                    "value": "0.315",
                    "ns": "447947017"
                },
                {
                    "itemid": "23296",
                    "שעון": "1351090456",
                    "value": "0.275",
                    "ns": "435307141"
                }
            ],
            "מזהה": 1
       }

מקור

CHistory::get()‎ בתוך ui/include/classes/api/services/CHistory.php.

Documentation