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
•Selecting the default Help format (Online Help or local PDF file) to open when the Help command is selected
Design options
In the Design tab (screenshot below), you can set the application-wide general options for designs.
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 known. 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.
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.
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.
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.
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/2.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.8. If you notice any problems with FOP 2.8, 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
The Taxonomy Packages pane (i) provides access to Taxonomy Manager and (ii) enables you to add custom packages. Altova's XBRL Taxonomy Manager allows you to install, upgrade, and manage commonly used taxonomies. How to use it is described in the section Taxonomy Manager. The description below focuses exclusively on the installation of custom 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).
2.Click Edit (see screenshot above) to display the XBRL Taxonomy Packages dialog (screenshot below).
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 options
La section Réseau (voir la capture d'écran ci-dessous) vous permet de configurer les paramètres de proxy de réseau.
Adresses IP
Lorsque les noms d’hôte résolvent plus d’une adresse dans les réseaux mixtes IPv4/IPv6, sélectionner cette option fait que les adresses IPv6 sont utilisées. Si l’option n’est pas sélectionnée dans de tels environnements, alors les adresses IPv4 sont utilisées.
Délai d’expiration
•Délai d’expiration du transfert : Si cette limite est atteinte pour deux packs de données consécutifs d’un transfert (envoyés ou reçus), alors le transfert entier est abandonné. Les valeurs peuvent être spécifiées en secondes [s] ou millisecondes [ms], avec le défaut étant 40 secondes. Si l’option n’est pas sélectionnée, alors il n’y a pas de limite de temps pour abandonner un transfert.
•Délai d’expiration de la phase de connexion : Il s’agit de la limite de temps au sein de laquelle la connexion doit être établie, y compris le temps pris pour les négociations de sécurité. Les valeurs peuvent être spécifiées en secondes [s] ou millisecondes [ms], avec le défaut étant 300 secondes. Ce délai d’expiration ne peut être désactivé :
Certificat
•Vérifier le certificat de serveur TLS/SSL : Si sélectionné, alors l’authenticité du certificat de serveur est vérifiée en contrôlant la chaîne de signatures numériques jusqu’à ce qu’un certificat racine de confiance est atteint. Cette option est activée par défaut. Si cette option n’est pas sélectionnée, alors la communication n’est pas sécurisée, et les attaques (par exemple, une attaque « man-in-the-middle ») ne serait pas détectée. Notez que cette option ne vérifie pas que le certificat est en fait pour le serveur avec lequel il communique. Pour permettre une sécurité entière, les deux certificats et l’identité doivent être vérifiés (voir la prochaine option).
•Vérifier l’identité de serveur TLS/SSL : Si sélectionné, alors le certificat de serveur est vérifié pour appartenir au serveur avec lequel nous voulons communiquer. Ceci est fait en vérifiant que le nom de serveur dans l’URL est le même que le nom dans le certificat. Cette option est activée par défaut. Si cette option n’est pas sélectionnée, alors l’identité du serveur n#est pas vérifiée. Notez que cette option n’active pas la vérification du certificat du serveur. ‘Pour permettre une sécurité entière, les deux certificats et l’identité doivent être vérifiés (voir l’option précédente).
Network Proxy options
La section Proxy de réseau vous permet de configurer des paramètres de proxy personnalisés. Ces paramètres ont une incidence sur la manière dont l'application se connecte à Internet (par exemple, pour une validation XML). Par défaut, l'application utilise les paramètres proxy du système, dans la plupart des cas, vous n'aurez donc pas à changer les paramètres de proxy. Si vous souhaitez, toutefois, définir un proxy réseau alternatif, dans la zone de liste de configuration Proxy, sélectionnez Automatic ou Manual pour configurer les paramètres en conséquence.
Note : Les paramètres de proxy de réseau sont partagés parmi toutes les applications de Altova MissionKit. Donc, si vous modifiez les paramètres dans une application, toutes les applications de MissionKit en seront touchées.
Utiliser les paramètres de proxy de système
Utilise les paramètres Internet Explorer (IE) configurables par le biais des paramètres de proxy du système. Effectue également une requête des paramètres configurés avec netsh.exe winhttp.
Configuration de proxy automatique
Les options suivantes sont possibles :
•Paramètres auto-détection : Consulte un script WPAD (http://wpad.LOCALDOMAIN/wpad.dat) par le biais de DHCP ou DNS, et utilise ce script pour une configuration proxy.
•URL de script : Spécifie une URL HTTP dans un script configuration-auto-proxy (.pac) qui doit être utilisé pour cette configuration de proxy.
•Recharger : Réinitialise et recharge la configuration automatique de proxy actuelle. Cette action requiert Windows 8 ou plus, et peut prendre jusqu'à 30 sec avant de prendre effet.
Configuration de proxy manuelle
Spécifier manuellement le nom d'hôte et le port entièrement qualifiés pour les proxies des protocoles respectifs. Un scheme pris en charge peut être inclus dans le nom d'hôte (par exemple : http://hostname). Il n'est pas exigé que le schéma soit le même que le protocole respectif si le proxy prend en charge le schéma.
Les options suivantes sont possibles :
•Proxy HTTP : Utilise le nom d'hôte spécifié et le port pour le protocole HTTP. Si Utiliser le serveur proxy pour tous les protocoles est sélectionné, alors le proxy HTTP spécifié est utilisé pour tous les protocoles.
•Proxy SSL : Utilise le nom d'hôte spécifié et le port pour le protocole SSL.
•Pas de proxy pour : Une liste séparée par point-virgule (;) de nom d'hôtes entièrement qualifiés, de noms de domaine, ou d'adresses IP pour des hôtes qui doivent être utilisés sans un proxy. Les adresses IP ne doivent pas être abrégées et les adresses IPv6 doivent être entourées de crochets (par exemple : [2606:2800:220:1:248:1893:25c8:1946]). Les noms de domaine doivent commencer avec un point (par exemple : .example.com).
•Ne pas utiliser le serveur proxy pour les adresses locales : Si cochées, ajoute <local> à la liste Pas de proxy pour. Si cette option est sélectionnée, les éléments suivants n'utiliseront pas le proxy : (i) 127.0.0.1, (ii) [::1], (iii) tous les noms d'hôte ne contenant pas de point (.).
Note : Si un serveur proxy a été défini et que vous voulez déployer une de mappage sur Altova FlowForce Server, vous devez sélectionner l’option Ne pas utiliser le serveur de proxy pour les adresses locales.
Paramètres de proxy actuels
Fournit un journal verbeux de la détection de proxy. Il peut être réinitialisé avec la touche Réinitialiser située à droite du champ Tester URL (par exemple, en changeant l'URL de test, ou lorsque les paramètres de proxy ont été modifiés).
•URL test : Une URL test peut être utilisée pour voir quel proxy est utilisé pour cette URL spécifique. Aucun E/S n'est effectué avec cette URL. Ce champ ne doit pas être vide si configuration-auto-proxy est utilisé (soit par le biais de Utiliser paramètres de proxy de système soit Configuration proxy automatique).
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
Dans l'onglet Java (voir la capture d’écran ci-dessous), vous pouvez saisir en option un chemin vers une Java VM (Machine Virtuelle) sur votre système de fichier. Veuillez noter que le fait d'ajouter un chemin Java VM personnalisé n'est pas toujours nécessaire. Par défaut, StyleVision tente de détecter le chemin Java VM automatiquement en lisant (dans cet ordre) le registre Windows et la variable d'environnement JAVA_HOME. Le chemin personnalisé ajouté dans ce dialogue prendra la priorité sur tout autre chemin Java VM détecté automatiquement.
Vous devrez éventuellement ajouter un chemin Java VM personnalisé, par exemple si vous utilisez une machine virtuelle Java qui ne possède pas de programme d'installation et ne crée pas d'entrées de registre (par exemple, OpenJDK d'Oracle). Vous pourrez également définir ce chemin si vous souhaitez contourner, pour une raison quelconque, tout chemin Java VM détecté automatiquement par StyleVision.
Veuillez noter les points suivants :
•Le chemin Java VM est partagé entre les applications de desktop (pas serveur) Altova. Par conséquent, si vous le modifiez dans une application, il s'appliquera automatiquement à toutes les autres applications Altova.
•Le chemin doit pointer vers le fichier jvm.dll provenant du répertoire \bin\server ou \bin\client, par rapport au répertoire sur lequel le JDK a été installé.
•La plateforme StyleVision (32-bit, 64-bit) doit être la même que celle du JDK.
•Une fois avoir modifié le chemin Java VM, vous devrez éventuellement redémarrer StyleVision pour que les nouveaux paramètres prennent effet.
La modification du chemin Java VM touche les zones suivantes :
•Connectivité JDBC
•Fonctions d'extension Java pour XSLT/XPath
•Prise en charge du code-barres
Help
StyleVision fournit de l’Aide (le manuel utilisateur) en deux formats :
•Aide en ligne, sous format HTML, qui est disponible sur le site web d’Altova. Afin d’accéder à l’Aide en ligne, vous aurez besoin d’un accès Internet.
•Un fichier Aide sous format PDF, est installé sur votre machine quand vous installez StyleVision. Il est appelé StyleVision.pdf et est situé dans le dossier d’application (dans le dossier de fichiers de programme). Si vous n’avez pas accès à Internet, vous pouvez toujours ouvrir ce fichier Aide enregistré localement.
L’option Aide (capture d’écran ci-dessous) vous permet de sélectionner lequel des deux formats s’ouvre quand vous cliquez sur la commande Aide (F1) dans le menu Aide.
Vous pouvez modifier cette option à tout moment pour la nouvelle sélection. Les liens dans cette section (voir capture d’écran ci-dessus) ouvre le format Aide respectif.