On this Page
Overview
The Documentum connector in SkySync allows you to analyze, migrate, copy, and synchronize files between your Documentum account and cloud storage repositories and on-premise network file shares. The first step is to create the Documentum connection by providing the connection information required for SkySync to connect to the server. The connector can be created using any Documentum user account with permissions to access the content.
SkySync currently supports Documentum 7.3.
Create Connection | SkySync Application User Interface
Select Connections > Add connection.
Select Documentum as the platform on the Add connection modal.
Enter the connection information. Reference the table below for details about each field.
Test the connection to ensure SkySync can connect using the information entered.
Select Done.
Add connection modal - Documentum
Field | Description | Required |
---|---|---|
Display as | Enter the display name for the connection. If you will be creating multiple connections, ensure the name readily identifies the connection. The name displays in the application, and you can use it to search for the connection and filter lists. If you do not add a display name, the connection will automatically be named using the CMIS URL. For example, Documentum (http://XX.XX.XX.XXX:XXXX/emc-cmis/resources). If it will be useful for you to reference the connection by the URL, you should use the default name. | Optional |
CMIS URL | Enter the URL for the Content Management Interoperability Services (CMIS) server. | Required |
User name | Enter the username that should be used to log on to the server. This needs to be an account with permissions to access the content that will be processed. | Required |
Password | Enter the password for the username added in the previous field. | Required |
Repository | Enter the Documentum repository name. | Required |
Item Type | Enter the item type that should be assigned to uploaded items. For example, cmis:document. | Optional |
Secondary Item Types | Enter the secondary item types that should be applied. This is a comma or semicolon delimited list of item types for properties being retained as metadata. This is user defined and will vary by instance. | Optional |
Agent URL | Enter the URL for the computer where the Documentum agent is installed. The Documentum agent provides access to additional functionality. This is an optional entry, but SkySync uses the entry to determine if additional features should be turned on for the connection. If this field is populated, SkySync turns on the additional features; if it is blank, SkySync assumes the agent is not being used and doesn’t turn on the additional features. See Documentum Agent under Features and Limitations for more information about the features enabled through the Documentum agent. | Optional |
Lifecycle | Enter the lifecycle state that should be applied to the document when it is created. The SkySync extension module must be installed to use this option. | Optional |
Connection Test Succeeded
Features and Limitations
Platforms all have unique features and limitations. SkySync’s transfer engine manages these differences between platforms and allows you to configure actions based on Job Policies and Behaviors. The information below is platform specific. Use the Platform Comparison tool to see how your integration platforms may interact regarding features and limitations.
Supported Features | Unsupported Features | Other Features/Limitations |
---|---|---|
Path length maximum: 255 | ||
Author/Owner preservation | Invalid characters: \ \\ / < > : | ? * | |
No Leading whitespace | ||
No trailing whitespace before extensions | ||
Account map | No trailing whitespace after extensions | |
Group map | ||
Permission preservation | ||
Documentum Agent
Documentum offers an optional agent that provides additional functionality. In order for you to use the following features, you will need to install the agent.
Audit Trail Support: This feature allows for the preservation of CreatedBy and ModifiedBy.
Author/Owner Preservation: If Documentum is the destination connection, this feature allows the reading and writing of the author for the file. Without the agent, the author can be read but now applied.
Querying Accounts: This feature provides the ability to search for user accounts. This is used behind the scenes for Audit Trail Support and in the SkySync user interface for account mapping.
Querying Groups: allows the ability to search for groups. This is used behind the scenes for Audit Trail Support and in the SkySync user interface for group mapping.
Permissions: This features allows for getting and modifying the permissions of an item.
The agent is a file named “documenutm-usermapping.war” and should be placed in the root of the webapps directory. Restarting the web server will unpack the agent and install it automatically.
This information applies only to Tomcat Apache 8.5.
Create Connection | SkySync API
A basic Documentum connection can be made using the example below.
POST {{url}}v1/connections/ |
---|
{ "name": "display name goes here", "platform": { "id": "documentum" }, "auth": { "uri": "http://CMIS URL", "username": "username", "password": "password", "repository": "repository name", "item_type": "cmis:document", "secondary_item_types": "property1;property2;property3", "agent_url": "http://CMIS URL/documentum-usermapping", "lifecycle": "lifecycle state" } } |
Create a Job | SkySync API Job Configuration Example
Below is an example Job for a connection created as standard user, no impersonation.
POST {{url}}v1/jobs |
---|
{ "name":"Simple Job", "kind": "transfer", "transfer": { "transfer_type": "copy", "source": { "connection": { "id": "Source Connection ID" }, "target": { "path": "/sourceDocumentLibrary" } }, "destination": { "connection": { "id": "Destination Connections ID" }, "target": { "path": "/destinationFolder" } }, "simulation_mode": false }, "schedule": { "mode": "manual" }, "stop_policy": { "on_success": 5, "on_failure": 5, "on_execute": 25 }, "category": { "name": "Report {Name}" } } |