Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 24 Current »

Create a new user role.

Use the following operation to create a user role in Zephyr Enterprise.

POST flex/services/rest/v3/role

Request format

To create a user role, send a POST request to the following URL:

http://{ZEPHYR-SERVER}/flex/services/rest/v3/role

Request body

{
  "name":"Administration Role",
  "description":null,
  "roleTemplateId":"1"
}

The roleTemplateId value specifies the level of permissions for certain applications in Zephyr. It can be either 1 (Administration Apps), or 2 (Project Apps).

Response body

#For Role Template 1

{
  "id" : 106,
  "name" : "Administration Role ",
  "hasManagerApp" : false,
  "deletable" : true,
  "editable" : true,
  "createdOn" : 1588062308198,
  "roleTemplate" :
  {"id" : 1,"templateName" : "Administration Apps","templateType" : 1,
  "templateApps" : "{
  "apps": [
           {"id":1,"name":"System Setup"},
           {"id":2,"name":"User Setup"},
           {"id":3,"name":"Project Setup"},
           {"id":6,"name":"Defect Admin"},
           {"id":32,"name":"Group Setup"}
          ]
}",
  "editable" : true,
  "deletable" : true
},
"isProjectAppRole" : false}
For Role Template 2

{
  "id" : 107,
  "name" : "Project APP",
  "hasManagerApp" : false,
  "deletable" : true,
  "editable" : true,
  "createdOn" : 1588062577117,
  "roleTemplate" : {
  "id" : 2,
  "templateName" : "Project Apps","templateType" : 2,"templateApps" : "
    {"apps": [
              {"id":8,"name":"Release Setup"},
              {"id":9,"name":"Requirements"},
              {"id":11,"name":"Test Planning"},
              {"id":13,"name":"Reporting"},
              {"id":15,"name":"Test Repository"},
              {"id":16,"name":"Test Execution"},
              {"id":17,"name":"Defect Tracking"},
              {"id":20,"name":"Execute All Executions"}
             ]
    }",
  "editable" : true,
  "deletable" : true},
  "isProjectAppRole" : true
}

Assign a permission to the role

Use the following operation to assign a permission to the user role.

PUT /flex/services/rest/v3/role/permission?roleid={role ID}

Request format

To assign a permission to a user role, send a PUT request to the following URL:

http://{ZEPHYR-SERVER}/flex/services/rest/v3/role/permission?roleid={role ID}

role ID is the ID of the role of the Zephyr Enterprise user.

Request body ( Administration Apps)

[
  {"applicationName":1,"deleteable":false},
  {"applicationName":2,"deleteable":false},
  {"applicationName":3,"deleteable":false},
  {"applicationName":6,"deleteable":false},
  {"applicationName":32,"deleteable":false}
]


Request body (Project Apps)

[
  {"applicationName":8,"deleteable":true},
  {"applicationName":9,"deleteable":true},
  {"applicationName":11,"deleteable":true},
  {"applicationName":13,"deleteable":false},
  {"applicationName":15,"deleteable":true,"readable":true,"editable":true},
  {"applicationName":16,"deleteable":true},
  {"applicationName":17,"deleteable":false},
  {"applicationName":20,"deleteable":false}
]

The applicationName value indicates the application that can be accessed by the user who has the specified role.

Possible values:

1 - System Setup
2 - User Setup
3 - Project Setup
6 - Defect Admin
8 - Release Setup
9 - Requirements
11 - Test Planning
13 - Reporting
15 - Test Repository
16 - Test Execution
17 - Defect Tracking
20 - Execute All Executions
32 - Group Setup

See Also

Migration REST API

  • No labels