Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sap-samples/btp-events-to-business-actions-framework

Build Events-to-Business Actions Scenarios with SAP BTP and Microsoft Azure/AWS
https://github.com/sap-samples/btp-events-to-business-actions-framework

4172 btp-use-case-factory business-actions events industry-4 iot sample sample-code sap-cap

Last synced: about 16 hours ago
JSON representation

Build Events-to-Business Actions Scenarios with SAP BTP and Microsoft Azure/AWS

Awesome Lists containing this project

README 

        
# Build Events-to-Business Actions Scenarios with SAP BTP and Microsoft Azure/AWS



[![REUSE status](https://api.reuse.software/badge/github.com/SAP-samples/btp-events-to-business-actions-framework)](https://api.reuse.software/info/github.com/SAP-samples/btp-events-to-business-actions-framework)



This repository contains code samples and instructions for developing an extension application in SAP BTP. The sample application has been developed to help customers enable building event-driven applications in SAP BTP for business scenarios to integrate any type of events from systems/applications/platforms into the SAP ecosystem via SAP BTP. These applications can be developed leveraging the events-to-business actions framework which helps to configure actions that need to be taken in SAP LoB systems based on the events. 



In this tutorial, the events are received from Microsoft Azure IoT and AWS IOT Platform and the actions for these events are taken in SAP S/4HANA. You can use this application to further customize it for other systems as well.



**Inbound to SAP S/4HANA**



In this scenario, events generated by Microsoft Azure/AWS IoT platforms are sent to SAP BTP's eventing service. In this tutorial, we have shown the development and configuration for SAP Advanced Event Mesh. This can be achieved using SAP Event Mesh service as well. The Node.js extension application based on the events-to-business actions framework subscribes to the Event Mesh queue and executes the action that is required to be taken based on the event details configured.



> **Important Note** : Please be aware that this GitHub repository is still work in progress for improvements and additional scenarios. Make sure you're pulling the repository from time to time and redeploying it in SAP BTP.



## Table of Contents



[Scenario](#scenario)\

[Business Process Flow](#business-process-flow)\

[Solution Architecture](#solution-architecture)\

[Implementation: Configuration and Development](#configuration-and-development)\

[Additional Resources](#additional-resources)\

[Known Issues](#known-issues)\

[Reference](#reference)\

[Disclaimer](#disclaimer)\

[How to Obtain Support](#how-to-obtain-support)\

[Code of Conduct](#codeofconduct)\

[Contributing](#contributing)\

[License](#license)



## Scenario



The business scenario you will be implementing here is to integrate real-time events generated from Microsoft Azure IoT Platform/AWS IoT into SAP business processes to enrich the outcome of enterprise operations and facilitate rapid decision-making. The framework can be extended to any platform and any kind of event.



You can choose to configure and integrate events with any SAP LoB solution.



## Business Process Flow



In this event-driven scenario, based on the real-time status of the IoT Devices, actionable events are sent to SAP BTP to decide on the critical business actions to be taken in the SAP Enterprise Business systems based on business rules defined in the system.



![plot](./images/usecase%20scenario.png)



1. Data from IoT Devices are sent to Microsoft Azure IoT Central/AWS IoT which includes all the streaming data from the devices.



2. Based on the rules in Microsoft Azure IoT/AWS IoT, the data is published to SAP Advanced Event Mesh/SAP Event Mesh in case of any actions that need attention. This is configured in IoT Rules in the IOT Platform. Similar decisions can be configured in other systems and applications as well.



3. SAP BTP acts as a consumer. Once the event details are received, the SAP BTP extension application which is configured with all necessary actions (For example, configuring the decisions in SAP Build Process Automation to decide on the action to be taken, executing the chain of actions that needs to be taken based on the event received, configure the OData API call to be executed etc) executes the respective chain of actions.



4. The extension application in SAP BTP executes the business actions in respective SAP Enterprise systems.



## Solution Architecture



The solution architecture and detailed documentation for integrating with Microsoft Azure IoT can be found at



[Integration-With-Microsoft Azure-IoT](./documentation/Integration-With-Azure-IoT/README.md).



The solution architecture and detailed documentation for integrating with AWS IoT can be found at



[Integration-with-AWS-IoT](./documentation/Integration-with-AWS-IoT/README.md).



## Additional Resources



This project has been implemented based on the following SAP CAP sample repository.



- [Cloud-cap-samples](https://github.com/SAP-samples/cloud-cap-samples/)



## Known Issues



No known issues.



## Reference



### Creation of Azure IoT solutions



[Azure IoT Central](https://azure.microsoft.com/en-in/products/iot-central/)



### Creation of AWS IoT solutions



[AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/what-is-aws-iot.html)



## Disclaimer



This project has been a proof of concept, including several limitations and prerequisites. The objective was to build a extension application for receiving and automating the actions in SAP S/4HANA. For this reason, the coding should not be seen as any recommendation for productive implementation. It fulfils the purpose and requirements of a proof of concept and is not intended for productive usage. It has been declared as pure proof of concept only to give the development teams ideas for solving potential challenges when integrating events from other platforms and SAP S/4HANA using SAP BTP. This can be extended to integrate with any other SAP LoB system as well.



## 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.

For additional support, [ask a question in the SAP Community](https://answers.sap.com/questions/ask.html).



## Contributing



If you wish to contribute code, offer fixes or improvements,  send a pull request. Due to legal reasons, contributors will be asked to accept a DCO when they create the first pull request to this project. This happens in an automated fashion during the submission process. SAP uses [the standard DCO text of the Linux Foundation](https://developercertificate.org/).



Refer to the [CONTRIBUTING](CONTRIBUTING.md) file for guidelines to contributions from external parties.



For additional support, [ask a question in the SAP Community](https://answers.sap.com/questions/ask.html).



## Code of Conduct



Refer to the [CODE OF CONDUCT](CODE_OF_CONDUCT.md) file.



## 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.