Adding Git and other source control providers

Add a Git source control provider to allow users to attach commits to issues, test cases, and requirements from Git. See Third-Party Integrations for a list of supported versions.

When commits are attached from Git, the commit information and file paths are displayed on the Helix ALM item Source Files tab. You can also configure commit and file URLs to provide hyperlinks to attachments in items and other areas, such as reports.

The following steps are also used to add other providers that are not officially supported by Helix ALM.

1. Make sure the Helix ALM external source control provider CGI (ttextpro.exe) is installed on the web server that hosts Helix ALM. See the installation help for information.

2. Make sure external source control provider access is enabled in the Helix ALM Registry Utility. This is required to send attachment information from source control applications to Helix ALM. See the Registry Utility help for information.

3. Choose Tools > Administration > Source Control Providers.

The Source Control Providers dialog box opens.

4. Click Add.

5. Enter the provider Name. You can enter up to 256 characters. Provider names must be unique.

6. Select Git as the Type. To configure a provider for a different integration, select Other.

7. Enter the Commit URL to specify the format for hyperlinks provided with commit information on the item Source Files tab.

For example, http://www.wysicorp.com/gitweb/?p=.git;a=commit;h=<commitHash>.

8. Enter the File URL to specify the format for hyperlinks provided with files attached to items as part of a commit.

For example, http://www.wysicorp.com/gitweb/?p=.git;a=history;f=<fileHash>;hb=<commitHash>.

The commit and file URL formats depends on your Git viewer and the data provided to Helix ALM from the integration scripts. Include variables to replace with values from the attachment in angle brackets (<>). Refer to your Git viewer documentation for information about supported URL formats.

9. Make sure Active is selected so users can use the integration. This option is selected by default.

10. Click OK to save the provider.

After the provider is added, you must include the automatically generated provider key in the integration scripts to exchange attachment information between the source control provider and Helix ALM. See Creating hook scripts for Git integration.