ProReport - Get report specification

API Url

Use it to get report specification.

GET
http://localhost:16010/ProMarkREST/web/ProReport/reports/{id}/specification

Permissions: user

Request headers

FieldTypeDescription
Accept-LanguageoptionalString

=en-GB Language use for localization.

X-ClientoptionalString

=Client type.

Allowed values:"Portal""Mobile""Admin"
X-RoleoptionalNumber

ProMark role (1: Employee, 2: User).

Allowed values:{12}
X-WebPart-IdoptionalNumber

Unique web-part identifier.

Path parameters

FieldTypeDescription
idString

Report id.

Success 200

FieldTypeDescription
responseObject

Main object containing the response data.

  dataObject[]
    reportsObject[]
      attributesoptionalObject[]

Report dynamic attributes.

        descriptionstring

Attribute description

        idstring

Attribute Id

        optionsObject[]

attribute option

          descriptionstring

option description

          valuestring

option value

        readOnlyBoolean

TRUE if the attribute is read only

        typeNumber

attribute type

        valuestring

Attribute Value

      definitionObject

Report definition object.

        descriptionoptionalstring

Report specification description.

        namestring

Report specification name. name.

        pageNameoptionalstring

Report page name.

        pageTextoptionalstring

Report page text.

        reportNameoptionalstring

Report name.

        reportTextoptionalstring

Report text.

        transactionIdoptionalstring

Report transaction Id.

        typeNumber

Report type.

Allowed values:{123}
      groupsObject[]

Report groups.

        calculationstring

Group calculation.

        descriptionstring

Group description.

        displayboolean

true - group is visible, false - group is not cisible.

        idNumber

Group number.

        textIdstring

System text id.

        texttypestring

System text type.

      idstring

The id of the report.

      layoutObject

Report layout.

        col1optionalstring

Col1 label

        col2optionalstring

Col2 label

        columnsObject[]
          formatstring

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)

          formulastring

Column formula

          idNumber

Column id

          textstring

Column header

        displayDetailsBoolean

TRUE=Show detail lines

        footerCalculationstring

footer calculation

        onlyShowCalcString

Comma separated list of columns that will display data only for the group calculation

        onlyShowDetailsString

Comma separated list of columns that will display data only for the details section

        showLogoBoolean

TRUE=Show logo on page header

        showPageNumberBoolean

TRUE=Show page number on footer

        showPhDateBoolean

TRUE=Show report execution date

        showSignatureSectionBoolean

TRUE=Show section for signature on report footer

      maxGroupsNumber

Maximum number of editable group slots (0-5).

      parentIdString

The parent id of 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": {
"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

FieldTypeDescription
responseObject

Main object containing the response data.

  dataObject

Object containing the requested data (empty).

  errorCodeNumber

Error code.

  errorMessageString

Error description.