The Configure Transformation Scenario dialog is used to associate a
scenario from the list of all scenarios with the edited document by selecting an entry from
the list. The dialog is opened by pressing the
Configure Transformation Scenario
button on the Transformation toolbar of the document view. Once
selected,
the scenario will be applied with only one click on the
Apply Transformation Scenario
from
the same toolbar. Pressing the
Apply
Transformation Scenario button before associating a scenario with the edited
document will invoke first the Configure Transformation Scenario dialog
and then apply the selected scenario.
The Configure Transformation Scenario dialog can be opened using one of the methods previously presented or by selecting .
Configure Transformation Scenario Dialog
The Scenario type allows you to choose what type of user defined transformation scenario is displayed:
If you want an XSLT scenario select as Scenario type either XML transformation with XSLT or XSLT transformation then complete the dialog as follows:
The Configure Transformation Dialog - XSLT Tab
The following buttons are shown immediately after the input field:
Insert Editor
Variables - Opens a pop-up menu allowing to introduce special
Oxygen XML Editor plugin
editor
variables or custom editor
variables in the XML URL field.
Browse for local
file - Opens a local file browser dialog allowing to select a local file
for
the text field.
Browse for remote
file - Opens
an
URL browser dialog allowing to select a remote file
for
the text field.
Browse for archived
file - Opens a zip archive browser dialog allowing to select a file
from
a zip archive that will be inserted in the text field.
Open in editor -
Opens the file with the path specified in the text field in an editor panel.
Advanced options - Configure advanced
options specific for the Saxon HE / PE / EE engine. They are the same options as the ones set in the user preferences but they
are configured as a specific set of transformation options for each transformation scenario.
By default if you do not set a specific value in the transformation scenario each advanced
option has the same value as the global option with the same name set in the user preferences. The advanced options include two options that are not available globally in the user preferences: the initial XSLT template and the initial XSLT mode of the transformation. They are Saxon specific options that allow imposing the name of the first XSLT template that starts the XSLT transformation or the initial mode of transformation.
The advanced options specific for Saxon HE / PE / EE are:
Note that any external DTD is likely to be read even if not used for validation, because DTDs can contain definitions of entities.
The advanced options available only in Saxon PE / EE are:
The advanced options available only in Saxon EE are:
When creating a scenario that applies to an XML file, Oxygen XML Editor plugin fills the XML URL field with the default variable ${currentFileURL}. This means the input for the transformation is taken from the currently edited file. You can modify this value to some other file path. This is the case when you are currently editing a section from a large document, but you want the transformation to be performed on the main document. You can specify in this case either a full absolute path: file:/c:/project/docbook/test.xml or a path relative to one of the editor variables, for example or the current file directory: ${cfdu}/test.xml.
When the scenario applies to XSL files, the field XSL URL initially contains ${currentFile} editor variable. Just like in the XML case, you can specify here the path to a master stylesheet. The path can be configured using the editor variables or the custom editor variables.
The Configure Transformation Dialog - FO Processor Tab
The Configure Transformation Dialog - Output Tab