folderMetadata

The folderMetadata task creates or updates folder metadata.

Note: This task does not recognize the password file that other tasks accept to log in to the Jazz repository.

Folder metadata is stored in Jazz source control management as properties or name value pairs. To designate which folder to process and what properties to create, nest folderMetadataRule elements in the folderMetadata task.

The following table describes folderMetadata attributes.

Attribute	Description	Required
clean	Specify `true` to discard all current folder properties. Valid values are `true` and `false`. The default is `false`.	No
projectRoot	Root directory of the zComponent project. The default is the location where the Ant script that runs the fileMetadataDelete task is located.	No
verbose	More message output. The default value is `false`.	No

folderMetadataRule Elements

The folderMetadataRule element is specified in the folderMetadata element. Each folderMetadataRule element identifies a folder to process and a property to create or update. At least one folderMetadtaRule element is required.

The following table describes the valid folderMetadtaRule element attributes.

Attribute	Description	Default	Required
match	The regular expression to match against the zFolder name/zFile name string. For example, you can specify `match=".*/source\.cbl"` for the COBOL/source.cbl file.	None	Yes
name	The name of the folder metadata property you want to modify when the regular expression matches the zFolder name string.	None	Yes
value	The value of the folder metadata property you want to specify. Empty strings are allowed an do not result in a property being deleted. If a value is not specified, the property value will default to an empty string.	None	No

Note: This task must be run in an eclipse environment.

Example

Set a property for a folder


<!-- Folder Metadata Define -->
<target name="folder" description="Folder Metadata Define">

	<im:foldermetadata>
		<im:foldermetadatadeleterule match="ASM$" name="package.folder.fmid" value="01"/>
	</im:foldermetadata>

</target>