Lesson 4 Controlling value stream data
Track value stream dots as they change status or state.
Before you begin
About this task
All particle state changes should be reflected in the value stream, and be easy to identify by simply viewing the value stream. In this lesson, we learn how to configure the value stream to display changes as the Jira particle changes status.
To modify the tutorial value stream, complete the following steps:
Procedure
- On the Value Streams page, select the tutorial value stream.
-
Click
.The helloWorld-vsm.json file is downloaded to your computer.Note: If you have the helloWorld-vsm.json used in the previous lesson, you can use that.
-
In your text editor, open the helloWorld-vsm.json file, and then add the
following DQL queries to the Development stages.
The
issue.status
queries reference the Jira project's workflow statuses. Thepr.status
refers to the status of GiutHub pull requests.{ "name": "Development", "description": null, "stages": [ { "name": "In Progress", "query": "(issue.status='In Progress' OR pr.status=open) AND issue.status!='In Review'", "description": null, "wipLimit": null, "gates": null }, { "name": "Review", "query": "issue.status!=Done AND pr.status=open", "description": null, "wipLimit": null, "gates": null }, { "name": "Merged", "query": "(pr.status='MERGED' OR pr.status=closed)", "description": null, "wipLimit": null, "gates": null },
-
In the helloWorld-vsm.json file, in the
linkRules
array, add the rules that link the tutorial's GitHub repository with the Jira project."linkRules": [ { "fromIntegrationName": "tutorial GitHub", "toIntegrationName": "tutorial Jira", "fromField": "pr.name", "toField": "issue.id", "pattern": "([A-Z]+-[0-9]+)" } ],
-
Save the file, and then on the helloWorld value stream page, select , and then select the JSON file.
-
Refresh the helloWorld page.
After the page refreshes, the particle representing the Jira issue moves from the Backlog stage to the Selected for Development stage, as shown in the following figure:
Figure 1. Particle changed stage If your Jira project has more than one issue with the status of
Selected for development
, all of them appear in the Selected for development stage.
Results
In this lesson, you learned how to manage particle status changes.
What to do next
You can use other DQL queries to
filter stages. If you apply labels to Jira issues, for example, you can use the
labels
DQL property. If you define the following query for a stage,
"query": "issue.labels='asset'"
, then only Jira issues with the
asset
label appear in the stage. You can attach DQL queries to phases and
stages in the value stream JSON file. Additionally, you can use the value stream Query bar
to define DQL queries that further refine data filters.