Content Management Interoperability Services (CMIS) Version 1.1

B.3 A Non-Normative Tutorial
A collection of Non-normative examples of Orderly:
B.3.1
Comments and Whitespace
Orderly supports comments, comments are initiated with either '#' or '//' and continue to the first encountered
newline ('\n').
Orderly doesn't rely overmuch on whitespace, leaving the decision of how to format your schema up to you.
B.3.2
Property Names
Property names may be anything that is allowed inside JSON strings. Unlike JSON itself, however, Orderly
provides a shorthand that allows a subset of strings to be represented without quotes.
For instance these are all valid Orderly:
string foo;
string "foo";
string "this is a property name with spaces";
B.3.3
Common Properties
From the JSONSchema specification, four options exist which apply to all data types:
The optional property indicates a value which is not required in a conformant JSON instance. Optional
values are represented in Orderly with a trailing question mark:
string name;
string "name";
The requires property says that if a value is present in the instance JSON, another named value MUST also
be present. In Orderly a requirement on another type is expressed by placing the property name (optionally
quoted) enclosed in angle brackets at the end of a type definition:
string town ;
Multiple properties MAY be required, and SHOULD be separated with commas:
string town ;
The enum property specifies a set of allowable values for a key in the JSON document.
string mood [ "happy", "sad", "meh" ];
integer secretOfLife [ 7, 42 ];
In a JSONSchema document the default property specifies a default value for a property. One could imagine
that as an input object passes validation it will be automatically augmented with default values for required
properties missing in the instance object. The specification of default values in Orderly looks something like
assignment in most programming languages:
string mood [ "happy", "sad", "meh" ] = "happy"; # optimistically default to "happy"
CMIS-v1.1-csprd01
Standards Track Work Product
Copyright © OASIS Open 2012. All Rights Reserved.
18 August 2012
Page 319 of 331