Red Hat Training
A Red Hat training course is available for Red Hat Decision Manager
Chapter 13. Configure the Red Hat Business Optimizer REST API
The Decision Server supports the following Red Hat Business Optimizer REST APIs. These APIs are also available through JMS and the Java client API.
Prerequisite
Red Hat Decision Manager has been installed and configured with basic HTTP Authentication for the kie-server
role. You have identified the server endpoint base URL, for example, http://SERVER:PORT/CONTEXT/services/rest/server/
.
-
To get a specific marshalling format, add the HTTP headers
Content-Type
and optionalX-KIE-ContentType
in the HTTP request. For example:
Content-Type: application/xml X-KIE-ContentType: xstream
X-KIE-ContentType
supports the following values: xstream
, xml
, json
.
The requests and responses in the example below assume that a KIE container is built using the Employee Rostering example in Decision Central, by calling a PUT
on /services/rest/server/containers/employee-rostering
with this content:
<kie-container container-id="employee-rostering"> <release-id> <group-id>employeerostering</group-id> <artifact-id>employeerostering</artifact-id> <version>1.0.0-SNAPSHOT</version> </release-id> </kie-container>
13.1. [GET] /containers
Returns the list of created containers.
Example 13.1. Example Server Response (XStream)
<response type="SUCCESS" msg="List of created containers"> <result class="kie-containers"> <kie-container> <container-id>employee-rostering</container-id> <release-id> <group-id>employeerostering</group-id> <artifact-id>employeerostering</artifact-id> <version>1.0.0-SNAPSHOT</version> </release-id> <resolved-release-id> <group-id>employeerostering</group-id> <artifact-id>employeerostering</artifact-id> <version>1.0.0-SNAPSHOT</version> </resolved-release-id> <status>STARTED</status> <scanner> <status>DISPOSED</status> </scanner> </kie-container> </result> </response>
13.2. [PUT] /containers/{containerId}/solvers/{solverId}
Creates a new solver with the given {solverId}
in the container {containerId}
. The request’s body is a marshalled SolverInstance
entity that must specify the solver configuration file.
The following is an example of the request and the corresponding response.
Example 13.2. Example Server Request (XStream)
<solver-instance> <solver-config-file>employeerostering/employeerostering/EmployeeRosteringSolverConfig.solver.xml</solver-config-file> </solver-instance>
Example 13.3. Example Server Response (XStream)
<solver-instance> <container-id>employee-rostering</container-id> <solver-id>solver1</solver-id> <solver-config-file>employeerostering/employeerostering/EmployeeRosteringSolverConfig.solver.xml</solver-config-file> <status>NOT_SOLVING</status> <score/> </solver-instance>
13.3. [GET] /containers/{containerId}/solvers
Returns the list of solvers created in the container.
Example 13.4. Example Server Response (XStream)
<org.kie.server.api.model.instance.SolverInstanceList> <solvers> <solver-instance> <container-id>employee-rostering</container-id> <solver-id>solver1</solver-id> <solver-config-file>employeerostering/employeerostering/EmployeeRosteringSolverConfig.solver.xml</solver-config-file> <status>NOT_SOLVING</status> <score/> </solver-instance> </solvers> </org.kie.server.api.model.instance.SolverInstanceList>
13.4. [GET] /containers/{containerId}/solvers/{solverId}
Returns the current state of the solver {solverId}
in container {containerId}
.
Example 13.5. Example Server Response (XStream)
<solver-instance> <container-id>employee-rostering</container-id> <solver-id>solver1</solver-id> <solver-config-file>employeerostering/employeerostering/EmployeeRosteringSolverConfig.solver.xml</solver-config-file> <status>NOT_SOLVING</status> <score/> </solver-instance>
13.5. [POST] /containers/{containerId}/solvers/{solverId}/state/solving
Starts the solver {solverId} in container {containerId} if it is not executing yet. The request’s body is a marshalled PlanningSolution
to be optimized.
The following is an example to solve the OptaCloud problem with 2 computers and 6 processes. The solver runs asynchronously. Send a request to the bestsolution URL to get the best solution.
Example 13.6. Example Server Request (XStream)
<employeerostering.employeerostering.EmployeeRoster> <employeeList> <employeerostering.employeerostering.Employee> <name>John</name> <skills> <employeerostering.employeerostering.Skill> <name>reading</name> </employeerostering.employeerostering.Skill> </skills> </employeerostering.employeerostering.Employee> <employeerostering.employeerostering.Employee> <name>Mary</name> <skills> <employeerostering.employeerostering.Skill> <name>writing</name> </employeerostering.employeerostering.Skill> </skills> </employeerostering.employeerostering.Employee> <employeerostering.employeerostering.Employee> <name>Petr</name> <skills> <employeerostering.employeerostering.Skill> <name>speaking</name> </employeerostering.employeerostering.Skill> </skills> </employeerostering.employeerostering.Employee> </employeeList> <shiftList> <employeerostering.employeerostering.Shift> <timeslot> <startTime>2017-01-01T00:00:00</startTime> <endTime>2017-01-01T01:00:00</endTime> </timeslot> <requiredSkill reference="../../../employeeList/employeerostering.employeerostering.Employee/skills/employeerostering.employeerostering.Skill"/> </employeerostering.employeerostering.Shift> <employeerostering.employeerostering.Shift> <timeslot reference="../../employeerostering.employeerostering.Shift/timeslot"/> <requiredSkill reference="../../../employeeList/employeerostering.employeerostering.Employee[3]/skills/employeerostering.employeerostering.Skill"/> </employeerostering.employeerostering.Shift> <employeerostering.employeerostering.Shift> <timeslot reference="../../employeerostering.employeerostering.Shift/timeslot"/> <requiredSkill reference="../../../employeeList/employeerostering.employeerostering.Employee[2]/skills/employeerostering.employeerostering.Skill"/> </employeerostering.employeerostering.Shift> </shiftList> <skillList> <employeerostering.employeerostering.Skill reference="../../employeeList/employeerostering.employeerostering.Employee/skills/employeerostering.employeerostering.Skill"/> <employeerostering.employeerostering.Skill reference="../../employeeList/employeerostering.employeerostering.Employee[3]/skills/employeerostering.employeerostering.Skill"/> <employeerostering.employeerostering.Skill reference="../../employeeList/employeerostering.employeerostering.Employee[2]/skills/employeerostering.employeerostering.Skill"/> </skillList> <timeslotList> <employeerostering.employeerostering.Timeslot reference="../../shiftList/employeerostering.employeerostering.Shift/timeslot"/> </timeslotList> <dayOffRequestList/> <shiftAssignmentList/> </employeerostering.employeerostering.EmployeeRoster>
13.6. [POST] /containers/{containerId}/solvers/{solverId}/state/terminating-early
Requests the solver to terminate early, if it is running. This does not delete the solver, the best solution can still be retrieved.
13.7. [GET] /containers/{containerId}/solvers/{solverId}/bestsolution
Returns the best solution found at the time the request is made. If the solver has not terminated yet (so the status
field is still SOLVING
), it will return the best solution found up to then, but later calls can return a better solution.
Example 13.7. Example Server Response (XStream)
<solver-instance> <container-id>employee-rostering</container-id> <solver-id>solver1</solver-id> <solver-config-file>employeerostering/employeerostering/EmployeeRosteringSolverConfig.solver.xml</solver-config-file> <status>NOT_SOLVING</status> <score scoreClass="org.optaplanner.core.api.score.buildin.hardsoft.HardSoftScore">0hard/0soft</score> <best-solution class="employeerostering.employeerostering.EmployeeRoster"> <employeeList> <employeerostering.employeerostering.Employee> <name>John</name> <skills> <employeerostering.employeerostering.Skill> <name>reading</name> </employeerostering.employeerostering.Skill> </skills> </employeerostering.employeerostering.Employee> <employeerostering.employeerostering.Employee> <name>Mary</name> <skills> <employeerostering.employeerostering.Skill> <name>writing</name> </employeerostering.employeerostering.Skill> </skills> </employeerostering.employeerostering.Employee> <employeerostering.employeerostering.Employee> <name>Petr</name> <skills> <employeerostering.employeerostering.Skill> <name>speaking</name> </employeerostering.employeerostering.Skill> </skills> </employeerostering.employeerostering.Employee> </employeeList> <shiftList> <employeerostering.employeerostering.Shift> <timeslot> <startTime>2017-01-01T00:00:00</startTime> <endTime>2017-01-01T01:00:00</endTime> </timeslot> <requiredSkill reference="../../../employeeList/employeerostering.employeerostering.Employee/skills/employeerostering.employeerostering.Skill"/> </employeerostering.employeerostering.Shift> <employeerostering.employeerostering.Shift> <timeslot reference="../../employeerostering.employeerostering.Shift/timeslot"/> <requiredSkill reference="../../../employeeList/employeerostering.employeerostering.Employee[3]/skills/employeerostering.employeerostering.Skill"/> </employeerostering.employeerostering.Shift> <employeerostering.employeerostering.Shift> <timeslot reference="../../employeerostering.employeerostering.Shift/timeslot"/> <requiredSkill reference="../../../employeeList/employeerostering.employeerostering.Employee[2]/skills/employeerostering.employeerostering.Skill"/> </employeerostering.employeerostering.Shift> </shiftList> <skillList> <employeerostering.employeerostering.Skill reference="../../employeeList/employeerostering.employeerostering.Employee/skills/employeerostering.employeerostering.Skill"/> <employeerostering.employeerostering.Skill reference="../../employeeList/employeerostering.employeerostering.Employee[3]/skills/employeerostering.employeerostering.Skill"/> <employeerostering.employeerostering.Skill reference="../../employeeList/employeerostering.employeerostering.Employee[2]/skills/employeerostering.employeerostering.Skill"/> </skillList> <timeslotList> <employeerostering.employeerostering.Timeslot reference="../../shiftList/employeerostering.employeerostering.Shift/timeslot"/> </timeslotList> <dayOffRequestList/> <shiftAssignmentList/> <score>0hard/0soft</score> </best-solution> </solver-instance>
13.8. [POST] /containers/{containerId}/solvers/{solverId}/problemfactchanges
Real-time planning feature. Submits one or multiple ProblemFactChanges to update the dataset the solver currently optimizes.
13.9. [GET] /containers/{containerId}/solvers/{solverId}/problemfactchanges/processed
Real-time planning feature. Returns true if the solver processed all ProblemFactChanges that had been submitted. Returns false otherwise.
13.10. [DELETE] /containers/{containerId}/solvers/{solverId}
Disposes the solver {solverId}
in container {containerId}
. If it has not terminated yet, it terminates it first.