ControlTier Inc. > Open.ControlTier
 
Font size:      

Transform

Description

Transform dynamically performs a transformation of some entity in the workbench using a template and context constraints specified.

The Transform element may contain a template element to have the document dynamically generated via that template. Otherwise, if no Template element is present, the generated document will be the XML view representation for the specified context element.

The "destdir" and "destfile" attributes specify where the downloaded content should be written to.

Parameters

AttributeDescriptionRequired
depotThe project to updateYes
resultpropertyProperty to set with success/fail valueYes
commentText describing purpose of updateYes
passfileFile containing authentication info to server. If passfile is not specified, information from the framework.properties file is used instead.No
destdirDirectory where destfile should be stored.Yes
destfileFile where transform results should be stored.Yes

Parameters specified as nested elements

template

A template.

context

A context.

Examples

Run a transform on the fly.

	<transform
           serverurl="${viewdoc.server}"
           depot="${entity.depot}"
           resultproperty="rs"
           comment="something re this update"
           destdir="${entity.instance.dir}/"
           destfile="something.test.out"
           >
          <context direction="internal" proximity="1" maprefuri="${entity.mapref-uri}"/>
          <template file="${templateFile}" dir="/pkgs" type="simple"/>
        </transform>

      

Run a transform with no template specified. This returns a view in an XML document.

	<transform
           serverurl="${viewdoc.server}"
           depot="${entity.depot}"
           resultproperty="rs"
           comment="something re this update"
           destdir="${entity.instance.dir}/"
           destfile="something.test.out"
           >
          <context direction="internal" proximity="1" maprefuri="${entity.mapref-uri}"/>
        </transform>