Creating plug-in integrations#

Work with external tools by defining integrations.

Before you can create an integration, make sure that you have the user credentials and connection information required by the external tool, such as URLs, and API endpoints. To create an integration with HCL™ Launch, for example, you need a user token generated by HCL Launch, and the URL where the server is located. Ensure that you have all the necessary connection information at hand before starting.

Credentials and other connection properties vary among individual plug-ins. You can find property descriptions and use cases for all plug-ins on the product website.

A plug-in is a software add-on designed to communicate with external services and applications. Each plug-in defines an expected record type and communication method. Communication can be uni-directional or bi-directional. To use a plug-in, you configure an integration. There are three ways to configure an integration:

This topic describes the first two methods. Native integrations are described in a separate section.

To configure an integration, complete the following steps:

  1. On the HCL™ Accelerate Home page, click Settings > Integrations > Plugins.

    The Plugins page lists the available plug-ins. For some plug-ins, you use the Add Integration button as described next. Other plug-ins require that you first install the plug-in before you can create integrations. Parser-type plug-ins generally provide metric or quality-type data. You can access the data supplied by parser-type plug-ins by using the Insights feature. Installed parser-type plug-ins are listed on the Plugins tab.

  2. Click Add Integration for the plug-in that you intend to use, and then define the integration properties.

    For information about the properties that are unique to the plug-in, visit the product website.

  3. You can configure integrations for some plug-in types by adding an integration definition to a value stream JSON file.

    Using a text editor, define an integration object in the integrations array of the value_stream_name.json file. The following code example illustrates a Jira integration.

    ```

     {
          "_id": "velocity-generated-id",
          "type": "ucv-ext-jira",
          "tenant_id": "velocity-generated-id",
          "name": "my-JIRA",
          "disabled": false,
          "properties": {
            "baseUrl": "http://my-jira-url",
            "username": "admin",
            "password": "****",
            "jiraProjects": [
              "My-Project"
            ]
          }
        },
    

    ```

    Integrations created by the value stream method are displayed on the Integrations page along with integrations created by the other methods.

The integration is listed on the Integrations page. The Integrations page is where you can manage integrations.

Integrations start providing data as soon as they are successfully configured. For some integration types, such as quality-data types, you can start using their data without additional configuration. For example, you can create dashboard charts that contain quality data as soon as you complete the integration. JUnit is an example of a quality-type plug-in.

Other integration types require additional configuration before you can start using their data. Native integrations require that tasks be added to deployment plans. Value stream integrations, such as GitHub™, require a reference in the value stream JSON file. If you define an integration on the Plugins page, add a reference to the integration name in the JSON file. If you define an integration directly in a JSON file as described in Step 3, no additional configuration is required.

See installing plug-ins in products for additional information.

Parent topic: Extending product functions