Integrating with an ECM system or an IBM BPM store

Use a service to allow a business process developed in IBM® Process Designer to work with an Enterprise Content Management (ECM) system or an IBM BPM store.

Before you begin

If you are working with an ECM system rather than an IBM BPM store, you should have added your Enterprise Content Management (ECM) servers to your process application as shown in Adding an Enterprise Content Management server.

You should add the Content Management (SYSCM) toolkit to your dependencies, if it has not been added as you will need access to the ECM types. To add this toolkit dependency, select + beside TOOLKITS. In the Add dependency menu, select the Content Management toolkit version you require.

About this task

To build a service that integrates with an ECM system or an IBM BPM store, follow these steps:

Procedure

Create a service that contains a Content Integration step:
- In web Process Designer, create a service flow from the Services category in the library.
- To create a heritage human service in web Process Designer, click User Interface > Heritage Human Service.
- In the desktop Process Designer, select a service from the library area that supports Content Integration steps. The following services contain a Content Integration step.
  - Select Implementation in the library section and then +. From the menu, select Integration Service
  - Select User Interface and then +. From the menu, select Ajax Service.
  - Select User Interface and then +. From the menu, select Heritage Human Service.
  Enter a name for the service on the following dialog box and click Finish. The editor opens with the Diagram view in focus.
From the palette, drag a Content Integration step to the canvas and provide a meaningful name for it.
Click Implementation in the Properties view. Under Enterprise Content Management Server, <Use data mapping> is the default selection in the Server field. It means that in the Data Mapping tab section, the Server name input map is enabled and editable. You can pass a server name by using a variable in that field.
Alternatively, you can select one of the following server types in the Server field.
- IBM BPM managed store
- IBM BPM content store
- IBM BPM document store
- The name of an ECM server
For information about these server types, see Management of folders and documents for ECM systems.

If you want to select the name of an ECM server but no ECM servers are available for selection, you can add a server in the Process App Settings editor. See Adding an Enterprise Content Management server.
Under Content Operation, select an appropriate ECM operation. See Outbound operations for external ECM systems and IBM BPM stores.
Click Data Mapping. In this section you can create the map between the variables for input and output. These variables need to be created. You can create them manually by yourself or use the auto-map function. The auto-map function creates private variables for the business objects, which are used by the service you create. To create these private variables, click the auto-map icon . The mapping structure for each operation is discussed in Data mapping in Enterprise Content Management operations.
Note: To use the auto-map function, you must be in the desktop Process Designer.
Click Save or Finish Editing.

What to do next

As with any service, if you have errors at run time, use catching error events to handle errors thrown by a content integration step. A content integration step may raise an error with error code ECMError and error data of type ECMError. See Handling errors in services.