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:
-
On the Value Stream page, click Download value stream map. The
value_stream_name.json
is downloaded to the specified location. -
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: http://10.134.116.110:7990/rest/api/1.0]", "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]" } }
```
-
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 },
-
On the Value Stream page, click 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 particles provide information for the linked tools.
- About value stream integrations
Integrate external tools into your value streams. - Linking integrated tools
Link value stream tools to one another.
Parent topic: Value stream management