qrapids backlog Services

Connection to the Backlog Tool

qrapids-backlog RESTful services are used to connect the dashboard with a concrete Backlog Tool. The dashoard uses this connection to:

• export the generated QRs.
• know the list of milestones for a project: Milestone is referring to important dates for the project (internal releases, releases, quality check points,...).
• Know the list of phases for a project (under development): A phase is any kind of period of time (project phases, sprints, ...).

In order to configure the connection to these services, you need to configure the backlog.url in the application.properties file (detailed information in Strategic Dashboard Configuration File)

Export QR service

Example of the REST API endpoint

REQUEST

curl -XPOST <qr-issuetracker URL>/createIssue -H 'Content-Type: application/json' -d '
{
     "issue_summary": "QRAPIDS: This is a test issue",
     "issue_description": "Lorem ipsum",
     "issue_type": "Story",
     "project_id": "testproject",
     "decision_rationale": "Lorem ipsum"
}'

RESPONSE

{
     "issue_url": "https://<your jira url>/rest/api/latest/issue/201860",
     "issue_id": "RPA-425"
}

The project_id paremeter is comming from the Backlog Id attribute from the project, it can be customised in the Products configuration form. If the project does not have a backlog id, the product_id will be filled with the project id used by Q-Rapids Tool for identifying the assessed projects (the text used for the indexes suffix in the Elastic).

Import Milestones

Example of the REST API endpoint

REQUEST

curl -XPOST <qr-issuetracker URL>/milestones -H 'Content-Type: application/json' -d '
{
     "project_id": "PR_X12",
     "date_from": "PR_X12",
}'

date_from is optional:

• filled: the result is the list of milestones from this day
• not filled: the result is the list of all milestones associated to the project

RESPONSE

[{
     "milestone_date": "01/04/2019",
     "milestone_name": "Version 1.2.5",
     "milestone_description": "Release fixing some bugs"
     "milestone_type": "Internal release",
},{
     "milestone_date": "30/06/2019",
     "milestone_name": "Version 1.3"
     "milestone_description": "Version 1.3 adding new features"
     "milestone_type": "Release",
}]

Import Phases

Example of the REST API endpoint

REQUEST

curl -XPOST <qr-issuetracker URL>/phases -H 'Content-Type: application/json' -d '
{
     "project_id": "PR_X12",
}'

RESPONSE

[{
     "date_from": "01/04/2019",
     "date_to": "30/04/2019"
     "phase_name": "Project set-up",
     "phase_description": "Eliciting project goals & setting-up the infrastruture and teams",
},{
     "date_from": "01/05/2019",
     "date_to": "15/05/2019"
     "phase_name": "Design",
     "phase_description": "Defining project requirements and initial design",
},{
     "date_from": "16/05/2019",
     "date_to": "30/09/2019"
     "phase_name": "Development",
     "phase_description": "Development, Testing, and Releasing",
}]