About value stream integrations#

Integrate external tools into your value streams.

Value stream integrations are specified in the value_stream_name.json file. Each value stream has its own value_stream_name.json field. You can add any number of integration objects to the JSON file.

You can add integrations to value streams by these two methods:

  1. Create an integration on the Integrations page, and then insert a reference to it in the value_stream_name.json file. For example, the following JSON code adds an integration named "DevOps Team" into the value stream, "name": "DevOps team".
  2. Define all properties for the integration in the value_stream_name.json file. When you configure an integration with this method, the integration will be listed on the Integrations page.

Properties common to all value stream integrations#

While all plug-ins have unique properties, the plug-ins that you can integrate into a value stream share some common properties. These properties identify the integration and determine if the integration is enabled or disabled.

The following table describes the properties that are common to all value stream integrations.

Property Description
_id Value stream identifier. The value is generated by UrbanCode™Velocity.
type The plug-in type identifier. See the list of supported plug-in types later in this topic.
tenant_id Tenant identifier. The value is generated by UrbanCodeVelocity.
name Integration name. The name should be unique.
disabled A flag that is used to disable the integration. The default value is null, which means the integration is enabled. To disable the integration, change the value to true. You can also set this value with the Disable/Enable button on the Integrations page.
properties The properties object defines properties that are specific to the plug-in. See the documentation for the tool that you want to integrate.

For information about the parameters unique to a specific integration, see Introducing plug-ins.

The following code block shows a typical Jira-type integration defined in the value_stream_name.json file:

"type": "ucv-ext-jira",     
"name": "my-jira",     
"properties": {       
"baseUrl": "https://my_jira_url",       
"username": "my_jira_userID",       
"password": "<password>",       
"jiraProjects": [         "JT"       ]     

Parent topic: Integrating tools into value streams