ProReport - Get report instance

API Url

Use it for loading a specific report instances that were saved in the repository.

GET
http://localhost:16010/ProMarkREST/rest/ProReport/repository/{id}

Permissions: user

Path parameters

FieldTypeDescription
idString

Unique identifier of the report instance.

Success 200

FieldTypeDescription
responseObject

Main object containing the response data.

  dataObject

Object containing the requested data.

    savedReportsObject[]

Object with all saved report instances.

      canEditBoolean

True = Logged in user can change the report.

      canRenderBoolean

Indicates whether the report can be rendered. This value is always false for Excel export and Predefined host transaction report types. For standard reports, it is false if the report exceeds the size limit.

      descString

Description of the report instance.

      expiryDate

Date when report will stop being available in the repository.

      fileIdString

Unique identifier of the report files. Needed when opening reports.

      idString

Unique identifier of the report instance.

      ownerString

Report creator's user id.

      parentIdString

Unique identifier of the report used when running this instance.

      privateBoolean

Report's security status.

      recurrentBoolean

true=Report is part of a recurrence series.

      reportTypeString

Report type (0=Classic report, 1=Excel report, 2=Host report).

      runTimeDatetime

Date and time when report was executed. If 'null', the report was not yet executed (delayed execution).

      sharedWithoptionalString

Available only for owner. A list of users ids of users that have access to the report.

  messageoptionalObject

Object containing response messages.

    codeNumber

Message code.

    textString

Message text.

    typeString

Type of message.

Allowed values:"warning""info"

Success example:

HTTP/1.1 200 OK
{
"response": {
"data": {
"savedReports": [
{
"id": "Rep10000",
"desc": "Absence rules on totals 120 days",
"runTime": null,
"expiry": "2016-11-30",
"fileId": "",
"recurrent": true,
"parentId": "Absence01",
"reportType": 0,
"owner": "MGR",
"canEdit": true,
"private": true
}
]
},
"errorCode": 0,
"errorMessage": ""
}
}

Error 4xx

FieldTypeDescription
responseObject

Main object containing the response data.

  dataObject

Object containing the requested data (empty).

  errorCodeNumber

Error code.

  errorMessageString

Error description.

Error example:

HTTP/1.1 404 Not found
{
"response": {
"errorCode": 285,
"errorMessage": "The report was not found. Maybe it was deleted by another user."
}
}