Print      Open PDF Version of Online Help


Previous Topic

Next Topic

Creating Workflow Actions: Create Integration Event

A Create Integration Event action on a workflow rule automatically sends an integration event to one or more integration queues when the conditions on the workflow rule are met and a change is detected in at least one of the fields that are tracked by the Create Integration Event action.

About Create Integration Event Actions and Wait Actions

If you want to use a Create Integration Event action to create an integration event that captures the changes made to a record by the event that triggers a workflow rule, then you must place the Create Integration Event action before any Wait action in the sequence of actions on the workflow rule. If a Wait action precedes a Create Integration Event action on a workflow rule, then the Wait action prevents the Create Integration Event action from detecting changes to the record. When the waiting period on the Wait action ends, the record is read again before the remaining actions on the rule are performed, and the values of the fields on the record before the event that triggered the workflow rule are not preserved. Therefore, the previous value and the current value of a field are considered to be the same, and the Create Integration Event action does not create an integration event because it does not detect any change in the tracked fields.

NOTE: You can create multiple actions for a workflow rule, up to a maximum of 25 actions for each rule.

The following procedure describes how to create a Create Integration Event action.

Before you begin. To perform the procedure described here, you must have the Manage Workflow Rules privilege in your user role. For information on adding privileges to roles, see Adding Roles.

To create a Create Integration Event action

  1. Navigate to the rule where you want to create the action:
    1. In the upper-right corner of any page, click the Admin global link.
    2. In the Business Process Management section, click Workflow Configuration.
    3. On the Workflow Rules List page, find the rule where you want to create the action.

      For information about searching for workflow rules in the list page, see Filtering Lists.

  2. Click the Workflow Name link on the rule.
  3. In the Actions title bar on the Workflow Rule Detail page, click Menu, and select Create Integration Event.

    NOTE: The trigger event on the workflow rule determines what types of actions can be created on the rule.

    TIP: You can create a copy of an existing workflow rule action by clicking the Copy link for the action.

  4. In the Workflow Action Edit page, enter a name for the action.
  5. If you want to enable the action, select the Active check box.
  6. Select the integration queues to which the integration events will be written.
  7. Save the workflow action.
  8. From the record-level menu in the list of actions, select Configure for the integration event action that you want to configure.

    NOTE: The Configure option is not available for actions where the trigger event is When Records Are Merged.

  9. In the Configure Integration Event Tracking page, select the check boxes for the fields, as needed:
    • Select the Always Include check box if you want the field to be included in the integration event even if the value of the field has not been changed.
    • Select the Track Changes check box if you want an integration event to be generated each time this field is updated.
  10. Save your changes.

The following table describes the fields on the Configure Integration Event Tracking page.

Field

Description

Display Name

The name of the field as it is displayed in the user interface.

Integration Tag

The integration tag that is used when the field is included in the integration event

Required

This read-only check box indicates if the field has been set up as a required field.

Always Include

Select this check box if you want the field to be included in the integration event even if the value of the field has not been changed.

NOTE: The Always Include check box is selected by default and cannot be deselected for certain fields used by Oracle CRM On Demand.

Track Changes

Select this check box if you want an integration event to be generated each time that this field is updated.

NOTE: The Track Changes check box is not available if the trigger event for the workflow rule is Before Record Is Deleted, After Association With Parent, or After Dissociation From Parent.
Also, if the trigger event for the workflow rule is After Association With Parent, or After Dissociation From Parent, then the set of fields displayed on the page will be the set of fields at the child record level. You cannot configure the set of fields included in the integration event at the parent record level.

For more information about integration events, see About Integration Events.

For step-by-step procedures for creating other types of workflow actions, see the following topics:

Related Topics

See the following topics for related information about workflows:


Published 5/4/2012 Copyright © 2005, 2012, Oracle. All rights reserved. Legal Notices.