Microsoft Teams Connector 12.13

# Retrieve Information from Microsoft Teams

To automatically retrieve content from Microsoft Teams, 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 (see Install Microsoft Teams Connector).

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

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

2. (Optional) If a proxy server is required to access the repository, set the following parameters.

   `ProxyHost` | The host name or IP address of the proxy server.
   `ProxyPort` | The port of the proxy server.
   `ProxyUsername` | (Optional) The user name to use to authenticate with the proxy server.
   `ProxyPassword` | (Optional) The password to use to authenticate with the proxy server.

3. (Optional) You can set the following parameters to specify what to synchronize:

   `TeamCantHaveRegex` | A regular expression to restrict the teams that are synchronized by the connector. If the display name of a team matches the regular expression, it is ignored.
   `TeamMustHaveRegex` | A regular expression to restrict the teams that are synchronized by the connector. The display name of a team must match the regular expression, otherwise it is ignored.
   `ChannelCantHaveRegex` | A regular expression to restrict the channels that are synchronized by the connector. If the name of a channel matches the regular expression, it is ignored.
   `ChannelMustHaveRegex` | A regular expression to restrict the channels that are synchronized by the connector. The name of a channel must match the regular expression, otherwise it is ignored.
   `IndexUserChats` | A Boolean value that specifies whether to synchronize one-to-one and group messages for each user. NOTE: To use this feature you must have an appropriate Microsoft 365 license that allows you to use the chats: getAllMessages endpoint. This might require payment to Microsoft (see the Microsoft documentation and use the parameter `ModelLicense` to specify your license model). You must also have a service application with access to the Microsoft Teams Protected APIs. For information about setting up a service application, see Set up an OAuth Service Application.
   `IndexAttachments` | A Boolean value that specifies whether to index attachments and hosted content as IDOL documents. By default, attachments and hosted content are ignored.

4. Save and close the configuration file.

© Copyright 2022 Micro Focus or one of its affiliates
Version 12.13 | Last updated October 2022

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 swpdl.idoldocsfeedback@microfocus.com.

We appreciate your feedback!

Product: IDOL Microsoft Teams Connector 12.13

Topic Title: Retrieve Information from Microsoft Teams