SAP HANA Cloud Integration (HCI) has recently become the official cloud integration solution for SAP SuccessFactors.
If you are new to HCI, I’m sure you will start playing with simple integration payloads and follow those payloads from the beginning to the end of the integration process. One thing you will figure out quickly is that tracing a payload message or output of the integration is a little tricky. HCI provides you with a range of pre-built connectors that you can use for incoming and outgoing channels (such as SFTP, HTTPS, etc.). However, if you’re missing any of the items required to set up these connections, for example, certificates, it can be difficult to get started.
In this blog, I will propose a quick solution for the problem mentioned above. I will describe how to create a lightweight web listener/end point using PHP (server side programming language). This channel will be a useful tool to have available during development. We will make this end point (URL where your service can be accessed by a client application) capable of recording the information into a file. It will also have the capability to display the information back as a web service response, which is great to test web service payload response scenarios.
This web listener will run on HTTP rather than HTTPS to make sure it is lightweight, easy to install, and doesn’t require a certificate or any authentication.
- You must have access to a web server host with a folder exposed to the internet
- The web server must support PHP
Steps to create the web listener:
- Open a text editor of your choice (such as notepad++) and create a file called: show.php
- Enter the following lines of code into the file and save the file
- Upload the file into the web hosting server via FTP. You may end up with a page such as http://www.yourhosting.com/myfolder/show.php. This URL will be your end point.
- You are done!
Testing the web listener:
Use SOAP UI or any other software that allows you to quickly post information to an end point. The screenshot below is the "Advanced REST Client Application" plugin for Chrome.
As you can see in the screenshot above, the output in green responds with the same information that was used for the POST method of the payload section.
You may also use the following options to turn off displaying and/or saving into a file. These two alternatives may be useful depending on the integration you are building.
Using the Web listener in HCI:
Once you have tested to see that the end point is functioning, you may use it in HCI as your HTTP channel.
1. Go to your Adapter Type options and select HTTP.
2. Go to the Adapter Specific settings and enter your end point. Select POST and authentication None.
3. Now run your integration and see how the payload gets posted into this channel. As a result, a new .txt file is created on the server with the payload!
4. Connect via FTP to see the files created.
Read our other posts on integrations here.
Disclaimer: This script is to be use in development environments only. It is not intended for production environments. Any script that generates a file into the web server needs to be used with caution as it has a risk of Cross-site scripting (XSS) attacks.