The task is used to restore escaped property values embedded in build properties.

Attributes

The task supports Build Extensions Debugging Attributes, as well as, its own task specific attributes. Click on a link for more information on the common attributes.

The following table describes the task specific attributes for the task:

Task Specific Attributes
Attribute	Description	Required
chars	Specifies a property 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 unescaped. The value of this property will be updated with all instances of the escape string changed to "${".	Yes
verbose	Specifies more message output. The default is false.	No

Notes

The escapePropertyunEscapeProperty tasks are used together to pass property values with embedded properties to another build when using the Ant PropertyFile task to create a property file to be passed to the Build Toolkit requestTeamBuild task using the overridePropertiesFile attribute. The idea behind these tasks is to delay resolution of the embedded Ant properties until they can be properly resolved by the requested build on the system where it is running and at the time it is running. The properties are escaped before they are processed by PropertyFile, avoiding property resolution by the requesting build, and unescaped after an Ant Property task has read the file in the requested build. Once the properties have been unescaped, embedded property resolution can take place with the correct values for the executing environment of the requested build.

Examples

Restore build properties from another build

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

<xt:createbuilddefinition
  repositoryAddress="${repositoryAddress}"
  userId="${repositoryUsername}"
  password="${repositoryPassword}"
  buildId="${buildId}"
  buildWorkspace="${workspaceName}"
  processAreaName="${processAreaName}"
  updateOnly="true">
  
  <!-- Jazz Source Control Properties -->
  <xt:teambuildproperty name="team.enterprise.scm.acceptBeforeFetch"           value="${ims.build.ant.updateProperty.acceptBeforeFetch}"/>
  
  <!-- z/OS Dependency Build Properties -->
  <xt:dpndbuildproperty name="team.enterprise.build.ant.useGeneratedBuildFile" value="${ims.build.ant.updateProperty.useGeneratedBuildFile}"/>
  <xt:dpndbuildproperty name="team.enterprise.build.ant.buildFile"             value="${ims.build.ant.updateProperty.buildFile}"/>
  <xt:teambuildproperty name="team.enterprise.build.ant.preBuildFile"          value="${ims.build.ant.updateProperty.preBuildFile}"/>
  <xt:teambuildproperty name="team.enterprise.build.ant.postBuildFile"         value="${ims.build.ant.updateProperty.postBuildFile}"/>
  
  <!-- Ant with Enterprise Extensions Configuration -->
  <xt:dpndbuildproperty name="team.enterprise.build.ant.antArgs"               value="${ims.build.ant.updateProperty.antArgs}"/>
  <xt:dpndbuildproperty name="team.enterprise.build.ant.javaVMArgs"            value="${ims.build.ant.updateProperty.javaVMArgs}"/>
  
  <!-- z/OS Dependency Build Options Properties -->
  <xt:dpndbuildproperty name="team.enterprise.build.ant.buildAllItems"         value="${ims.build.ant.updateProperty.buildAllItems}"/>
  <xt:teambuildproperty name="team.enterprise.build.ant.buildableSubset"       value="${ims.build.ant.updateProperty.buildableSubset}"/>
  <xt:teambuildproperty name="team.enterprise.build.ant.buildChangesOnly"      value="${ims.build.ant.updateProperty.buildChangesOnly}"/>
  
  <!-- Build Engines -->
  <xt:deletebuildengine id="NASWRBA0S"/>
  <xt:buildengine id="NASWBFA00"/>
</xt:createbuilddefinition>

getTaskNameHdr()

Attributes

Notes

Examples