A fix is available
APAR status
Closed as documentation error.
Error description
When using businessData.get() JS API , the results may different and the values returned may be unexpected if the BO is of List type. If an element/index was previously selected , future data retrieval will only return the data of that element. This is unclear for users utilizing this API.
Local fix
n/a
Problem summary
**************************************************************** * USERS AFFECTED: IBM BPM Express, Standard and Advanced. * **************************************************************** * PROBLEM DESCRIPTION: Applications using Javascript API * * businessData.get() may get unexpected * * results when retrieving business data. * **************************************************************** * RECOMMENDATION: * **************************************************************** It is unclear how the Javascript API TWProcessInstance.businessData.get() method works as the documentation does not state what is returned explicitly. When invoking businessData.get() on a business object of type List, if an index was previously selected, only the selected indecies will return. If no indicies were selected then the returned object will be of type List.
Problem conclusion
If it is not intended to only retrieve the selected indicies during runtime, the API method listClearAllSelected() must be called prior to businessData.get(). The business object will no longer have selected indicies and will return as a List object when retrieved. A document APAR has been created to improve the current Javascript API reference table and add information on how to use these APIs in conjunction.
Temporary fix
Comments
APAR Information
APAR number
JR48591
Reported component name
BPM ADVANCED
Reported component ID
5725C9400
Reported release
800
Status
CLOSED DOC
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2013-11-22
Closed date
2014-01-21
Last modified date
2014-01-21
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
Fix information
Applicable component levels
[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSFTN5","label":"IBM Business Process Manager Advanced"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"8.0","Line of Business":{"code":"LOB45","label":"Automation"}}]
Document Information
Modified date:
12 October 2021