Bug #2568
closed
Inconsistent naming of "method"(s) element
Added by Will Tyburczy about 18 years ago.
Updated almost 16 years ago.
Category:
eml - general bugs
Description
The "method" element of the entity (dataTable) and attribute elements should have the same name as the "methods" element at the dataset level.
targeting for 2.1.0, although may drop back to unspecified.
schema bugs targeted for 2.1.0 set to P1
The methodsType elements are children of <methods> or <method> elements in several mnodules:
eml-attribute.xsd:
<xs:element name="method" type="md:MethodsType" minOccurs="0">
eml-dataset.xsd:
<xs:element name="methods" type="md:MethodsType" minOccurs="0">
eml-entity.xsd:
<xs:element name="method" type="md:MethodsType" minOccurs="0">
eml-methods.xsd:
<xs:element name="methods" type="MethodsType">
the xpaths in instance documents:
eml/dataset/methods
eml/dataset/dataTable/method
eml/dataset/dataTable/attributeList/attribute/method
the declarations will be standardized to
<xs:element name="methods" type="md:MethodsType" ...>
for these reasons:
1. the type is called MethodsType (plural) in the imported methods module,
2. it can be composed of multiple <methodStep> elements (or other) children,
3. use of a plural noun is common common practice in XML to contain multiple singular children of the same noun, which means that if the methods module is expanded in the future, <method> children (singular) could be inserted to contain the <methodStep>s
don't close this bug till you update the pngs for:
dataTable
entity
spatialRaster
spatialVector
storedProcedure
view
all these ref the EntityGroup (changed in rev 1.86)
this is done, except for the documentation PNGs, which are now all listed in bug #3600. so this one can be closed.
Just adding a summary of what Jing and I found for method/s declarations:
These 2 were already declared as "methods" and dont need to be changed:
eml-dataset.xsd: <xs:element name="methods" type="md:MethodsType" minOccurs="0">
eml-methods.xsd: <xs:element name="methods" type="MethodsType">
This path need to be changed: attribute/method
eml-attribute.xsd: <xs:element name="method" type="md:MethodsType" minOccurs="0">
and those that use the EntityGroup:
otherEntity/method
dataTable/method
spatialRaster/method
spatialVector/method
view/method
eml-entity.xsd: <xs:group name="EntityGroup">
eml-entity.xsd: <xs:element name="method" type="md:MethodsType" minOccurs="0">
eml-dataTable.xsd: <xs:group ref="ent:EntityGroup"/>
eml-entity.xsd: <xs:group ref="EntityGroup"/>
eml-spatialRaster.xsd: <xs:group ref="ent:EntityGroup"/>
eml-spatialVector.xsd: <xs:group ref="ent:EntityGroup"/>
eml-storedProcedure.xsd: <xs:group ref="ent:EntityGroup"/>
eml-view.xsd: <xs:group ref="ent:EntityGroup"/>
Original Bugzilla ID was 2568
Also available in: Atom
PDF