JR47104: PROCESS PORTAL FAILS LOADING AFTER BULK ATTRIBUTE UPDATE IN PROCESS ADMIN CONSOLE

Download Version 8.0.1 Fix Pack 2 for the IBM Business Process Manager products
Version 8.5.0 Fix Pack 1 for the IBM Business Process Manager products
Version 8.5 Refresh Pack 5 for the IBM Business Process Manager products

APAR status

• Closed as program error.

Error description

• The Process Admin Console allows administrators to update user
  attributes either by attribute or by user
  via the Bulk User Attribute Assignment panel (below Server Admin
  area of
  the Process Admin Console,
  click User Management, then Bulk User Attribute Assignment).
  
  In some circumstances, updates using this panel may prevent
  users from
  using Process Portal by updating the
  user's profile incorrectly. There are two known cases:
  1) Assigning an empty value to the 'Locale' attribute via the
  'View by
  Attribute' option
  2) Submitting an empty panel using the update button on the
  'View by
  User' option in an LDAP setup.
  
  In both cases, instead of the empty string a NULL value might be
  written
  to the database for the Locale attribute,
  causing Process Portal to fail loading afterwards.
  
  As a symptom, you may see the following exception in the
  SystemOut.log:
  RestHelper    W   parameter 'locale' must be not null
   java.lang.IllegalArgumentException: parameter 'locale' must be
  not null
   at
   com.lombardisoftware.utility.i18n.LocaleUtils.transformDefaultT
  oDojoLoc
  ale
  

Local fix

• n/a
  

Problem summary

• The Process Admin Console allows administrators to update user
  attributes either by attribute or by user via the Bulk User
  Attribute Assignment panel (below Server Admin area of the
  Process Admin Console, click User Management, then Bulk User
  Attribute Assignment).
  
  PROBLEM DETAILED DESCRIPTION:
  Under some circumstances, updates using this panel may prevent
  users from using Process Portal by updating the user's profile
  incorrectly. There are two known cases:
  1) Assigning an empty value to the 'Locale' attribute via the
   'View by Attribute' option
  2) Submitting an empty panel using the update button on the
   'View by User' option in an LDAP setup.
  
  In both cases, instead of the empty string a NULL value might be
  written to the database for the Locale attribute, causing
  Process Portal to fail loading afterwards.  As a symptom, you
  may see the following exception in the SystemOut.log:
    RestHelper    W   parameter 'locale' must be not null
      java.lang.IllegalArgumentException: parameter 'locale'
      must be not null
    at com.lombardisoftware.utility.i18n.LocaleUtils.
      transformDefaultToDojoLocale
  

Problem conclusion

• After installing the fix, Process Portal will tolerate NULL for
  the locale, and just picks the default locale then.  Process
  Admin wrote attributes that weren't changed. Now only values
  that were changed are written to the DB.
  
  FIX AVAILABILITY:
  iFix for 8.0.1.1 is available on Fix Central, search for APAR
  JR47104 at http://www.ibm.com/support/fixcentral/
  Fix is also targetted for inclusion in next fixpack for BPM
  8.0.1, BPM 8.5.0
  
  When obtaining any of the above fixes, be sure to download the
  accompanying readme, for itself, and any prerequisite fixes, and
  review them thorougly.
  

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

• R801 PSY

     UP