HomeGuidesRecipesAPI
HomeGuidesAPILog In
Guides
These docs are for v16. Click to read the latest docs for v31.

CMIS Connector

📘

Deployment Feature Availability

This feature is not available in CoLo deployment.

CMIS is an interoperability standard for content and document management systems which solves the problem of each vendor having their own API specification.

SmartIQ has a CMIS Connector type within the pure cloud multi-tenant environments. Made up of both an Action and Data Connection, the CMIS Connector allows an organization to connect to their enterprise document management system for the storage and retrieval of documents and records from any system which has implemented CMIS.

Components

Action

Data Connection

  • CMIS Data

Configuration

The CMIS Connector is configured centrally, via the Settings page in Manage > Settings > CMIS. The available options are summarized below.

Overrides for some of these options are available in the Save Document action.

SettingDescription
Host URLThe URL of the CMIS server's Atom bindings

Note: the CMIS version of the selected binding document needs to match with the selected "CMIS Version".
Service Account UsernameThe username of the service account to use for logging in to the CMIS server.
Service Account PasswordThe password of the service account to use for logging in to the CMIS server.
Default Repository IDThe default repository to use when communicating with the CMIS server.
CMIS VersionThe CMIS interface version to use. Accepted values are "1.1" and "1.0".
Debug ModeWhether to log detailed information for debugging purposes. If enabled, the messages are written to the Management console in Manage.
Where a network expection occurs, the status message returned may be explained in more detail in Microsoft's WebExceptionStatus documentation

Usage

Save Document Action

The Save Document action can be used to save one or more documents to the CMIS repository. A number of inputs are available to override the global settings.

InputDescriptionFormat
Access Control Entries (Principal:Permission)Permissions to grant to CMIS principals with respect to the document.

Note: There can only be one access control entry for a given Principal.
Key-value pairs; the key should be a CMIS PrincipalId and the value should be one of write, read, or all.
Document TypeThe CMIS type of the document. The default is cmis:document.
Metadata (parameter = value)Additional data (such as author, for example) to be stored as part of the document record.Key-value pairs; values for multi-value properties should be pipe-separated
Repository IDThe repository to use for saving the document. This is optional if a repository is set in the global settings.
Repository PathSpecifies the path within the repository at which the document should be stored.
Version StateThe version state in which to create the document record.Drop-down selection of Minor, Major, Checkout, or None.

Documents to be saved are supplied to the action by attaching them as Action Documents in Design. By default, the action will use all generated documents.

Update Document Action

The Update Document Action can be used to update one or more documents in the CMIS repository. A number of inputs are available to override the global settings.

InputDescriptionFormat
Access Control Entries (Principal:Permission)Permissions to grant to CMIS principals with respect to the document.

Note: There can only be one access control entry for a given Principal.
Key-value pairs; the key should be a CMIS PrincipalId and the value should be one of write, read, or all.
Document Id (Mandatory)Id of the document to update, which will be used to identify which document should be updated. The document type must have versioning for an update to work.
Document TypeThe CMIS type of the document. The default is cmis:document.
Metadata (parameter = value)Additional data (such as author, for example) to be stored as part of the document record. Names must match available metadata in the CMIS service.

Update has an additional metadata value of {skip}. If a metadata value is set to {skip}, no action is taken on update and allows users to skip updating values that have not changed.
Key-value pairs; values for multi-value properties should be pipe-separated
Repository IDThe repository to use for saving the document. This is optional if a repository is set in the global settings.
Repository PathDefault is root path (/), otherwise set to the folder path where content is to be saved.
Version StateThe version state in which to create the document record.Drop-down selection of Minor, Major, Checkout, or None (Default).

Data Connector

The CMIS Data Connector supports retrieving simple data about the connected CMIS repository. The available queries are:

  • List stored documents
  • List available folders
  • Fetch basic details for a document