Transformationen

Transformationsbeschreibung (XML Datei)

Die Konfigurationsdatei beschreibt (in XML) die Transformation der Template-Dateien in den Projektordner. Im Normalfall wird es sich hier um .cpp / .h sowie ggf. Projektdateien handeln – es können aber alle Arten von Dateien behandelt werden.

Der Wurzelknoten ist ein Element <ProjectFileGeneratorConfig>. Direkt an diesem Knoten kann das Attribute useProjectInterface=“true“ gesetzt werden. Es setzt den Processing Vorgang in den Modus Visual-Studio Projekte zu erzeugen (im Gegensatz zu TC-C++-Modulen).

Hier folgen mehrere <FileDescription>-Elemente, die jeweils die Transformation einer Datei beschreiben. Nach diesen Elementen besteht die Möglichkeit, in einem Element <Symbols> Symbole, die zur Transformation bereitstehen, zu definieren.

Transformation der Template-Dateien

Ein Element <FileDescription> ist folgendermaßen aufgebaut:

<FileDescription openFile="true"> 
 <SourceFile>FileInTemplatesDirectory.cpp</SourceFile>
 <TargetFile>[!output SYMBOLNAME].cpp</TargetFile>
 <Filter>Source Files</Filter>
</FileDescription>

• Die Quelldatei aus dem Templates-Verzeichnis wird als <SourceFile> angegeben.
• Die Zieldatei im Projekt-Verzeichnis wird als <TargetFile> angegeben. Dabei wird normalerweise ein Symbol mittels des Kommandos [!output …] genutzt werden.
• Mit dem Attribut „copyOnly“ kann angegeben werden, ob die Datei transformiert werden soll, d. h. dass die in der Quelldatei beschriebenen Transformationen ausgeführt werden. Ansonsten wird die Datei lediglich kopiert.
• Mit dem Attribut „openFile“ kann angegeben werden, ob die Datei nach dem Erstellen des Projektes in Visual Studio geöffnet werden soll.
• Filter: Es wird im Projekt ein Filter angelegt.
  Hierfür muss am <ProjectFileGeneratorConfig> das Attribute useProjectInterface=”true” gesetzt werden.

Transformationsanweisungen

In den Template-Dateien werden Kommandos genutzt, welche die Transformationen selber beschreiben.

Folgende Kommandos stehen bereit:

• [!output SYMBOLNAME]
  Dieses Kommando ersetzt das Kommando durch den Wert (Value) des Symbols. Eine Reihe von vordefinierten Symbolen steht bereit.
• [!if SYMBOLNAME], [!else] und [!endif] beschreiben eine Möglichkeit, entsprechenden Text bei der Transformation nur in bestimmten Situationen einzubinden.

Symbolnamen

Symbolnamen können auf 3 Arten für die Transformationsanweisungen bereitgestellt werden.
Diese werden von den zuvor beschriebenen Kommandos verwendet, um Ersetzungen vorzunehmen.

1. Eine Reihe von vordefinierten Symbolen direkt in der Konfigurationsdatei:
   In der XML-Datei ist eine Liste von <Symbols> vorgesehen. Hier können Symbole definiert werden: <Symbols>
<Symbol>
<Name>CustomerSymbol</Name>
<Value>CustomerString</Value>
</Symbol>
</Symbols>
2. Die generierten Zieldateinamen können durch Hinzufügen des „symbolName“-Attributes bereitgestellt werden:
   <TargetFile symbolName="CustomerFileName">[!output SYMBOLNAME].txt</TargetFile>
3. Wichtige Symbole werden vom System selber bereitgestellt