comments on CMIS v1.1 PR

[Robin Cover <robin@oasis-open.org>]

Two comments on the 30-day Public Review for CMIS v1.1 [1]

=========================================================

Need a (Normative) Reference for "the Orderly language"

=========================================================

With respect to Section 6 Conformance (Browser Binding, 

"CMIS Orderly Schema") and the presentation of content

in Appendix B:

----------------------------------------------------------------

Appendix B. Schema Language (Orderly)

We wish to thank Lloyd Hilaiel for his work in defining the

Orderly language, and express our gratitude for allowing

the use of Orderly in this specification.... Orderly is an

ergonomic micro-language that can represent a subset of

JSONSchema

B.3 A Non-Normative Tutorial

B.4 The Normative Grammar

Orderly_schema

----------------------------------------------------------------

It appears that the "CMIS Orderly Schema" (aka "Orderly_schema",

presented in the independent file "cmis-browserbinding.orderly"

http://docs.oasis-open.org/cmis/CMIS/v1.1/csprd01/schema/cmis-browserbinding.orderly

(cited there as "Browser Binding Schema)  is a "Normative Portion"

in the Work Product.  If so, the formal language used

(called "the Orderly language") needs to have a (Normative) Reference

in the Introductory content of the spec.  In the review spec, there is no

reference/citation for "the Orderly language" in Section 1.3 or 1.4

1.3 Non-Normative References 

http://docs.oasis-open.org/cmis/CMIS/v1.1/csprd01/CMIS-v1.1-csprd01.html#x1-40002

1.2 Normative References

http://docs.oasis-open.org/cmis/CMIS/v1.1/csprd01/CMIS-v1.1-csprd01.html#x1-50003

=========================================================

Identifiers for (Orderly) schema elements are broken

=========================================================

In Section 5.4 and perhaps other sections, the identifers

for the Orderly schema elements (using HTTP-scheme URIs)

are mostly broken in that they contain one or two (maybe

more) SPACE characters. The SPACE characters need to be

removed.

Examples (33 examples, partial listing)

5.4.1 Service URL

Schema Element: http://docs.oasis-open.org/ns/ cmis/browser/201103/repositories

5.4.2.1 Selector "repositoryInfo"

Schema Element: http://docs.oasis-open.org/ns/ cmis/browser/201103/repositories

5.4.2.2 Selector "typeChildren"

Schema Element: http://docs.oasis-open.org/ns/ cmis/browser/201103/typeList

5.4.2.3 Selector "typeDescendants"

Schema Element: http://docs.oasis-open.org/ns/ cmis/browser/201103/typeContainer

5.4.2.4 Selector "typeDefinition" [two SPACE characters]

Schema Element: http: //docs.oasis-open.org/ns/cmis/ browser/201103/typeDefinitionType

5.4.2.5 Selector "checkedOut"

Schema Element: http://docs.oasis-open.org/ns/ cmis/browser/201103/objectList

5.4.2.6 Action "createDocument"

Schema Element: http://docs.oasis-open.org/ns/ cmis/browser/201103/object

5.4.2.7 Action "createDocumentFromSource"

Schema Element: http://docs.oasis-open.org/ns/ cmis/browser/201103/object

5.4.2.8 Action "createRelationship"

Schema Element: http://docs.oasis-open.org/ns/ cmis/browser/201103/object

5.4.2.9 Action "createPolicy"

Schema Element: http://docs.oasis-open.org/ns/ cmis/browser/201103/object

5.4.2.10 Action "createItem"

Schema Element: http://docs.oasis-open.org/ns/ cmis/browser/201103/object

5.4.2.11 Action "bulkUpdate" [two SPACE characters]

Schema Element: <Array>http://docs.oasis-open. org/ns/cmis/browser/201103/ objectIdAndChangeToken

   

5.4.2.12 Selector "query"  [two SPACE characters]

Schema Element: http: //docs.oasis-open.org/ns/cmis/ browser/201103/queryResultList

5.4.2.13 Action "query"   [two SPACE characters]

Schema Element: http: //docs.oasis-open.org/ns/cmis/ browser/201103/queryResultList

5.4.2.14 Selector "contentChanges"

Schema Element: http://docs.oasis-open.org/ns/ cmis/browser/201103/objectList

5.4.2.15 Action "createType"  [two SPACE characters]

Schema Element: http: //docs.oasis-open.org/ns/cmis/ browser/201103/typeDefinitionType

5.4.2.16 Action "updateType"  [two SPACE characters]

Schema Element: http: //docs.oasis-open.org/ns/cmis/ browser/201103/typeDefinitionType

[5.4.2.17 Action "deleteType"

 Schema Element:  /* none provided */  ]

5.4.2.18 Selector "lastResult"

Schema Element: http://docs.oasis-open.org/ns/ cmis/browser/201103/transaction

5.4.3.1 Selector "children"  [two SPACE characters]

Schema Element: http: //docs.oasis-open.org/ns/cmis/ browser/201103/objectInFolderList

5.4.3.2 Selector "descendants"   [two SPACE characters]

Schema Element: <Array>http: //docs.oasis-open.org/ns/cmis/ browser/201103/objectContainer

5.4.3.3 Selector "folderTree"  [two SPACE characters]

Schema Element: <Array>http: //docs.oasis-open.org/ns/cmis/ browser/201103/objectContainer

5.4.3.4 Selector "parent"

Schema Element: http://docs.oasis-open.org/ns/ cmis/browser/201103/object

5.4.3.5 Selector "parents"  [two SPACE characters]

Schema Element: <Array>http: //docs.oasis-open.org/ns/cmis/ browser/201103/objectParent

5.4.3.6 Selector "checkedout"

Schema Element: http://docs.oasis-open.org/ns/ cmis/browser/201103/objectList

5.4.3.7 Action "createDocument"

Schema Element: http://docs.oasis-open.org/ns/ cmis/browser/201103/object

5.4.3.8 Action "createDocumentFromSource"

Schema Element: http://docs.oasis-open.org/ns/ cmis/browser/201103/object

5.4.3.9 Action "createFolder"

Schema Element: http://docs.oasis-open.org/ns/ cmis/browser/201103/object

5.4.3.10 Action "createPolicy"

Schema Element: http://docs.oasis-open.org/ns/ cmis/browser/201103/object

5.4.3.11 Action "createItem"

Schema Element: http://docs.oasis-open.org/ns/ cmis/browser/201103/object

5.4.3.12 Selector "allowableActions"  [two SPACE characters]

Schema Element: http: //docs.oasis-open.org/ns/cmis/ browser/201103/allowableActions

5.4.3.13 Selector "object"

Schema Element: http://docs.oasis-open.org/ns/ cmis/browser/201103/object

5.4.3.14 Selector "properties"

Schema Element: http://docs.oasis-open.org/ns/ cmis/browser/201103/properties

*** Stopped checking/listing here; similar errors in sections 5.4.3.15 and following

[1]  30-day Public Review for CMIS v1.1

     Content Management Interoperability Services (CMIS) Version 1.1

     Committee Speci?cation Draft 01 / Public Review Draft 01 

     https://lists.oasis-open.org/archives/tc-announce/201209/msg00003.html

     10 September 2012 and ends 10 October 2012

-- 
Robin Cover
OASIS, Director of Information Services
Editor, Cover Pages and XML Daily Newslink
Email: robin@oasis-open.org
Staff bio: http://www.oasis-open.org/people/staff/robin-cover
Cover Pages: http://xml.coverpages.org/
Newsletter: http://xml.coverpages.org/newsletterArchive.html
Tel: +1 972-296-1783