עדכון לוח מחוונים

תיאור

object dashboard.update(object/array dashboards)

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

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

פרמטרים

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

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

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

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

דפי לוח המחוונים מתעדכנים על ידי המאפיין dashboard_pageid. דפי לוח מחוונים חדשים ייווצרו עבור אובייקטים ללא מאפיין dashboard_pageid ודפי לוח המחוונים הקיימים יימחקו אם לא נעשה בהם שימוש חוזר. דפי לוח המחוונים יוזמנו באותו סדר כפי שצוין. רק המאפיינים שצוינו של דפי לוח המחוונים יעודכנו. נדרש לפחות אובייקט עמוד אחד של לוח המחוונים עבור מאפיין דפים.
users array Dashboard user שיתופים כדי להחליף את האלמנטים הקיימים.
userGroups מערך מרכז שליטה קבוצת משתמשים שיתופים כדי להחליף את האלמנטים הקיימים.

החזר ערכים

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

דוגמאות

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

שנה שם לוח מחוונים ל"סטטוס שרת SQL".

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "dashboard.update",
            "params": {
                "dashboardid": "2",
                "name": "סטטוס שרת SQL"
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

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

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

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

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "dashboard.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
       }

שנה בעלים של לוח המחוונים

זמין רק למנהלי מערכת וסופר אדמינים.

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "dashboard.update",
            "params": {
                "dashboardid": "2",
                "userid": "1"
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 2
       }

תְגוּבָה:

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

מידע נוסף

מקור

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