https://github.com/sap-samples/s4hana-microsoft-team-app-integration

Learn how to build a Microsoft Teams extension app and approve SAP S/4HANA purchase order in Microsoft Teams App
https://github.com/sap-samples/s4hana-microsoft-team-app-integration

4164 bridge-framework btp-use-case-factory example example-code integration microsoft-teams s4hana sap-btp

Last synced: 8 months ago
JSON representation

Learn how to build a Microsoft Teams extension app and approve SAP S/4HANA purchase order in Microsoft Teams App

• Host: GitHub
• URL: https://github.com/sap-samples/s4hana-microsoft-team-app-integration
• Owner: SAP-samples
• License: apache-2.0
• Created: 2022-12-15T00:41:33.000Z (about 3 years ago)
• Default Branch: main
• Last Pushed: 2025-03-07T13:30:07.000Z (10 months ago)
• Last Synced: 2025-03-27T05:51:10.614Z (9 months ago)
• Topics: 4164, bridge-framework, btp-use-case-factory, example, example-code, integration, microsoft-teams, s4hana, sap-btp
• Language: JavaScript
• Homepage:
• Size: 12 MB
• Stars: 12
• Watchers: 13
• Forks: 5
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          

[![REUSE status](https://api.reuse.software/badge/github.com/SAP-samples/s4hana-microsoft-team-app-integration)](https://api.reuse.software/info/github.com/SAP-samples/s4hana-microsoft-team-app-integration)

# Approve SAP S/4HANA Purchase Order in Microsoft Teams App

In this project, we would like to demonstrate how to integrate the SAP S/4HANA with the Microsoft Teams App, so that the user could perform the SAP S/4HANA purchase order approval in the Microsoft Teams App.

## Business Scenario

![Business Scenario](./assets/images/Business%20Scenario.png)

- The buyer creates a new Purchase Order in SAP S/4HANA On-Premises system.

- The purchase manager receives a notification in Microsoft Teams in the form of a dialog card.

- The purchases manager can view the details of the Purchase Order in the Microsoft Teams.

- The purchases manager can 

  - Approve the purchase order in the Microsoft Teams.

  - Reject the purchase order in the Microsoft Teams.

  - Forward the purchase order data as an adaptive card to the buyer and request more information.

## System Architecture Diagram

![System Architecture](./assets/images/System%20Architecture.png)

The **SAP BTP Bridge Framework** is the **key component** that **connecting** the **SAP S/4HANA** and **Microsoft Teams**. It is an SAP BTP based integration framework and allows user to define the UI of the extension application which will be installed in the Microsoft Teams easily and quickly by fill out JSON configuration files. 

 

The **SAP BTP Bridge Framework** also provides an **automation tool** that help you **creates underlying resources on Microsoft Azure and SAP BTP**, **deploys Bridge Framework** in your SAP BTP Subaccount, and **generates Microsoft Teams extension app**. 

 

**After the administrator installs the extension application generated by the Bridge Framework in the Microsoft Teams app**, the purchase order creator and approver will sign-in with the extension application in the Microsoft Teams app.

  - purchase order creator and approver's Microsoft Teams conversation reference will be stored in the **Microsoft Blob Storage** Service.

 

**After the purchase order creator creates a new purchase order**

  - There is an SAP S/4HANA ABAP job running on the background in the SAP S/4HANA system to send the purchase order data and release purchase order workflow data to the message queue in the SAP BTP Event Mesh Service.

  

  - The Bridge Framework backend service listening on the message queue, consume the data coming from SAP S/4HANA system.

  

  - The Bridge Framework backend service process the data, get purchase order approver information, and generate the notification card.

  

    - Extract the email address of purchase order creator and purchase order approver from the message.

    - Fetch purchase order approver's user profile by calling Microsoft Graph Service.

    - Fetch purchase order approver's conversation reference based on user profile by calling Microsoft Blob Storage Service.

    - Encapsulate the purchase order data and workflow instance data into the notification card.

  - The Microsoft Bot Service send notification card to the purchase order approver based on the conversation reference.

 

**After the purchase order approver receive the notification card in the Microsoft Teams app**, they could view the details information of purchase order, and approve/reject the purchase order by click the button in the notification card. The implementation of this functionality is

  - Once the user clicks the button, the Microsoft Teams token, which contains user information, will be send to the Bridge Framework backend service.

  - The Bridge Framework backend service will exchange the user's Microsoft Teams token to the SAP BTP Access Token via principal propagation.

  

  - The Bridge Framework will consume the SAP S/4HANA Purchase Order API, along with user's BTP access token, to fetch the purchase order data from SAP S/4HANA system.

  - The Bridge Framework will consume the SAP S/4HANA Task Gateway Service, along with user's BTP access token, to update the workflow instance data in SAP S/4HANA system to approve/reject the purchase order.

  

  - In-order to consume the SAP S/4HANA APIs from the SAP BTP, the SAP BTP Destination Service, and SAP BTP Connectivity Service is needed.

  

  - The Cloud Connector needs to be installed in the SAP S/4HANA system, to enable the communication between SAP S/4HANA and SAP BTP.

## How to obtain support

[Create an issue](https://github.com/SAP-samples//issues) in this repository if you find a bug or have questions about the content.

 

## License

Copyright (c) 2022 SAP SE or an SAP affiliate company. All rights reserved. This project is licensed under the Apache Software License, version 2.0 except as noted otherwise in the [LICENSE](LICENSE) file.