JR57862: RETURN STATEMENTS IN COACH VIEW LOAD, UNLOAD, OR BOTH TYPES OF EVENT HANDLERS CAUSE USER-DEFINED EVENT HANDLERS TO BREAK

bpm.8570.cf2017.06.delta.repository

APAR status

• Closed as program error.

Error description

• A return statement that runs in the load, unload, or both types
  of coach view event handlers affects how the parent view object
  is assigned. Because the parent view is not fully initialized,
  the user-defined events don't work properly. IBM Business
  Process Manager (BPM) users are unaware that some IBM BPM code
  will no longer run because the return statement ran. The
  following JavaScript error is recorded in the browser's console
  log file:
  
  "Cannot read property getParrent  of undefined."
  
  PRODUCTS AFFECTED:
  IBM Business Process Manager (BPM) Advanced
  IBM BPM Standard
  IBM BPM Express
  

Local fix

• Explicitly add the IBM BPM code (see the lines starting with
  this.bpmEventHelper... below) to the load event handler before
  the custom load code, or wrap the load event handler code in a
  try...finally block.
  

Problem summary

• For the user-defined event framework, additional code is
  appended to event handlers when coaches are generated. If the
  load, unload, or both types of event handlers do not contain the
  return statement, this code runs and performs some
  initialization that are key to events being handled correctly
  later on.
  

Problem conclusion

• A fix will be included in IBM BPM V8.5.7 cumulative fix 2017.06
  that ensures code injected into the load, unload, or both event
  handlers when coaches are generated at run time.
  

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

• Fixed component name

  BPM STANDARD

• Fixed component ID

  5725C9500

Applicable component levels

• R857 PSY

     UP