SHARK Link HTTP Interface

This HTTP interface is web service that accepts XML files posted using the HTTP protocol and the file included in the body of the post. The HTTP Interface simple receives the file and store it in a folder, where it can be imported using the normal Host Link XML Importer. So it is only a transport layer for the XML document, it will not do any processing.

Compared to a SOAP Web Service it is much simpler to setup, but there is no “contract” like the WSDL file and no status response indicating if the document actually was imported successfully. 

Configuration

 

Step 1 - Installating the required software

The portlet “ws-dump.war” most be available in the SHARK webapps folder. 

 

Step 2 - Setting Parameters

Some of the parameters, like where the files are stored, are defined in web.xml file inside the servlet. It can be required to configure this. The default folder is c:\logisoft\log\ws-dump

 

Step 3 - Web Server Configuration

The Jetty Web Server must be configured to start the portlet.

 

 

In this configuration, the URL for access in the service will be: 

http://localhost:8086/sharklink/SharkLinkAdapter.service

(localhost is replaced with the actually server name)

 

Step 4 - SHARL Link Configuration

Configure SHARK Link to import the file from the “dump” folder, using a normal XML importer.

 

Step 5 - Testing

Curl is good for testing the connection, try something like:

curl.exe -v http://localhost:8086/sharklink/SharkLinkAdapter.service  --upload-file test1.xml

 

Curl kan be downloaded from here.

This is an example of a SAP configuration, using this interface to accept IDOCs from SAP.