Introduction

The connector supports the export and import of content and media items in ECM Documentum, by using Documentum's REST API. The exporter exports data from Documentum to our Unified Data Model (UDM), and the importer imports data from our UDM to Documentum. In this Article I'll explain the export functionality of the connector. 

Installation

The Documentum connector is written in Xill IDE, to make it work extract the zip and add it as a project in Xill. 

Next the properties have to be set accordingly to your environment, open the file xill.properties. For the exporter to work the following variables, like the Documentum repository, have to be set:

#udm
db.name=udm_documentum
udm.identity=documentum

#paths
project.root=D:/projects/connector_documentum/
project.exportPath=D:/projects/connector_documentum/export/
project.tempPath=D:/projects/connector_documentum/temp/
project.binaryPath=D:/projects/connector_documentum/export/binaries/
project.imagePath=D:/projects/connector_documentum/export/images/

#export
#if you have multiple servers, add the properties with an incremented integer (e.g. source.apiUrl2=[yoururlhere])
source.apiUrl1=http://localhost/dctm-rest/
source.username1=dmadmin
source.password1=password
#set how permissions will be resolved. Accepted parameters are  "DQL" and "basic"
source.permissionsType=DQL
source.extensionFile=fileextensions.sql
source.rootName1=MyRepo
source.root1=MyRepo

The connector has a demo project included that will create the UDM in MongoDB. 

Usage

Once installed, the mapping of the content types in Documentum to UDM have to be created. This has to be done in /config/export/mapping/<ContentType>.xill, over here you can create as many content type mappings as are necessary. 

The demo already has all standard Documentum content type mappings included, these are Container and Document. Note that there is also a Default.xill, this means the other content types share some metadata fields, which can be mapped in there. The advantage of this is that you only have to do it once instead of in all the other files separately. 

To start an export, simply run /project/Export.xill. It will export everything from the set Documentum Repo to UDM, and save the binaries to the export location.