Integrating Microsoft Teams with SAP Digital Manufacturing Cloud

[Kevin_Hunter]

SAP Digital Manufacturing Cloud has some very powerful features that allow you to integrate it to other platforms including both SAP and Non SAP applications.

This blog will show you how to integrate SAP Digital Manufacturing Cloud into Microsoft Teams, walking you step by step through the configuration of both Microsoft Teams and SAP Digital Manufacturing Cloud.

 

Lets get started by configuring Microsoft Teams.

Create a team In Microsoft Teams

1. First, click Teams on the left side of the app, then click Join or create a team  at the bottom of your teams list.


2. Then click Create team (first card, top left corner).


3. Choose Build a team from scratch.


4. Next, you’ll want to choose what kind of team you want this to be:To limit content and conversation to a specific set of people, choose Private.For a community or topic that anyone in the organization can join, choose Public.


5. Name your team and add an optional description.


6. When you're done, click Create.

Add the Incoming Webhook App

 

1. Press the 3 dots on the right-hand side of the team you created in the previous steps


2. Select Manage Team


3. Switch to the Apps tab and press the More apps button

4. Search for webhook and select the Incoming Webhook app


5. Click the Add to a team button

6. Ensure that the correct teams channel is displayed and press the Set up a connector button


7. A configuration page will now be displayed. Enter the name as SAP Digital Manufacturing Cloud (Or a name that you prefer) and either upload an image or keep the default. This name and image will be displayed along with the messages sent from DMC. Finally press the Create button


8. The webhook will now be created and a URL will be created. Copy this URL as you will need it later (Note:- This URL can be retrieved again later if you lose it) and press Done

A message will now be displayed in your teams channel showing the name and image you provided during the configuration and a message telling you the webhook was created.

9. The setup for Microsoft Teams is now completed and can now be used by DMC.

Microsoft Teams is now configured so we now move on to configure SAP BTP and SAP DMC.

DMC Configuration

BTP Destination

1. To be able to call an API outside of DMC you have to first create a destination in the BTP cockpit. Log onto you BTP cockpit and select the global tenant where DMC is installed. Expand the Connectivity section in the menu and select Destinations

 

2. Select New Destination

3. Configure the destination details as shown in this screenshot apart from using your own URL created during the webhook (only the start part of the URL) creation and press Save

DMC Web Server

 

1. In the DMC Launch Pad select the Manage Web Servers


2. Click on Create


3. Use the following settings and as when the destination was created use your own unique URL for the Host URL field and select your own unique plant.


4. Once the web server has been created go to the destinations section and add the Microsoft Teams destination created previously.


5. On the left hand side of the screen select the DMC_Cloud Web Server


6. This will open the configuration for the DMC_Cloud web server where we need to add the Microsoft teams web server to its list of connections. Press create to add the new connection.


7. Select the Microsoft teams service from the list


8. It should now appear in the list of connections (you may not have the same qty of connections as in the screenshot).

Create a service

1. From the DMC launch pad open the Manage Service Registry app


2. Click Create


3. In the Header section enter the following details


4. In the general information section enter the following details

Note: the path is the end section of the URL generated in Microsoft Teams.

5. The Parameters is left empty


6. The request body is required as this is where the actual message to be sent is passed to the webhook API. Turn on the request body


7. Select application/json for the Content Type


8. Select the drop-down icon next to inline schema and press Define Inline Schema


9. Replace the Schema Definition JSON with the following and press save

{

"type": "object",

"properties": {

"text": {

"description": "Message To Be Sent",

"type": "string"

}

},

"required": [

"text"

]

}

10. The service is now ready to be used.

Design Production Process

1. From the DMC Launchpad, open the Design Production Processes


2. Click Create


3. Click Create


4. Fill in the details as shown in this screenshot and press Create


5. Change the toolbar on the left-hand side to the editor by selecting the pencil icon and drag and drop a start and end control onto the worksheet.


6. Click on the start control to display the configuration and press Manage Parameters


7. Click Create and add one parameter called MessageToBeSent, type string and required as shown below, then press Save


8. On the left-hand tool bar select Select Services

 

9. Select the service you previously created, and press Save


10. Find your service in the list of Services and Processes on the left-hand side and drag and drop your service onto the worksheet. On the right-hand side map the text input field to your previously created MessageToBeSent parameter.


11. Join the start control to your service and your service to the end control.


12. Press Save All then Quick Deploy


13. The integration is now ready to be tested.

Testing

1. Press the Run button


2. Enter a value in the MessageToBeSent field and press Run


3. You should receive a message saying the process has been successfully executed and a message will be shown in the Microsoft Teams Channel.

 

That's it, you now have a custom service inside of SAP Digital Manufacturing Cloud that send messages to Microsoft Teams, reach out and let me know of any uses cases you think this could be useful for or any suggestions of other implementations you would like to see documented.

Thanks for taking the time to read this blog and please leave feedback or any questions you have.