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 d'un produit StyleVision d'Altova. 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\XMLSpy2025\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. Des composants additionnels, tels que des liens, tables et images peuvent aussi être ajoutés au design SPS. De cette manière, le document de sortie complet peut être conçu dans la SPS. Voir le manuel d'utilisation StyleVision pour consulter des explications détaillées de la création d'un design SPS dans 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 aussi noter qu'une sortie PDF de la documentation 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 de XMLSpy est utilisé.
Spécifier la SPS pour utiliser 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 WSDL est sélectionnée dans le dialogue de Documentation Schéma (accédé par le biais de la commande Design Schéma | Générer documentation). Dans le volet de design de la documentation de ce dialogue (voir la 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. Cliquez sur la touche OK du dialogue et, dans le dialogue Enregistré qui s'ouvre, sélectionnez le dossier pour et saisissez le nom du fichier de sortie.
| Note : | le fichier SPS doit situer correctement le schéma sur lequel il est basé : SchemaDocumentation.xsd (voir ci-dessus). |
Les designs SPS éditables suivants pour la génération de documentation de schéma sont fournis avec XMLSpy. Ils se trouvent dans le sous-dossier Altova\XMLSpy2025\Documentation\Schema\ du dossier (Mes Documents).
•OverallDocumentation.sps, qui génère une documentation complète sur le 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 crée une sortie de la 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 la capture d'écran ci-dessus).
Cliquer sur la touche Éditer dans le volet Design de Documentation pour lancer StyleVision et ouvrir la SPS sélectionnée dans une fenêtre StyleVision. Afin de préconsulter le document de résultat dans StyleVision, vous nécessiterez 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\XMLSpy2025\Documentation\Schema\SampleData
| Note : | afin d'utiliser une SPS pour générer une documentation de schéma, vous devez avoir installé StyleVision sur votre appareil. |