auditlog.get

תיאור

integer/array auditlog.get(object parameters)

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

שיטה זו זמינה רק לסוג משתמש סופר אדמין. ניתן לבטל הרשאות להתקשר למתודה בהגדרות תפקידי המשתמש. לִרְאוֹת מִשׁתַמֵשׁ תפקידים למידע נוסף.

פרמטרים

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

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

פרמטר	סוג	תיאור
auditids	string/array	החזר רק יומן ביקורת עם המזהים הנתונים.
userids	string/array	החזר רק יומן ביקורת שנוצרו על ידי המשתמשים הנתונים.
time_from	timestamp	מחזיר רק ערכי יומן ביקורת שנוצרו לאחר או בזמן הנתון.
time_till	timestamp	מחזיר רק ערכי יומן ביקורת שנוצרו לפני או בזמן הנתון.
sortfield	string/array	מיין את התוצאה לפי המאפיינים הנתונים. ערכים אפשריים הם: `auditid`, `userid`, `clock`.
filter	object	החזר רק תוצאות שתואמות במדויק את המסנן הנתון. מקבל מערך, כאשר המפתחות הם שמות מאפיינים, והערכים הם ערך בודד או מערך של ערכים להתאמה.< br> תומך בנוסף בסינון לפי שדות מאפיין פרטים: `שם_טבלה`, `שם_שדה`.
search	object	חיפוש מחרוזת משנה לא תלוי רישיות בתוכן של שדות: `שם משתמש`, `ip`, `שם משאב`, `פרטים`.
countOutput	boolean	הפרמטרים האלה משותפים לכל שיטות ה-'get' מתוארים בפירוש ההתייחסות.
excludeSearch	בולאני
limit	מספר שלם
פלט	שאילתה
preservekeys	בולאני
searchByAny	boolean
searchWildcardsEnabled	boolean
sortorder	מחרוזת/מערך
startSearch	boolean

החזר ערכים

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

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

דוגמאות

אחזר יומן ביקורת

אחזר שתי רשומות יומן ביקורת אחרונות.

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "auditlog.get",
            "params": {
                "output": "להרחיב",
                "sortfield": "שעון",
                "sortorder": "DESC",
                "מגבלה": 2
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

{
            "jsonrpc": "2.0",
            "תוצאה": [
                {
                    "auditid": "cksstgfam0001yhdcc41y20q2",
                    "userid": "1",
                    "username": "מנהל",
                    "שעון": "1629975715",
                    "ip": "127.0.0.1",
                    "action": "1",
                    "resourcetype": "0",
                    "resourceid": "0",
                    "resourcename": "ג'ים",
                    "recordsetid": "cksstgfal0000yhdcso67ondl",
                    "details": "{\"user.name\":[\"עדכון\",\"ג'ים\",\"\"],\"user.medias[37]\":[\"add\" ],\"user.medias[37].\":[\"add\"],\"user.medias[37].mediatypeid\":[\"add\",\"1\"],\ "user.medias[37].sendto\":[\"add\",\"[email protected]\"]}"
                   
                },
                {
                    "auditid": "ckssofl0p0001yhdcqxclsg8r",
                    "userid": "1",
                    "username": "מנהל",
                    "שעון": "1629967278",
                    "ip": "127.0.0.1",
                    "action": "0",
                    "resourcetype": "0",
                    "resourceid": "20",
                    "resourcename": "ג'ון",
                    "recordsetid": "ckssofl0p0000yhdcpxyo1jgo",
                    "details": "{\"user.username\":[\"add\",\"John\"], \"user.userid:\":[\"add\",\"20\"] ,\"user.usrgrps[28]\":[\"add\"],\"user.usrgrps[28].usrgrpid\":[\"add\", \"7\"]}"
                }
            ],
            "מזהה": 1
       }

מידע נוסף

עצם יומן פיקוח

מקור

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

Documentation