Retrieve Data through IMAP

To automatically retrieve content from an IMAP 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, specify the host name or IP address of the IMAP server, and the user name and password to use to authenticate.

    ImapServerName The host name or IP address of the IMAP server.
    UserName The user name required to access the IMAP server.
    UserPassword The password required to access the IMAP server.
  2. Specify the settings required to connect to the IMAP server:

    • To connect to the IMAP server over SSL, set the following parameters:

      SSLConfigSection The name of a section in the configuration file that contains the settings required to communicate with the IMAP server over SSL.
      ImapServerSSLPort The port to use for the SSL connection.
    • To connect to the IMAP server without SSL, set the following parameters:

      ImapServerTCPPort The port to use to connect to the IMAP Server.
  3. You can set additional parameters to specify how the connector retrieves information.

    UseListCmd

    A Boolean that specifies the method used to retrieve a list of mailboxes.

    • To use the RFC2060 LIST command to retrieve a list of mailboxes, set this parameter to true.
    • To use the mailbox name specified by the MailboxName parameter, set this parameter to false.
    MailboxName The name of the mailbox to retrieve messages from (when UseListCmd=false).
    ListCmdMailboxName The wildcard sent to the IMAP server with the LIST command (when UseListCmd=true). Set this parameter to * to return everything, or set this parameter to an IMAP mailbox name to return a single mailbox.

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

  4. Save and close the configuration file.