OneDrive Connector 25.3
OneDrive Connector Help

# Retrieve Information from OneDrive

To automatically retrieve content from OneDrive, 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. Ensure that the relevant OAuth parameters are included in the configuration file. For example, the following line imports the relevant parameters from a file named `oauth.cfg`. This file is generated by the OAuth configuration tool that is supplied with the connector.

       [MyTask] < "oauth.cfg" [OAUTH]

   For information about importing parameters into a configuration file, see Include an External Configuration File.

2. If you have installed the connector on a machine that is behind a proxy server, set the following configuration parameters so that the connector can access OneDrive.

   `ProxyHost` | The host name or IP address of the proxy server to use to access OneDrive.
   `ProxyPort` | The port of the proxy server to use to access OneDrive.

3. If you are retrieving information from a OneDrive for Business environment, set the following parameters:

   `ProcessAllUserDrives` | A Boolean value that specifies whether to retrieve information from the drives of all enabled users in a OneDrive for Business environment. To retrieve information from all enabled users, set this parameter to `TRUE`. When `ProcessAllUserDrives=False`, the connector only processes drives that belong to the user account used to access OneDrive.
   `UserMustHaveRegex` | A regular expression to limit the users whose files are retrieved. The principal name of a user must match the regular expression, otherwise the user is ignored.
   `UserCantHaveRegex` | A regular expression to limit the users whose files are retrieved. If the principal name of a user matches the regular expression, the user is ignored.
   `MappedSecurity` | (Optional) A Boolean value that specifies whether to add Access Control Lists (ACLs) to documents. If you want to use mapped security to protect documents from unauthorized access, set this parameter to `TRUE`. For more information about mapped security, see Mapped Security.

4. (Optional) To limit the information that is retrieved from OneDrive, set the following parameters:

   `PathMustHaveRegex` | A list of regular expressions. The full path a folder must match one of the regular expressions, otherwise the folder and its contents (including subfolders) are ignored.
   `PathCantHaveRegex` | A list of regular expressions. If the full path of a folder matches any of the regular expressions, the folder and its contents (including subfolders) are ignored.
   `FileNameMustHaveRegex` | A list of regular expressions. The name of the file must match one of the regular expressions, otherwise it is ignored.
   `FileNameCantHaveRegex` | A list of regular expressions. If the name of a file matches any of the regular expressions, the file is ignored.

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

5. Save and close the configuration file.

Copyright 2025 Open Text
Version 25.3 | Last updated July 2025

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: Knowledge Discovery OneDrive Connector 25.3

Topic Title: Retrieve Information from OneDrive