System - Get tabs

API Url

Used for loading portal/mobile (depending on X-Client) tabs containing web-parts.

GET
http://localhost:16010/ProMarkREST/rest/System/tabs

Permissions: user

Query parameters

FieldTypeDescription
extendoptionalString

webparts = Include child web-parts collection in response.

visibleoptionalBoolean

true = Get only visible tabs.

Success 200

FieldTypeDescription
responseObject

Main object containing the response data.

  dataObject

Object containing the requested data.

    tabsObject[]

Collection of tabs.

      idNumber

Tab identifier.

      nameString

Name of the tab.

      visibleBoolean

true = Tab is visible on the user.

      webpartsoptionalObject[]

Collection of web-parts.

        idInt64

Web-part unique identifier.

        nameString

Name of the web-part.

        orderNumber

Order sequence inside the zone (used for layout).

        propertiesoptionalObject[]

Collection of web-part properties.

          idString

Property unique identifier.

          lockedBoolean

true = Web-part property is read-only.

          nameString

Name of property.

          typeNumber

Type of property.

          valueString

Value of property.

          visibleBoolean

true = Web-part property is visible to the user.

        tabIdNumber

Tab identifier.

        typeNumber

Web-part type.

        zoneNumber

Zone identifier (used for layout).

  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": {
"tabs": [
{
"id": 1,
"name": "Personal",
"iconId": "delete",
"visible": true
}
]
},
"errorCode": 0,
"errorMessage": ""
}
}

Success example when extend=webparts:

HTTP/1.1 200 OK
{
"response": {
"data": {
"tabs": [
{
"id": 1,
"name": "Personal",
"visible": true,
"webparts": [
{
"id": 409,
"type": 1,
"name": "Registration",
"tabId": 1,
"zone": 1,
"order": 1
},
{
"id": 410,
"type": 2,
"name": "Attendance overview",
"tabId": 1,
"zone": 2,
"order": 1,
"properties": [
{
"id": "ActDeptDes",
"name": "Show actual department description",
"value": "FALSE",
"type": 2,
"visible": true,
"locked": false
},
{
"id": "ActDeptId",
"name": "Show act department ID",
"value": "FALSE",
"type": 2,
"visible": true,
"locked": false
}
]
}
]
}
]
},
"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.