SAP ST TT INCLUDE documentation, setup help and example usage

ARTICLE

ST - tt:include , Including Transformations

Syntax
tt:include name="trafo" [templates="tmpl1 tmpl2 ..."] /

Effect
The tt:include statement can be used to embed a different ST
program trafo in an ST program: This statement makes the templates and type definitions of the included program usable in the current ST program. The ST program trafo must exist actively in the repository. trafo is not case-sensitive.
The ST command tt:include can be executed in an ST program only outside of templates. In the default setting, it includes all named templates of transformation trafo at transformation level (unnamed main templates are not included). Make sure that no namespace conflicts occur; a transformation is not allowed to include itself.
If you specify the attribute templates , only the templates
tmpl1 tmpl2 specified there and the templates called by them using tt:apply are included.

Note
Only those transformations can be included (in another transformation) whose named templates are not in conflict with the existing named templates. Using tt:apply , you can use the included named templates as subtemplates in "including" templates.

Example
The ST program below corresponds to the example from Subtemplates Without Their Own Data Roots
except that the subtemplate of an included ST program is used.
<(><<)>tt:transform template="TEMP_MAIN"

xmlns:tt="http://www.sap.com/transformation-templates">
tt:root name="ROOT"/
<(><<)>tt:template name="TEMP_MAIN">
<(><<)>week>
<(><<)>day1 tt:ref="ROOT.DAY1">
tt:apply name="TEMP_SUB" /
<(><<)>/day1>
<(><<)>day2 tt:ref="ROOT.DAY2">
tt:apply name="TEMP_SUB" /
<(><<)>/day2>
...
<(><<)>/week>
<(><<)>/tt:template>
tt:include name="..." /
/tt:transform
The statement tt:include could also be placed before the main template. The included ST program can be implemented as follows:
<(><<)>tt:transform
xmlns:tt="http://www.sap.com/transformation-templates">
<(><<)>tt:template>
...
<(><<)>/tt:template>
<(><<)>tt:template name="TEMP_SUB">
<(><<)>name>
tt:value ref="$ref.name" /
<(><<)>/name>
<(><<)>work>
tt:value ref="$ref.work" /
<(><<)>/work>
<(><<)>/tt:template>
/tt:transform

Documentation extract taken from SAP system, � Copyright SAP AG. All rights reserved