#אסימון

שיעור זה נועד לעבוד עם אסימונים.

הפניות לאובייקט:

שיטות זמינות:

תיאור

integer/array trend.get(object parameters)

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

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

פרמטרים

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

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

פרמטר סוג תיאור
itemids string/array החזר רק מגמות עם מזהי הפריטים הנתונים.
time_from timestamp החזר רק ערכים שנאספו לאחר או בזמן הנתון.
time_till timestamp החזר רק ערכים שנאספו לפני או בזמן הנתון.
countOutput boolean ספור את מספר האובייקטים שאוחזרו.
limit integer הגבלת כמות האובייקטים שאוחזרו.
output query הגדר שדות לפלט.

החזר ערכים

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

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

דוגמאות

אחזור נתוני מגמת פריט

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "trend.get",
            "params": {
                "פלט": [
                    "מספר זיהוי של הפריט",
                    "שָׁעוֹן",
                    "נום",
                    "ערך_דקה",
                    "ערך_ממוצע",
                    "value_max",
                ],
                "itemids": [
                    "23715"
                ],
                "limit": "1"
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

{
            "jsonrpc": "2.0",
            "תוצאה": [
                {
                    "itemid": "23715",
                    "שעון": "1446199200",
                    "num": "60",
                    "value_min": "0.165",
                    "value_avg": "0.2168",
                    "value_max": "0.35",
                }
            ],
            "מזהה": 1
       }

מקור

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