You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@manifoldcf.apache.org by pi...@apache.org on 2018/04/12 07:24:21 UTC

svn commit: r1828953 - in /manifoldcf/branches/CONNECTORS-1356-2.7.1: ./ site/src/documentation/content/xdocs/en_US/ site/src/documentation/resources/images/en_US/

Author: piergiorgio
Date: Thu Apr 12 07:24:21 2018
New Revision: 1828953

URL: http://svn.apache.org/viewvc?rev=1828953&view=rev
Log:
added CMIS Output Connector documentation in english language (CONNECTORS-1437)

Added:
    manifoldcf/branches/CONNECTORS-1356-2.7.1/site/src/documentation/resources/images/en_US/cmis-output-connection-configuration.png   (with props)
Modified:
    manifoldcf/branches/CONNECTORS-1356-2.7.1/CHANGES.txt
    manifoldcf/branches/CONNECTORS-1356-2.7.1/site/src/documentation/content/xdocs/en_US/end-user-documentation.xml
    manifoldcf/branches/CONNECTORS-1356-2.7.1/site/src/documentation/content/xdocs/en_US/included-connectors.xml

Modified: manifoldcf/branches/CONNECTORS-1356-2.7.1/CHANGES.txt
URL: http://svn.apache.org/viewvc/manifoldcf/branches/CONNECTORS-1356-2.7.1/CHANGES.txt?rev=1828953&r1=1828952&r2=1828953&view=diff
==============================================================================
--- manifoldcf/branches/CONNECTORS-1356-2.7.1/CHANGES.txt (original)
+++ manifoldcf/branches/CONNECTORS-1356-2.7.1/CHANGES.txt Thu Apr 12 07:24:21 2018
@@ -3,6 +3,9 @@ $Id$
 
 ======================= 2.8-dev =====================
 
+CONNECTORS-1437: Documentation for the CMIS Output Connector
+(Piergiorgio Lucidi)
+
 CONNECTORS-1436: Porting of CMIS Output Connector from 2.6 to 2.8
 (Piergiorgio Lucidi)
 

Modified: manifoldcf/branches/CONNECTORS-1356-2.7.1/site/src/documentation/content/xdocs/en_US/end-user-documentation.xml
URL: http://svn.apache.org/viewvc/manifoldcf/branches/CONNECTORS-1356-2.7.1/site/src/documentation/content/xdocs/en_US/end-user-documentation.xml?rev=1828953&r1=1828952&r2=1828953&view=diff
==============================================================================
--- manifoldcf/branches/CONNECTORS-1356-2.7.1/site/src/documentation/content/xdocs/en_US/end-user-documentation.xml (original)
+++ manifoldcf/branches/CONNECTORS-1356-2.7.1/site/src/documentation/content/xdocs/en_US/end-user-documentation.xml Thu Apr 12 07:24:21 2018
@@ -766,6 +766,49 @@
                       <a href="http://docs.aws.amazon.com/cloudsearch/latest/developerguide/configuring-index-fields.html">this document</a> for details of how to set up an Amazon Cloud Search
                       schema.</p>
             </section>
+            
+            <section id="cmisoutput">
+              <title>CMIS Output Connection</title>
+              <p>The CMIS Output Connection type allows you to migrate content to any CMIS-compliant repository.</p>
+              <p>By default each CMIS Connection manages a single CMIS repository, this means that if you have multiple CMIS repositories exposed by a single
+                  endpoint, you need to create a specific connection for each CMIS repository.</p>
+              <p>CMIS repository documents are typically secured by using the CMIS Authority Connection type.  This authority type, however, does not have access
+                    to user groups, since there is no such functionality in the CMIS specification at this time.  As a result, most people only use the CMIS connection type
+                    in an unsecured manner.</p>
+              <br/>
+              <p>A CMIS Output connection has the following configuration parameters on the output connection editing screen:</p>
+              <br/><br/>
+              <figure src="images/en_US/cmis-output-connection-configuration.png" alt="CMIS Output Connection, configuration parameters" width="80%"/>
+              <br/><br/>
+              <p>Select the correct CMIS binding protocol (AtomPub or Web Services) and enter the correct username, password and the endpoint to reference the CMIS document server services.</p>
+              <p>The endpoint consists of the HTTP protocol, hostname, port and the context path of the CMIS service exposed by the CMIS server:</p>
+              <br/>
+              <p><code>http://HOSTNAME:PORT/CMIS_CONTEXT_PATH</code></p>
+              <br/><br/>
+              <p>The CMIS Query must be provided to select your own drop zone in the target folder that should be an existent CMIS folder.</p>
+              <p>By default the crawler will replicate the same source path structure for each content in that target folder.</p>
+              <p>Considering to have your contents in your source repository inside the following path:</p>
+              <br/>
+              <p><code>/MySourceRepo/Invoices</code></p>
+              <br/>
+              <p>And supposing to have configured your CMIS Output Connection with the default value of the CMIS Query for your target folder:</p>
+              <br/>
+              <p><code>SELECT * FROM cmis:folder WHERE cmis:name='Apache ManifoldCF'</code></p>
+              <br /><br/>
+              <p>All the migrated contents will be dropped in the following target CMIS folder:</p>
+              <br/>
+              <p><code>/path/to/your/Apache ManifoldCF/MySourceRepo/Invoices</code></p>
+              <br/>
+              <p>Optionally you can provide the repository ID to select one of the exposed CMIS repository, if this parameter is null the CMIS Connector will consider the first CMIS repository exposed by the CMIS server.</p>
+              <br/>
+              <p>Note that, in a CMIS system, a specific binding protocol has its own context path, this means that the endpoints are different:</p>
+              <p>for example the endpoint of the AtomPub binding exposed by the actual version of the InMemory Server provided by the OpenCMIS framework is the following:</p>
+              <p><code>http://localhost:8080/chemistry-opencmis-server-inmemory-war-0.5.0-SNAPSHOT/atom</code></p>
+              <br/><br/>
+              <p>The Web Services binding is exposed using a different endpoint:</p>
+              <p><code>http://localhost:8080/chemistry-opencmis-server-inmemory-war-0.5.0-SNAPSHOT/services/RepositoryService</code></p>
+              <br /><br/>
+            </section>
 
             <section id="elasticsearchoutputconnector">
                 <title>ElasticSearch Output Connection</title>

Modified: manifoldcf/branches/CONNECTORS-1356-2.7.1/site/src/documentation/content/xdocs/en_US/included-connectors.xml
URL: http://svn.apache.org/viewvc/manifoldcf/branches/CONNECTORS-1356-2.7.1/site/src/documentation/content/xdocs/en_US/included-connectors.xml?rev=1828953&r1=1828952&r2=1828953&view=diff
==============================================================================
--- manifoldcf/branches/CONNECTORS-1356-2.7.1/site/src/documentation/content/xdocs/en_US/included-connectors.xml (original)
+++ manifoldcf/branches/CONNECTORS-1356-2.7.1/site/src/documentation/content/xdocs/en_US/included-connectors.xml Thu Apr 12 07:24:21 2018
@@ -65,6 +65,7 @@
       	<caption>Output Connector interoperability table</caption>
       	<tr><th>System</th><th>Connector Platform</th><th>Server Platform</th><th>Client Version</th><th>Server Version</th></tr>
       	<tr><td>Amazon CloudSearch</td><td> Pure Java </td><td> N/A </td><td> N/A</td><td> N/A </td></tr>
+      	<tr><td>CMIS</td><td> Pure Java </td><td>CMIS 1.1</td><td>CMIS 1.1</td><td>Tested with OpenCMIS In-Memory Server 1.1.0 and Alfresco 5.2</td></tr>
       	<tr><td>ElasticSearch</td><td> Pure Java </td><td> N/A </td><td> N/A</td><td> Tested with ElasticSearch 1.0, 1.1, 1.2, 1.3 </td></tr>
       	<tr><td>OpenSearchServer</td><td> Pure Java </td><td> N/A </td><td> N/A</td><td> Tested with OpenSearchServer 1.2.1, 1.2.2, 1.2.3, 1.3, 1.4, 1.5.x </td></tr>
       	<tr><td>SearchBlox</td><td>Pure Java</td><td>Various</td><td>Various</td><td>Various</td></tr>

Added: manifoldcf/branches/CONNECTORS-1356-2.7.1/site/src/documentation/resources/images/en_US/cmis-output-connection-configuration.png
URL: http://svn.apache.org/viewvc/manifoldcf/branches/CONNECTORS-1356-2.7.1/site/src/documentation/resources/images/en_US/cmis-output-connection-configuration.png?rev=1828953&view=auto
==============================================================================
Binary file - no diff available.

Propchange: manifoldcf/branches/CONNECTORS-1356-2.7.1/site/src/documentation/resources/images/en_US/cmis-output-connection-configuration.png
------------------------------------------------------------------------------
    svn:mime-type = image/png