Copying and Opening URLs

This topic describes how to copy and open a URL to a StarTeam project, view, folder, or item.

In this topic:

Back to top

URL Overview

The StarTeam client can open URL shortcut links to projects, views, folders, Not-in-View folders, and items. This enables you to quickly access specific locations in a project. You can also copy a URL to the clipboard, which allows you to easily move its contents to an appropriate application, such as an email client or a document.

Like other URLs, StarTeam URLs include the name of the server for the connection. In some organizations, StarTeam servers may be reached from both the Internet and the corporate intranet. In such cases, a server may have two different IP addresses. If you configure the server list to reference a server by its IP address, rather than its DNS name, then any URLs generated by the client will work only from the network on which that IP address exists.

Note: StarTeam shortcuts use the file extension .stx. For shortcuts to saved View Compare/Merge sessions, it uses .vcmx and .vcms.

Tip: Double-click a StarTeam URL link in an email or other application to open StarTeam to the specified project, view, or item. In Windows Explorer, StarTeam links display a small StarTeam icon which you can double-click to open.

Back to top

Copying a URL to the Clipboard

To copy a URL to the clipboard, do the following:

  1. Select one or more items in the upper pane.
  2. Right-click the selected items and choose Copy URL to clipboard.

    This action places in the clipboard a plain text version of the URL to the selected items and an HTML representation of the links to the selected items. From the clipboard, you can paste the URL to a selected application.

  3. Paste the URL to the application of choice.

    Note: Copying a URL to the clipboard is equivalent to dragging an item or items from the list pane or folder tree onto an application. Not all applications support pasting the HTML representation, although Word, Excel, and Outlook do support HTML data.

Back to top

Opening a URL

To open a URL, do the following:

  1. Choose Project > Open StarTeam URL.

  2. Type a valid URL to a project, view, folder, or item in the Open StarTeam URL dialog box. For example: starteam:/hostname:49201/myproject.

    • If the URL is a reference to a project, the default view of the project opens.
    • If the URL is a reference to a view or folder, then the view or folder opens.
    • If the URL is a reference to an item, the item's view opens, the item's parent folder is selected in the folder tree, the item type is selected, and the item itself is selected in the item list or tree on the upper pane.
  3. Optional: Clear the Open URL in new window check box if you want the view to open in the same window you have open.

    Note: On the Workspace tab in Tools > Personal Options, you can define the default setting for the way a view displays in your workspace when you open a link to a StarTeam URL.

  4. Click OK.

Back to top