JR51596: EXPOSED SERVICES REST API DOES NOT SUPPORT FILTERING OF TOOLKIT SERVICES THAT SNAPSHOTS REFER TO

8.5.0.1-WS-BPM-IFJR51596
Version 8.5 Refresh Pack 6 for the IBM Business Process Manager products
Version 8.5.0 Fix Pack 2 for the IBM Business Process Manager products

APAR status

• Closed as program error.

Error description

• When you use the REST API /exposed to retrieve exposed services,
  or if you use IBM Process Portal (which invokes the API to
  populate the Launch tab in the right pane of the My Work page,
  in addition to the Dashboards menu), the API retrieves each
  service in each toolkit that each process application snapshot
  refers to. With a large number of snapshots that refer to
  toolkits, the set of services that the API returns can grow
  large, with some services being duplicated when multiple
  snapshots of the same application are deployed.  As a result,
  the API might perform slowly.
  
  PRODUCTS AFFECTED:
  IBM Business Process Manager (BPM) Advanced
  IBM BPM Standard
  IBM BPM Express
  

Local fix

Problem summary

• The /exposed REST API does not provide an option for filtering
  the services that are exposed in toolkits that snapshots refer
  to. As a result, each exposed service in a toolkit is included
  in the API's result set, once for the toolkit itself plus once
  for each time a process application snapshot refers to the
  toolkit.
  

Problem conclusion

• A fix is available for IBM BPM V8.5.0.0 and V8.5.0.1 that adds a
  new parameter, excludeReferencedFromToolkit, to the exposed
  services REST API, and adds a corresponding configuration
  property, com.ibm.bpm.portal.excludeReferencedFromToolkit, to
  the Mashups_ConfigService provider that Process Portal uses. The
  new parameter and new property allow you to specify the
  following multiple subtypes (comma-separated):
  
  administration_service
  dashboard
  startable_service
  url
  
  When you specify a service subtype, exposed services of that
  subtype within toolkits are not included in any application
  context that refers to them and, therefore, is included only
  once in the API result set (for the toolkit itself).
  
  On Fix Central (http://www.ibm.com/support/fixcentral), search
  for JR51596:
  
    1. Select IBM Business Process Manager with your edition from
  the product selector, the installed version to the fix pack
  level, and your platform, and then click Continue.
    2. Select APAR or SPR, enter JR51596, and click Continue.
  
  When you download fix packages, ensure that you also download
  the readme file for each fix. Review each readme file for
  additional installation instructions and information about the
  fix.
  

Temporary fix

• Not applicable
  

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

• R850 PSY

     UP