Lesson 4 Controlling value stream data#
Track value stream particles as they change status or state.
Before you begin
Before you begin this lesson, make sure that you complete the previous lesson.
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 Configure value stream map > Download value stream map.
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 Configure value stream map > Replace value stream map, 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:
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
In later tutorials, you will learn how to integrate other popular tools into your value streams, such as Git, Rally, and HCL™ Launch.
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.
Parent topic: Linking value stream tools