CMIS connectors

Bonita native CMIS connectors allow to connect Bonita processes to content management systems.

Overview

Content Management Interoperability Services (CMIS) is an open standard that allows different content management systems to inter-operate over the Internet.

CMIS provides a common data model covering typed files and folders with generic properties that can be set or read. There is a set of services for adding and retrieving documents ('objects'). There may be an access control system, a checkout and version control facility, and the ability to define generic relations.

Two protocol bindings are defined, one using WSDL and SOAP and another using REST, using the AtomPub convention. The model is based on common architectures of document management systems.

Bonita Studio contains the following CMIS connectors:

Upload a new version
Upload a document
Create a folder
Delete a document version
Delete a folder
Delete a document

If you have processes that use CMIS connectors from previous versions, these connectors will no longer work. You need to update the configuration of each connector, including any scripts that construct the URLs used.

Alfresco specific configuration for document versioning

Document versioning is disabled by default in Alfresco.

If you wish to use the "Upload a new version" connector to upload a new document version, you will have to enable document versioning following the official Alfresco documentation.

If this configuration is not set, new versions of documents will overwrite previous ones.

Example: How to upload a document

In the Connector list window:
- Select the CMS/CMIS connector category.
- Select the Upload a document connector.
- Click Next.
In the General window:
- Enter a name.
- Click Next.
In the Server window, enter the information necessary to connect to the repository:
- Username and password
- Repository name (for example Main Repository)
- Binding type: webservices (or atompub)
- The URL (server address) for the atompub binding if it is used
- If using webservices, there are four new URLs:
  - RepositoryService, for example https://localhost:12345/alfresco/cmis/RepositoryService?wsdl
  - RepositoryService endpoint
  - ObjectService, for example https://localhost:12345/alfresco/cmis/ObjectService?wsdl
  - ObjectService endpoint
- Click Next.
In the Document window:
- Enter the Document name of the document to upload.
- Enter the relative or absolute path to the Parent folder that contains the document.
- Enter the Destination name to be assigned to the document after it is uploaded.
- Click Next.
In the Output operations window:
- You can store the returned document_id in a variable.
- Click Finish.

Example: Creating a folder on Alfresco

This example presents the creation of a folder on a local installation of Alfresco 5.0 with a CMIS connector configured with AtomPub.

In the Connector list window:
- Select the CMS/CMIS connector category.
- Select the Create a folder connector.
- Click Next.
In the General window:
- Enter a name.
- Click Next.
In the Server window, enter the information necessary to connect to the repository:
- Username and password
- Repository name: -default-
- Binding type: atompub
- URL: http://localhost:8080/alfresco/api/-default-/public/cmis/versions/1.1/atom/
- Click Next.
In the Folder window, enter the location and name of the folder you wish to create:
- Parent folder: / (root folder)
- Folder name: bonita
- Click Next.
In the Output operations window:
- You can store the returned folder_id in a variable.
- Click Finish.