JR48591: UNEXPECTED RESULTS WHEN RETRIEVING BUSINESSDATA OBJECT USING JS API

Version 8.5 Refresh Pack 5 for the IBM Business Process Manager products

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 is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

Applicable component levels