templatedashboard.עדכון

תיאור

object templatedashboard.update(object/array templateDashboards)

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

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

פרמטרים

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

יש לציין את המאפיין dashboardid עבור כל לוח מחוונים, הכל נכסים אחרים הם אופציונליים. רק המאפיינים שצוינו יהיו מְעוּדכָּן.

בנוסף ללוח המחוונים של התבנית הסטנדרטית properties, השיטה מקבלת את הדברים הבאים פרמטרים.

פרמטר סוג תיאור
pages array לוח המחוונים של תבניות pages כדי להחליף את דפי לוח המחוונים הקיימים.

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

החזר ערכים

(object) מחזירה אובייקט המכיל את המזהים של התבנית המעודכנת לוחות מחוונים תחת המאפיין dashboardids.

דוגמאות

שינוי שם של לוח מחוונים של תבנית

שנה שם לוח מחוונים של תבנית ל"גרפי ביצועים".

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "templatedashboard.update",
            "params": {
                "dashboardid": "23",
                "name": "גרפי ביצועים"
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

{
            "jsonrpc": "2.0",
            "תוצאה": {
                "dashboardids": [
                    "23"
                ]
            },
            "מזהה": 1
       }

עדכון דפי לוח המחוונים של התבניות

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

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "templatedashboard.update",
            "params": {
                "dashboardid": "2",
                "עמודים": [
                    {
                        "dashboard_pageid": 1,
                        "name": 'שם שונה לדף'
                    },
                    {
                        "dashboard_pageid": 2,
                        "יישומונים": [
                            {
                                "type": "שעון",
                                "x": 0,
                                "y": 0,
                                "רוחב": 4,
                                "גובה": 3
                            }
                        ]
                    },
                    {
                        "תצוגה_תקופה": 60
                    }
                ]
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

{
            "jsonrpc": "2.0",
            "תוצאה": {
                "dashboardids": [
                    "2"
                ]
            },
            "מזהה": 2
       }

ראה גם

מקור

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