Design défini par l'utilisateur

www.altova.com Imprimer cette rubrique Page précédente Un niveau supérieur Page suivante

Accueil >  Manuel de l'utilisateur et référence > Commandes de menu  > Menu Conception de schéma > Générer Documentation >

Design défini par l'utilisateur

À la place du standard fixe du design XMLSpy, vous pouvez créer un design personnalisé pour la documentation de schéma. Le design personnalisé est créé dans une SPS StyleVision qui est un modèle de design pour le document de sortie.

 

Créer la SPS

Une StyleVision Power Stylesheet (ou SPS) est créée à l'aide du logiciel Altova StyleVision. Une SPS pour la génération de la documentation de schéma doit être basée sur un Schéma XML qui spécifie la structure de la documentation de schéma. Ce schéma est appelé SchemaDocumentation.xsd, et est fourni avec votre package XMLSpy. Il est stocké dans le dossier : C:\Documents and Settings\<username>\My Documents\Altova\XMLSpy2019\Documentation\Schema.

 

Lors de la création du design SPS dans StyleVision, les nœuds du schéma SchemaDocumentation.xsd sont placés dans le modèle de design et des styles et propriétés leur sont assignés. Les composants supplémentaires, comme des liens, des tables et des images peuvent aussi être ajoutés au design SPS. De cette manière, tout le document de sortie peut être conçu dans la SPS. La création d'un design de SPS dans StyleVision est décrite en détail dans le manuel d'utilisateur StyleVision.

 

L'avantage d'utiliser une SPS pour générer une documentation de schéma est que vous détenez le contrôle sur le design de documentation du schéma. Veuillez également noter que la sortie PDF de la documentation de schéma est uniquement disponible si une SPS définie par l'utilisateur est utilisée ; la sortie PDF n'est pas disponible si le design fixe XMLSpy est utilisé.

 

Spécifier la SPS à utiliser pour la documentation de schéma

Une fois qu'une SPS a été créée, elle peut être utilisée pour générer une documentation de schéma. La SPS que vous souhaitez utiliser pour générer la documentation de schéma peut être sélectionnée dans le dialogue Documentation de schéma (accessible depuis la commande Conception de schéma | Générer documentation). Dans le volet de design de la documentation de ce dialogue (voir capture d'écran ci-dessous), choisir le bouton radio Utiliser un design défini par l'utilisateur. Vous pouvez ensuite cliquer sur la touche Parcourir et chercher la SPS que vous souhaitez. Cliquer sur la touche OK du dialogue et, dans le dialogue Enregistrer qui apparaît, choisir le dossier et saisir le nom du fichier de sortie.

 

Note :Le fichier SPS doit localiser correctement le schéma sur lequel il est basé : SchemaDocumentation.xsd (voir ci-dessus).

SchemaDocSelectSPS

Les designs SPS éditables suivants pour la génération de documentation de schéma sont fournis avec XMLSpy. Ils se trouvent dans le dossier (Mes Documents): C:\Documents and Settings\<username>\My Documents\Altova\XMLSpy2011\Documentation\Schema\. Il s'agit de :

 

OverallDocumentation.sps, qui génère une documentation complète du schéma
Statistics.sps, qui liste le nombre d'éléments globaux et locaux, des attributs et des groupes d'attributs, et des types simples et complexes pour le schéma principal et pour chaque fichier de schéma indépendamment.
StructureOverview.sps, qui sort une structure d'éléments globaux et de types complexes jusqu'à une profondeur configurable
TypeDerivations.sps, qui liste les types simples et complexes et tous leurs types dérivés directement et indirectement sous la forme d'une arborescence
XPathGenerator.sps, qui génère toutes les déclarations XPath possibles jusqu'à une profondeur configurable

 

Ces fichiers, avec d'autres fichiers SPS que vous avez récemment parcourus, seront disponibles dans la liste de choix de l'option Utiliser un design défini par l'utilisateur (voir capture d'écran ci-dessus).

 

Cliquer sur la touche Édition dans le  volet de Design de la documentation pour lancer StyleVision et ouvrir la SPS sélectionnée dans une fenêtre StyleVision. Afin de consulter le document résultant dans StyleVision, il vous faudra un fichier de Travail XML. Un fichier XML échantillon a déjà été attribué aux designs SPS listés ci-dessus Sample.xml, qui est situé dans le dossier (Mes Documents), dans le sous-dossier suivant :

 

Altova\XMLSpy2019\Documentation\Schema\SampleData

 

Note :Pour pouvoir utiliser une SPS pour générer une documentation de schéma, vous devez avoir installé StyleVision sur votre appareil.

 


© 2018 Altova GmbH