Title: Collaboration mechanisms Describe the issue: Documentation in this paragraph is inconsistent and unusable Suggestions for improvement: REWRITE maybe? also, the whole section does not seem to have been spell checked. Additional information: This is in the BPMS 6 User Guide To be more specific in A.3 "Messages: intended primarily for communication with other systems especially if a complex data type is required (it is possible ton define a Message structure that can become a process variable" and then, an few lines below, in "Messages are ment for inter-Process communication, not for communication with other external systems" SO WHICH STATEMENT IS TRUE?? in general there is no how-to documentation on this subject: nowhere in this User guide is it explained how to send and receive messages (or signals??) with DATA, and how they are correlated. And nowhere in the developer's guide either.
Thanks for reporting this Andrea. I am looking into it and will update it shortly.
Andrea. Once again, thanks for reporting this. I have had a better look at this. I agree, we should provide info about how to use signals and messages and to do that I have created a separate bug to track the work [2]. I have removed the following statement: "Messages are ment for inter-Process communication, not for communication with other external systems" and also fixed many typos in those two sections. This work can be verified starting here [1]. Once it has been verified, I will update the docs on access.redhat.com with an async release. [1] https://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_JBoss_BPM_Suite/6.0/html-single/User_Guide/index.html#sect-Collaboration_mechanisms [2] https://bugzilla.redhat.com/show_bug.cgi?id=1157869
freely citing Maciej: Messages are actually implemented as signals which makes them scoped only for given ksession so only communication within the process and between process instances. For external system interaction send and receive task should be used with proper handler implementation. WorkItemHandler is the interface to implement and will be technology dependent (JMS, REST, WS, ..). Send and receive task implementation should require simple message object in contrary to 'ordinary' user specific service task implementations of WorkItemHandler interface.
Jiri - sorry for the delay in this. But I have fixed the text in the colloboration mechanisms chapter to clarify the definition of Messages from Maciej. This can be verified here [1]. Moving this back to ON_QA. [1] https://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_JBoss_BPM_Suite/6.0/html-single/User_Guide/index.html#sect-Collaboration_mechanisms
Thanks Vikram, verified.
*** Bug 1121708 has been marked as a duplicate of this bug. ***