MS Teams

The source MS Teams connector allows files and folders to be picked up from One Drive/Sharepoint and transformed into motation.

Specifics

The source MS Teams connector uses MS Graph API to pick up the files and folders from One Drive/Sharepoint. You will need to register an single tennant application with the appropriate permissions to use this connector.

Permissions

Registering ImpulseSync as an app

You will need to register ImpulseSync as an application in Microsoft identity platform. Register ImpulseSync as a single tennant.

Once it's registered you will have a tennant ID and a client ID. You will also need a client secret.

Finally, ImpulseSync requires the appropriate permissions. It must be able to read the files for a drive in a site. This can be granted by granting the Files.Read.All permission.

Adding Files.Read.All permission

Click "Add a permission". Then select Microsoft Graph.

Select "Application permissions". Then type files.read.all into the search bar.

Then select the Files.Read.All permission and click "add permissions" at the bottom.

Finally, grant admin consent for the permission.

Endpoint Config

When saving an endpoint for a MS Teams repository via REST instead of the UI you must use the following key:value pairs in the payload.

• contentRepo:ms-teams

• contentRepoVersion:latest

Connector queries for all files

Because this connector uses the MS Graph API to pickup files, there are some restrictions inherited from the API.

One of these restrictions is the need to manually filter files based on a time stamp. The MS Graph API does not allow for a query to be made for files which sorts or filters by time stamp. This means the connector must query through all files in a folder on pickup. This can cause picking up files to take longer than expected for a transaction that is picking up files from a very large folder.

Unsupported

Anything unsupported by the MS Graph API is also unsupported by this connector. i.e., the sorting param only works with name and url fields.

Passing in a select param is unsupported.

Passing in an expand param is unsupported.

Passing in an order by param is unsupported.

Adapter Properties

Property	Purpose
clientId	The client ID for the registered ImpulseSync application in the MS identify platform.
clientSecret	The client secret for the registered ImpulseSync application in the MS identify platform.
tenantId	The tenant ID for the registered ImpulseSync application in the MS identify platform.
driveId	The drive ID to pick up files from.
siteId (optional)	The site ID the drive lives at to pick up files from. (default: no site id)
rateLimitPerSecond (optional)	The rate limit requests should be sent to the MS Graph API. (default: 10)

Job Options

Name	Description	Data Type	Required	Default Value
folder	The relative folder path from root of a drive to pick up files from.	Text	true	No Default Value
query	MS Graph query parameters to be added to the API request to pick up files.	Text	false	No Default Value

folder job option

The folder job option is the relative folder path from the root of the drive ID.

Motation Object Support

Object	Supported
Category	No
Definition	Yes
Domain	No
Folder	Yes
Language	No
Relationship	No
Tag	No