Creating Workflow Actions: Create Integration EventA 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 ActionsIf 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. About Picklist Value Formats in Integration EventsDepending on how you set up your integration event queues, the values in picklist fields in the integration events are recorded either in the language of the user whose action causes the integration event to be created, or as language-independent code (LIC) values. For information about specifying the picklist value format for an integration event queue, see Creating Integration Event Queues and Managing Integration Event Settings. About the Billing, Shipping, and Primary Flags in Account and Contact Address RecordsIn integration events for the Account Address record type, you can include the Billing and Shipping flags that indicate whether an address is the designated billing address or shipping address for the account. Similarly, in integration events for the Contact Address record type, you can include the Primary flag that indicates whether an address is the primary address for the contact. However, you cannot track changes to the Billing, Shipping, and Primary flags. This means that changes to these flags cannot be used to trigger the creation of integration events, even if you select the Always Include check box for the flags. If you include one of these flags in an integration event, and if that flag is changed at the same time as a field for which the changes are tracked, then the integration event that is created as a result of the change to the tracked field does not show the new value of the flag. Instead, the integration event shows the value of the flag before the update was made. However, the next time that an integration event is created as a result of a change to a tracked field, the integration event includes the value of the flag field after the previous update was made. For example, assume that you have two addresses, Address A and Address B, linked to a contact called Jane Smith. Address A is the primary address for Jane Smith. You have a workflow Create Integration Event action for the Contact Address record type that is configured as follows:
If a user updates the Address Type field on Address A from the contact address record for Jane Smith and also deselects the Primary check box for Address A, then the integration event that the workflow action creates as a result of the change to the Address Type field shows the new address type, but the value of the Primary flag in the integration event still indicates that the Address A is the primary address for Jane Smith. However, the next time that the Address Type field on Address A from the contact address record is changed and an integration event is created as a result of the change, the Primary flag in the integration event shows that Address A is not the primary address for Jane Smith. 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 Data Rules - 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
The following table describes the fields on the Configure Integration Event Tracking page.
About the Track Changes Check BoxThe 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 workflow actions on which the Track Changes check box is available, the workflow action creates an integration event only if the Track Changes check box is selected for at least one field, and if a change is detected in at least one of the fields for which the Track Changes check box is selected. When the integration event is created, all of the fields that have the Always Include check box selected in the workflow action are included in the integration event. System Field ExceptionsIf the trigger event for the workflow rule is anything other than When New Record Saved, then Oracle CRM On Demand does not generate integration events in cases where the Track Changes check box is selected for one or more of the following system fields, and the Track Changes check box is not selected for any other field:
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 TopicsSee the following topics for related information about workflows: |
Published 6/21/2021 | Copyright © 2005, 2021, Oracle and/or its affiliates. Legal Notices. |