2012-10-02 1 views
0

XML 스키마 파일을 문서화하라는 요청을 받았습니다. 각 스키마 요소에 대한 비즈니스 및 기술 설명을 포함해야합니다. 우리의 가이드 라인과 W3C XML Schema 권고안을 살펴보면, 가장 좋은 방법이 정확히 무엇인지 궁금해합니다.XML 스키마 디자인 - <xs : documentation> 원본 속성 값

우리의 가이드 라인은 주석 태그는 다음과 같은 형식을 가져야한다고 명시 :

<xs:annotation> 
    <xs:documentation source="BusinessDescription">This is the business description</xs:documentation> 
    <xs:documentation source="TechnicalDescription">This is the business description</xs:documentation> 
</xs:annotation> 

는 XML 포인트는 소스 속성이 유형을 사용해야한다고 "XS : 된 anyURI을". 분명히 "BuinessDescription"과 "TechnicalDescription"은 URI가 아니며 스키마 전체에서 수많은 반복됩니다. 따라서 의미 속성으로 source 속성을 사용하는 것이 실제로 옳은가?

XML 스키마에서 http://shop.oreilly.com/product/9780596002527.do Eric van der Vlist는 이것이 허용 가능하지만 상호 운용성 문제를 야기 할 수 있다고 설명함으로써이 견해와 모순된다는 제안을합니다.

답변

3

잘 알려진 표준 속성을 배제하는 대신 텍스트 대신 잘 형성된 xml을 넣을 수 있습니다. 거기에 노드가 <Business>This is the business...</Business><Technical>This is the technical....</Tecnhical> 있습니다.