Lesson 5 Using linked dots#

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:


  1. On the Value Streams page, select the tutorial value stream.

  2. 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.

  3. 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.

  4. 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.


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