Integrate FileNet BPM with IBM Content Manager, Part 1: Analyze, design, and model using FileNet Business Process Manager and IBM Content Manager

An example using the "ABC Company" scenario

This is the first in a series of four articles that show you how to integrate FileNet Business Process Management with IBM Content Manager Version 8 (CM8). Leverage the best features of both FileNet and Content Manager by enabling BPM to use the IBM Content Manger as its content repository. If you already have IBM Content Manager, you can make use of FileNet BPM to manage your business process, and if you are new to IBM ECM software, you have more choices for FileNet BPM with different content repositories. The series uses the ABC Company’s Auto Insurance Claim system as a fictitious example to show you how to integrate these two powerful products.


Peng Shi (, Software Engineer, IBM Content Manager Development, IBM Japan

Peng ShiPeng Shi is a software engineer in IBM China Software Development Lab (CSDL). He works on IBM Content Manager development. He is a certified WebSphere Studio V5.0 developer. He has also worked as software engineer for FileNet development.

James Lin (, Distinguished Engineer, IBM Content Manager Development, IBM Japan

James LInJames Lin is the lead architect for IBM Content Management Development.

Dipayan Gangopadhyay (, Senior Advisor, IBM Research, IBM Japan

GangopadhyayDipayan Gangopadhyay is senior advisor for solution engineering strategy. He works in IBM Almaden Research.

20 March 2008

Also available in Vietnamese

Introduction to FileNet P8 BPM architecture

FileNet Business Process Manager (BPM) has the flexibility and scalability to deal with the most complex business processes. It can handle millions of transactions, thousands of users, and multiple business applications. It also supplies a set of tools that lets you create, modify, manage, analyze, and simulate your own business processes. The business process can be directly performed in the generic user interface, FileNet Workplace. You can also build your application with Process Engine API to execute these business processes.

The FileNet P8 Platform provides the baseline components, including the Content Engine, Process Engine, Application Engine, and Rendition Engine. The most important component used for business process management (BPM) is the Process Engine. Figure 1 shows its architecture diagram.

Figure 1. FileNet P8 BPM Architecture
FileNet P8 BPM Architecture

As you can see in the diagram above, besides the powerful process engine, the FileNet BPM also provides many convenient services and tools to manage all aspects of business processes, such as process routing, rules management, process simulation and modeling, and process analysis. The following section shows you how to utilize these tools to analyze, model, and perform your own business processes.

Introduction to IBM Content Manager architecture

IBM Content Manager is a product portfolio designed to manage volumes of unstructured content. This unstructured content includes documents, images, audio files, streaming videos, billing reports, business records, and Web content. It provides two, out-of-the-box content management solutions, Windows® Client and e-Client, based upon its integrated platform for e-business solutions. Content Manager support IBM DB2® and Oracle which are the mainstream enterprise database systems. And it supports multiple platforms including low-end Windows and Linux®, middle-end Unix®, and high-end z/OS®. By leveraging these powerful underlying infrastructures, it can handle a huge volume of content with good performance. Figure 2 depicts its architecture.

Figure 2. IBM Content Manager architecture
IBM Content Manager architecture

Many companies that already use IBM Content Manager as their critical content repository may be looking for ways to leverage FileNet BPM as a way to manage their content-based business processes. This series uses a fictitious company, the ABC Company, as an example to show you step-by-step instructions on how you can integrate FileNet BPM with the IBM Content Manager.

The motivation for integrating FileNet P8 BPM with IBM Content Manager is to enable enterprise to enjoy the benefits of process-driven content-intensive application, and to move away from monolithic applications where business processes and information integrity rules are buried inside application code. Existing enterprise customers of IBM have enjoyed over the years the scalability of IBM Content Manager. Not only have they built business applications around IBM Content Manager, but also have accumulated petabytes of enterprise content in those repositories.

On the other hand, driven by the need to achieve higher business agility, there is significant movement today in enterprises to have their business processes reside explicitly outside of applications, so that they can take ownership of these business processes, rather than being tied to the release cycle of application vendors to realize their business process re-engineering initiatives. P8 BPM provides best-in-class business process automation capabilities for content-intensive applications. Thus, integrated P8 BPM capabilities with IBM Content Manager becomes a strategic platform for existing repository owners towards their taking ownership of their business processes while preserving existing investments in our repository products and without moving petabytes of existing content.

Case study - ABC Company’s business requirements

ABC Company is a large insurance company in an emerging country that focuses on life insurance and auto insurance. It has many documents stored in the IBM Content Manager, such as policy documents, pictures, claims documents, and customer information documents.

The company needs to adjust their rules and business logic based on continuously changing business requirements. But, it is very costly to change the business process and business rule embedded in the existing applications. They want a solution to improve the business agility and to enable them to accelerate business growth. ABC Company has the following requirements:

  • The business process and rules can be simulated
  • The business process and rules can be tracked, analyzed, and statistical
  • The business process and rules can deal with the different roles of people
  • The business process can be either sequential or parallel
  • The business process can be synchronized with any other business processes
  • The business process can be associated with a deadline
  • The business process can interact with the third party applications
  • Work can be assigned or reassigned to a user
  • All the instances of the business process can be administered
  • A work item of a business process can be locked or unlocked
  • Milestones can be added to a business process
  • e-mail notification can be sent to the business process participant when the work arrives

Analysis of ABC Company’s business requirements

There are many business processes in ABC Company. We use the "Auto Insurance Claim" business process as a scenario to analyze its requirements.

The basic outline of this process is as follows:

  1. The Customer Service Representative (CSR) collects the customer’s claim, detailed information of the RoadEvent, and the related documents into the content management repository. The created AutoClaim (including all this information) is sent to the adjuster to process.
  2. The adjuster receives AutoClaim, checks and evaluates the detailed information and the related documents, and calculates the ClaimAmount of the AutoClaim.
  3. If the ClaimAmount is more than $2000, this AutoClaim will be sent to the supervisor for approval. Otherwise, the adjuster can approve this AutoClaim.
  4. If the AutoClaim was rejected, the adjuster sends a notification mail to the claimer. Otherwise, the adjuster submits the payment request.

There are three roles in this business process: CSR, adjuster, and Supervisor. These roles are shown in Figure 3.

Figure 3. Role definition of ABC Company’s auto insurance claim process
Role definition of ABC Company’s Auto Insurance Claim Process

Model design of ABC Company’s auto insurance claim system

Figure 4 shows a class diagram depicting the business entities based on the business requirements:

Figure 4. Class diagram of the auto insurance claim Scenario
Class Diagram of the Auto Insurance Claim Scenario

Figure 5 shows the business process as an activity diagram:

Figure 5. Activity diagram of the auto insurance claim scenario
Activity Diagram of the Auto Insurance Claim Scenario

The architecture of the ABC Company's auto insurance claim system

The system architecture for the integration of FileNet BPM and IBM Content Manager is decided after requirement analysis and model design. Figure 6 shows the architecture of the AMC Company's auto insurance claim system:

Figure 6. The architecture of the ABC Company's auto insurance claim system
The architecture of the ABC Company's Auto Insurance Claim system

The development approach is outlined as follows:

  1. Create the CM8 schema: Every CM item type is mapped from one entity in the data model.
  2. Create business objects: We create a set of business objects (Java® classes) that can access CM8 repositories transparently at high level. For each entity in the data model, a business object is created. Moreover, we create a gateway class which wraps all the operations of all the business objects and does data-type conversions to overcome some limitations of P8 BPM Component Integrator.
  3. Register the gateway class into Component Integrator: We register the gateway class using Component Integrator. The methods of all the business objects for a given repository can be accessed by business processes in P8 BPM via a single component queue.
  4. Define business process: With the use of the P8 process designer tool, you define the process where the process steps can refer to the operations of the gateway class which invokes the corresponding methods of business objects and ultimately communicate with CM8 repositories.
  5. Create or modify UI: You can create or modify UI client code needed to launch the processes, access in-boxes of users, accept user's input and display of business objects and the like. This is accomplished by calling BPM API and methods of business objects.

The preceding steps are illustrated below using an Insurance Claim Processing application example for the ABC Company. For the first step, you can use the IBM Content Manager System Administrator Client to create the item-type definition. For a quick setup, you can also import the process definition from the XML file in the Downloads section. Figure 7 shows the import:

Figure 7. Use IBM Content Manager System Administration Client to import the XML schema file
Use IBM Content Manager System Administration Client to import the XML schema file

After importing the XML schema file into the IBM Content Manager, you will see that the imported item types are corresponding to classes of the class diagram in Figure 4. Figure 8 shows the customer content schema:

Figure 8. The created item type
The created item type


In Part 1 of this series, you have seen a broad overview of the architecture of FileNet P8 BPM and IBM Content Manager V8. Based on the ABC Company’s case study, we have analyzed the business requirements, created a business class model and a business process model, designed the architecture for ABC Company’s Auto Insurance Claim system. And we also created a data model definition in the IBM Content Manager system to finish the first step of the system implementation, you can download the attachments, and import them into your IBM Content Manager system.

Part 2 will introduce you how to create the Java Business Entities to manipulate the data in the IBM Content Manager repository and how to create a gateway class for these Java Business Entities.


Data model definition in IBM Content Managerdatamodel.xsd53.9KB



Get products and technologies

  • Download FileNet Content Manager demo to see how IBM FileNet P8 integrates content, process, and compliance to streamline, manage, and optimize an auto claim handling process.
  • Download IBM product evaluation versions and get your hands on application development tools and middleware products from DB2®, Lotus®, Rational®, Tivoli®, and WebSphere®.



developerWorks: Sign in

Required fields are indicated with an asterisk (*).

Need an IBM ID?
Forgot your IBM ID?

Forgot your password?
Change your password

By clicking Submit, you agree to the developerWorks terms of use.


The first time you sign into developerWorks, a profile is created for you. Information in your profile (your name, country/region, and company name) is displayed to the public and will accompany any content you post, unless you opt to hide your company name. You may update your IBM account at any time.

All information submitted is secure.

Choose your display name

The first time you sign in to developerWorks, a profile is created for you, so you need to choose a display name. Your display name accompanies the content you post on developerWorks.

Please choose a display name between 3-31 characters. Your display name must be unique in the developerWorks community and should not be your email address for privacy reasons.

Required fields are indicated with an asterisk (*).

(Must be between 3 – 31 characters.)

By clicking Submit, you agree to the developerWorks terms of use.


All information submitted is secure.

Dig deeper into Information management on developerWorks

Zone=Information Management
ArticleTitle=Integrate FileNet BPM with IBM Content Manager, Part 1: Analyze, design, and model using FileNet Business Process Manager and IBM Content Manager