IBM Support

Release Note: Event subscriptions configured in IBM FileNet Content Manager 5.5.2 and handled by a BPMEventHandler event action fail to trigger event notifications to IBM Business Automation Workflow

Release Notes


Abstract

When event subscriptions are configured in IBM FileNet Content Manager 5.5.2 and handled by a BPMEventHandler event action, event notifications are not triggered and passed to the IBM Business Automation Workflow system.

This problem has not been observed in IBM FileNet Content Manager 5.5.0 or earlier.


Content

Symptom

To better understand this problem and its symptoms, assume that a Business Automation Workflow system is configured to receive notifications from a document CheckinEvent event in IBM FileNet Content Manager 5.5.2. When a document is uploaded into IBM FileNet Content Manager 5.5.2, the CheckinEvent in FileNet Content Manager triggers a CheckedIn event in BPMEventHandler. The expected behavior of the CheckedIn event in BPMEventHandler is to notify the Business Automation Workflow system that a document is checked in. This notification might launch, for example, a BPM process in the Business Automation Workflow system. However, BPMEventHandler throws one of the following two exceptions instead:

  • com.ibm.bpm.integration.filenet.BPMEventHandler\n
java.lang.NoClassDefFoundError: org.apache.commons.httpclient.Credentials\n
  • java.lang.ClassNotFoundException: org.apache.commons.codec.DecoderException
 

Cause

The following JAR files were bundled in earlier releases of IBM FileNet Content Manager 5.5.x but are no longer bundled in IBM FileNet Content Manager 5.5.2 and later releases:
  • commons-httpclient-3.0.1.jar
  • commons-codec-1.3-minus-mp.jar
There are no plans to bundle these JAR files in IBM FileNet Content Manager 5.5.x in the future.
 

Diagnosing The Problem

When this problem occurs, the NoClassDefFoundError or ClassNotFoundException exception is thrown (as described above in the Symptom section).
 

Resolving The Problem

Business Automation Workflow 19.0.0.1 and 19.0.0.2 can be configured to receive event notifications from IBM FileNet Content Manager 5.5.2 by following the steps in the help topic Using the event handler for FileNet Content Manager. In the "Creating the event action" section of the help topic, the current step 5 explains how to specify a JAR file as the code module in the Administration Console for Content Platform Engine (ACCE). For your convenience, steps 4 and 5 from the help topic are provided below. However, the instructions in step 5 below are enhanced and you should follow them rather than step 5 in the help topic:

4. On the Specify the Type of Event Action page, enter the Java class handler com.ibm.bpm.integration.filenet.BPMEventHandler. Enable the Configure code module check box. Click Next.

5. On the Specify the Code Module page, enter a Code Module title, for example, "BPM event handler code module". Click Browse and select and add the following JAR files:
  • filenet-bpm-event-handler-51 JAR file
  • commons-httpclient JAR file (which can be downloaded from https://mvnrepository.com/artifact/commons-httpclient/commons-httpclient/3.0.1)
  • commons-codec JAR file (which can be downloaded from https://mvnrepository.com/artifact/commons-codec/commons-codec/1.3)

 

[{"Type":"MASTER","Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SS8JB4","label":"IBM Business Automation Workflow"},"ARM Category":[{"code":"a8m50000000CcUcAAK","label":"Content Management Integration-\u003EExternal ECM-\u003EFileNet"}],"ARM Case Number":"","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"21.0.2;21.0.3;19.0.0.1;19.0.0.2;19.0.0.3;20.0.0.1;20.0.0.2"}]

Document Information

Modified date:
17 December 2021

UID

ibm10878787

Page Feedback