Arctera™ Insight Surveillance Web Client User Guide
- Introducing Arctera Insight Surveillance
- Getting started
- Working with dashboard widgets
- Managing employees and employee groups
- Managing departments
- Managing reviewer assignment
- Managing research folders
- Managing department users
- Managing department-level archives
- Managing department-level searches
- Managing department-specific hotword sets
- Managing department-specific labels
- Managing department-specific review comments
- Viewing employees associated with departments
- Managing users, roles, and permissions
- Managing application-level archives
- Managing application-level searches
- Managing application-specific hotword sets
- Managing application-specific labels
- Managing application-specific review comments
- Managing search schedules
- Managing export operations
- Managing reviews
- Working with reports
- Enhanced reporting
- Departments API
- Users API
- Roles API
- User Roles API
- Classification Tags API
- Labels API
- Searches API
- ItemMetrics API
- Reviewer Mapping API
- MonitoredEmployees API
- Evidence of Review API
- Item Classification Metrics API
- Item Label Metrics API
- Item Hotword Metrics API
- Item Details API
- Managing Power BI templates for reporting APIs
- Managing application wide audit settings
- Working with audit viewer
- Managing application wide review setting
User Roles Async API
UserRolesAsync | This API submits the report generation request which executes asynchronously. The result of this API contains the identifier for the report, status, and location for retrieving the report data. The report identifier and locations in the result can be used to track the report generation operation. |
To use the UserRolesAsync API, follow the steps below:
Call the UserRolesAsync API to submit a report generation request.
This asynchronous API supports GET and POST query methods. Use any of the following as needed:
GET https://<Reporting endpoint base URL>/OData/UserRolesAsync?ReportName=<Name of the report>&Users=[list of comma-separated values]&Departments=[list of comma-separated values]&Scopes=[list of comma-separated values]
POST https://<Reporting endpoint base URL>/OData/UserRolesAsync
GET https://<Reporting endpoint Base URL>/odata/ UserRolesAsync?ReportName=<Name of the report>Users=[1247,3821]
POST https://<Reporting endpoint base URL>/OData/UserRolesAsync
The following parameters/filters can be used with the UserRolesAsync API when invoked using the GET and POST methods. The system uses the AND operator between the filters to return the result based on the specified filters.
ReportName
Mandatory
Specify the name of the report you want to generate.
The report name can be up to a maximum of 256 characters long.
Special characters are not allowed; only alphanumeric values are permitted.
Departments
Optional
Specifies IDs of the departments to which users and their roles belongs to.
:
This API can pass a maximum of 100 Departments IDs as input.
: JSON array of integers 'id'(identifier fields) that is Departments.
Note:
To get the Department IDs, See Departments API. Refer to the field only.
Scopes
Optional
Specifies the scope of the users roles. Possible values are: 160 for application-level roles and 161 for department-level roles.
: JSON array of integers 'id'(identifier fields) that is Scopes.
Users
Optional
Specifies IDs of the users.
This API can pass a maximum of 100 User IDs as input.
: JSON array of integers 'id'(identifier fields) that is Users.
Note:
To get the User IDs, See Users API. Refer to the field only.
POST https://<Reporting endpoint base URL>/OData/UserRolesAsync { "ReportName":"TestUserRolesReport", "Departments":[], "Scopes":"[], "Users":[3821] }
POST https://<Reporting endpoint base URL>/OData/UserRolesAsync { "ReportName":"TestUserRolesReport", "Departments":[23], "Scopes":"[], "Users":[] }
POST https://<Reporting endpoint base URL>/OData/UserRolesAsync { "ReportName":"TestUserRolesReport", "Departments":[23], "Scopes":"[160,161], "Users":[55,67] }
POST https://<Reporting endpoint base URL>/OData/UserRolesAsync { "ReportName":"", "Departments":[23], "Scopes":"[160], "Users":[3821] }
The following table explains the parameters showcased in the response to a User Roles Async API request.
Name
Description
reportId
Displays report ID. It is generated upon successful execution of API.
reportName
Displays report name. It is generated upon successful execution of API.
reportType
Displays the report type as User Roles.
reportDate
Displays the date of report generation after successful execution of API.
reportStatus
Displays report status. For more information on statuses, See Report Status API..
info
Displays a message if the report request has queued successfully or not.
newReportInstanceQueued
Specifies whether a new report generation request has been submitted or not. The Rate Limiting feature restricts submission of multiple requests with identical input parameters if attempted within one minute.
It returns the following values:
: The value is shown as False, if the input parameters of the current request are identical to the parameters of the already submitted request within one minute, a new report will not be queued. As a result, the details of the existing report request are returned.
reportStatusLocation
Displays a URL with report ID.
To view the status of this report, use the same URL.
reportDataLocation
Displays a URL for the location of report data.
To access the report data, use the same URL.
Call the ReportStatus API to get the status of the UserRolesAsync API report. See Report Status API.
Once the report is ready, call the UserRoles API to get the report data from the asynchronous API. See User Roles API.