This type of transformation allows you to configure the options and parameters of an Ant build script.
An Ant transformation scenario is usually associated with an Ant build script. Oxygen XML Author Eclipse plugin runs an Ant transformation scenario as an external process that executes
the Ant build script with the built-in Ant distribution (Apache Ant version 1.9.8) that is included with
the application, or optionally with a custom Ant distribution configured in the scenario.
Tip: Certain Ant tasks require additional JAR libraries (for example, Ant
mail tasks). The additional libraries can be added by editing the Ant transformation
scenario, and in the Output tab, click the Libraries
button in the bottom right corner. This opens a dialog box where you can add JAR
libraries. For a list of library dependencies, see https://ant.apache.org/manual/install.html#librarydependencies.
To create an Ant transformation scenario, use one of the following methods:
- Use the
Configure Transformation Scenario(s) (Alt + Shift +
T, C (Command + Option + T, C on macOS)) action from the
toolbar or the XML menu. Then click the New button and select
ANT transformation. - Go to and select Transformation Scenarios to display this view. Click the
New Scenario drop-down menu button and
select ANT transformation.
Both methods open the transformation configuration dialog box.
The upper part of the dialog box allows you to specify the Name of the transformation scenario.
The lower part of the dialog box contains several tabs that allow you to configure the options that control the transformation.
Since Ant transformation scenarios are run as separate processes, to instruct Oxygen XML Author Eclipse plugin to open certain resources created by the separate process, you can use
<echo> elements in your build files with the following
syntax:<echo>Finished publishing: "absolute/path/to/file.ext"</echo>