NCEAS / z-test-issues

Test issue imports from redmine
0 stars 0 forks source link

eml not valid is xmlSpy versions 2006+, eml-text and eml-documentation #419

Closed mbjones closed 7 years ago

mbjones commented 7 years ago

Author Name: Margaret O'Brien (Margaret O'Brien) Original Redmine Issue: 2703, https://projects.ecoinformatics.org/ecoinfo/issues/2703 Original Date: 2006-12-15 Original Assignee: Matt Jones


This is NOT a duplicate of bug 2054.

These changes are needed to make eml validate in xmlSpy2006+: eml-text.xsd:

=> add mixed="true" and to the choice of this complexType add minOccurs="0" eml-documentation.xsd: add elementFormDefault="qualified" to the root-element History: Some folks who have newer versions of xmlSpy (2006, 2007) were not able to validate eml documents. The failures are mysterious and variable. Validating eml.xsd is successful, but when validating a data package, Spy replies that the schema is invalid. It usually fails in eml-view, but also occasionally in eml-project, or eml-software. Initially, Altova tech support said that it was a bug in Spy. They recently changed their tune, and suggested the above changes to our schema. With these changes, local copies of EML can now be validated in Spy2007. Altova did not quote the parts of the xml specification relating to this error. Given the error messages from Spy, I was not able to see where eml failed to comply with the xml specs. I have put the email trail with error messages at the url above, if that helps anyone else get to the bottom of this. It could be that this xmlSpy behavior is still a defect in the software, and that eml schema is valid as is, and that tech support is just trying to shut me up. Relationships to other bugs: 1. It's possible that this was part of the behavior that Inigo reported in bug #2479, or described in emails to eml-dev. 2. This is not related to bug 2054, in which eml.xsd failed due to the element in additionalMetadata. That failure was noticed first in xmlSpy2005, whereas this behavior first appeared with Spy2006.
mbjones commented 7 years ago

Original Redmine Comment Author Name: Margaret O'Brien (Margaret O'Brien) Original Date: 2007-04-03T19:26:58Z


Bug 2704 has been marked as a duplicate of this bug.

mbjones commented 7 years ago

Original Redmine Comment Author Name: Margaret O'Brien (Margaret O'Brien) Original Date: 2007-04-03T19:30:06Z


Bug 2705 has been marked as a duplicate of this bug.

mbjones commented 7 years ago

Original Redmine Comment Author Name: Margaret O'Brien (Margaret O'Brien) Original Date: 2008-02-08T01:25:31Z


from INigo and Margaret: EML uses some parts of DocBook schema (eg. and children). Some of these are generating the parsing errors in XMLSpy 2006+. For example, in eml.xsd, there are these lines inside :

The Dublin Core Metadata Initiative

So it seems that there are 2 choices for the short term:

  1. take all the ulink, citetitle, and other offending tags out of eml documentation
  2. add these elements in as children of para

We could consider adding these back (and maybe more?) docBook elements later (i.e., 2.1+)

mbjones commented 7 years ago

Original Redmine Comment Author Name: Margaret O'Brien (Margaret O'Brien) Original Date: 2008-03-21T22:25:19Z


From Chris and Margaret: With respect to the docbook elements that contribute to this bug in eml-text.xsd, we looked into the status of the DocBook schema. We discovered that as of March 2008, there is a committee draft for DocBook schema v5. It appears to be a complete refactoring of v4 (the dtd), and introduces many backward incompatibilities. Although EML is not terribly dependent on v4, importing this schema is likely to be outside the scope of eml-2.0.2, but might be considered in the future.

current specification http://www.docbook.org/specs/docbook-5.0-spec-cd-03.html development history http://www.docbook.org/specs/

mbjones commented 7 years ago

Original Redmine Comment Author Name: Margaret O'Brien (Margaret O'Brien) Original Date: 2008-03-25T18:43:03Z


This is a summary of the fixes reported necessary by Inigo in his email to eml-dev (2008-02-27). Probably this list could be split into multiple bugs. Most schema docs are affected, and many also affect instance docs.

a. => add mixed="true"

b. and to the choice of this complexType add minOccurs="0"

c. eml-documentation.xsd: add elementFormDefault="qualified" to the root-element

1 - : unexpected under in eml.xsd and elsewhere--> add element , and child tag () to the element (in eml-text.xsd), following the "docBook" model.

2 - : no more elements under --> close element before we open s (group was not nested appropriately in eml.xsd)

3 - : further elements required under element in about ALL *.xsd files ---> added

group following and corresponding closing elements.

4 - : further elements required under element in most of *.xsd files --> added

group inside and corresponding closing elements.

5 - : empty element in "methods description" eml-entity.xsd --> entry deleted

6 - : element not allowed under element

in eml-attribute.xsd --> removed and corresponding closing element

7 - : element opened after <para> group, not allowed ---> closed </section>, reopen <section>, then <title> is OK. (so, added </section><section> before <title>)</p> <p>8 - new soft-complain: namespaces added for "coverage" in eml-dataTable.xsd</p> <p>9 - : many empty <doc:description/> elements in eml-spatialRaster.xsd ---> Many elements removed or filled with "summary" content</p> <p>10 - : many empty <doc:description/> elements in eml-spatialReference.xsd ---> Many elements <doc:description> filled with preceeding "<doc:summary>" content</p> <p>11 - : many empty <doc:description/> elements in eml-spatialVector.xsd ---> Many elements <doc:description/> removed from eml-spatialVector.xsd </p> </div> </div> <div class="comment"> <div class="user"> <a rel="noreferrer nofollow" target="_blank" href="https://github.com/mbjones"><img src="https://avatars.githubusercontent.com/u/766407?v=4" />mbjones</a> commented <strong> 7 years ago</strong> </div> <div class="markdown-body"> <hr /> <p>Original Redmine Comment Author Name: <strong>Margaret O'Brien</strong> (Margaret O'Brien) Original Date: 2008-03-31T21:56:14Z</p> <hr /> <p>These are the changes required to fix bug 2703 (disregard list from previous comment):</p> <ol> <li>eml-documentation.xsd: elements moduleName, moduleDescripiton, recommendedUsage, standAlone should be set to form="qualified" </li> <li>eml-text.xsd: add mixed="true" to the definition of txt:TextType</li> <li>eml-text.xsd: the <para> and <section> elements must be optional (minOccurs="0" maxOccurs="unbounded")</li> <li>eml-text.xsd: add a child element to para: <ulink></li> <li>eml-text.xsd: add a child element to para: <citetitle></li> <li>eml-text.xsd: change element <sidebar> to <section></li> </ol> <p>The schema now validates in xmlSpy2007 at the W3C, everywhere. <a href="http://www.w3.org/2001/03/webdata/xsv">http://www.w3.org/2001/03/webdata/xsv</a> For a version of the XSV validator which can be added to the oxygen editor, see: <a href="http://www.oxygenxml.com/doc/ug-standalone/custom-validation.html">http://www.oxygenxml.com/doc/ug-standalone/custom-validation.html</a></p> </div> </div> <div class="comment"> <div class="user"> <a rel="noreferrer nofollow" target="_blank" href="https://github.com/mbjones"><img src="https://avatars.githubusercontent.com/u/766407?v=4" />mbjones</a> commented <strong> 7 years ago</strong> </div> <div class="markdown-body"> <hr /> <p>Original Redmine Comment Author Name: <strong>Margaret O'Brien</strong> (Margaret O'Brien) Original Date: 2008-03-31T22:41:38Z</p> <hr /> <p>small correction to fixes for 2703: the offending tag <sidebar> appears in the attribute schema, not eml-text.xsd</p> <ol start="6"> <li>eml-attribute.xsd: change element <sidebar> to <section></li> </ol> </div> </div> <div class="comment"> <div class="user"> <a rel="noreferrer nofollow" target="_blank" href="https://github.com/mbjones"><img src="https://avatars.githubusercontent.com/u/766407?v=4" />mbjones</a> commented <strong> 7 years ago</strong> </div> <div class="markdown-body"> <hr /> <p>Original Redmine Comment Author Name: <strong>Margaret O'Brien</strong> (Margaret O'Brien) Original Date: 2008-09-22T17:10:19Z</p> <hr /> <p>changing status to "fixed"</p> </div> </div> <div class="comment"> <div class="user"> <a rel="noreferrer nofollow" target="_blank" href="https://github.com/mbjones"><img src="https://avatars.githubusercontent.com/u/766407?v=4" />mbjones</a> commented <strong> 7 years ago</strong> </div> <div class="markdown-body"> <hr /> <p>Original Redmine Comment Author Name: <strong>Redmine Admin</strong> (Redmine Admin) Original Date: 2013-03-27T21:21:03Z</p> <hr /> <p>Original Bugzilla ID was 2703</p> </div> </div> <div class="page-bar-simple"> </div> <div class="footer"> <ul class="body"> <li>© <script> document.write(new Date().getFullYear()) </script> Githubissues.</li> <li>Githubissues is a development platform for aggregating issues.</li> </ul> </div> <script src="https://cdn.jsdelivr.net/npm/jquery@3.5.1/dist/jquery.min.js"></script> <script src="/githubissues/assets/js.js"></script> <script src="/githubissues/assets/markdown.js"></script> <script src="https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11.4.0/build/highlight.min.js"></script> <script src="https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11.4.0/build/languages/go.min.js"></script> <script> hljs.highlightAll(); </script> </body> </html>