How to use the MicrosoftTeamsConnector transformer

Introduction

The MicrosoftTeamsConnector transformer was created to address this idea on the FME Community. Inside the transformer are a number of HTTPCaller transformers which interact with Microsoft Teams using the Microsoft Graph API.

To authenticate and authorize FME to make these API calls, you will need to install and configure the Microsoft Teams (Graph) web service.

Post a message to a channel 

In order to post a message to a Microsoft Teams channel, all input parameters must be set.

The Team and Channel must match the names exactly, as they are in Microsoft Teams.

Inside the transformer, API calls are made using Team and Channel IDs, not the name. A TestFilter has been used to match the user input with the names returned from Microsoft, if the two strings don’t match, the transformer will fail.
 

When run, this transformer will post the message to the channel specified.

List files in a channel

In order to list files from a Microsoft Teams channel, all input parameters must be set except for the Message parameter.

The Team and Channel must match the names exactly, as they are in Microsoft Teams. Inside the transformer, API calls are made using Team and Channel IDs, not the name. A TestFilter has been used to match the user input with the names returned from Microsoft, if the two strings don’t match, the transformer will fail.

When run, this transformer will output one feature for every top-level file or folder that exists within the channel. To browse subfolders, it would be best to use the List action of the SharePointOnlineConnector.

The output attributes are:

Team Name: As specified in the transformer parameters

Channel Name: As specified in the transformer parameters

FolderURL: A URL to the location of the folder where the file exists (in SharePoint)

File Name: The name of the file

Web URL: A URL to view the file in a web browser (if supported)

Download URL: A URL that will directly download the file

Get SharePoint details for this channel

If a user wishes to download, upload or delete a file from Microsoft Teams, they will need to use the SharePointOnlineConnector transformer. This is because Microsoft Teams files are accessed through SharePoint. 

In order to get the SharePoint details, all input parameters must be set except for the Message parameter.

The output attributes are:

Team Name: As specified in the transformer parameters

Channel Name: As specified in the transformer parameters

Root|Full Path: The path to either the root location (useful to list all files that have been uploaded to a channel) or the path to the location of a top-level item.

Site: The SharePoint site where the file exists

Document Library: The document library where the file exists