View Source

The integration features:

* Hyperlink TeamForge artifacts in commit message to corresponding TeamForge pages
* Generate an issues report from commit messages
* Display the modifications of each issue
* Update TeamForge tracker artifacts based on
** commit commands in the commit messages
** a list specified manually
** a specified query based on lucene search syntax
* Generate TeamForge tracker artifacts based on the build or step status
* Create a release to TeamForge File Releases along with:
** Updating "Fix in Release" fields
** Updating specified fields of TeamForge tracker artifacts
** Publishing files to the release
* Upload files to TeamForge documents
* Delegate user management to TeamForge logins. (*NOTE* if you are using LDAP as TeamForge authenticator, please also use LDAP authenticator instead.)

*NOTE* Supported Team Forge version should be TeamForge 5.4 or higher.

Below we will describe how to integrate with TeamForge.


h2. Basic Integration
In configuration setting > Issue Tracker > TeamForge Server, you can define the TeamForge setting like below:


After the setting defined, the QuickBuild can generate the issues report automatically based on your commit messages, moreover, all TeamForge tracker artifact ids occurred in commit messages are hyperlinked.

*TeamForge Issues Report*


*Artifacts link in commit messages*


And now below steps are available for you to add to your workflow:
* Create TeamForge Artifact
* Create TeamForge Release
* Update TeamForge Artifacts
* Upload Files to TeamForge


h2. Create TeamForge Artifact
In your configuration workflow definition, you can add one or more "Create TeamForge Artifact" step to create TeamForge artifacts based on the build status or step status.

h2. Create TeamForge Release
In your configuration workflow definition, you can add a "Create TeamForge Release" step to create a release in the specified package. The step can also help you to update the "Fixed in Release" field of specified TeamForge artifacts, moreover, you may update extra fields via "extra attributes".


Also, you may upload files based on "File Pattern" to the release.

h2. Update TeamForge Artifacts
In your configuration workflow definition, you can add a "Update TeamForge Artifacts" step to update the TeamForge tracker artifacts. The artifacts are provided from commit message, from a specific list, or from a lucene search.


h2. Upload Files to TeamForge Documents
In your configuration workflow definition, you can add a "Upload Files to TeamForge" step to upload files to TeamForge documents.

h2. Supported TeamForge Artifact Attributes
Besides the attributes you need input in the step, you may specify extra attributes with below format line by line:
attribute name=attribute value

Below lists all supported attributes:
||Attribute Name||Description||
|title|The title of the artifact|
|description|The description of the artifact|
|group|The group of the artifact|
|category|The category of the artifact|
|status|The status of the artifact|
|customer|The customer of the artifact|
|estimatedEffort|The estimated effort of the artifact. Number only.|
|remainingEffort|The remaining effort of the artifact. Number only.|
|autosumming|Whether auto summing the effort or not. true or false.|
|assignee|The assignee of the artifact|
|fixedIn|The release id this artifact is fixed in|
|comment|The comment for updating the artifact|

*Flex/Custom Fields*

The flex/custom fields are also supported, you need add a prefix "flex:" to the custom field name. For example, you have a custom field named _My Custom1_, and if you want to specify the value, you need write like:
flex:My Custom1=Some value

When you update TeamForge artifact via commit command, you need replace all space to underscore "_", for example:
Fix artf1100 --flex:My_Custom1 Some value

h2. Delegate user management to TeamForge logins
To delegate user management to TeamForge is very easy, just go to Administration page and select Authenticators page, then add a TeamForge authenticator and QuickBuild will use TeamForge logins to authenticate the users.

h2. Integrate with Orchestrate
1. To integrate with Orchestrate, first, you need enable Orchestrate feature in TeamForge, please refer to the TeamForge documentation for details.

2. After Orchestrate is enabled in your project, go to Orchestrate page and click Manage Source button, you will see below page:


3. Choose Build category and click button _Add a new source_, so you can add QuickBuild source like below:


4. Now, copy and paste the settings to our QuickBuild TeamForge server:


5. After adding Orchestrate successfully, each time the build is finished, QuickBuild will post a message to Orchestrate and you will see the message in Orchestrate like below: