Transformation scenario

Before transforming the current edited XML document in <oXygen/> 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 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.

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.

Batch transformation

Alternatively, a transform action can be applied on a batch of files from the Project view's contextual menu without having to open the files:

  • Apply Transformation Scenario - applies to each selected file the transformation scenario associated to that file. If the currently processed file does not have an associated transformation scenario then a warning is displayed in the Warnings view to let the user know about it.

  • Transform with... - allows the user to select one transformation scenario to be applied to each one of the currently selected files.