Enterprise Vault™ Compliance Accelerator Reviewer's Guide

Last Published:
Product(s): Enterprise Vault (15.1)

ItemMetrics - List by filter

POST https://<Reporting endpoint Base URL>/odata/ItemMetrics

Request body

The following filters can be used with the ItemMetrics API when invoked using the POST method. The system uses the AND operator between the filters to return the result based on the specified filters.

Name

Type

Description

Departments

Optional

Specifies the department to which the captured item belongs and returns item counts for items within that department.

Data Type: JSON array of integers 'id'(identifier fields) that is department IDs.

Limitation: As an input, the ItemMetrics API can pass maximum of 1000 Departments IDs.

CaptureType

Optional

Specifies the mode/technique used to capture the item in Compliance Accelerator and returns item counts for items with the specified capture type.

Data Type: JSON array of integers 'id'(identifier fields) that is CaptureType IDs.

Limitation: As an input, the ItemMetrics API can pass maximum 10 CaptureType IDs.

CaptureDateStart

Mandatory

Specifies the date on which items are captured or ingested in Compliance Accelerator is recorded as the CaptureDate for that item.

Returns item counts whose CaptureDate is greater than or equal to the specified CaptureDateStart.

Date format: yyyy-mm-dd

Data Type: JSON array of integers 'id'(identifier fields) that is CaptureDateStart.

CaptureDateEnd

Mandatory

Specifies the date on which items are captured or ingested in Compliance Accelerator is recorded as the CaptureDate for that item.

Returns item counts whose CaptureDate is less than or equal to the specified CaptureDateEnd.

Date format: yyyy-mm-dd

Data Type: JSON array of integers 'id'(identifier fields) that is CaptureDateEnd.

MessageDirections

Optional

Specifies whether the item was sent/received from within the organization or from an external source and returns item counts for items that have the specified message direction.

Data Type: JSON array of integers 'id'(identifier fields) that is MessageDirections IDs

Limitation: As an input, the ItemMetrics API can pass maximum 5 MessageDirections IDs.

MessageType

Optional

Specifies the type of captured items and returns item counts for items that have the specified message type.

Data Type: JSON array of integers 'id'(identifier fields) that is MessageType IDs.

Limitation: As an input, the ItemMetrics API can pass maximum 100 MessageType IDs on a single page.

Scenario 1:

To get the item counts for Departments IDs 7622, between CaptureDates 2023-11-24 and 2023-12-24 and having CaptureType as 1 or 3.

Sample Requests

POST https://<Reporting endpoint Base URL>/odata/ItemMetrics

{

{"CaptureDateStart": "2023-11-24",

"CaptureDateEnd": "2023-12-24",

"Departments": [7622],

"CaptureType": [1,3]

}

Sample response

Status code: 200 OK

Scenario 2

To get item counts for Department IDs 9 and 5, between CaptureDates 2023-06-01 and 2023-08-02 and having MessageType IDs as 7 or 8.

Sample request

POST https://<Reporting endpoint Base URL>/odata/ItemMetrics

{

"CaptureDateStart": "2023-06-01",

"CaptureDateEnd": "2023-08-02",

"Departments": [9,5],

"MessageType": [7,8]

}

Scenario 3:

To get item counts for Departments IDs 9 and 5 , between CaptureDates 2023-06-01 and 2023-08-02 and having MessageDirections as 1 or 2.

POST https://<Reporting endpoint Base URL>/odata/ItemMetrics

{

"CaptureDateStart": "2023-06-01",

"CaptureDateEnd": "2023-08-02",

"Departments": [9,5],

"MessageDirections": [1,2]

}

Scenario 4:

To get item counts for Departments IDs 9 and 5 , between CaptureDates 2023-06-01 and 2023-08-02 and having MessageType IDs as 7 or 8.

POST https://<Reporting endpoint Base URL>/odata/ItemMetrics

{

"CaptureDateStart": "2023-06-01",

"CaptureDateEnd": "2023-06-02",

"Departments": [9,5],

"MessageType": [7,8]

}

Supported OData Filters

See Supported OData query options.

Supported reporting endpoint API filters and their values

See Supported reporting endpoint API filters and their values.

Responses

See Responses.