To configure global options for XQuery transformation and validation
scenarios that use the Saxon HE/PE/EE engine, open the
Preferences dialog box and go to .
Oxygen XML Author Eclipse plugin allows you to configure the following XQuery options for the Saxon
12.5 Home Edition (HE), Professional Edition (PE), and Enterprise
Edition (EE):
- Use a configuration file ("-config")
- Sets a Saxon 12.5 configuration file that is used for
XQuery transformation and validation scenarios.
- Enable Optimizations ("-opt")
- This option is selected by default, which means that optimization is enabled. If not
selected, the optimization is suppressed, which is helpful when reducing the compiling
time is important, optimization conflicts with debugging, or optimization causes
extension functions with side-effects to behave unpredictably.
- Use linked tree model ("-tree:linked")
- This option activates the linked tree model.
- Strip whitespaces ("-strip")
- Specifies how the strip whitespaces operation is handled. You can choose one of
the following values:
- All ("all") - Strips all whitespace text nodes from
source documents before any further processing, regardless of any
@xml:space attributes in the source document.
- Ignore ("ignorable") - Strips all ignorable
whitespace text nodes from source documents before any further processing,
regardless of any
@xml:space attributes in the source document.
Whitespace text nodes are ignorable if they appear in elements defined in the DTD or
schema as having element-only content.
- None ("none") - Strips no whitespace before further
processing.
The following option is available for Saxon
12.5 Professional
Edition (PE) and Enterprise Edition (EE) only:
- Allow calls on extension functions ("-ext")
- If selected, calls on external functions are allowed. Selecting this option is not
recommended in an environment where untrusted stylesheets may be executed. It also
disables user-defined extension elements and the writing of multiple output files, both
of which carry similar security risks.
The options available specifically for Saxon
12.5 Enterprise
Edition (EE) are as follows:
- Validation of the source file ("-val")
- Requests schema-based validation of the source file and of any files read using
document() or similar functions. It can have the following values:
- Schema validation ("strict") - This mode requires an XML
Schema and allows for parsing the source documents with strict schema-validation
enabled.
- Lax schema validation ("lax") - If an XML Schema is
provided, this mode allows for parsing the source documents with schema-validation
enabled but the validation will not fail if, for example, element declarations are
not found.
- Disable schema validation - This specifies that the source
documents should be parsed with schema-validation disabled.
- Validation errors in the result tree treated as warnings
("-outval")
-
Normally, if validation of result documents is requested, a validation error is
fatal. Selecting this option causes such validation failures to be treated as
warnings.
- Write comments for non-fatal validation errors of the result
document
- The validation messages for non-fatal errors are written (wherever possible)
as a comment in the result document itself.
- Enable XQuery update ("-update:(on|off)")
-
This option controls whether or not XQuery update syntax is accepted. The default
value is off.
- Backup files updated by XQuery ("-backup:(on|off)")
- If selected, backup versions for any XML files updated with an XQuery Update are
generated. This option is available when the Enable XQuery update
option is selected.