Component load rules

You can specify component load rules in a build definition on the Rational Team Concert™ source control page, which only displays if you selected Rational Team Concert source control as a Pre-Build option when you created the build definition.

As part of creating a Jazz™ build definition, you can create a component load rules file that defines a subset of component files and folders for the build to load. If you do not specify a load rules file, the build loads the entire component. You must create the load rules file in the build workspace. If the build definition enables accepting incoming change sets, they are accepted before the load rules file is read.

The format of the file is illustrated in this example.
# Two directives are supported:
# folderName=
# RootFolderName=

# In this example the component contains the following tree of folders
# /MyMain/
# /MyMain/products/
# /MyMain/products/command line client/
# /MyMain/products/command line client/project1/
# /MyMain/products/command line client/project1/src/
# /MyMain/products/command line client/project1/src/A.java
# /MyMain/products/command line client/project1/src/... a number of other sub directories and files
# /MyMain/products/command line client/project2/
# /MyMain/products/command line client/project3/
# /MyMain/products/MetroNome/project4/
# /MyMain/products/MetroNome/project5/
# /MyMain/products/RTC/project6/
# plus other directories under MyMain

# use folderName to specify a particular folder to load
# the name of the folder is full, case-correct path starting at the component root
# this line loads the folder /MyMain/products/RTC/project4/ and the files
# (but not the subfolders) it contains
folderName=/MyMain/products/RTC/project4/

# use RootFolderName when you want to load a folder and all of its subfolders,
# including new ones that may be created after the load rules file has been written
# this line loads the folder /MyMain/products and all of the files and subfolders it contains
RootFolderName=/MyMain/products/
Note: Named folders must exist, and the rules must not define overlapping subsets or folder name collisions.

Feedback