Lesson 4 Controlling value stream data

Track value stream dots 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 dot 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 dot changes status.

To modify the tutorial value stream, complete the following steps:


  1. In your tutorial Jira project, change the workflow status of one of your issues from Backlog to Selected for Development.
  2. On the Value Streams page, select the tutorial value stream.
  3. 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.
  4. In your text editor, open the helloWorld-vsm.json file, and then add a DQL query to the Selected for Development stage in the JSON file.
    The following DQL query limits the Selected for Development stage to Jira issues with the workflow status of Selected for Development:
         "phases": [
              "name": "PLAN",
              "description": "",
              "stages": [
                  "name": "Backlog",
                  "query": "issue.status=\"Backlog\"",
                  "description": "",
                  "wipLimit": null,
                  "gates": null
                  "name": "Selected for Development",
                  "query": "issue.status=\"Selected for Development\"",
                  "description": "",
                  "wipLimit": null,
                  "gates": null
  5. Save the helloWorld-vsm.json file.
  6. On the helloWorld value stream page, select Configure value stream map > Replace value stream map, and then select the JSON file that you modified.
  7. Refresh the helloWorld page.
    After the page refreshes, the dot representing the Jira issue moves from the Backlog stage to the Selected for Development stage, as shown in the following figure:
    Figure 1. dot 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.


In this lesson, you learned how to manage dot 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.