Content Management Interoperability Services (CMIS) connector overview (SharePoint Server 2010)

Applies to: SharePoint Server 2010

This article describes the Content Management Interoperability Services (CMIS) connector for Microsoft SharePoint Server 2010, which enables SharePoint users to interact with content that is stored in any repository that has implemented the CMIS standard. The connector also makes SharePoint Server 2010 content available to any application that has implemented the CMIS standard. The CMIS connector is available as part of the SharePoint 2010 Administration Toolkit. For more information, see SharePoint 2010 Administration Toolkit (SharePoint Server 2010).

The CMIS connector for SharePoint Server 2010 includes two features:

• The Content Management Interoperability Services (CMIS) Consumer Web Part

• The Content Management Interoperability Services (CMIS) Producer

In this article:

• About the CMIS standard and specification

• About the CMIS Producer and CMIS Consumer Web Part

• Installing and configuring CMIS connectors

• Bindings and permissions

• Mapping the CMIS data model to SharePoint concepts

About the CMIS standard and specification

CMIS is a Web services standard that allows content-enabled applications to interact seamlessly with any application that has implemented it. By providing access to multiple repositories with the CMIS Producer and consuming and rendering the data the CMIS Consumer Web Part, SharePoint Server 2010 becomes a CMIS-compliant system that interoperates with any platform that has implemented the CMIS standard.

The CMIS interface can be layered on top of an existing Content Management System (CMS) and its programming interfaces. It defines a universal, generic set of capabilities provided by a CMS and a set of services designed to work with those capabilities. The standard is not intended to prescribe how specific features should be implemented within those CMS, and is not intended to exhaustively expose all of the system's capabilities through the CMIS interfaces. For more information, see the Content Management Interoperability Services (CMIS) Version 1.0 specification (https://go.microsoft.com/fwlink/p/?LinkId=199562).

About the CMIS Producer and CMIS Consumer Web Part

The CMIS connector in the Toolkit is made up of two components:

• The Content Management Interoperability Services (CMIS) Consumer Web Part, which can be added to any SharePoint page. This Web Part displays and lets users interact with the contents of any CMIS-compliant repository.

• The Content Management Interoperability Services (CMIS) Producer, which allows applications to interact with SharePoint lists and document libraries programmatically by using the interfaces that are defined in the CMIS standard.

When these components are installed on SharePoint Server 2010, the server supports CMIS with connectors that connect to CMIS Web services and display list views of data from selected CMIS-compliant data sources, or repositories, to authenticated users.

The CMIS specification describes data model, services, Restful AtomPub binding, extensions, collections, feeds, resources, and Web services binding details. A data source is CMIS-compliant if it adheres to the CMIS specification. The CMIS components in the Toolkit comply with the CMIS specification.

Installing and configuring the CMIS connector

The CMIS producer obtains the same results from SOAP and REST Web services. The CMIS Web service exposes SharePoint lists as CMIS repositories. When a request is processed, the CMIS Producer loads a CMIS repository object that holds the basic list information. The Producer returns data in the form of a CMIS response structure, and if needed, it also returns data in the body of the response.

The CMIS Consumer Web Part connects to the CMIS producer and gets repository information based on address and authentication information entered in its Connection Options section.

Installing the CMIS connector

The CMIS connector is installed with the SharePoint 2010 Administration Toolkit. To learn how to install the toolkit, see Installing the SharePoint 2010 Administration Toolkit (SharePoint Server 2010). When you install the Toolkit, the CMIS Producer and CMIS Consumer Web Part are installed automatically.

Configuring the CMIS connector

After the installation is complete, activate and configure the CMIS Producer and the CMIS Consumer Web Part, as follows.

To activate and deploy the CMIS connector features

1. Verify that you meet the following minimum requirements: See Add-SPShellAdmin.

2. On the Start menu, click All Programs.

3. Click Microsoft SharePoint 2010 Products.

4. Click SharePoint 2010 Management Shell.

5. At the Windows PowerShell command prompt, type the following command to add the solution to the farm solution gallery:

   Add-SPSolution -LiteralPath 'C:\Program Files\Microsoft\SharePoint 2010 Administration Tookit\Content Management Interoperability Services (CMIS) Connectors\spcmis.wsp'
   

6. To deploy the solution, from the SharePoint Server 2010 Central Administration Web site, click System Settings and then click Manage Farm Solutions.

7. Click spscmis.wsp, choose the appropriate deployment settings, and then click Deploy Solutions.

   Note

   When deployment is complete, Solution Properties should show that the solution was successfully deployed to all target sites.

   Important

   When selecting solution details, remember which site you designate as the producer. In order to avoid an error later that states that the solution cannot be activated, open IIS Manager and verify that the Web application that will host the producer has only one header entry in the Bindings section.

8. On the Site Actions menu of the site that contains the content to be consumed, click Site Settings, choose Manage site collection features, and click Activate to activate the CMIS Producer feature.

9. On the Site Actions menu of the site where the CMIS Consumer Web Part will be added, click Site Settings, choose Manage site collection features, and click Activate to activate the CMIS Consumer Web Part feature.

To add the CMIS Consumer Web Part to a page in the consumer site collection

1. Change the page to Edit Mode, click Insert on the ribbon, and select the CMIS Consumer Web Part.

2. Edit the Appearance, Layout, and Advanced properties.

3. Edit the Connection Options.

4. Type the appropriate WSDL address in the Specify WSDL Address field, as shown in the following table. The CMIS connector only supports the SOAP WSDL.

   Note

   If you are using a third-party CMIS connector, you can connect it to the REST Atom Service binding if you know the address of the producer site, the GUID for the list or library, and the CMIS command that you want to use to interact with the REST ATOM service. For more information, see the CMIS specification.

   Protocol	URL format	Description
   SOAP WSDL	http://webURL/_vti_bin/CMISSoapwsdl.aspx	webURL represents the URL that locates the SPList on the producer site.
   REST Atom Service	http://web/_vti_bin/cmis/rest/[repositoryid]?command	web represents the producer site. [repository id] is the list or library GUID, and command is a command that exists in the CMIS specification (for example, getRepositoryInfo).

5. Select the WS-Security Required check box, and click Basic or Digest, depending on the type of CMIS authentication that the CMIS repository is set up to use. For more information, see the "Bindings and permissions" section later in the article.

6. Click Get Repository list to query the CMIS producer and return a list of available CMIS-compliant repositories.

   Note

   If an error appears after you attempt to sign on to the repository (such as an "Unable to obtain master key" error), you must configure the secure store. For information, see Configure the Secure Store Service (SharePoint Server 2010).

7. Select the repository from the Select Repository list that contains the data to display in the CMIS Consumer Web Part.

8. Click OK to apply settings and save changes.

Bindings and permissions

The CMIS standard defines a domain model, Web services, and Restful AtomPub bindings that can be used by applications to work with one or more content management repositories. The SOAP and AtomPub bindings defined in the CMIS specification are functionally equivalent and consistent—each protocol only defines the syntax for how methods are invoked and how responses are formatted. All of the same CMIS functionality is exposed regardless of which protocol is used.

The CMIS standard has two concepts of permissions, as follows:

• Basic permissions include read, write, and all. A user with Read permissions can only view data from a repository. A user with Write permissions can contribute to a repository, and a user with All permissions has full control.

• Digest permissions are those that are defined by and expressed by a repository. These permissions do not have an explicitly defined meaning in the CMIS specification. They can be looked up at runtime using CMIS interfaces.

The CMIS specification maps allowable actions to the access control level (ACL) permissions defined for a repository. A client application can discover how the permissions that are exposed by the repository affect what actions a user can perform by way of CMIS. Other factors can affect whether a user can perform an action. For example, to check out an object from the repository, a user may need both the appropriate permission and the item must not already be checked out.

Mapping the CMIS data model to SharePoint concepts

The CMIS standard specification uses specific terminology that has equivalents inSharePoint Server 2010. The following table defines key CMIS concepts and maps them to their SharePoint equivalents.

See Also

Other Resources

HTTP Extensions for Distributed Authoring (WebDAV)
Business Data Connectivity Service Authentication
Business Data Connectivity Service Authorization