Configuring a web service endpoint

You can configure the endpoint of a SOAP or REST decision web service, typically to point to a proxy URL rather than the URL where the WSDL, WADL, and OpenAPI files are generated from.

About this task

If you use a load balancer or proxy, you can configure the web service to point to the proxy URL rather than the URL where the WSDL, WADL, and OpenAPI files are generated from. A web service specifies a single interface that the service supports, and a list of endpoint locations where that service can be accessed. To direct the messages through another endpoint, you must rewrite the endpoint URL of the service. After you changed the web service endpoint, you can execute the service without reliance on the URL where the WSDL, WADL, or OpenAPI file is generated from.
You can change the web service endpoint in two ways:
  • You can use the Rule Execution Server console as explained in this procedure.
  • When you execute a decision service with a client that is generated by using a WSDL, WADL, or OpenAPI file, you can also override the URL of the decision service in the client itself. For example, in Axis (see the Apache Axis page at http://axis.apache.org/axis/index.html), a ServiceLocator class is available in the web service client classes that are generated with Rule Designer. The ServiceLocator class defines the getExecutionPreTradeChecksPort method, which takes a URL as a parameter. The name of this class depends on the name of the ruleset. For example:
    PreTradeChecksDecisionService_PortType pt = locator.getExecutionPreTradeChecksPort (URL);

Procedure

  1. Start your application server (or the sample server), open the Rule Execution Server console, and sign in to it.
  2. Click the Explorer tab, expand the RuleApp that you want, and select a ruleset to open the Ruleset View.
  3. Expand Hosted Transparent Decision Services (HTDS) Options.
  4. Click Edit.
  5. Customize the URL in the Web service endpoint section.
  6. Click Save. To undo your changes, click Cancel instead of Save.

Results

The generated WSDL, WADL, or OpenAPI descriptors includes the updated Web service endpoint information as part of their service URL.