Discussion :

[Trublion]

Bonjour,

Je cherche des outils mais surtout des retours d'expérience sur les outils qui permettent de générer automatiquement la documentation d'un XSD (reprise de la structure, des cardinalités, etc sous une forme plus lisible que le XSD lui-même).

Par exemple on trouve plusieurs outils dans ce lien mais il y en a sûrement certains qui sont meilleurs que d'autres !

Mon environnement de travail est Windows Server 2003 et Visual Studio 2005, et il s'agit de documenter les xsd de mes projets BizTalk.

Merci d'avance

[Trublion]

Cette section du forum n'est sans doute pas très lue... Tant pis.

Pour ceux qui tomberait sur cette file, Liquid XML permet de générer très simplement de la documentation sous la forme HTML à partir d'un XSD. La restriction de la version gratuite peut facilement être contournée en éditant soi-même le schéma s'il y a des problèmes avec les clauses include/import.

Par ailleurs la "trial version" de stylus studio ne m'a pas convaincu.

Enfin j'ai abandonné l'idée d'utiliser DocFlex-DocLet par manque d'expérience du monde Java, donc malheureusement je ne sais même pas à quoi ressemble la documentation produite. S'il y a des avis la dessus je reste ouvert.

[Waldoo]

Bonjour,
Je découvre le langage XML et j'ai pu générer des fichiers XML d'exemple en se basant sur le XSD avec la version d'évaluation de LiquidXML.

Mais les fichiers XML sont peu "lisible" à l'oeil nu .
Par exemple, il est généré :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

<vehicule id="01" name="Voiture" power_hp="100" wheels="6" color="red">

Mais je voudrais qu'il génère:

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
 
<vehicule id="01">
   <name>Voiture</name>
   <power_hp>100</power_hp>
   <wheels>6</wheels>
   <color>red</color>
</vehicule>

Quand il y a 4 attributs, c'est encore lisible mais quand il y a 15 attributs pour l'élément vehicule c'est plus difficile


Y a t'il moyen que le logiciel inclue plus de sous-balise pour la lisibilité du XML ?

[thelvin]

Euh.... attributs et éléments ne sont pas interchangeables.

Le XSD, justement, indique si les données se mettent dans des attributs ou dans des éléments.
Par conséquent, un exemple créé à partir d'un XSD, va forcément faire ce que le XSD dit.
Si ça ne te plaît pas, c'est le XSD qu'il faut modifier.

Ceci étant dit, pour faire la même chose en plus lisible, il y aurait :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
<vehicule id="01"
  name="Voiture"
  power_hp="100"
  wheels="6"
  color="red"
  >

Je ne sais pas si Liquid XML propose une option pour ça. En général pas grand-chose ne le propose. Quand je le veux j'ai tendance à modifier moi-même un sérialiseur XML existant.

[Waldoo]

Euh.... attributs et éléments ne sont pas interchangeables.

Le XSD, justement, indique si les données se mettent dans des attributs ou dans des éléments.
Par conséquent, un exemple créé à partir d'un XSD, va forcément faire ce que le XSD dit.
Si ça ne te plaît pas, c'est le XSD qu'il faut modifier.

c'est moi qui ait confondu Attributs et éléments sous LiquidXML, tout est en ordre maintenant .

Merci