CMIS 1.0 has been ratified for over a year and is proving to be incredibly useful and popular. What now? Come and learn what the CMIS Technical Committee is focused on for the next version of the specification. We will discuss new features including Content Type Mutability, Repository Extensions, the new Browser Binding, Secondary Object Types (such as Aspects), Retention and Legal Hold Policies, and Tagging. We will lend an eye to the future to review other possible features and invite the audience to suggest what they feel the specification lacks.
4. Whatʼs Happened?"
Development
CMIS
1.0
Plug-‐Fest
in
May
started
by
EMC,
released
for
TC
working
on
IBM
&
Microso@
public
comment
CMIS
1.1
2006
2008
2009
2010
2011
IniAal
Proposal
CMIS
1.0
SubmiEed
to
OASIS
RaAfied
in
May
and
TC
formed
5. Whatʼs Happened?"
Original Goals and Scope
• Enable applications to target different ECM repositories uniformly"
• Provide a set of basic services enabling richer ECM applications
and use cases"
• Allow for loose coupling of an ECM application and the underlying
repository"
• Use popular protocol bindings"
• REST / AtomPub"
• Web Services / SOAP"
Were we successful?
6.
7. Whatʼs Happened?"
Current State of the CMIS Ecosystem
• Implemented by every major ECM repository vendor"
• More than 50 CMIS applications"
• Alfresco is leading the charge"
Providers
Consumers
10. Whatʼs Happened?"
• Highlighted as an open source option for provider and consumer
implementers"
• Top-level Apache project"
• Client libraries / APIʼs"
• Java (OpenCMIS)"
• .NET (DotCMIS)"
• PHP (CMIS PHP Client)"
• Python (cmislib)"
• CMIS Workbench: graphical client, groovy console"
• OpenCMIS Server – interfaces to implement for a java provider"
11. Whatʼs Happened?"
State of the CMIS Technical Committee (TC)"
• CMIS 1.0 errata – Vote just passed; Needs to be published"
• CMIS Technical Committee working on CMIS 1.1"
• Already talking about issues and ideas for CMIS 2.0"
14. CMIS Refresher"
Repository
• Contains folders, documents and other objects"
• Must provide all basic services in the CMIS specification"
• Must provide REST and SOAP bindings"
• Advertises capabilities through a service"
15. CMIS Refresher"
Object Types
• Stricly-typed data model"
• Each object has an object type"
• Four base object types:"
• Document, Folder, Relationship & Policy"
• Base types may have sub-types"
16. CMIS Refresher"
Properties
• All objects have properties"
• A property holds zero to many typed values"
• Property definitions have attributes"
• Common attributes e.g. ID, PropertyType, Cardinality"
• Property type specific attributes e.g. precision for decimals"
• Property data types"
• String, Boolean, Decimal, Integer, Datetime, Id, Uri and Html"
17. CMIS Refresher"
Documents
• Instance of the document base type or sub-type"
• Documents have properties and optionally a content stream and
renditions"
• Content streams are normally set and retrieved in separate operations"
• Documents may be versionable"
18. CMIS Refresher"
Folders
• Folders can contain folders and documents"
• Any other kind of object that is declared to be fileable"
• Folders cannot have more than one parent folder"
• Folders can decide what types they contain"
• A folder can specify it may only contain document of a given content type"
• Documents may optionally be unfiled"
• Documents may optionally belong to multiple folders"
19. CMIS Refresher"
Relationships
• A directional relationship between any two objects"
• An object can have any number of relationships including with
itself"
• A relationship has a source and target but this ʻdirectionʼ has no
CMIS-defined semantics"
• Referential integrity is not enforced"
• When the relationship is created, both end-points must exist"
• Repository support for relationships is optional"
20. CMIS Refresher"
Policies
• An administrative policy that can be enforced by a repository"
• Used to manage objects in ways that are, by themselves, outside
the scope of CMIS"
• Such as records retention"
• policyText property contains the details of the policy"
• Policy text is opaque to the CMIS repository"
• Repository support for policies is optional"
21. CMIS Refresher"
Access Control
• Permission"
• An allowed action (read, write, all)"
• Mapping to allowed actions is repository specific and discoverable"
• Principal – a user or a group"
• Access Control Entry (ACE)"
• One or more permissions granted to a Principal"
• Access Control List (ACL)"
• A collection of ACEʼs"
• Can be assigned to an object and can be propagated"
• Repository support for Access Control is optional"
22. CMIS Refresher"
Versioning
• A document may be versioned as indicated by the type definition"
• Versions represent the properties and content of a document at a
given point in time"
• All versions of a document collectively define its Version Series"
• CheckOut creates a Private Working Copy which can be edited
and checked in"
23. CMIS Refresher"
Query
• Based on well known standard – SQL-92"
• With ECM extensions added"
• Each type is treated as a logical relational table"
• Joins may be supported"
• Either inner, or both inner and outer joins"
• Repository specific behavior"
• Query supports metadata and/or full-text"
• Repository support for full-text search is optional"
24. CMIS Refresher"
Services
• Eight sets of services:"
• Repository, Object, Discovery, Navigation, Versioning, Relationship, Policy
and ACL"
• Support for create, read, update and delete operations for various
types"
• Some examples:"
• Repository Services: getRepositories, getRepository, getTypeDefinition"
• Navigation Services: getChildren, getFolderParent, getObjectParents"
• Object Services: createDocument, createFolder, getObject,
getObjectByPath, getContentStream, deleteObject"
• Versioning Servcies: checkOut, cancelCheckOut, checkIn, getAllVersions"
25. CMIS Refresher"
Protocol Bindings
• Providers must implement RESTful AtomPub and SOAP"
RESTful AtomPub
• Feeds, entries & links"
• GET, POST, PUT, DELETE"
• Example: createDocument by POST to parent folderʼs collection"
• Recommend HTTP Basic Authentication"
Web Services
• SOAP"
• WSDL and XSD are defined in the specification"
• Recommend Basic Authentication and WS Security
UsernameToken"
27. Coming Soon – CMIS 1.1"
Browser Binding – CMIS-719
• Designed to allow developers to build browser based applications"
• Use already understood technologies including"
• HTML, HTML Forms, JavaScript and JSON"
• Does not require a JavaScript library"
• Optimized for use in a browser, also useful for HTTP based
bindings for other application types"
28. Coming Soon – CMIS 1.1"
Browser Binding – CMIS-719
• HTTP Protocol"
• Predictable URLʼs"
• JSON Data Representation"
• Described by orderly: http://orderly-json.org"
CMIS
JSON
String
string
Boolean
boolean
Decimal
number
Integer
number
DateAme
number
(milliseconds
since
1970/01/01,
UTC)
Uri
string
Id
string
Html
string
29. Coming Soon – CMIS 1.1"
Browser Binding – CMIS-719
• Uses HTTP GET and POST exclusively"
• HTML forms used to POST content must include “cmisaction” to describe
the action to perform e.g. createDocument, createFolder, etc."
• Various controls specified per operation"
• Details here:"
• http://bit.ly/tlACld"
30. Demo!"
Browser Binding in Alfresco
• More efficient than Web Services and
the AtomPub binding"
• Try it! http://cmis.alfresco.com/"
• JSONView Firefox extension"
• Alfresco Community 4.0b"
31. Coming Soon – CMIS 1.1"
Type Mutability – CMIS-669
Use Cases
• CMIS Application needs to install its own metadata and uninstall if
removed"
• CMIS Repository migration application would not only migrate
documents from one repository to another; but would be able to
migrate and preserve the metadata as well"
• General purpose Administration applications that allow
administrators to edit metadata for new systems"
32. Coming Soon – CMIS 1.1"
Type Mutability – CMIS-669
Requirements
• Must be optional and backward compatible with 1.0"
• Must be implemented in a way such that is it obvious to someone
familiar with CMIS 1.0 how these operations would be
implemented"
• POST to the ʻTypes Childrenʼ collection creates a new type, etc."
• Must allow an application to setup new types with associated new
properties"
• Optionally allows an application to delete types it has created"
• Exposed schema changes will be confined to a small footprint"
• A Type Mutability aware CMIS 1.1 client MUST work fine with a
CMIS 1.0 (non Type Mutability) aware server"
33. Coming Soon – CMIS 1.1"
Type Mutability – CMIS-669
• Discoverable Optional Capability exposed on a type"
• cmisTypeMutabilityCapabilitiesType enum"
• create (new child types), update, delete"
• New services: createType, updateType and deleteType"
• Details here:"
• http://bit.ly/v9zeYg"
34. Coming Soon – CMIS 1.1"
Secondary Object Types – CMIS-713
• Aspects!"
Use Cases
• Additional metadata has to be attached after the document has
been created"
• Adding a new set of properties is necessary for some business
cases"
• Some technical metadata derived from the content can only be
added after the repository has analyzed the content"
• Some common and crosscutting concepts such as tags, comments
and ratings can be implemented with secondary types."
• Secondary types and their properties can reveal and control the
status of an object. Examples are legal holds, workflows, storage/
archiving information, publishing information, etc."
35. Coming Soon – CMIS 1.1"
Secondary Object Types – CMIS-713
• New base type: cmis:secondary "
• Other base types have new attribute:
cmis:secondaryObjectTypeIds "
• Added to updateProperties and checkIn services"
• Properties are returned via query operations"
• Can be filtered using property filter syntax"
• Details here:"
• http://bit.ly/syhlzW"
36. Coming Soon – CMIS 1.1"
Approved
• CMIS Repository Extensions (CMIS-693)"
• Allow Creation of Unfiled Documents with AtomPub (CMIS-711)"
• Description Property for all Base Types (CMIS-712)"
• Retention & Hold (CMIS-714)"
• Currently proposed to split these into separate proposals"
37. Coming Soon – CMIS 1.1"
Under Consideration
• External Content Reference (CMIS-705)"
• Batch Operations (CMIS-727)"
• Is PWC the latest version? (CMIS-728)"
• Query Wildcard Clarification (CMIS-729)"
41. CMIS implementation is based on OpenCMIS"
Why has it been re-implemented?
• OpenCMIS is used by several CMIS repositories.
Alfresco automatically benefits from all bug fixes and
improvements."
• One code base for the AtomPub and the Web Services binding
(and the Browser Binding)."
• Better CMIS specification compliance."
• Better performance, less memory consumption,
handling of big documents."
42. CMIS implementation is based on OpenCMIS"
How does this affect CMIS clients?
• New URLs…"
• The old implementation and URLs will be available but are deprecated."
• Specification compliant, generic CMIS clients shouldnʼt see a difference."
• Aspects and the Alfresco OpenCMIS Extension work as before."
• If the CMIS Client make any assumptions about the format the
object id, it has to change! (See next slides.)"
43. CMIS Document IDs in Alfresco 4"
Alfresco 3.X Object Ids:
• Current version document id: "node ref
workspace://SpacesStore/e5787fce-7583-4b74-8836-8dcc94df4493!
• Version document id: current version node ref + “;” + version label
workspace://SpacesStore/e5787fce-7583-4b74-8836-8dcc94df4493;1.0!
• The creation of a new version doesnʼt change the current version
document id. Not spec compliant!!
• A client must not assume that a document id always represents the
current version!"
44. CMIS Document IDs in Alfresco 4"
Alfresco 4.X Object Ids:
• Current version document id: "node ref + “;” + version label
workspace://SpacesStore/e5787fce-7583-4b74-8836-8dcc94df4493;1.1!
• Version document id: current version node ref + “;” + version label
workspace://SpacesStore/e5787fce-7583-4b74-8836-8dcc94df4493;1.0!
• The creation of a new version changes the current version document id.
Spec compliant!!
• General advice: Treat the object id as an opaque string."
45. OpenCMIS client available in web scripts"
Use case examples:
• Alfresco Share mashups and federated queries"
• Synchronize documents between repositories"
• Publishing scenarios"
• Simple migration scenarios"
46. OpenCMIS client available in web scripts"
New JavaScript top level object: cmis
• This object manages connections to CMIS servers."
• Three connection types:"
• Current Alfresco server (uses OpenCMIS local binding if possible)"
• Preconfigured connection"
• Web script configured connection"
var cmisConnection = cmis.getConnection(myConnectionId);
var cmisSession = cmisConnection.getSession();
model.folder = cmisSession.getRootFolder();
model.children = model.folder.getChildren().iterator();