Provision Microsoft Teams from Dynamics 365 Commerce

Article
08/12/2022

This article describes how to provision Microsoft Teams by using organizational data from Dynamics 365 Commerce.

Dynamics 365 Commerce offers an easy way to provision Teams if you haven't yet set up teams for your retail stores there. By taking advantage of well-defined information from Commerce that you want to use in Teams, you can help your store employees get started in Teams. This information includes the organizational hierarchy, store names, employee information, and Microsoft Entra accounts.

The process of provisioning Teams has two main steps:

In Teams, create a team for each retail store, and add store workers as members of the appropriate team. If an employee is associated with more than one retail store, team membership will reflect that fact. A communications team that includes regional managers as members will be created to help publish tasks from Teams.
Upload your organizational hierarchy from Commerce to Teams.

Provision Teams in Commerce headquarters

Before you provision Microsoft Teams, complete these tasks:

Confirm that all regional managers have been made communications managers.
Confirm that the Azure account of every store manager and worker has been associated with that manager's or worker's worker record in Commerce headquarters.

To provision Teams in Commerce headquarters, follow these steps.

Go to Retail and Commerce > Channel setup > Microsoft Teams Integration Configuration.
On the Action Pane, select Provision teams. A batch job that is named Teams provision is created.
Go to System administration > Inquiries > Batch jobs, and find the most recent job that has the description Teams provision. Wait until this job has finished running.

Tip

If none of your regional managers, store managers, and store workers have been associated with a Teams license, you might receive the following error message: "Failed to retrieve appliable Sku categories for the user." To correct the issue, select Sync teams and members on the Action Pane.

Validate Teams provisioning in the Teams admin center

To validate Microsoft Teams provisioning in the Microsoft Teams admin center, follow these steps.

Go to the Teams admin center, and sign in as the administrator of your e-commerce tenant.
In the left navigation pane, select Teams to expand it, and then select Manage teams.
Confirm that one team has been created for each Commerce retail store.
Select a team, and confirm that store workers have been added to it as members.
In the left navigation pane, select Users, and confirm that all store employees in all stores have been added as users.

The following illustration shows an example of the Manage teams page in the Teams admin center.

Example of the Manage teams page in the Teams admin center.

Upload a Commerce organizational hierarchy to Teams

The Commerce organizational hierarchy can be used in Microsoft Teams to publish tasks to all or selected stores that use the same hierarchy structure.

To upload a Commerce organizational hierarchy to Teams, follow these steps.

In Commerce headquarters, go to Retail and Commerce > Channel setup > Microsoft Teams Integration Configuration.
Select Download targeting hierarchy, and then select Retail Stores by Region to download a comma-separated values (CSV) file of the organizational hierarchy.
Install the Microsoft Teams PowerShell module by following the steps in Install Microsoft Teams PowerShell.
When you're prompted in the Teams PowerShell window, sign in by using the administrator account for your Microsoft Entra tenant.
Follow the steps in Set up your team targeting hierarchy to upload the CSV file for the targeting hierarchy.

Verify that the organizational hierarchy was uploaded to Teams

To verify that the organizational hierarchy was uploaded to Microsoft Teams, follow these steps.

Sign in to Teams as a communications manager.
In the left navigation pane, select Tasks by Planner.
On the Published lists tab, create a new list that has a dummy task.
Select Publish. The organizational hierarchy should appear in the Select who to publish to dialog box, as shown in the example in the following illustration.

Example of an organizational hierarchy in the Select who to publish to dialog box.