Get Process View Columns

Get the information of process view columns.

Request Format

GET https://{apigw-address}/enos-bpm-service/v2.0/work/display-view/{displayViewKey}/columns

Request Parameters (Header)

Name Location Mandatory/Optional Data Type Description
Authorization Header Mandatory String The access token, which is represented by the bearer token. It can be obtained by invoking the Log In or Refresh Access Token API.

Request Parameters (URI)

Name Location (Path/Query) Mandatory/Optional Data Type Description
displayViewKey Path Mandatory String The process view key.

Response Parameters

Name Data Type Description
data Data Struct The information of process view columns.

Data Struct

Name Data Type Description
id String The process view column ID.
title String The process view column name.
displayViewKey String The process view key.
bindProperty String The name of the process property displayed in the process view column.
defaultVisibility Boolean The default visibility of process view column.
fixedVisibility Boolean Whether the process view column is set to be constantly visible.
filterable Boolean Whether filter is enabled for the process view column.
fixedFilterable Boolean Whether filterable can be modified for the process view column.
type String The process view column type.
source String Whether the source of the process view column is system or custom.
order Integer The order of the process view column.
warning Boolean Whether variable corresponding to the process view column has been deleted in the latest version of the process definition.
options Option Struct The options of a drop-down type process view column.

Option Struct

Name Data Type Description
name String The name of an option in the process view column.
value String The value of an option in the process view column.

Error Codes

Code Description
33404 The process view key does not exist.

Samples

Request Sample

url: https://{apigw-address}/enos-bpm-service/v2.0/work/display-view/{your_display_view_key}/columns

method: GET

headers: {"Authorization":"Bearer {your_access_token}"}

Return Sample

{
  "code": 0,
  "msg": "",
  "data": [
    {
      "id": "a6574b142f8a511eab997105badde4ea7",
      "title": "Process Name",
      "displayViewKey": "C10S_TEST11",
      "bindProperty": "name",
      "defaultVisibility": true,
      "fixedVisibility": false,
      "filterable": true,
      "fixedFilterable": true,
      "type": "Single-Select List",
      "source": "System",
      "order": 0
    },
    {
      "id": "a6574b143f8a511eab997105badde4ea7",
      "title": "Started by",
      "displayViewKey": "C10S_TEST11",
      "bindProperty": "startedBy",
      "defaultVisibility": true,
      "fixedVisibility": false,
      "filterable": true,
      "fixedFilterable": false,
      "type": "Single-Select List",
      "source": "System",
      "order": 1,
      "options": [
        {
          "name": "user01",
          "value": "u15578231118721"
        },
        {
          "name": "user02",
          "value": "u15644810865581"
        },
        {
          "name": "user03",
          "value": "u15719991268501"
        }
      ]
    },
    {
      "id": "a6574b144f8a511eab997105badde4ea7",
      "title": "Time Started",
      "displayViewKey": "C10S_TEST11",
      "bindProperty": "started",
      "defaultVisibility": true,
      "fixedVisibility": false,
      "filterable": true,
      "fixedFilterable": false,
      "type": "Time",
      "source": "System",
      "order": 2
    },
    {
      "id": "a6574b145f8a511eab997105badde4ea7",
      "title": "Status",
      "displayViewKey": "C10S_TEST11",
      "bindProperty": "processStatus",
      "defaultVisibility": true,
      "fixedVisibility": false,
      "filterable": true,
      "fixedFilterable": false,
      "type": "Single-Select List",
      "source": "System",
      "order": 3,
      "options": [
        {
          "name": "inProgress",
          "value": "inProgress"
        },
        {
          "name": "terminated",
          "value": "terminated"
        },
        {
          "name": "completed",
          "value": "completed"
        }
      ]
    },
    {
      "id": "a6574b146f8a511eab997105badde4ea7",
      "title": "Current Task",
      "displayViewKey": "C10S_TEST11",
      "bindProperty": "taskName",
      "defaultVisibility": true,
      "fixedVisibility": false,
      "filterable": false,
      "fixedFilterable": true,
      "type": "Single-Select List",
      "source": "System",
      "order": 4
    },
    {
      "id": "a6574b147f8a511eab997105badde4ea7",
      "title": "Current Assignee",
      "displayViewKey": "C10S_TEST11",
      "bindProperty": "assignee",
      "defaultVisibility": true,
      "fixedVisibility": false,
      "filterable": false,
      "fixedFilterable": true,
      "type": "Single-Select List",
      "source": "System",
      "order": 5
    },
    {
      "id": "a6574b148f8a511eab997105badde4ea7",
      "title": "Time Completed",
      "displayViewKey": "C10S_TEST11",
      "bindProperty": "completedTime",
      "defaultVisibility": true,
      "fixedVisibility": false,
      "filterable": true,
      "fixedFilterable": false,
      "type": "Time",
      "source": "System",
      "order": 6
    },
    {
      "id": "a6574b149f8a511eab997105badde4ea7",
      "title": "Time Terminated",
      "displayViewKey": "C10S_TEST11",
      "bindProperty": "terminatedTime",
      "defaultVisibility": true,
      "fixedVisibility": false,
      "filterable": true,
      "fixedFilterable": false,
      "type": "Time",
      "source": "System",
      "order": 7
    },
    {
      "id": "a6574b14af8a511eab997105badde4ea7",
      "title": "Terminator",
      "displayViewKey": "C10S_TEST11",
      "bindProperty": "terminatedBy",
      "defaultVisibility": true,
      "fixedVisibility": false,
      "filterable": true,
      "fixedFilterable": false,
      "type": "Single-Select List",
      "source": "System",
      "order": 8,
      "options": [
        {
          "name": "user01",
          "value": "u15578231118721"
        },
        {
          "name": "user02",
          "value": "u15644810865581"
        },
        {
          "name": "user03",
          "value": "u15719991268501"
        }
      ]
    },
    {
      "id": "a6574b14bf8a511eab997105badde4ea7",
      "title": "Process Instance ID",
      "displayViewKey": "C10S_TEST11",
      "bindProperty": "processInstanceId",
      "defaultVisibility": true,
      "fixedVisibility": true,
      "filterable": true,
      "fixedFilterable": false,
      "type": "Text",
      "source": "System",
      "order": 9
    }
  ]
}

Java SDK Sample

public class BpmSdkTest{
    @Test
    public void getProcessViewColumnsTest() {
        String bearerToken = "your_bearer_token";
        String displayViewKey = "your_display_view_key";
        DisplayViewColumnsRequest request = new DisplayViewColumnsRequest(displayViewKey, bearerToken);
        DisplayViewColumnsResponse response = getPoseidon().getResponse(request, DisplayViewColumnsResponse.class);
        assertNotNull("response cannot be null", response);
    }
}