June 29, 2007

Embed TestTrack in the Salesforce.com Interface

Helix ALM

Works with TestTrack 7.6 and later

This article includes the steps to embed TestTrack Web in the Salesforce.com interface. You'll need:
  • Your TestTrack Web server to be publicly accessible from the Internet.
  • The path to your TestTrack Web server installation. If you're familiar with how web servers work and your IT environment, you can probably guess this. If not, ask the TestTrack administrator or IT staff for help.
  • An existing Salesforce.com account and the necessary permissions to customize the account's global interface.
You'll get:
  • Embedded access to the TestTrack Web client via a custom tab usable by all of your Salesforce.com users.

Getting Started

To embed the TestTrack Web client in your Salesforce.com interface, perform the following steps to create a Custom Tab in Salesforce.com.
  1. Log in to your Saleforce.com account.
  2. Click the Setup link in the top-right corner of the browser.
  3. Along the left sidebar, under the App Setup heading, expand the Create menu and click the Tabs link.

Creating the Tab

  1. Click New to launch the wizard that will guide you through the tab creation process.

Choose Tab Layout

  1. Select a layout and click Next.
Note that this tab will be available for all of your Salesforce.com users. We recommend using the single column, or full page width, layout to ensure users will not have to scroll horizontally to view the entire TestTrack Web client interface.

Define Content

Select the following content and display property options:
  1. Set Tab Type to URL, since you're going to be pointing directly to your TestTrack Server installation.
  2. Enter a short, descriptive Tab Label, such as TestTrack.
  3. Select a Tab Style. There are a number of tab styles available, including our favorite, the bug!
  4. Enter the Content Frame Height. We recommend setting this to at least 800 pixels to ensure minimal vertical scrolling within the tab. Ultimately though, how each user has set their TestTrack preferences will affect how much vertical scrolling is needed. The more defects per page they view, the more scrolling they'll have to do.
  5. Click Next when you finish defining content.

Enter the URL Details

The last step in the process is to point the new tab to your TestTrack Server installation. The general construction of the URL goes like this.
http://yourserver/cgipath/ttcgi.exe?command=LoginScreen
  • yourserver - The IP address or public name of the server that hosts your TestTrack Web server components. The TestTrack Web server must be publicly accessible from the Internet.
  • cgipath - This was configured when you installed the TestTrack Web server components. If you're running on IIS, the default is scripts. If you're running on Apache, the default is cgi-bin. If don't know the cgipath contact your TestTrack administrator or IT staff for help.
Following is an example of a TestTrack server that could be running here at Seapine (this link doesn't actually work).
http://ttp.seapine.com/scripts/ttcgi.exe?command=LoginScreen

Tada!

You're almost finished.
  1. In Salesforce.com, go to Customize My Tabs.
  2. Add the TestTrack tab to your interface.
  3. Click the tab, and you'll be prompted to log in to TestTrack.

4.  Login and select the TestTrack project you want to use.

You're finished!