Adding a content event to a BPD

In a BPD, a content event is used to catch or throw interactions with an enterprise content management (ECM) system. You can add one of several types of content events, such as a start event, intermediate event, boundary event, or event subprocess start event.

Before you begin

This topic describes how to add a content event to a BPD 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 add a content event to a BPD and create 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 perform this task, you must be in the IBM® Process Designer desktop editor.

About this task

Although you can add a content event to an existing BPD, you can also add a content event to a new BPD by completing the following steps:

Procedure

  1. Open the Process Designer desktop editor.
  2. Open a process application in the Designer view.
  3. Click the plus (+) icon beside Processes and then select Business Process Definition. The New Business Process Definition wizard opens.
  4. In the Name field, specify a name for the new BPD.
  5. Click Finish. The new BPD is displayed in the Process library list (under Business Process Definitions) and the BPD opens in the BPD editor.
  6. In the canvas, select the existing Start event or select the Start Event or Intermediate Event icon in the palette and drag the event to the canvas.
  7. Click the Properties tab and then click Implementation. The Implementation panel opens.
  8. In the Start Event Details or Intermediate Event Details section, change None to Content. The event in the diagram changes to display a Content marker icon.
  9. Beside the Attached Content UCA area in the Content Trigger section, click Select to select an existing content undercover agent (UCA). (If you select an existing message UCA, the intermediate event in the diagram is changed from a content event to a message event.) Alternatively, you can click New to create a content UCA. For information about creating content UCAs, see Creating and configuring an undercover agent for a content event.
  10. In the BPD editor canvas, ensure that the Content event is selected, then click the Properties tab and click Data Mapping. The Data Mapping panel opens.
  11. Perform the data mapping tasks by completing the following steps:
    1. Click the variable selector icon on the right side of each field to map each undercover agent output variable to a local variable in the BPD.
    2. If you are working with an intermediate event, select the variable that you want to use to correlate the event with the BPD instance. The variable selected for correlation is identified by an assignment symbol (correlation icon). This correlation ensures that the parameter values of the runtime message are passed to the correct BPD instance. (IBM Business Process Manager only requires one variable mapping to correlate the event.)
    For undercover agents that are implemented using a complex variable rather than a service, you can select the complex variable or the top-level child properties of the variable for mapping or correlation.
  12. Click Save.
Parent topic: Performing modeling tasks for inbound events