Executing a ruleset from a client

You can execute a valid ruleset by creating an XML request and using the POST method.

About this task

To execute a deployed ruleset by using the REST service, you generate the XML payload and post the request. You can also generate a WADL representation of request and response elements. See Generating a WADL representation.

In your client, you construct the request message as an XML packet, which depends on the XML signature in WADL format of the REST service. The client must specify the web service URL, pass in the request, and specify a variable to hold the response from the service.

Procedure

Generate an XML fragment by posting your request to the following URI.

http://{host}:{port}/DecisionService/rest/v1/{rulesetPath}/xml

Example:

GET http://localhost:9080/DecisionService/rest/v1/miniloanRuleApp/1.0/miniloanRuleset/1.0/xml

Then, you can use the result as a starting point to write an XML request.

Validate the XML structure of the request by posting your request to the following URI.
```
http://{host}:{port}/DecisionService/rest/v1/{rulesetPath}/validate
```
Example:
```
POST http://localhost:9080/DecisionService/rest/v1/miniloanRuleApp/1.0/miniloanRuleset/1.0/validate
```
Tip: You can test the generation of the XML code also from the Rule Execution Server console as explained in Testing a ruleset for REST execution.
Post the execution request to the following URI: .
```
http://{host}:{port}/DecisionService/rest/v1/{rulesetPath}
```
REST requests for execution use the POST method. The request body contains the XML payload Example:
```
POST http://localhost:9080/DecisionService/rest/v1/miniloanRuleApp/1.0/miniloanRuleset/1.0
```
The execution response is sent in XML format. If the request is not valid, error messages are returned in JSON format. For more information, see Request and response schema.