G2 CR00151: modify design of XML Schema
IPTC G2-Standards: Change Request document
Title: modify design of XML Schema
Change Request number: G2 CR00151
Standard to be changed (delete the inappropriate ones): NewsML-G2
Standard’s version to be changed: 2.10
|Change Request History|
|2||2012-02-24||NAR-dev group: reviewed, disscussed and agreed|
Changes to existing documents/specifications are highlighted in yellow.
Editing notes for the spec documents are highlighted in cyan.
In drafts only: Text highlighted in magenta needs further discussion
Description of the change: (free-text)
The declaration of a couple of G2 XML elements is made "global".
Rationale for the change:
The NewsML-G2 specifications define in section 13.2.4 the Hint and Extension Points
To act as an Hint Point properties from the News Architecture for G2 namespace may be added.
The purpose of properties from the NAR namespace is to add a set of hints, i.e. properties which have to
comply with the structure of the G2 item target resource but do not have to be extracted from it. These
properties must be added this way:
- Immediate child properties of <itemMeta>, <contentMeta>, or <concept> - optionally with their
descendants - may be used directly under the extension point
- All other properties require the full path excluding only the item's root element.
In the XML Schema the Hint and Extension points define the processContent behaviour as "lax".
This requires that an element is declared at the top level of an XML Scheme to be validated in such a Hint and Extension Point.
In the XML Schema of NewsML-G2 2.10 a couple of elements representing a metadata property or wrapper of top level properties were found which do not comply with this rule, it was required to fix this by moving the declaration of these element to the top level making them global declarations.
Further it was discussed to make all elements representing a metadata property or wrapper of top level properties regardless of the impact from the Hint and Extension Point rules as this would help to adopt NewsML-G2 metadata properties for XML documents which are controlled by another XML Schema.
Reference to related IPTC discussion(s) (on Yahoo groups etc):
Postings with the subject “Problem with assert/type” and the notes of the 17 February confernce call on the NAR-dev Yahoo group.
Formalised change request:
To comply with the “immediate child” rule these elements need a top level = a global declaration:
- link (child of itemMeta)
- conceptId (child of concept)
- type (child of concept)
To comply with the “all other” rule these elements need a top level = a global declaration:
To make all top level elements of the G2 properties usable with "lax" Extension points these elements need a top level = a global declaration: