SAP Digital Manufacturing Cloud boasts powerful features that enable seamless integration with various platforms, including both SAP and non-SAP applications. This guide outlines the process of notifying workers via Microsoft Teams using the extensibility capabilities of SAP Digital Manufacturing and the Business Technology Platform (BTP).
Overview
Sending notifications to operators in Microsoft Teams when an order is released or when the resource status changes can streamline communication and ensure timely action. The key steps include:
- Integration Setup
- Trigger Point Configuration
- Notification Configuration
- Recipient Selection
- Notification Format
- Testing and Deployment
Step-by-Step Integration Guide
Step 1: Create a Team Channel in Microsoft Teams
- Click Teams on the left side of the app, then click Join or create a team at the bottom
- Click Create team (first card, top left corner)
- Build a team from scratch
- Choose Private to limit content and conversation to a specific set of people, or Public for a community or topic anyone in the organization can join
- Name your team and add an optional description
- Click Create
Step 2: Add Incoming Webhook App in Team Channel
- Click the three dots on the right-hand side of the team you created
- Select Manage Team
- Switch to the Apps tab and click More apps
- Search for webhook and select the Incoming Webhook app
- Click Add to a team
- Ensure the correct team channel is displayed and press Set up a connector
- Configure the webhook with a name and image, then click Create
- Copy the URL provided as it will be needed later
- A message will be displayed on your team’s channel confirming the webhook creation
Step 3: Create a Destination in BTP
- Log onto your BTP cockpit and select the global tenant where DM is installed
- Expand the Connectivity section and select Destinations
- Click New Destination
- Configure the destination details using the URL created in the webhook setup (only the start part of the URL) and press Sav
Step 4: Create a Server in DM
- In the DM Launch Pad, select Manage Web Servers
- Click Create and use your unique URL for the Host URL field and select your unique plant
- Add the Microsoft Teams destination created previously
- In the DM_Cloud web server configuration, add the Microsoft Teams web server to its list of connections
Step 5: Create a Service Registry in DM
- Open the Manage Service Registry app from the DM launch pad
- Click Create and fill in the required details in the Header and General Information sections
(Note:- Paste the whole Incoming webhook URL in URL/path) - Enable the request body and set the Content Type to application/json
- Define the inline schema and save the service
(Note:-Replace the Schema JSON with following)
Inline Schema
{
"type": "object",
"properties": {
"type": {
"type": "string"
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"contentType": {
"type": "string"
},
"content": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"body": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"text": {
"type": "string"
},
"wrap": {
"type": "boolean"
},
"style": {
"type": "string"
},
"fontType": {
"type": "string"
},
"size": {
"type": "string"
},
"color": {
"type": "string"
},
"isSubtle": {
"type": "boolean"
},
"width": {
"type": "string"
},
"title": {
"type": "string"
},
"value": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"type",
"text"
]
}
},
"$schema": {
"type": "string"
},
"version": {
"type": "string"
},
"actions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"type",
"title",
"url"
]
}
}
}
}
}
}
}
},
"required": [
"type",
"attachments"
]
}
Step 6: Design Production Process in DM
- Open Design Production Processes from the DM Launchpad
- Click Create, fill in the required details, and press Create
- Drag and drop start, script, and end controls onto the worksheet
- Select Services and add the previously created service
- Connect the controls in the sequence to retrieve order details, labor details, Script and Microsoft Teams service
Your Final Script Task should look it this(Note:- While selecting Schema in Manage Parameter you need to select your attachementSchema that you find in Manage Service Registry>your API Services name>Request Body>Schema)
Final Script Code:-
$output.attachments = [{
"contentType": "application/vnd.microsoft.card.adaptive",
"content": {
"type": "AdaptiveCard",
"body": [{
"type": "TextBlock",
"text": "Order Released Details",
"wrap": true,
"style": "heading",
"fontType": "Default",
"size": "Large",
"color": "Accent",
"isSubtle": true
},
{
"type": "ColumnSet",
"columns": [{
"type": "Column",
"width": "auto",
"items": [{
"type": "TextBlock",
"text": "Raised By-",
"wrap": true
}]
},
{
"type": "Column",
"width": "stretch",
"items": [{
"type": "TextBlock",
"text": $input.Supervisor,
"wrap": true
}]
}]
},
{
"type": "ColumnSet",
"columns": [{
"type": "Column",
"width": "auto",
"items": [{
"type": "TextBlock",
"text": "Assigned To-",
"wrap": true
}]
},
{
"type": "Column",
"width": "stretch",
"items": [{
"type": "TextBlock",
"text": $input.User,
"wrap": true
}]
}]
},
{
"type": "TextBlock",
"text": "At Location",
"wrap": true,
"style": "heading",
"separator": true,
"size": "ExtraLarge"
},
{
"type": "FactSet",
"facts": [
{
"title": "Site-",
"value": $input.Plant
},
{
"title": "Workcenter-",
"value": $input.WorkCenter
},
{
"title": "Resource-",
"value": $input.WorkCenter
}]
},
{
"type": "TextBlock",
"text": "Current Product",
"wrap": true,
"style": "heading",
"separator": true,
"size": "ExtraLarge"
},
{
"type": "FactSet",
"facts": [{
"title": "Order-",
"value": $input.OrderNumber
},
{
"title": "SFC-",
"value": $input.SFC
}]
}],
"$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
"version": "1.5",
"actions": [{
"type": "Action.OpenUrl",
"title": "View Order Details",
"url": "https://your-dm-url.test.execution.eu20.dmc.cloud.sap/cp.portal/site#ManageOrders-Display?sap-ui-app-id-hint=sap.dm.dme.manageorder&&searchPayload="+$input.OrderNumber
}]
}
}]
$output.type= "message"
6. Now, Map your Script output
I have used different service and Script Task to fetch following Details
- Current Date & Time
- Current Supervisor Name working on particular shift at particular time period
- Current Operator Name working on particular shift at particular time period
- Plant Detail
- Work Center & Resource
- Order Details
You can also create your own card design from Adaptive Cards
Final look of Production Process for Order Released
Step 7: Set Up Business Rule
- Select Manage Automatic Trigger and choose Business Rules in the DM Launch Pad
- Click Create and provide the necessary details in the Header and General Setting sections
- Configure the action to select the Production Process created earlier and map the input parameters
For Order ReleasedFor Resource Status Changed
Step 8: Testing
- Press the Run or Debug button
- Enter the required details (Plant and Order Number) and press Run
- Verify that the process executes successfully and a message is shown on the Microsoft Teams Channel
Conclusion
By following these steps, SAP Digital Manufacturing Cloud is integrated with Microsoft Teams, enabling efficient notifications and communication with operators. This integration leverages the capabilities of the Business Technology Platform to enhance operational efficiency and responsiveness
Do you enjoy this post? I would love to hear your thoughts! Share your feedback in the comments section below. Every piece of feedback is highly appreciated and valued.
Relevant community resources:
- SAP Digital Manufacturing Community
- Post and answer questions on SAP Digital Manufacturing
- Other Blog Posts on SAP Digital Manufacturing
Regards,
Kartik Singhal
- SAP Managed Tags: