TIBCO Source Control Tips - When to use Team Explorer

How to Install

1. Copy the TFSTibco.exe and TFSTibco.exe.config into a folder on the same machine where TIBCO BW is installed.
2. Edit the Config file accordingly. Important ones include:
*TeamFSURL - TFS URL including collection http://localhost:8080/tfs/Defaultcollection
*LogFileLocation - Location of the Adapters Log file.

What can it do?
After installing it open a command prompt go to that folder and run the help command
TFSTibco help

You will get this output:

This is the help for TFSTibcoDesignerRCSAdapter.

The syntax for the tool is the following:

TFSTibcoDesignerRCSAdapter "command" | -comment 'some text' | "second_arg"

where "command" may be any of the following:
=>Commands without any input which are used for configuration of RCS adapter:
supportsLocking, supportsCommit, foldersRequireRecursiveLock, supportsRecursiveLock, supportsSynchronize, wantsCommentOnAdd, specialVFileNames

=>Commands with one input which is the filepath of item ti be checked for tfs (and this is the next input passed by user):
isRevisionControlled, revert, revertRecursively, edit, editRecursively, delete, add, info

=>Commands without any input nad used by RCS adapter for the whole project path:
commitPreview, commit, updatePreview, update

=>And commands which takes as input a second argument:
encrypt, decrypt


Optionally user may provide the option "-comment 'sometext' " where the 'sometext' value inserted as comment into the "add" and "commit" commands.
Especially for commit if your comments is with the format:##xyz## where xyz is the TFS task number, then the changeset for the checkin commands is associated with the task by number xyz.


Optionally "second_arg" argument is used for commands:encrypt, decrypt and is the text we want to encrypt or decrypt.

Application Configuration File values description

==>SupportsCheckIns : Gets value true if we want RCS adapter to be able to perform check ins(commits)

==>TeamFSURL : The Url for Team Foundation Server eg. http://myteamfsserver:8080/

==>NeedsCommentsOnAdd: Set the value as true if you want RCS adapter to ask you provide comments on add command

==>LogFileSize : The file size (in bytes) of log file before its been rollover eg. 5120000000

==>ByPassCheckIsRevisionControl: Set to true if you want to bypasss the command isRevisionControlled. Do this if your project contains many files and this operation delays

==>TeamFSUsername : Set the value here for TFS connectivity if your pc is not joined in the domain or have different authentication.

==>TeamFSPassword : Set the value here for TFS connectivity if your pc is not joined in the domain or have different authentication.

==>TeamFSDomain : Set the value here for TFS connectivity if your pc is not joined in the domain or have different authentication.

==>LogInFile : Set the value to true if you want to log oprations in the debug file.


Hooking it up to TIBCO

You should create your TIBCO projects folder structure in your workspace ahead of time.
Map the folder structure to your local workspace.

If you are connecting an existing project you may want to copy the files into your workspace ready for source control. Adding them to source control using Team Explorer first.

Open TIBCO and select either New Project or Open existing project, either way you want to fill out the dialog like in the image.

1.Select the folder that contains your project in your workspace as the project directory.
2.In the Multi-User System drop down select Scriptable RCS Adapter.
3.Then select the TFSTibco Adapter as the script.
tibcotfs.png

You are now ready to us TIBCO with TFS

TIBCO Source Control Tips - When to use Team Explorer

Last edited Dec 17, 2011 at 4:08 PM by Dlloyd, version 7

Comments

No comments yet.