IBM BPM, V8.0.1, All platforms > Create processes in IBM Process Designer > Modeling processes > Integrating with Enterprise Content Management (ECM) systems > Inbound events from Enterprise Content Management systems > Performing modeling tasks for inbound events

Create an undercover agent for a content event

To obtain information about document or folder events on an Enterprise Content Management (ECM) server, create and configure a Content UCA that works with your event subscription. A Content UCA is used to initiate a BPM Start or Intermediate event when specific content changes occur on an ECM server. It is conceptually similar to a Message UCA, but it has a specialized Content marker to differentiate it from a Message marker.

This topic describes how to create Content UCA without consideration for some of the other components that are required to detect and respond to ECM events, such as an event subscription. If you need to create a Content UCA and all of the other required components as well, you should follow the instructions in the topic Subscribing to document and folder events: the end-to-end approach. This is a simpler approach than creating each component on a stand-alone basis and it automatically creates some resources that you would otherwise need to create manually.

To create and configure a Content UCA, complete the instructions in the following procedure.

Procedure

1. Create a Content UCA by completing the following steps:

   1. In the library area of the Designer page, click the plus (+) icon beside Implementation and then select Undercover Agent. The New Undercover Agent wizard opens.

   2. In the Name field, specify a name for the new UCA.

   3. In the Schedule Type drop-down list, select On Event.

   4. Click Finish. The UCA opens in the Undercover Agent editor.

2. Configure the Content UCA by completing the following steps in the Undercover Agent editor:
   1. Beside the Event Marker area, click Select and then select Content. (Use the Content selection to work with content events that originate from ECM servers. By comparison, the Message selection is used to work with message events that originate from BPDs, JMS listeners, or web services that you have created.)
   2. Beside the Implementation area, accept the default selection Variable or select Service (if necessary). (Use a variable implementation to pass events directly from the UCA to the BPD. By comparison, use a service implementation to process information about events by adding business logic or decisions.)

   3. If you accepted Variable as your implementation, the default variable type ECMContentEvent is used and it cannot be changed.

   4. If you selected Service as your implementation, the default attached service Default ECM Event is already selected. However, you can click Select beside the Attached Service area and choose a different attached service for the UCA.
   5. Ensure that the Enabled check box is selected, which enables the Content UCA to run.

   6. In the Parameter Mapping section, select the Use Default check box if you want to use the default value of the input variable in the attached service.

      If the input variable of the attached service does not have a default value, this check box is disabled. You can type a value in the field to manually map a constant value to the input variable of the attached service.

      For example, you might use a constant for testing purposes.

   7. Click Save.

   8. If you accepted the Content event marker and you need to create an event subscription for the UCA, click Add Event Subscription and follow the instructions in the topic Create event subscriptions.

   9. After you have configured and saved the Content UCA, you can click Run Now to test the Content UCA and monitor it as described in Maintaining and monitoring IBM BPM Event Manager.

Results

The new configured Content UCA is displayed in the Undercover Agents section of the Implementation library list.

Understanding and using undercover agents

Performing modeling tasks for inbound events