Bugzilla will be upgraded to version 5.0. The upgrade date is tentatively scheduled for 2 December 2018, pending final testing and feedback.
Bug 1219748 - Include list of supported commands for Decision Server
Include list of supported commands for Decision Server
Status: MODIFIED
Product: JBoss BRMS Platform 6
Classification: Retired
Component: Documentation (Show other bugs)
6.1.0
Unspecified Unspecified
urgent Severity medium
: ---
: One-off release
Assigned To: Vidya
Karel Suta
Dawn Eisner
:
Depends On:
Blocks:
  Show dependency treegraph
 
Reported: 2015-05-08 03:12 EDT by Anton Giertli
Modified: 2016-10-14 10:08 EDT (History)
2 users (show)

See Also:
Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
Environment:
Last Closed:
Type: Bug
Regression: ---
Mount Type: ---
Documentation: ---
CRM:
Verified Versions:
Category: ---
oVirt Team: ---
RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---


Attachments (Terms of Use)


External Trackers
Tracker ID Priority Status Summary Last Updated
JBoss Issue Tracker DROOLS-822 Major Pull Request Sent Missing documentation for kie-server-client 2016-09-02 01:28 EDT

  None (edit)
Description Anton Giertli 2015-05-08 03:12:54 EDT
Document URL: 

There are two URLs related

[1]
15.5.5. CommandExecutor Interface
https://access.redhat.com/documentation/en-US/Red_Hat_JBoss_BPM_Suite/6.1/html/Development_Guide/sect-Running_in_KIE.html#Available_API

[2] 10.5. THE REST API FOR MANAGING THE REALTIME DECISION SERVER - [POST]   /containers/{id}

https://access.redhat.com/documentation/en-US/Red_Hat_JBoss_BRMS/6.1/html-single/User_Guide/index.html


Section Number and Name: 

Describe the issue: 
User Guide includes following information:
Any valid command (of the type org.kie.api.Command) with correct attributes can be sent.

This is missleading and not true - there is a strict list of supported commands which can be send to Decision Server and it needs to be documented.


Suggestions for improvement: 
In [1] - list of commands should be explicitly written, it can be found here:
http://docs.jboss.org/drools/release/6.2.0.Final/drools-docs/html/ch09.html

Short XML snippet of every command should be included in form of Doc Attachment.

Then, in [2] the [1] should be referenced - saying this is the list of supported commands which can be send to endpoint

[POST]   /containers/{id}

***excluding these four***:
StartProcessCommand
SignalEventCommand
CompleteWorkItemCommand
AbortWorkItemCommand


Also, in this section:

[POST]   /
Using POST HTTP method, you can execute various commands on the Decision Server: create-container, list-containers, dispose-container and call-container.

I'd like to see examples with XML/JSON too.

Additional information:
Comment 2 Anton Giertli 2015-05-08 03:25:51 EDT
Regarding commands which can be sent to [POST] /

I think they are here:
https://github.com/droolsjbpm/droolsjbpm-integration/tree/master/kie-server-parent/kie-server-api/src/main/java/org/kie/server/api/commands
Comment 3 Anton Giertli 2015-05-08 09:17:50 EDT
(In reply to Anton Giertli from comment #2)
> Regarding commands which can be sent to [POST] /
> 
> I think they are here:
> https://github.com/droolsjbpm/droolsjbpm-integration/tree/master/kie-server-
> parent/kie-server-api/src/main/java/org/kie/server/api/commands

this should be definite proof
https://github.com/droolsjbpm/droolsjbpm-integration/blob/6.2.x/kie-server-parent/kie-server-services/src/main/java/org/kie/server/services/impl/KieServerImpl.java#L53-L79
Comment 4 Anton Giertli 2015-06-25 09:06:25 EDT
includes pull request

Note You need to log in before you can comment on or make changes to this bug.