Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Update response codes for endpoint "export/excel"



73269302Construct definition
POST

com.easesolutions.jira.plugins.coverage/1.0/data

Evaluates coverage data for view
GETcom.easesolutions.jira.plugins.coverage/1.0/displayFieldsGet display fields available for coverage view

...

Panel
titleColor#FFFFFF
titleBGColor#6c809a
titlecom.easesolutions.jira.plugins.requirements/1.0/coverage/prjKey/createcoverageview

Trigger the creation of a coverage view

Expand
titleClick here for details...
REQUEST
Panel
bgColor#f6f5f5
POST

/rest/com.easesolutions.jira.plugins.requirements/1.0/coverage/prjKey/createcoverageview?name&isPublic&columns
PARAMETERS


parameter

type

description

prjKey*stringthe project the view to be created
namestringthe name of the view
isPublicbooleanthe visibility of the view
columnsstring

an array of objects compose of name, type ("filter", "jql", or "issue types"), filter, and link types

example:

[
{"name": "Column 1","type": "jql","filter": "issuetype in (bug, improvement)","linkTypes": []},
{"name": "Column 2","type": "filter","filter": "10000": ["relates to","trace to","duplicates"]},
{"name": "Column 2","type": "issue types","filter": ["task", "bug"],"linkTypes": []}
]
fieldsToDisplaystringan array of field names (Note: name is case sensitive)
folderIdlongthe tree folder id (Optional)



RESPONSES

Status
colourGreen
titleSTATUS 201
- Returned if a coverage view is created

Code Block
titleExample Response JSON
View name has been successfully created

Status
colourRed
titleSTATUS 400
- Returned if the project is invalid, name is invalid or already exist, columns is invalid or contains invalid values, or an error occurs while creating the coverage view

Status
colourRed
titleSTATUS 401
- Returned if invalid user credentials, or the user has no permission to use Requirements for JIRA plugin

Status
colourRed
titleSTATUS 403
- Returned if the license is invalid or has expired, incompatible JIRA version, the project is not configured for Requirements for JIRA, or no permission to create coverage view

Status
colourRed
titleSTATUS 404
- Returned if project is not found


...

Panel
titleColor#FFFFFF
titleBGColor#6c809a
titlecom.easesolutions.jira.plugins.coverage/1.0/filter/saveFilter

Trigger the creation of a coverage view

Expand
titleClick here for details...
REQUEST
Panel
bgColor#f6f5f5
POST

/rest/com.easesolutions.jira.plugins.coverage/1.0/filter/saveFilter


Code Block
titleExample Request JSON
{
  "projectId": 10000,
  "isPublic": true,
  "name": "Coverage View",
  "addedFieldsJsonArray": ["issuetype","issuekey","status","priority","summary"],
  "columnFilterJsonObject": {<this object is defined elsewhere>}
}

Definition:

projectId - the project the view to be created
isPublic - the visibility of the view
name - the name of the view
addedFieldsJsonArray - an array of field names
columnFilterJsonObject - an object containing column data relevant to the coverage view



RESPONSES

Status
colourGreen
titleSTATUS 201
- Returned if a coverage view is created

Code Block
titleExample Response JSON
{
	"id": 1,
	"name": "Coverage View"
}

Status
colourRed
titleSTATUS 400
- Returned if the project is invalid, name is invalid or already exist, columns is invalid or contains invalid values, or an error occurs while creating the coverage view

Status
colourRed
titleSTATUS 401
- Returned if invalid user credentials, or the user has no permission to use Requirements for JIRA plugin

Status
colourRed
titleSTATUS 403
- Returned if the license is invalid or has expired, incompatible JIRA version, the project is not configured for Requirements for JIRA, or no permission to create coverage view

Status
colourRed
titleSTATUS 404
- Returned if project is not found


...

Panel
titleColor#FFFFFF
titleBGColor#6c809a
titlecom.easesolutions.jira.plugins.coverage/1.0/data

Evaluates coverage data for view

Expand
titleClick here for details...
REQUEST
Panel
bgColor#f6f5f5
POST

com.easesolutions.jira.plugins.coverage/1.0/data


Code Block
titleExample Request JSON
{
  "columns": [{
      "label": "Level 1",
      "jiraJql": "",
      "jiraFilterId": "",
      "linkTypes": [{"id": "-1","directions": {"in": true,"out": true}}],
      "currentIssueTypes": ["-1"],
      "projects": ["10000,DEMO,DEMO"],
      "fromLevel": -1
   }],
  "fields": [],
  "folderIssueKeys": [],
  "filterId": 0,
  "folderId": 0,
  "folderName": "",
  "projectId": 10000,
  "fromColumn": 0,
  "isFiltered": false
}



RESPONSES

Status
colourGreen
titleSTATUS 201
- Returned if data successfully parsed

Code Block
titleExample Response JSON
{  
   "headerList":[  
      {  
         "label":"Level 1",
         "issueTypes":"<any>",
         "linkTypes":"<any>",
         "fromLevel":-1,
         "projects":"DEMO (DEMO)",
         "columnTotal":5
      }
   ],
   "columns":{  
      "0":[  
         {  
            "issues":[{...}],
            "pathid":""
         }
      ]
   },
   "fromColumn":0,
   "maxLimit":1000
}

Status
colourRed
titleSTATUS 400
- Returned if the project is invalid, name is invalid or already exist, columns is invalid or contains invalid values, or an error occurs while creating the coverage view

Status
colourRed
titleSTATUS 401
- Returned if invalid user credentials, or the user has no permission to use Requirements for JIRA plugin

Status
colourRed
titleSTATUS 403
- Returned if the license is invalid or has expired, incompatible JIRA version, the project is not configured for Requirements for JIRA, or no permission to create coverage view

Status
colourRed
titleSTATUS 404
- Returned if project is not found


...

Panel
titleColor#FFFFFF
titleBGColor#6c809a
titlecom.easesolutions.jira.plugins.coverage/1.0/displayFields

Get display fields for coverage view

Expand
titleClick here for details...
REQUEST
Panel
bgColor#f6f5f5
POST

com.easesolutions.jira.plugins.coverage/1.0/displayFields



RESPONSES

Status
colourGreen
titleSTATUS 201
- Returned if successful

Code Block
titleExample Response JSON
[
  {
    "id": "issuetype",
    "name": "Issue Type",
    "selected": true
  },
  ....
]

Status
colourRed
titleSTATUS 400
- Returned if the project is invalid, name is invalid or already exist, columns is invalid or contains invalid values, or an error occurs while creating the coverage view

Status
colourRed
titleSTATUS 401
- Returned if invalid user credentials, or the user has no permission to use Requirements for JIRA plugin

Status
colourRed
titleSTATUS 403
- Returned if the license is invalid or has expired, incompatible JIRA version, the project is not configured for Requirements for JIRA, or no permission to create coverage view

Status
colourRed
titleSTATUS 404
- Returned if project is not found


...

Panel
titleColor#FFFFFF
titleBGColor#6c809a
titlecom.easesolutions.jira.plugins.coverage/1.0/filter/renameFilter

Rename coverage filter

Expand
titleClick here for details...
REQUEST
Panel
bgColor#f6f5f5
POST

com.easesolutions.jira.plugins.coverage/1.0/filter/renameFilter


Code Block
titleExample Request JSON
{
  "projectId": 10000,
  "name": "Filter C",
  "isPublic": false,
  "filterId": "3"
}



RESPONSES

Status
colourGreen
titleSTATUS 201
- Returned if successful rename

Code Block
titleExample Response JSON
{
  "id": "3",
  "name": "Filter C"
}

Status
colourRed
titleSTATUS 400
- Returned if the project is invalid, name is invalid or already exist, columns is invalid or contains invalid values, or an error occurs while creating the coverage view

Status
colourRed
titleSTATUS 401
- Returned if invalid user credentials, or the user has no permission to use Requirements for JIRA plugin

Status
colourRed
titleSTATUS 403
- Returned if the license is invalid or has expired, incompatible JIRA version, the project is not configured for Requirements for JIRA, or no permission to create coverage view

Status
colourRed
titleSTATUS 404
- Returned if project is not found


...

Panel
titleColor#FFFFFF
titleBGColor#6c809a
titlecom.easesolutions.jira.plugins.coverage/1.0/filter/updateFilter

Update coverage filter columns

Expand
titleClick here for details...
REQUEST
Panel
bgColor#f6f5f5
POST

com.easesolutions.jira.plugins.coverage/1.0/filter/updateFilter


Code Block
titleExample Request JSON
{
  "projectId": 10000,
  "filterId": "4",
  "isPublic": true,
  "columnFilterJsonObject": "{<this object is defined elsewhere>}",
  "addedFieldsJsonArray": ["issuetype","issuekey","status","priority","summary"]
}

Definition:

projectId - the project the view to be created
filterId - id of filter to update
isPublic - the visibility of the view
addedFieldsJsonArray - an array of field names
columnFilterJsonObject - an object containing column data relevant to the coverage view



RESPONSES

Status
colourGreen
titleSTATUS 201
- Returned if successful update

Code Block
titleExample Response JSON
{
  "id": "4",
  "name": "C",
  "columnFilterJsonObject": "{....}",
  "addedFieldsJsonArray": "[....]"
}

Status
colourRed
titleSTATUS 400
- Returned if the project is invalid, name is invalid or already exist, columns is invalid or contains invalid values, or an error occurs while creating the coverage view

Status
colourRed
titleSTATUS 401
- Returned if invalid user credentials, or the user has no permission to use Requirements for JIRA plugin

Status
colourRed
titleSTATUS 403
- Returned if the license is invalid or has expired, incompatible JIRA version, the project is not configured for Requirements for JIRA, or no permission to create coverage view

Status
colourRed
titleSTATUS 404
- Returned if project is not found


...

Panel
titleColor#FFFFFF
titleBGColor#6c809a
titlecom.easesolutions.jira.plugins.coverage/1.0/filter/deleteFilter

Delete coverage filter

Expand
titleClick here for details...
REQUEST
Panel
bgColor#f6f5f5
POST

com.easesolutions.jira.plugins.coverage/1.0/filter/deleteFilter


PARAMETERS

parameter

type

description

projectIdLongproject id of filter to be deleted
filterIdLongfilterId of filter to be deleted



RESPONSES

Status
colourGreen
titleSTATUS 201
- Returned if coverage is successfully deleted

Status
colourRed
titleSTATUS 400
- Returned if the project is invalid, name is invalid or already exist, columns is invalid or contains invalid values, or an error occurs while creating the coverage view

Status
colourRed
titleSTATUS 401
- Returned if invalid user credentials, or the user has no permission to use Requirements for JIRA plugin

Status
colourRed
titleSTATUS 403
- Returned if the license is invalid or has expired, incompatible JIRA version, the project is not configured for Requirements for JIRA, or no permission to create coverage view

Status
colourRed
titleSTATUS 404
- Returned if project is not found


...

Panel
titleColor#FFFFFF
titleBGColor#6c809a
titlecom.easesolutions.jira.plugins.coverage/1.0/filter/getAllFilters

Get all public and personal coverage filters for user

Expand
titleClick here for details...
REQUEST
Panel
bgColor#f6f5f5
GET

com.easesolutions.jira.plugins.coverage/1.0/filter/getAllFilters



RESPONSES

Status
colourGreen
titleSTATUS 201
- Returned if successful

Code Block
titleExample Response JSON
{
   "publicFilters":[
      {
         "id":"1",
         "name":"Filter A",
		 "projectId": 10000
      },
      {
         "id":"2",
         "name":"Filter B",
		 "projectId": 10001
      }
   ],
   "personalFilters":[
      {
         "id":"3",
         "name":"Filter C",
		 "projectId": 10000
      }
   ]
}

Status
colourRed
titleSTATUS 400
- Returned if the project is invalid, name is invalid or already exist, columns is invalid or contains invalid values, or an error occurs while creating the coverage view

Status
colourRed
titleSTATUS 401
- Returned if invalid user credentials, or the user has no permission to use Requirements for JIRA plugin

Status
colourRed
titleSTATUS 403
- Returned if the license is invalid or has expired, incompatible JIRA version, the project is not configured for Requirements for JIRA, or no permission to create coverage view

Status
colourRed
titleSTATUS 404
- Returned if project is not found


...

Panel
titleColor#FFFFFF
titleBGColor#6c809a
titlecom.easesolutions.jira.plugins.coverage/1.0/filter/getFilter

Get specific coverage filter

Expand
titleClick here for details...
REQUEST
Panel
bgColor#f6f5f5
GET

com.easesolutions.jira.plugins.coverage/1.0/filter/getFilter


PARAMETERS

parameter

type

description

projectIdLongproject id of filter to get
filterIdLongfilterId of filter to get



RESPONSES

Status
colourGreen
titleSTATUS 201
- Returned if successful

Code Block
titleExample Response JSON
{
  "id": "1",
  "name": "Filter A",
  "columnFilterJsonObject": "{....}",
  "addedFieldsJsonArray": "[....]"
}

Status
colourRed
titleSTATUS 400
- Returned if the project is invalid, name is invalid or already exist, columns is invalid or contains invalid values, or an error occurs while creating the coverage view

Status
colourRed
titleSTATUS 401
- Returned if invalid user credentials, or the user has no permission to use Requirements for JIRA plugin

Status
colourRed
titleSTATUS 403
- Returned if the license is invalid or has expired, incompatible JIRA version, the project is not configured for Requirements for JIRA, or no permission to create coverage view

Status
colourRed
titleSTATUS 404
- Returned if project is not found


...

Panel
titleColor#FFFFFF
titleBGColor#6c809a
titlecom.easesolutions.jira.plugins.coverage/1.0/filter/getFilters

Get public and personal coverage filters for project

Expand
titleClick here for details...
REQUEST
Panel
bgColor#f6f5f5
GET

com.easesolutions.jira.plugins.coverage/1.0/filter/getFilters


PARAMETERS

parameter

type

description

projectIdLongproject id of filter to get



RESPONSES

Status
colourGreen
titleSTATUS 201
- Returned if successful

Code Block
titleExample Response JSON
{
  "publicFilters": [{"id": "1","name": "Filter A"}, {"id": "2","name": "Filter B"}],
  "personalFilters": [{"id": "3","name": "Filter C"}]
}

Status
colourRed
titleSTATUS 400
- Returned if the project is invalid, name is invalid or already exist, columns is invalid or contains invalid values, or an error occurs while creating the coverage view

Status
colourRed
titleSTATUS 401
- Returned if invalid user credentials, or the user has no permission to use Requirements for JIRA plugin

Status
colourRed
titleSTATUS 403
- Returned if the license is invalid or has expired, incompatible JIRA version, the project is not configured for Requirements for JIRA, or no permission to create coverage view

Status
colourRed
titleSTATUS 404
- Returned if project is not found


...

Panel
titleColor#FFFFFF
titleBGColor#6c809a
titlecom.easesolutions.jira.plugins.coverage/1.0/export/excel

Export the coverage view to an excel file

Expand
titleClick here for details...
REQUEST
Panel
bgColor#f6f5f5
POST

com.easesolutions.jira.plugins.coverage/1.0/export/excel


Code Block
titleExample Request JSON
{
  "columns": [{
      "label": "Level 1",
      "jiraJql": "",
      "jiraFilterId": "",
      "linkTypes": [{
          "id": "-1",
          "directions": {"in": true,"out": true}
      }],
      "currentIssueTypes": ["-1"],
      "projects": ["10000,DEMO,DEMO"],
      "fromLevel": -1,
      "issueSize": 0,
      "coverageCompleteness": 0
  }],
  "fields": [],
  "folderIssueKeys": [],
  "filterId": 0,
  "folderId": 0,
  "folderName": "",
  "projectId": 10000,
  "fromColumn": 0,
  "isFiltered": false
}



RESPONSES

Status
colourGreen
titleSTATUS
201
200
- Returned if excel file creation is successful

Code Block
titleExample Response JSON
EXCEL FILE

Status
colourRed
titleSTATUS 400
- Returned if the project is invalid, name is invalid or already exist, columns is invalid or contains invalid values, or an error occurs while creating the coverage view

Status
colourRed
titleSTATUS 401
- Returned if invalid user credentials, or the user has no permission to use Requirements for JIRA plugin

Status
colourRed
titleSTATUS 403
- Returned if the license is invalid or has expired, incompatible JIRA version, the project is not configured for Requirements for JIRA, or no permission to create coverage view

Status
colourRed
titleSTATUS 404500
- Returned if project is not found


...

Panel
titleColor#FFFFFF
titleBGColor#6c809a
titlecom.easesolutions.jira.plugins.coverage/1.0/export/xml

Export the coverage view to an xml file

Expand
titleClick here for details...
REQUEST
Panel
bgColor#f6f5f5
POST

com.easesolutions.jira.plugins.coverage/1.0/export/xml 


Code Block
titleExample Request JSON
{
  "columns": [{
      "label": "Level 1",
      "jiraJql": "",
      "jiraFilterId": "",
      "linkTypes": [{
          "id": "-1",
          "directions": {"in": true,"out": true}
      }],
      "currentIssueTypes": ["-1"],
      "projects": ["10000,DEMO,DEMO"],
      "fromLevel": -1
  }],
  "fields": [],
  "folderIssueKeys": [],
  "filterId": 0,
  "folderId": 0,
  "folderName": "",
  "projectId": 10000,
  "fromColumn": 0,
  "isFiltered": false
}



RESPONSES

Status
colourGreen
titleSTATUS 201
- Returned if xml file creation is successful

Code Block
titleExample Response JSON
XML FILE

Status
colourRed
titleSTATUS 400
- Returned if the project is invalid, name is invalid or already exist, columns is invalid or contains invalid values, or an error occurs while creating the coverage view

Status
colourRed
titleSTATUS 401
- Returned if invalid user credentials, or the user has no permission to use Requirements for JIRA plugin

Status
colourRed
titleSTATUS 403
- Returned if the license is invalid or has expired, incompatible JIRA version, the project is not configured for Requirements for JIRA, or no permission to create coverage view

Status
colourRed
titleSTATUS 404
- Returned if project is not found


...