This topic applies only to the IBM Business Process Manager Advanced configuration.

Services to support case management applications

You can create services to use with your case management applications. These services, which can do standard tasks in your case management applications, can be shared by all case types in a process application.

Case management functions are only available if you have IBM BPM Advanced with the Basic Case Management feature installed.

A service to support a case management application uses its own server type. The server type is IBM® BPM content store. IBM BPM content store supports all Content Management Interoperability Services (CMIS) operations.

Add the Content Management (SYSCM) toolkit to your dependencies if it is not there, as you need access to the Enterprise Content Management (ECM) types. To add this toolkit dependency, select + beside TOOLKITS. In the Add dependency menu, select the Content Management toolkit version that you require.

Select any 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 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. Select IBM BPM content store to create a case service.
Under Content Operation, select an appropriate ECM operation.
Click Data Mapping. Create the map between the variables for input and output. These variables must 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. Click the auto-map icon to create these private variables ().
The mapping structure for each operation is shown in Data mapping in Enterprise Content Management operations.
Save your work to update the process application with any changes to your service.

Enterprise Content Management operations can reference the content of a case by using JavaScript.

Table 1. Referencing content of a case by using JavaScript
Content or function referenced	JavaScript required in the Enterprise Content Management operation
Accessing the case folder	Requires the `tw.system.currentProcessInstance.caseFolderId` JavaScript API, which contains the identifier of the root case folder.
Accessing the starting document of a case	Requires the `tw.system.currentProcessInstance.startingDocumentId` JavaScript API, which contains the identifier of the document that initiated the start of the case. If the case was started manually, the identifier is null.
Accessing the enabling document of a case activity	Requires the `tw.system.currentAdHocActivityInstance.enablingDocumentID` JavaScript API, which contains the identifier of the document that started or enabled the case activity. The identifier is null for activities not started by a precondition of a document filed in the case.
Creating a subfolder under a case folder	Every subfolder of the case folder must be of type `IBM_BPM_CaseSubFolder`. You must specify this type in the Object type ID parameter of the Create Folder operation.