[comment]: # translation:outdated

[comment]: # ({668456d1-668456d1})
# auditlog.get

[comment]: # ({/668456d1-668456d1})

[comment]: # ({1db866af-002826bb})
### תיאור

`integer/array auditlog.get(object parameters)`

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

::: noteclassic
שיטה זו זמינה רק לסוג משתמש *סופר אדמין*.
ניתן לבטל הרשאות להתקשר למתודה בהגדרות תפקידי המשתמש. לִרְאוֹת
[מִשׁתַמֵשׁ
תפקידים](/manual/web_interface/frontend_sections/administration/user_roles)
למידע נוסף.
:::

[comment]: # ({/1db866af-002826bb})

[comment]: # ({f693984f-c9891e0d})
### פרמטרים

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

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

|פרמטר|[סוג](/manual/api/reference_commentary#data_types)|תיאור|
|--|--|------|
|auditids|string/array|החזר רק יומן ביקורת עם המזהים הנתונים.|
|userids|string/array|החזר רק יומן ביקורת שנוצרו על ידי המשתמשים הנתונים.|
|time\_from|timestamp|מחזיר רק ערכי יומן ביקורת שנוצרו לאחר או בזמן הנתון.|
|time\_till|timestamp|מחזיר רק ערכי יומן ביקורת שנוצרו לפני או בזמן הנתון.|
|sortfield|string/array|מיין את התוצאה לפי המאפיינים הנתונים.<br><br>ערכים אפשריים הם: `auditid`, `userid`, `clock`.|
|filter|object|החזר רק תוצאות שתואמות במדויק את המסנן הנתון.<br><br>מקבל מערך, כאשר המפתחות הם שמות מאפיינים, והערכים הם ערך בודד או מערך של ערכים להתאמה.< br><br>תומך בנוסף בסינון לפי שדות מאפיין פרטים: `שם_טבלה`, `שם_שדה`.|
|search|object|חיפוש מחרוזת משנה לא תלוי רישיות בתוכן של שדות: `שם משתמש`, `ip`, `שם משאב`, `פרטים`.|
|countOutput|boolean|הפרמטרים האלה משותפים לכל שיטות ה-'get' מתוארים ב[פירוש ההתייחסות](/manual/api/reference_commentary#common_get_method_parameters).|
|excludeSearch|בולאני|^|
|limit|מספר שלם|^|
|פלט|שאילתה|^|
|preservekeys|בולאני|^|
|searchByAny|boolean|^|
|searchWildcardsEnabled|boolean|^|
|sortorder|מחרוזת/מערך|^|
|startSearch|boolean|^|

[comment]: # ({/f693984f-c9891e0d})

[comment]: # ({7223bab1-7223bab1})
### החזר ערכים

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

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

[comment]: # ({/7223bab1-7223bab1})

[comment]: # ({b41637d2-b41637d2})
### דוגמאות

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({8b612824-66670b26})
#### אחזר יומן ביקורת

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

בַּקָשָׁה:

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

תְגוּבָה:

``` json
{
     "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\",\"support123@company.com\"]}"
            
         },
         {
             "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
}
```

[comment]: # ({/8b612824-66670b26})

[comment]: # ({e2b9a859-e2b9a859})
### מידע נוסף

-   [עצם יומן פיקוח](/manual/api/reference/auditlog/object)

[comment]: # ({/e2b9a859-e2b9a859})

[comment]: # ({11b31975-11b31975})
### מקור

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

[comment]: # ({/11b31975-11b31975})