Options

www.altova.com Print this Topic Previous Page Up One Level Next page

Home >  User Reference > Tools Menu >

Options

The Options command opens a dialog in which you specify settings for:

 

The properties of the following Design View components: markup tags, layout containers, and templates with no known context
Sorting of attributes and elements in the Schema Tree View
Actions to undertake when a file is double-clicked from within a project window
The encoding of output documents
The processing of the internally generated XSL-FO document, which is required in order to enable the PDF Preview and the generation of PDF files in StyleVision
The XBRL taxonomy packages that should be used for validations and transformations
The conversion of SPS files to MobileTogether Design files
Locating the Java Virtual Machine

 

Design options

In the Design tab (screenshot below), you can set the application-wide general options for designs.

 

DlgOptionsDesign

 

The following options can be set:

 

Maximum width (in pixels) of markup tags. Enter the positive integer that is the required number of pixels.
Grid size of layout containers in absolute length units. The specified lengths are the distances between two points on the respective grid axis.
Default additional width and height of Layout Boxes. These additional lengths are added to all layout boxes in order to provide the extra length that is often required to accommodate the bigger text renditions of print formats. These values can be specified as percentage values or as absolute length units.
The default behavior when a node-template is created at a location where the context node is not know. This option typically applies to User-Defined Templates in which the template has been created for items that cannot be placed in context in the schema source of the design. If a node is created within such a user-defined template, then the node can be created with (i) only its name, or (ii) with the full path to it from the schema root. You can set one of these options as the default behavior, or, alternatively, ask to be prompted each time this situation arises. The default selection for this option is Always Ask.

 

 

Schema options

In the Schema tab, elements and attributes can be listed alphabetically in ascending order. To do this, check the respective check boxes in the Schema tab (screenshot below). By default, attributes are listed alphabetically and elements are listed in an order corresponding to the schema structure, as far as this is possible.

 

DlgOptionsMain

 

Project options

In the Project sidebar, when an XML file or XSD file is double-clicked, one of three actions is executed depending on the options set in the Project tab of the Options dialog (screenshot below): (i) Edit the file in XMLSpy; (ii) Create a new design based on the selected file; (iii) Ask the user which action to execute.

 

dlg_options_project

 

If the Save Without Confirmation setting is checked, then any changes to the project are automatically saved when the project or StyleVision is closed. Otherwise, you will be prompted to save any unsaved changes.

 

Default Encoding (of output files)

In the Default Encoding tab (screenshot below), you can set default encodings for the various outputs separately. The encoding specifies the codepoints sets for various character sets. The dropdown list of each combo box displays a list of encoding options. Select the encoding you require for each output type, and click OK. Every new SPS you create from this point on will set the respective output encodings as defined in this tab.

 

dlg_options

 

In the XSLT-for-HTML, the output encoding information is registered at the following locations:

 

In the encoding attribute of the stylesheet's xsl:output element:

 <xsl:output version="1.0" encoding="UTF-8" indent="no" omit-xml-declaration="no" media-type="text/html" />

In the charset attribute of the content-type meta element in the HTML header:

 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />

 

 

In the XSLT-for-RTF, the output encoding information is registered in the encoding attribute of the stylesheet's xsl:output element:

<xsl:output version="1.0" encoding="ISO-8859-1" indent="no" method="text" omit-xml-declaration="yes" media-type="text/rtf" />

 

In the XSLT-for-PDF, the output encoding information is registered in the encoding attribute of the stylesheet's xsl:output element:

<xsl:output version="1.0" encoding="UTF-8" indent="no" omit-xml-declaration="no" media-type="text/html" />

 

Note: These settings are the default encodings, and will be used for new SPSs. You cannot change the encoding of the currently open SPS using this dialog. To change the encoding of the currently open SPS, use the File | Properties command.

 

XSL options

In the meta information of HTML and PDF output files, the line 'Generated by StyleVision' will be generated by default. Purchased versions of the product provide an option to disable the generation of this line.

 

Once the XSL-FO settings are correctly made, each time the PDF Preview tab is clicked, the following happens:

 

1.An XSL-FO document is generated (behind the interface) by processing the Working XML File with the currently active SPS.
2.The XSL-FO is then processed by an FO processor to generate the PDF that is displayed in the PDF Preview window.

 

In the XSL-FO tab, the following settings must be made in order for the PDF Preview to be enabled and for PDF files to be generated.

 

fop93_options

 

FO Processor

You can use any FO processor of your choice. All you have to do is enter the path to the processor's executable in this dialog. For details, see Setting up StyleVision.

 

XSL-FO Generation

Selecting the FOP 0.93/1.0 compliant option filters out those FOP properties that have not yet been implemented in the latest version of FOP. Selecting the Full XSL-FO standard option will not filter out any properties when the XSLT-for-FO is being generated.

 

Depending on your selection, the XSLT-for-FO will be created with or without the objects, properties, and values that are beyond the compliance level of FOP 0.93/1.0/2.0. You should be aware of the possible outcomes from this point in the processing. These are as follows:

 

If you have selected FOP 0.93/1.0/2.0 compliance and use FOP as your processor, then the PDF generation should work fine.
If you have selected full usage of the XSL-FO standard and use FOP as your processor, then any formatting object or property in the FO document that is not supported by the current version of FOP will cause FOP to generate either a warning or an error. An error is fatal, and no PDF will be generated.
If you use a processor other than FOP, the success of the transformation will depend upon the compliance level of the processor.

 

For standard use, we recommend:

 

Install FOP 2.0. If you notice any problems with FOP 2.0, we suggest you use either FOP 1.0 or FOP 0.93.
Selecting FOP 0.93/1.0/2.0 compliant in the Options dialog.

 

Note: The XSLT-for-FO that you generate with the File | Save Generated Files | Save Generated XSL-FO File command will be either in compliance with FOP 0.93/1.0/2.0 or with the full XSL-FO standard, depending on the selection you make for the XSL-FO Generation option in this dialog. Any error will only be reported when the FO document is processed by the FO processor.

 

 

Technical Note: StyleVision opens the executable of the FO processor using the path you enter in the FO Processor pane of the Options dialog. It sends the following arguments to the executable:

 

%1 : -fo

%2 : filename.fo

%3 : -pdf

%4 : filename.pdf

 

These arguments are as used in the FOP command: FOP -fo filename.fo -pdf fileame.pdf. You can use these arguments to invoke any FO processor, if the arguments suffice to make a successful call.

 

Taxonomy packages

An XBRL Taxonomy Package is a zipped archive that contains an offline copy of a taxonomy. The package contains a catalog XML file that maps URIs to the taxonomy's file locations, and so makes the taxonomy available offline to applications. The rules that specify how taxonomy packages are to be structured and built are laid out in the Taxonomy Packages Recommendation of XBRL.org.

 

After you have downloaded a taxonomy package, you can set up StyleVision to automatically identify and use the entry point catalog file of the package. Do this by adding the package to the list of active taxonomy packages. The catalog files of active packages will then be used to locate resources for operations such as XBRL validation.

 

Note:A resource pointed to by an active package's catalog file will be used for all StyleVision operations that require that resource. If such a resource is different in some way than the resource that was previously used by StyleVision, then errors might result when operations are run. For more information, see the caution at the bottom of this topic.

 

To add a taxonomy package, do the following:

 

1.Select Tools | Options | Taxonomy Packages to display the Taxonomy Packages pane (screenshot below).

OptionsTaxonomyPackages

2.Click Edit (see screenshot above) to display the XBRL Taxonomy Packages dialog (screenshot below).

Click to expand/collapse

3.Click Add Taxonomy, then browse to the location of the taxonomy package, select it, and click Open. (You can also select multiple packages to add at one time.) The package will be added to the taxonomy package list in the dialog. The list is displayed as a tree of two levels. The first level indicates the taxonomy; the second level shows the packages of that taxonomy. The check box to the left of a taxonomy entry indicates whether that taxonomy is active or not. A newly added taxonomy will be active by default.
4.Click OK to finish. The newly added packages will be displayed in the Taxonomy Packages pane of the Options dialog (first screenshot above).

 

Note the following points:

 

If you wish to add an additional package to a taxonomy, do this: Select the taxonomy in the XBRL Taxonomy Packages dialog (screenshot above), then add the additional package/s via the Add Packages button. The added package/s will be displayed at the second level of that taxonomy.
When a taxonomy package is selected in the list in the upper pane of the XBRL Taxonomy Packages dialog, its details (including its offline location) are displayed in the dialog's lower pane (see screenshot above).
To deactivate a taxonomy, uncheck its check box. If you deactivate a taxonomy, its catalog file/s will not be used. Deactivation is useful if, say, you wish to switch between two versions of a taxonomy.
You can remove a package by selecting it and clicking Remove.
The following Altova applications support Taxonomy Package Registration: XMLSpy, MapForce, and StyleVision. The taxonomy package list is common to all these applications. If you edit the list in one application, then the modified list will be displayed in the other applications as well. If you edit the package list in one application, and another application is open at the same time, then the other application will display an alert asking whether you wish to reload the package list to reflect the modification.

 

 

Caution: Package catalogs might redirect to incompatible resources

A resource pointed to by an active package's catalog file/s will be used for all StyleVision operations that require that resource. An example of such a resource would be XML Schema, which is used for both XML validation as well as XBRL validation. If the offline resource located by the package's catalog file is incompatible with your existing environment, then errors might result. In this case, deactivate the taxonomy package and contact the creators of the package with the error information.

 

Network Proxy options

The Network Proxy section enables you to configure custom proxy settings. These settings affect how the application connects to the Internet (for XML validation purposes, for example). By default, the application uses the system's proxy settings, so you should not need to change the proxy settings in most cases. If necessary, however, you can set an alternative network proxy using the options below.

 

Note:The network proxy settings are shared among all Altova MissionKit applications. So, if you change the settings in one application, all MissionKit applications will be affected.

inc-OptionsNetworkProxy

 

Use system proxy settings

Uses the Internet Explorer (IE) settings configurable via the system proxy settings. It also queries the settings configured with netsh.exe winhttp.

 

Automatic proxy configuration

The following options are provided:

 

Auto-detect settings: Looks up a WPAD script (http://wpad.LOCALDOMAIN/wpad.dat) via DHCP or DNS, and uses this script for proxy setup.
Script URL: Specify an HTTP URL to a proxy-auto-configuration (.pac) script that is to be used for proxy setup.
Reload: Resets and reloads the current auto-proxy-configuration. This action requires Windows 8 or newer, and may need up to 30s to take effect.

 

Manual proxy configuration

Manually specify the fully qualified host name and port for the proxies of the respective protocols. A supported scheme may be included in the host name (for example: http://hostname). It is not required that the scheme is the same as the respective protocol if the proxy supports the scheme.

 

The following options are provided:

 

Use this proxy for all protocols: Uses the host name and port of the HTTP Proxy for all protocols.
No Proxy for: A semi-colon (;) separated list of fully qualified host names, domain names, or IP addresses for hosts that should be used without a proxy. IP addresses may not be truncated and IPv6 addresses have to be enclosed by square brackets (for example: [2606:2800:220:1:248:1893:25c8:1946]). Domain names must start with a leading dot (for example: .example.com).
Do not use the proxy server for local addresses: If checked, adds <local> to the No Proxy for list. If this option is selected, then the following will not use the proxy: (i) 127.0.0.1, (ii) [::1], (iii) all host names not containing a dot character (.).

 

Note:If a proxy server has been set and you want to deploy to Altova FlowForce Server, you must select the option Do not use the proxy server for local addresses.

 

Current proxy settings

Provides a verbose log of the proxy detection. It can be refreshed with the Refresh button to the right of the Test URL field (for example, when changing the test URL, or when the proxy settings have been changed).

 

Test URL: A test URL can be used to see which proxy is used for that specific URL. No I/O is done with this URL. This field must not be empty if proxy-auto-configuration is used (either through Use system proxy settings or Authomatic proxy configuration).

 

MobileTogether Design

The options listed below are available for the conversion of SPS files to MobileTogether Design (MTD) files. (These conversions are done via the Export as MobileTogether Design File command.)

 

Static text and paragraph-level text that contain inline formatting (for example a paragraph element that contains a bold or italic element) is by default converted into a single MTD label, where the text will have the formatting of the block-level text. You can however set an option to split this kind of text (block-level text with inline formatting) into multiple MTD labels, where each label has the formatting that corresponds to the original text fragment.
If the SPS has a condition with branches, then the conversion to MTD will, by default, convert all branches of the condition and will position them in sequence one below the other in the MTD document. You can optionally choose to suppress the conversion of the condition (and all its branches).

 

Java options

On the Java tab, you can optionally enter the path to a Java VM (Virtual Machine) on your file system. Note that adding a custom Java VM path is not always necessary. By default, StyleVision attempts to detect the Java VM path automatically by reading (in this order) the Windows registry and the JAVA_HOME environment variable. The custom path added on this dialog box will take priority over any other Java VM path detected automatically.

 

You may need to add a custom Java VM path, for example, if you are using a Java virtual machine which does not have an installer and does not create registry entries (for example, Oracle's OpenJDK). You might also want to set this path if you need to override, for whatever reason, any Java VM path detected automatically by StyleVision.

inc-jvm-settings-SV

Note the following:

 

The Java VM path is shared between Altova desktop (not server) applications. Consequently, if you change it in one application, it will automatically apply to all other Altova applications.
The path must point to the jvm.dll file from the \bin\server or \bin\client directory, relative to the directory where the JDK was installed.
The StyleVision platform (32-bit, 64-bit) must be the same as that of the JDK.
After changing the Java VM path, you may need to restart StyleVision for the new settings to take effect.

 

Changing the Java VM path affects the following areas:

 

JDBC connectivity
Java extension functions for XSLT/XPath
Barcode support

 


© 2019 Altova GmbH