Git Integration Setup

Prerequisite

The ExtraView Command Line Interface must be installed on your Git server and configured to point to your ExtraView server in order for the Git integration to function properly.

Installation

Download the "update" script from ExtraView and copy it to the hooks directory of your Git server. This script is the main point of integration between Git and ExtraView, and it is executed whenever a git push command is issued for one or more commits.

Configuration

To configure the integration hook script, edit the "update" file and set the following variables to appropriate values for the environment. Replace the quoted words USER and PASSWORD with the username and password, respectively, of the ExtraView account used by the integration. Replace the http://SERVER.DOMAIN/evj portion in the EV_URL variable with the URL of your ExtraView server.


# ExtraView variables
$EV_USER = "USER";
$EV_PASSWORD = "PASSWORD";
$EV_URL = "http://SERVER.DOMAIN/evj/ExtraView/ev_api.action?user_id=$EV_USER&password=$EV_PASSWORD";

Usage

To use the integration, you need to git push one or more commits from the working directory to the Git server. For any commit that contains text similar to "Bug Id: <number>" (where <number> is an ExtraView record ID), the update hook will validate that the number exists in ExtraView (using the credentials provided above) as a record, and then update the COMMENTS field of that record with the commit message and file diffs. If any of the commits fails the number validation, then the git push command is aborted with an error message (and no records are updated in ExtraView).