Use the HZ: Raise API Events profile option to enable or disable either of the TCA business event types. See: Business Event Types and Profile Options and Profile Option Categories.
Note: You must set this profile option before working with data in order to determine how to capture business events.
Available settings for the profile option are:
All Events Disabled: Neither granular nor business object events are raised.
Only Granular (V2) Events Enabled: Only granular events are raised. Business object events are disabled.
Only Business Object Events Enabled: Only business object events are raised. Granular events are disabled.
All Events Enabled: Both granular and business object events are raised.
Attention: Set the HZ: Raise API Events profile option appropriately based on your installation's requirements and the presence of any custom solutions using TCA business events. Enable either or both of the business event types only if you are using the corresponding TCA business events. If not, set the profile option to All Events Disabled, to avoid unnecessary overhead to your system.
Your setting of the HZ: Raise API Events profile option also depends on:
Oracle E-Business Suite applications that use TCA Business Events. See: How Oracle E-Business Suite Applications Use TCA Business Events.
High volume loads of data into the TCA Registry, for which all events should be disabled. See: Specific Situations to Disable Business Events For.
Business events will not be raised even if you set the HZ: Raise API Events profile option to enable events, when either of the following conditions exists:
Business events are disabled.
Business events are enabled but there is no activity.
No enabled subscriptions exist for business events.
Several Oracle E-Business Suite applications leverage the TCA business events infrastructure to provide additional functionality in respective product areas. For these features to properly function, set the HZ: Raise API Events profile option to Only Granular (V2) Events Enabled or All Events Enabled. See: Defining the Business Event Types to Raise.
Oracle E-Business Suite applications do not use business object events. You might need to enable business object events, however, if you have custom integrations with other systems using business object events, a likely scenario in a data hub implementation.
This table lists Oracle E-Business Suite applications and the respective features that leverage TCA granular business events. Refer to product-specific documentation for details on the features and related setup steps.
| Oracle E-Business Suite Application | Feature That Uses TCA Granular Business Events |
|---|---|
| Oracle Advanced Collections | Territory assignment |
| Oracle Partner Management | Channel team assignment |
| Oracle Sales | Territory assignment |
| Oracle Shipping | Consolidation of TCA and HRMS locations for shipping activity |
| Oracle Student System | Workflow notification to administrator on change of address |
| Oracle Telecommunications Billing Integrator | Publication of information to third party billing systems |
| Oracle Trading Community Architecture | Workflow Directory synchronization |
In some situations, all TCA business events must be disabled, including granular events. See: Specific Situations to Disable Business Events For. You can take alternative actions so that specific Oracle E-Business Suite functions that leverage TCA business events are still performed. See: Impact and Alternatives of Not Raising Granular Business Events.
You should disable all Oracle Trading Community Architecture business events whenever a high volume of records is loaded into the TCA Registry. Set the HZ: Raise API Events profile option to All Events Disabled so that no events are raised. See: Defining the Business Event Types to Raise.
Disable business events for these situations:
Custom code using TCA APIs to load high volume data: Set the profile option to disable all events before you run your custom program to load data. Alternatively, you can code the profile option setting into your custom program, so that events are disabled every time you load data.
Oracle E-Business Suite products loading high volume data: Several E-Business Suite applications load high volume data into TCA. These programs automatically set the profile option to All Events Disabled. After the programs complete, they set the profile option value back to what it was before the run.
This table shows the programs and the corresponding E-Business Suite application.
| Oracle E-Business Suite Application | Program |
|---|---|
| Oracle iStore | Lead Import |
| Oracle Marketing |
|
| Oracle Order Management | Order Import |
| Oracle Payables | Supplier Import |
| Oracle Sales | Lead Import |
| Oracle Site Management | Retail Site Creation |
| Oracle Student System |
|
| Oracle Trading Community Architecture |
|
This table shows programs that can load high volume data into TCA, but do not automatically set the profile option to All Events Disabled.
Attention: If you are loading high volume data using these programs, you are strongly recommended to disable the events before running the programs.
| Oracle E-Business Suite Application | Program |
|---|---|
| Oracle Human Resources | Data Pump |
| Oracle Transportation | Upload Supplier Ship-from Location |