Create a team project on Team Foundation server to establish a repository for source content, where teams can plan, track progress, and collaborate.
Learn how to collaborate from RoboHelp using Team Foundation Server.
Prerequisites for connecting to Team Foundation Server
Before creating a Team Foundation Server connection profile, do the following:
- Set up Team Foundation Version Control on your machine. For more information, see Microsoft Help.
- In RoboHelp, choose Edit > Preferences. In the Application Settings dialog box, click Version Control and specify the complete path of the tf.exe binary in the Team Foundation Client field. The tf.exe binary is available in the Visual Studio or Team Explorer install directory on your computer. An example path:
C:/Program Files (x86)/Microsoft Visual Studio/2017/Enterprise/Common7/IDE/CommonExtensions/Microsoft/
TeamFoundation/Team Explorer/TF.exe
RoboHelp supports the tf.exe file version 14.102 and above.
If your system language is other than English, a workaround is needed to support the connection to Team Foundation Server. The folder that contains tf.exe also contains subfolders for different languages. Remove or rename the subfolder corresponding to your system language so that tf.exe defaults to the English version. For example, if your system language is French, remove or rename the 'fr' subfolder.
Create a Team Foundation Server connection profile
-
Note:
Ensure that your system user account (through which RoboHelp is being run) has adequate permissions to access the created team project. For information about modifying user permissions, see Microsoft Help.
-
In RoboHelp, choose Collaborate > New Connection.
-
In the Connection Profiles dialog box, specify a name for your connection profile.
-
From the Version Control drop-down list, select Team Foundation Server.
-
In the Team Project Collection URL field, specify the team project collection URL in the following format:
http://myserver:8080/tfs/DefaultCollection
-
In the Team Project field, specify the name of the Team Foundation Server project.
Note:The team project name and casing must match the name and casing of the team project on the Team Foundation Server.
RoboHelp prefixes the project name with '$/'.
-
In the Workspace field, specify a workspace name. This workspace is created at the path specified in the Local Path field.
Workspace is your local copy of the project. You can create content locally in RoboHelp and then check it in to Team Foundation Server. For more information about workspace, see Microsoft Help.
Note:Ensure that your system user account (through which RoboHelp is being run) has adequate permissions to create a workspace for the team project.
RoboHelp works only with local workspaces. For information about using a local workspace and setting the default workspace type for your project collection, see Microsoft Help.
-
In the Local Path field, specify a path on your computer that maps to the team project.
If the connection profile is to be used to upload the currently open RoboHelp project to Team Foundation Server, specify the folder containing the project or any of its parent folders. This folder is mapped to the team project contents on the server.
Otherwise, to use the connection profile to download a team project, provide the path to an empty local folder in which the project is to be downloaded.
-
Click Save.
Download a project from Team Foundation Server
-
In RoboHelp, choose Collaborate > Open Connection and select a Team Foundation Server connection profile.
Note:For first-time connections to the Team Project Collection URL, RoboHelp prompts for your password and saves it in the system Credential Manager for subsequent use. If you changed the password recently, delete or update the corresponding record from the Credential Manager to avoid password error prompts. The record is stored in this format:
team:<server>|<user>
If RoboHelp does not find a matching record in the system Credential Manager, it prompts for the password again. For more information about system Credential Manager (Windows), see Microsoft Help.The project is cloned at the local path specified in the connection profile.
-
In the Open dialog box, select a RoboHelp project file (.rhpj) and click Open.
RoboHelp opens the project file.
Note:When you open a RoboHelp project for the first time using these steps, connection information is stored inside the project for subsequent use. So directly open the project using one of the ways described in Open a project.
Work with files under version control
-
Add content to or edit a topic. You can quickly begin editing files when your network connection is unavailable or unreliable. As RoboHelp uses only local workspaces, you need not explicitly check out files before editing.
-
To check-in the changes to the server, choose Collaborate > Check In.
-
In the Check-in dialog box, from the list of modified, newly added, and deleted files, select the files you want to check in.
-
You can optionally specify a check-in description.
-
Click Check-in.
After the check-in is successful, RoboHelp displays a success message.
Note:If the file you are trying to check in is changed by another user on the server, the check-in fails. You are prompted to resolve the conflict between the local and server versions. After all conflicts are resolved, check in the file again.
-
To sync your local files with the latest version from the Team Foundation Server, choose Collaborate > Get Latest Version.
Files in your workspace are updated, except for those containing edits. You can merge the local edited versions with the updated versions from the server during check-in.
Lock files
You can lock files in the Contents panel to temporarily prevent changes by other users on the server. This is helpful if you want to change a file in your workspace and then check it in without being forced to resolve merge conflicts. Only one user at a time can lock a file.
-
To refresh the lock status of a file, right-click it and select Refresh Lock Status.
RoboHelp indicates the lock status of a file as when locked by other users and as when locked by you.
-
To view the name of the user who locked the file, hover the pointer over .
-
To lock a file, right-click it in the Contents panel and select Lock. The Lock option is displayed only if the file is not already locked by another user. Locking a file allows other users to edit it however, they cannot check in their changes to the server before the lock is removed.
-
To unlock a locked file, right-click it and select Unlock. This allows other users to check-in their changes to the server. When you check in a file that is locked by you, it is automatically unlocked.
Add a project to Team Foundation Server
-
To add a project, choose Collaborate > Add Project and select a Team Foundation Server connection profile.
The local path in the profile must contain the current project. For more information, see Step 8 in Create a Team Foundation Server connection profile.
The Check-in dialog box opens.
-
Check in the required files as described in Work with files under version control.
Remove Team Foundation Server connection
-
To remove the Team Foundation Server project connection from the current RoboHelp project, choose Collaborate > Remove Connection.
-
If you want to delete the local workspace also, select the Delete any source control information from the local folder also field in the Confirm dialog box.
Caution:Check-in all your changes before deleting the workspace and unlock locked files that are not being checked in.
Note:The delete workspace operation fails if the current system user does not have delete permission.
-
Click Ok.
As soon as the connection is removed, RoboHelp reopens the project, and the Add Project option in Collaborate menu becomes available. To add the project again, see Add a project to Team Foundation Server.