XF-Application-Mocks

Contains lightweight substitutes for SAP applications to ease the development and testing of extension and integration scenarios based on Varkes. Together with SAP Business Technology Platform, Kyma Runtime, it allows for efficient implementation of application extensions without the need to access the real SAP applications during development.

Description

The SAP Business Technology Platform, Kyma Runtime is designed to easily extend and mash up different SAP applications and third-party APIs. To demo SAP Business Technology Platform, Kyma Runtime functionality, you can use a dummy application for integration rather than a full-blown application setup.

A smart and lightweight mock application allows you to save installation time, maintenance effort, and resources. Use its user-friendly interface to:

• Successfully simulate requests or Events sent from an external system to SAP Business Technology Platform, Kyma Runtime, and returned responses.
• Testing functionality in or on top of the SAP Business Technology Platform, Kyma Runtime without worrying about the dependencies.

The application mocks in this repository provide dummy implementations for most of the SAP Customer Experience applications. They are not bound to SAP Business Technology Platform, Kyma Runtime scenarios and can be operated standalone. All mocks are built with the API-driven approach in mind.

Requirements

The application mocks are NodeJS projects based on Varkes libraries and Express web framework. To run them, you require a Docker-based container infrastructure, like pure Docker, Kubernetes or SAP Business Technology Platform, Kyma Runtime.

Installation

Each application mock holds detailed installation instructions in a README file:

• SAP Commerce Cloud Mock
• SAP Commerce Cloud Mock (Lite edition)
• SAP Marketing Cloud Mock
• SAP Cloud for Customer Mock

Usage

To run the mocks using Kyma as the runtime environment, run the following kubectl command to set up a namespace:

kubectl create namespace mocks
kubectl label namespace mocks env=true

and to deploy the mock on SAP Business Technology Platform, Kyma Runtime

kubectl apply -n mocks -f https://raw.githubusercontent.com/SAP/xf-application-mocks/main/commerce-mock/deployment/kyma.yaml
kubectl apply -n mocks -f https://raw.githubusercontent.com/SAP/xf-application-mocks/main/commerce-mock-lite/deployment/kyma.yaml
kubectl apply -n mocks -f https://raw.githubusercontent.com/SAP/xf-application-mocks/main/marketing-mock/deployment/kyma.yaml
kubectl apply -n mocks -f https://raw.githubusercontent.com/SAP/xf-application-mocks/main/c4c-mock/deployment/kyma.yaml

Known issues

The application mocks based on the @varkes/odata-mock (currently the marketing and c4c mocks) do not support any relations between the model definitions provided in the related EDMX files. A solution supporting the full EDMX specification will be provided soon.

Support

If you find an issue or want to submit an idea, open a Github Issue. Also, feel free to contribute by creating a pull request.

License

Copyright (c) 2020 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 file.