Before transforming an XML document in
Oxygen XML Developer plugin
you must define a
transformation scenario to apply to that document. A scenario is a set of values for various
parameters defining a transformation. It is not related to any particular document but to a
document type:
- Scenarios that apply to XML files - Such a scenario contains the location of an
XSLT stylesheet that is applied on the edited XML document and other transform
parameters.
- Scenarios that apply to XSLT files - Such a scenario contains the location of an
XML document that the edited XSLT stylesheet is applied on and other transform
parameters.
- Scenarios that apply to XQuery files - Such a scenario contains the location of an
XML source that the edited XQuery file is applied on and other transform parameters. When
the XML source is a native XML database the XML source field of the scenario is empty
because the XML data is read with XQuery
specific
functions like document(). When the XML source is a
local XML file the URL of the file is specified in the XML input field of the scenario.
- Scenarios that apply to SQL
files - Such a scenario specifies a database connection for the database server that
will run the SQL file associated with the scenario. The data processed by the SQL script is
located in the database.
- Scenarios that apply to XProc files - Such a scenario contains the location of an
XProc script and other transform parameters.
- DITA-OT scenarios - Such a scenario provides the parameters for an Ant
transformation that will execute a DITA-OT build script.
Oxygen XML Developer plugin
comes with a
built-in version of Ant and a built-in version of DITA-OT but different versions can be set
in the scenario.
A scenario can be created at document type level or at
global level. The scenarios defined at document type level are available only for the
documents that match that document type. The global scenarios are available for any
document.
In order to apply a transformation scenario one has to press the
Apply Transformation Scenario button
from the Transformation toolbar.