unEscapeProperty

The unEscapeProperty task restores escaped property values imbedded in build properties.

The following table describes unEscapeProperty attributes.

Attribute Description Required

chars

Specifies a proprety escape string. All instances of "${" will be changed to the value specified by chars. The chars attribute is optional. The default escape string is "\$\{".

No

name

Name of the ant property whose value is to be escaped. The value of this property will be updated with all instances of "${" changed to the escape string.

Yes

verbose

Specifies more message output. The default is false.

No

Note: The escapeProperty/unEscapePropety tasks are used together to pass property values with imbedded properties to another build using the ant propertyfile task and the Build Toolkit's requestTeamBuild task using the overridePropertiesFile attribute.

Example

Restore build properties from another build

<!-- Un-escape properties -->
<im:unescapeproperty name="ims.build.ant.updateProperty.acceptBeforeFetch"/>
<im:unescapeproperty name="ims.build.ant.updateProperty.antArgs"/>
<im:unescapeproperty name="ims.build.ant.updateProperty.buildAllItems"/>
<im:unescapeProperty name="ims.build.ant.updateProperty.buildChangesOnly"/>
<im:unescapeProperty name="ims.build.ant.updateProperty.buildFile"/>
<im:unescapeProperty name="ims.build.ant.updateProperty.buildableSubset"/>
<im:unescapeProperty name="ims.build.ant.updatePropety.javaVMArgs"/>
<im:unescapeProperty name="ims.build.ant.updateProperty.postBuildFile"/>
<im:unescapeProperty name="ims.build.ant.updateProperty.preBuildFile"/>
<im:unescapeProperty name="ims.build.ant.updateProperty.useGeneratedBuildFile"/>

<im:createbuilddefinition
	repositoryAddress="${repositoryAddress}"
	userID="${repositoryUsername}"
	password="${repositoryPassword}"
	buildId="${buildId}"
	buildWorkspace="${workspaceName}"
	processAreaName="${processAreaName}"
	updateOnly="true"
	updateProperties="true">

	<!-- Jazz Source Control Properties -->
	<im:teambuildproperty name="team.enterprise.scm.acceptBeforeFetch"		  value="${ims.build.ant.updateProperty.acceptBeforeFetch}"/>

	<!-- z/OS Dependency Build Properties -->
	<im:dpndbuildproperty name="team.enterprise.build.ant.useGenerateBuildFile" value="${ims.build.ant.updateProperty.useGeneratedBuildFile}"/>
	<im:dpndbuildproperty name="team.enterprise.build.ant.buikldFile" 		  value="${ims.build.ant.updateProperty.buildFile}"/>
	<im:dpndbuildproperty name="team.enterprise.build.ant.preBuildFile"		 value="${ims.build.ant.updateProperty.preBuildFile}"/>
	<im:dpndbuildproperty name="team.enterprise.build.ant.postBuildFile"		value="${ims.build.ant.updateProperty.postBuildFile}"/>

	<!-- Ant with Enterprise Extensions Configuration -->
	<im:dpndbuildproperty name="team.enterprise.build.ant.buildAllItems"		value="${ims.build.ant.updateProperty.antArgs}"/>
	<im:dpndbuildproperty name="team.enterprise.build.ant.javaVMArgs"		   value="${ims.build.ant.updateProperty.javaVMargs}"/>

	<!-- z/OS Dependency Build Options Properties -->
	<im:dpndbuildproperty name="team.enterprise.build.ant.buildAllItems"		value="${ims.build.ant.updateProperty.buildAllItems}"/>
	<im:teambuildproperty name="team.enterprise.build.ant.buildableSubset"	  value="${ims.build.ant.updateproperty.buildableSubset}"/>
	<im:teambuildproperty name="team.enterprise.build.ant.buildChangesOnly"	 value="${ims.build.ant.updateProperty.buildChangesOnly}"/>

	<!-- Build Engines -->
	<im:deletebuildengine id="NASWRBA0S"/>
	<im:buildengine id="NASWBFA00"/>
</im:createbuilddefinition>

video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki