Integrating tools into value streams#

Create value stream integrations by defining integration objects to the value-stream-name.json file.

Modify the value stream with the phases, stage, and queries that you need for you project.

To define an integration, complete the following steps:

  1. On the Value stream page, click value stream configure and select Download value stream map. The value_stream_name.json is downloaded to the specified location.

  2. Using a text editor, define an integration object in the value_stream_name.json file.

    The following code example illustrates a Bitbucket™ integration:


        "type": "ucv-ext-bitbucket-server",
        "tenant_id": "[ID]",
        "name": "my-bitbucket",
        "disabled": false,
        "properties": {
          "baseApiUrl": "[Base URL ex:]",
          "username": "admin",
          "password": "[Basic user password]",
          "projectName": "[Full project name ex: JKE Mortgage Application]",
          "projectKey": "[Project key ex: JMA]",
          "repositoryName": "[app repository name ex: web-application]",
          "repositorySlug": "[app repository name ex: web-application]"


  3. Define queries for the stages where you expect to see data from the integrated tool.

    For example, the following query defined for the In Progress stage matches open pull requests from source control systems:


          "name": "Development",
          "description": null,
          "stages": [
              "name": "In Progress",
              "query": "pr.status="open",
              "description": null,
              "wipLimit": null,
              "gates": null   


  4. On the Value Stream page, click and select Replace value stream map, and then select the modified file.

    For more information about creating value stream integrations, see About value stream integrations.

Objects from the integrated tool appear in stages of the value stream, and the integration is listed on the Integrations page in the web UI.

Increase usability by linking integrated tools. Linked value stream dots provide information for the linked tools.

Parent topic: Creating value streams