Forward XML responses via HubCapp

Apps make XML requests to Compliance Engines (Logistics Server). The XML responses from such requests can be forwarded to a third party URL for supplementary processing. For example, they can be used to update an external system.

XML forwarding

The process is managed by HubCapp:

  1. The Data Agent Xml Response Proxy snippet must be included in the App, and configured to say which XML requests will have their responses forwarded.
  2. HubCapp Data Agent must be installed on the user’s machine, and configured to provide the target URL.

The Data Agent effectively listens for XML responses, handles them as normal, but also forwards them. To the user, the App behaves as normal.

Add the snippet

Open the App in Designer, and add the Data Agent Xml Response Proxy snippet. It has no UI for the user, so it can be placed anywhere on the canvas. Once included, configure its parameters.

In Schema Names, provide the names of the Pierbridge XSDs that will have their responses forwarded. This a comma-separated list.

If you set Server Name, License Key and Machine Name, then HubCapp Server instance is used for all App users. If you leave them unset, then the user’s settings provided in the App’s Peripheral Config Setting snippet (the Settings icon on a typical App) are used (meaning users can use different HubCapp Server instances for forwarding).

Use Send Request Data to include the client request XML, nested in a Request node, within the forwarded XML response.

Configure the user's HubCapp Data Agent

Install HubCapp Data Agent on the user’s machine, connect to the HubCapp Server (use Settings), and then configure XML response forwarding on the XML Forwarding Settings tab.

The Forwarding URL and Content Type are the minimum required fields, and the protocol needs to be included for the URL (for example, https://forwardingendpoint.com). The Proxy settings only need to be set when the URL is behind a proxy.

Article last edited 2 November 2022