Retrieve Documents from Documentum

To automatically retrieve content from Documentum, create a new fetch task by following these steps. The connector runs each fetch task automatically, based on the schedule that is defined in the configuration file.

To create a new Fetch Task

  1. Stop the connector.
  2. Open the configuration file in a text editor.
  3. In the [FetchTasks] section of the configuration file, specify the number of fetch tasks using the Number parameter. If you are configuring the first fetch task, type Number=1. If one or more fetch tasks have already been configured, increase the value of the Number parameter by one (1). Below the Number parameter, specify the names of the fetch tasks, starting from zero (0). For example:

    [FetchTasks]
    Number=1
    0=MyTask
  4. Below the [FetchTasks] section, create a new TaskName section. The name of the section must match the name of the new fetch task. For example:

    [FetchTasks]
    Number=1
    0=MyTask
    
    [MyTask]
  1. In the new section, set the following parameters. These are used to connect and authenticate with Documentum:

    Username The user name that the connector should use to authenticate with the Documentum repository.
    Password The password that the connector should use to authenticate with the Documentum repository.
    Domain (Optional) The domain of the user specified by the Username parameter.
    Docbase The name of the repository that you want to retrieve content from.
  2. Specify the documents that you want to retrieve from Documentum. The connector retrieves all documents by default.

    • To filter the documents that are returned, you can set the following optional parameters:

      FieldQueryN A statement to filter the documents that are returned from the Documentum repository.
      FolderCSVs A comma-separated list of folders from which documents are retrieved. If you do not set this parameter, the connector retrieves documents from all folders.
      FolderRecursion A Boolean value that specifies whether the connector searches subfolders of the paths specified by FolderCSVs.

      For example:

      [MyTask]
      Username=user
      Password=pa55w0rd
      Docbase=docbase
      FieldQuery0=r_content_size>0
      FolderCSVs=/documentum/docs
      FolderRecursion=true
      

      For a complete list of the parameters that you can use, refer to the Documentum Connector Reference.

    • To specify a custom statement to query Documentum, set the SelectStatement parameter:

      SelectStatement The query to use to identify the documents to retrieve from the Documentum repository. The query must return a column named r_object_id. You can use the string @lastruntime to represent the time of the last successful synchronize task.

      For example:

      [MyTask]
      Username=user
      Password=pa55w0rd
      Docbase=docbase
      SelectStatement=SELECT DISTINCT(dm_document.r_object_id) FROM dm_document
  3. Choose whether to run the connector in incremental mode, by setting the Incremental parameter:

    • To run the connector in incremental mode, set Incremental=true. Each time the task runs, the connector retrieves only the new, modified, and deleted documents.
    • To perform a full synchronize, set Incremental=false. Each time the task runs, the connector retrieves all of the documents that match your query or filters.
  4. Save and close the configuration file.