Sample adaptor templates are provided for several application types: source code, defect tracking, testing, and packaging. Adaptors are classified by the type of application they support.
The Build Forge product provides sample adaptor templates for the applications in the following table. The templates for ClearCase and ClearQuest do not require a separate license key. Other application templates are licensed through the Build Forge Adaptor Toolkit.
Adaptor templates XML files are installed in the following directory with an .xml file extension.
bfinstall\interface for computers running Microsoft Windows operating systems
bfinstall/Platform/interface for computers running UNIX or Linux operating systems
If a project runs with an adaptor attached through an adaptor link, the adaptor is not in debug mode, and the adaptor step fails, the adaptor removes the job.
Adaptor template name | Description | Type |
---|---|---|
ClearCaseBaseline | Scans a directory in a ClearCase view. Writes branch and version information reported by ClearCase to the BOM report. |
source |
ClearCaseByBaselineActivities | Creates a new baseline from the contents of a ClearCase view. Compares the new baseline and the baseline from the previous adaptor execution to identify change activity. For each change activity, writes the following information to the BOM report: activity, files changed, user, date, comments, and version. For each changed file, writes change details (from diff command output) to the BOM report. |
source |
ClearCaseByBaselineVersions | Creates a new baseline from the contents of a ClearCase view. Compares the new baseline and the baseline from the previous adaptor execution to identify changed files. For each changed file, writes the following information to the BOM report: file name, version, date, user, and comments. For each changed file, writes change details (from diff command output) to the BOM report. |
source |
ClearCaseByDate | Queries a ClearCase view for changes between two dates. The default dates are the current timestamp and the timestamp of the previous adaptor execution. For each changed file, writes the following information to the BOM report: file name, version, date, user, and comments. For each changed file, writes change details (from diff command output) to the BOM report. |
source |
ClearCaseByLabel | Creates and applies a new label to the contents of a ClearCase view. Compares the new label and the label from the previous adaptor execution to identify changed files. For each changed file, writes the following information to the BOM report: file name, version, date, user, and comments. For each changed file, writes change details (from diff command output) to the BOM report. |
source |
ClearQuestBaseClearCaseByDate | Queries a ClearCase view for changes between two dates. The default dates are the current timestamp and the timestamp of the previous adaptor execution. For each changed file, looks for a CrmRequest hyperlink attribute that identifies a ClearQuest change ID. Attempts to resolve the change ID by adding job information to resolve the defect record in ClearQuest if the ClearQuest status allows it to be resolved. For each changed file, writes the following information to the BOM report: the file name, defect ID, defect status, and any ClearQuest errors. |
defect |
ClearQuestClearCaseByActivity | Finds ClearQuest defect records associated with a list of ClearCase activities. For each defect record found, it adds job information to resolve the defect record within ClearQuest if the ClearQuest status allows it to be resolved. Writes the following information to the BOM report: files associated with ClearCase activity IDs and the ClearQuest defect status. |
defect |
ClearQuestUCMClearCaseByDate | Queries a ClearCase view for changes between two dates. The default dates are the current timestamp and the timestamp of the previous adaptor execution. Uses Rational Unified Change Management (UCM) to produce its results. For each changed file, writes the following information to the BOM report: the file name, defect ID, defect status, and any ClearQuest errors. |
defect |
CVSv1Baseline | Scans a CVS directory on a Build Forge agent looking for changed files. Writes the following information to the BOM report: changed file name, status, working version, repository version, and sticky tag. |
source |
CVSv1ByDate | Queries a CVS view for changes between two dates. The default dates are the current timestamp and the timestamp of the previous adaptor execution. Writes the following information to the BOM report: change type, date, user name, version, and file name. For each changed file, writes change details (from diff command output) to the BOM report. |
source |
CVSv1ByTag | Applies a new tag to a CVS module. Compares the differences between the newly tagged module and a module tagged during the previous adaptor execution. Writes the following information to the BOM report: file name, revision, state, date, time, change author, and commit comments. For each changed file, writes change details (from diff command output) to the BOM report. |
source |
CVSv2ByDate | Queries a CVS view for changes between two dates. The default dates are the current timestamp and the timestamp of the previous adaptor execution. Writes the following information to the BOM report: change type, date, user name, version, and file name. For each changed file, writes change details (from diff command output) to the BOM report. |
source |
JazzJBE | For users of Rational Team Concert 3.x and later. For information, see the Rational Team Concert documentation. |
source |
JazzSCM | Queries Rational Team Concert for changed source files. Writes the following information to the BOM report: source file changed, size of changed file, component changed, and changeset. |
source |
JazzSCMv2 | Queries Rational Team Concert version 2.x for changed source files. Writes the following information to the BOM report: source file changed, stream changed, component changed, changeset, user who made the change, the check-in comment, and the Jazz work item. |
source |
JUnit | Runs JUnit tests. Writes the following information to the BOM report: tests run, failures, errors, and elapsed time. |
test |
PerforceByDate | Queries a Perforce client for changes that occurred since the adaptor execution. Writes the following information to the BOM report: change, date, time, user, Perforce client, and comments. Writes change details (from diff command output) to the BOM report. |
source |
PerforceByRev | Queries a Perforce client for changes that occurred since the last repository revision. Writes the following information to the BOM report: change, date, time, user, Perforce client, and comments. Writes change details (from diff command output) to the BOM report. |
source |
Quota | Queries a Windows folder to determine if any of its subfolders exceed a specified threshold size. For each subfolder, writes the following information to the BOM report: folder size, owner, and last modified date. Writes to the BOM report a list of subfolders that exceeded the threshold size. Important: Notification is sent to the users who own the exceeded
directory in this order: first, by name within the Build Forge system;
and afterwards, by user name. If the notified user does not exist, <notify>
fails.
|
source |
StarTeamBaseline | Queries the folder for a StarTeam view to gather information about files. Writes the following information to the BOM report: file name, status, revision, and branch. |
source |
StarTeamByDate | Uses the StarTeam API to query a StarTeam view to identify changes between the current date and the previous adaptor execution. Writes the following information to the BOM report: changed files and directories, user, version, date, and change comments. Writes change details (from diff command output) to the BOM report. |
source |
SubversionByDate | Queries Subversion for repository changes that occurred between a past date and the current date. Writes the following information to the BOM report: change type, revision, user, file or directory, and change date. Writes the following information to the BOM report: file name, status, revision, and branch. |
source |
SubversionByRev | Queries Subversion for changes to a repository that occurred between the current revision and an earlier revision. For each change, writes the following information to the BOM report: revision, user, change type, file or directory path, and change date. Writes change details (from diff command output) to the BOM report. |
source |
SynergyByDate | Queries Rational Synergy for changes between two dates. The default dates are the current timestamp and the timestamp of the previous adaptor execution. For each changed file, writes the following information to the BOM report: file name, version, user, project, and date. For each changed file, writes change details (from diff command output) to the BOM report. |
source |
VSSByDate | Queries a Visual Source Safe directory for changes between an earlier date and the current date. Writes change information for projects and files to the BOM report: project or file, version, user, date, time, project activity, file project and action. Writes change details (from diff command output) to the BOM report. |
source |