WHINT MessageStore Viewer for SAP Cloud Integration

Description

The WHINT MessageStore Viewer allows you to retrieve messages and their payload persisted in the SAP Cloud Integration.

Installation

The easiest way to install the MessageStore Viewer is by deploying an official release which comes with the following features enabled:

• XSUAA Authentication to prevent unauthorized access to your instance
• SAP Connectivity Service to access on-premise systems e.g. SAP Process Orchestration
• 3 pre-defined destinations for development, staging and production system
• a default route whint-msv-\<space>.cfapps.\<region>.hana.ondemand.com

As it is not yet possible to upload the application in the BTP Cockpit, please make sure that you have installed the Cloud Foundry CLI. First login to your organization and choose the target space with

cf login

then start the deployment by running

cf deploy MessageStoreViewer_1.0.0.mtar

When the installation has finished, you will see the URL where the MessageStore Viewer is available

Application "MessageStoreViewer" started and available at "whint-msv-yourspace.cfapps.eu10.hana.ondemand.com"

Configuration

Go to your subaccount in the BTP Cockpit and assign the Role Collection MessageStoreViewer to everyone who is supposed to have access to the application.

Create at least one of following destinations that will show up as Development, Staging and Production in the MessageStore Viewer

• MSV_DEV (Development)
• MSV_STG (Staging)
• MSV_PRD (Production)

point them to your tenants API e.g. https://p0001-tmn.hci.eu1.hana.ondemand.com/api/v1 and make sure the property HTML5.DynamicDestination is set to true.

Congratulations, the WHINT MessageStore Viewer is now ready!

Advanced Options

For advanced configuration e.g. of the route, authentication or destinations, you can deploy a locally build version of the WHINT MessageStore Viewer. The only prerequisite is that you have a recent version of Node.js installed.

Clone the repository and install the dependencies (this may take some time)

git clone https://github.com/whint/messagestore-viewer-cf
npm install

The following configuration files can then be adjusted as needed:

• uimodule/webapp/manifest.json (destinations)
• mta.yaml (route, authentication, connectivity and general parameters)

A detailed description of the MTA Descriptor is available in the official documentation.

When you're done, build and deploy your application with

npm run build:mta
npm run deploy:cf

After deployment, the application can be tested locally with the destinations enabled through the App Router. Install the dependencies once

cd approuter
npm install

then copy the output of cf env MessageStoreViewer, node VCAP_SERVICES (wrapped in {...} to make it valid JSON) into approuter/default-env.json. Re-deploying the application may invalidate the environment, repeat if you get an error. Please note that the file contains sensitive data and should be kept in a safe place.

As there is no live-reload feature, the application has to be build and run manually every time the code changes

cd .. && npm run build:mta && cd approuter && npm run start

Support

Feel free to create an issue on GitHub if you have any questions or problems.

Credits

Made with 💙 by whitepaper.id GmbH using easy-ui5. Released under the GNU General Public License.