Retrieve Documents from a CMIS Server

To automatically retrieve content from a CMIS server, 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:

    CmisUrl The base URL for the CMIS server. This URL is used to construct the URLs to use to obtain information about repositories on the CMIS server.
  2. Specify the information that the connector should use to authenticate:

    Basic authentication To authenticate using basic authentication, set the parameters BasicUsername and BasicPassword.
    Digest authentication To authenticate using digest authentication, set the parameters DigestUsername and DigestPassword.
    NTLM authentication To authenticate using Windows authentication, set the parameters NTLMUsername and NTLMPassword.
    Kerberos To authenticate using Kerberos, set the parameters GssName, GssPath, and EnableKerberos.

    For more information about these parameters, refer to the CMIS Connector Reference.

  3. (Optional) To restrict the content that is retrieved by the connector, you can set the following parameters:

    RepositoryNameMustHaveRegex

    A Perl-compatible regular expression to restrict the repositories that are ingested by the connector. The full name of a repository must match the regular expression, otherwise the repository is ignored.

    RepositoryNameCantHaveRegex A Perl-compatible regular expression to restrict the repositories that are ingested by the connector. If the regular expression matches the full name of a repository, the repository is ignored.
  4. (Optional) To enable mapped security, set the MappedSecurity parameter:

    MappedSecurity A Boolean value that specifies whether to enable mapped security. If you want to extract security information from the repository and add an Access Control List (ACL) to each document, set this parameter to TRUE.
  5. Save and close the configuration file.