18.01.2015 Views

Content Management Interoperability Services (CMIS) Version 1.1

Content Management Interoperability Services (CMIS) Version 1.1

Content Management Interoperability Services (CMIS) Version 1.1

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

a form. If the control value of an optional parameter is set to an empty string ("") the default value MUST be<br />

used.<br />

A client MAY add controls to a form that are not defined by <strong>CMIS</strong> as long as the control names don't conflict<br />

with the patterns described in this specification.<br />

Since control values are strings, all other data types have to be serialized to strings. The same rules that<br />

apply to the serialization to JSON apply here.<br />

5.4.4.1 Action<br />

An HTML form used to POST <strong>CMIS</strong> content MUST include a control named "cmisaction" that indicates the<br />

<strong>CMIS</strong> operation to be performed. See section 5.4 <strong>Services</strong> for valid control values. The value of the control<br />

is case insensitive.<br />

Example:<br />

<br />

5.4.4.2 Structured and Array Parameters<br />

Some <strong>CMIS</strong> operations require structured parameters and arrays of values. Since HTML forms don't support<br />

that usage, some <strong>CMIS</strong> operation parameters are split into multiple controls in a form.<br />

For example, a <strong>CMIS</strong> property is split into a control that holds the property id and another control that hold<br />

property value. The association between the two controls is done by convention.<br />

The entirety of all properties is made up of an array of these property controls.<br />

Names of controls that are part of an array end with "[]" where is a positive integer.<br />

Arrays MUST always start with the index 0 and MUST be gapless.<br />

Example:<br />

An array of three properties looks like this in a HTML form:<br />

<br />

<br />

<br />

<br />

<br />

<br />

If a client sends invalid, incomplete or inconsistent data the repository SHOULD throw an invalidArgument<br />

exception.<br />

5.4.4.3 <strong>CMIS</strong> Controls<br />

This section lists all HTML form controls used by <strong>CMIS</strong> services.<br />

5.4.4.3.1 Succinct<br />

This flag indicates that the property presentation must be succinct. See section 5.2.11 Succinct Representation<br />

of Properties.<br />

Control name:<br />

Control value:<br />

succinct<br />

"true" or not set<br />

<strong>CMIS</strong>-v<strong>1.1</strong>-csprd01<br />

Standards Track Work Product<br />

Copyright © OASIS Open 2012. All Rights Reserved.<br />

18 August 2012<br />

Page 298 of 331

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!