ProReport - Get report specification
API Url
Use it to get report specification.
http://localhost:16010/ProMarkREST/web/ProReport/reports/{id}/specification
Permissions: user
Request headers
| Field | Type | Description |
|---|---|---|
Accept-Languageoptional | String | =en-GB Language use for localization. |
X-Clientoptional | String | =Client type. "Portal""Mobile""Admin" |
X-Roleoptional | Number | ProMark role (1: Employee, 2: User). {12} |
X-WebPart-Idoptional | Number | Unique web-part identifier. |
Path parameters
| Field | Type | Description |
|---|---|---|
| id | String | Report id. |
Success 200
| Field | Type | Description |
|---|---|---|
| response | Object | Main object containing the response data. |
| data | Object[] | |
| reports | Object[] | |
attributesoptional | Object[] | Report dynamic attributes. |
| description | string | Attribute description |
| id | string | Attribute Id |
| options | Object[] | attribute option |
| description | string | option description |
| value | string | option value |
| readOnly | Boolean | TRUE if the attribute is read only |
| type | Number | attribute type |
| value | string | Attribute Value |
| definition | Object | Report definition object. |
descriptionoptional | string | Report specification description. |
| name | string | Report specification name. name. |
pageNameoptional | string | Report page name. |
pageTextoptional | string | Report page text. |
reportNameoptional | string | Report name. |
reportTextoptional | string | Report text. |
transactionIdoptional | string | Report transaction Id. |
| type | Number | Report type. {123} |
| groups | Object[] | Report groups. |
| calculation | string | Group calculation. |
| description | string | Group description. |
| display | boolean | true - group is visible, false - group is not cisible. |
| id | Number | Group number. |
| textId | string | System text id. |
| texttype | string | System text type. |
| id | string | The id of the report. |
| layout | Object | Report layout. |
col1optional | string | Col1 label |
col2optional | string | Col2 label |
| columns | Object[] | |
| format | string | Column format (Default - 0, H:MM - 1, h:MM:SS - 2, M:SS - 3, H:CC - 4, H:CC:SS - 5, C:SS - 6, Percent - 100, Percent 1Dec - 101, Percent 2Dec - 102 0Dec - 200, 1Dec - 201, 2Dec - 202, 3Dec - 203, 4Dec - 204, DateTime - 301, Date - 302) |
| formula | string | Column formula |
| id | Number | Column id |
| text | string | Column header |
| displayDetails | Boolean | TRUE=Show detail lines |
| footerCalculation | string | footer calculation |
| onlyShowCalc | String | Comma separated list of columns that will display data only for the group calculation |
| onlyShowDetails | String | Comma separated list of columns that will display data only for the details section |
| showLogo | Boolean | TRUE=Show logo on page header |
| showPageNumber | Boolean | TRUE=Show page number on footer |
| showPhDate | Boolean | TRUE=Show report execution date |
| showSignatureSection | Boolean | TRUE=Show section for signature on report footer |
| maxGroups | Number | Maximum number of editable group slots (0-5). |
| parentId | String | The parent id of the report. |
messageoptional | Object | Object containing response messages. |
| code | Number | Message code. |
| text | String | Message text. |
| type | String | Type of message. "warning""info" |
Success example:
HTTP/1.1 200 OK{"response": {"data": {"reports": {"id": "Absence01","parentId": "","definition": {"name": "Absence rules on totals 120 days","description": "Shows absence where the total days in the period is 120 or more","pageName": "Absence rules on totals 120 days","pageText": "Shows absence where the total days in the period is 120 or more","reportName": "","reportText": "","transactionId": "","type": 0},"groups": [{"id": 1,"description": "Current department ID,Current department description","textId": "ttAbsIntv.DeptId,ttAbsIntv.DeptDescription","textType": "DB","calculation": "SUM","display": true},{"id": 2,"description": "Employee number","textId": "EMPLOYEE NUMBER","textType": "SortEmp","calculation": "SUM","display": true}],"maxGroups": 5,"layout": {"columns": [{"id": 1,"text": "No. of days","format": "202","formula": "$"}],"onlyShowCalc": "","onlyShowDetails": "","displayDetails": true,"showCertifLine": false,"showLogo": true,"showPageNumber": true,"showPhDate": true,"col1": "Period start","col2": "Period end","footerCalculation": "SUM"},"attributes": [{"id": "DayLimitMethod","description": "Specify day count limit check","value": ">","readOnly": true,"type": 4,"options": [{"value": 1,"description": "<"},{"value": 2,"description": "="},{"value": 3,"description": ">"}]},{"id": "DayLimit","description": "Day count limit","value": "119","readOnly": true,"type": 2},{"id": "OnlyOpenEndedPer","description": "Only open ended period","value": "false","readOnly": true,"type": 1},{"id": "InclOffDays","description": "Include off-days","value": "true","readOnly": true,"type": 1},{"id": "SepAbsIntv","description": "Check individual intervals","value": "FALSE","readOnly": true,"type": 1},{"id": "ExtAbsIntvBefore","description": "Extend interval back in time","value": "FALSE","readOnly": true,"type": 1},{"id": "ExtAbsIntvAfter","description": "Extend interval forward in time","value": "FALSE","readOnly": true,"type": 1}]}}}}
Error 4xx
| Field | Type | Description |
|---|---|---|
| response | Object | Main object containing the response data. |
| data | Object | Object containing the requested data (empty). |
| errorCode | Number | Error code. |
| errorMessage | String | Error description. |