Introduction
The MicrosoftTeamsConnector transformer was created to address this idea on the FME Community. Inside the transformer are several HTTPCaller transformers that 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
To post a message to a Microsoft Teams channel, all input parameters must be set.
The Team and channel names must match exactly, as they are in Microsoft Teams.
Inside the transformer, API calls are made using Team and Channel IDs, not the team or channel names. 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 posts the message to the specified channel.
List files in a channel
To list files from a Microsoft Teams channel, all input parameters must be set, except for the Message parameter.
The Team and channel names must match exactly, as they are in Microsoft Teams. Inside the transformer, API calls are made using Team and Channel IDs, not the team or channel names. 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 must use the SharePointOnlineConnector transformer. This is because Microsoft Teams files are accessed through SharePoint.
To retrieve 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