This is an extended bookshop with business-partner address data from S/4HANA. When the user creates an order, using the value help of the shipping address triggers a synchronous request to S/4HANA yielding all possible addresses belonging to this business partner. Once an address is selected, its data is replicated into a local database. To keep data in sync, an event handler is registered listening to all changes of business partners updating the local database table.

Prerequisites

S/4HANA Cloud System (Non-Mock Case)

To run your app in non-mock mode you need an S/4HANA Cloud system and connect it to your SAP Cloud Platform. You can use the SAP Cloud Platform Extension Factory to automate parts of this task. You need to enable synchronous APIs as well as events that are sent whenever business partners are changed.

To run the app locally, you need to create a default-env.json file in the bookshop folder containing the binding information (credentials of Enterprise Messaging as well as the destination to the business-partner service).

Running With Mocks

Just execute the following command in the bookshop folder.

cds run --in-memory --with-mocks

You can emit an event by executing the first request in the file req.http.

Running With an S/4HANA Backend

Provide the credentials in the cds.requires section of the package.json file in the bookshop folder, e.g.

      "API_BUSINESS_PARTNER": {
        "kind": "odata",
        "model": "srv/external",
        "credentials": {
          "destination": "cap-api532",
          "prefix": "sap/S4HANAOD/c532/BO"
        }
      }

Here, destination is the destination of your business-partner service and prefix is the prefix of the topic of the events.

Then simply run the following command in the bookshop folder.

cds run --in-memory

User Flow

After starting the app, go to http://localhost:4004/fiori.html#Shell-home and open the app Manage Orders to create an order.