Transform Task Reference

From ControlTier

Jump to: navigation, search


Contents

Description

Transform dynamically performs a transformation for some Resource in the model 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>

      
Development