Oxygen XML Author plugin 13.2.0

Transforming Documents | 289• XSL Formatting Objects (XSL:FO) - XSL:FO is an XML vocabulary for specifying formatting semantics.Oxygen XML Author plugin supports XSLT/XPath version 1.0 using Saxon 6.5.5, Xalan, Xsltproc, MSXML (3.0, 4.0,.NET) and XSLT/XPath 2.0 by using Saxon 9.3.0.5 HE, Saxon 9.3.0.5 PE, and Saxon 9.3.0.5 EE.Transformation ScenarioBefore transforming an XML document in Oxygen XML Author plugin you must define a transformation scenario toapply to that document. A scenario is a set of values for various parameters defining a transformation. It is not relatedto 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 onthe 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 editedXSLT 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 editedXQuery file is applied on and other transform parameters. When the XML source is a native XML database the XMLsource 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 thatwill 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 transformparameters.• DITA-OT scenarios - Such a scenario provides the parameters for an Ant transformation that will execute a DITA-OTbuild script. Oxygen XML Author plugin comes with a built-in version of Ant and a built-in version of DITA-OTbut 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 areavailable 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 theTransformation toolbar.Apply Transformation Scenario button from theBatch TransformationA transform action can be applied on a batch of files from the Project view's contextual menu without having to openthe files:•Apply Transformation Scenario - Applies the transformation scenario associated to each of the selected files.If the currently processed file does not have an associated transformation scenario then a warning is displayed in theWarnings view.•• Transform with... - Allows you to select one transformation scenario to be applied to each one of the currentlyselected files.xsl:message output information is collected and displayed in the Results View. All entries in the Results View point tothe location of the code that triggered them.Note: When you trigger a batch transformation, the output messages from the previous one are deleted.Built-in Transformation ScenariosIf the Apply Transformation Scenario button from the Transformation toolbar is pressed and there is no scenarioassociated with the edited document but this contains an xml-stylesheet processing instruction referring to a XSLTstylesheet (commonly used to display the document in Internet browsers), then Oxygen XML Author plugin will promptthe user and offer the option to associate the document with a default scenario based on this processing instruction. Thedefault scenario contains in the XSL URL field the URL from the href attribute of the processing instruction. This