2009-08-11 7 views
2

Nous travaillons sur un schéma pour un client, et nous voulons qu'il soit en mesure de le revoir afin que Tyne puisse le comprendre. Ils ne sont pas "non techniques", mais un fichier de schéma ou un grand diagramme semble très inamical à l'intention de quelqu'un qui apprend ce qu'il contient. Plus tard, d'autres développeurs vont devoir apprendre à utiliser le schéma, et un système de documentation décent serait bon.Quelle est la meilleure façon de permettre à un client d'examiner un schéma XML?

Existe-t-il un outil ou un diagramme ou un outil similaire utile? Comment gérez-vous cette situation? Que recommandez-vous?

Répondre

2

Avez-vous un exemple d'utilisation de tous vos éléments de schéma qui aurait du sens pour l'entreprise. Je présenterais l'exemple et ensuite montrer la structure - peut-être avec un diagramme de style XML Spy. Le plaisir de XML est qu'il est supposé être auto-documenté, donc à condition d'avoir utilisé des noms appropriés dans votre XSD, il devrait être raisonnablement facile à comprendre.

alt text http://www.syntel.nl/fintegrator/swift/swift/mt940/mt940_p4.png

+0

Le schéma que nous obtenons est trop gros pour tenir sur une seule feuille. Je note que votre diagramme a un peu de '+' qui implique que vous le présentez en segments. Cela pourrait être raisonnable. – mj2008

+0

Oui, il est préférable de créer des types complexes pour chacune des principales pièces réutilisables (par exemple, une structure d'adresse), puis de réutiliser ces types là où ils doivent aller. Ces petites pièces devraient être plus faciles à valider que la validation de l'ensemble du schéma en une seule fois. – pjp

+0

@pjp: Je suis curieux: votre schéma ci-dessus a-t-il une récursivité? c'est-à-dire un ComplexType X qui quelque part à l'intérieur contient un élément de ce même complexType X? par exemple. Une séquence (ci-dessus) peut inclure un autre CustomerStatementMessage. Je me demande aussi si vous pourriez savoir où je pourrais trouver des exemples de schéma du monde réel? (Je fais un outil lié au schéma, et il aide à l'optimiser pour les cas courants). Merci pour toute aide! – 13ren

Questions connexes