Standardized Event Handling for System Implementors

This feature streamlines event handling in Fusion Service by providing a standardized, no-code approach for System Implementors to subscribe to and respond to UI Events Framework events across pages and fragments. Previously, implementors needed to write custom JavaScript to handle these events, increasing complexity and maintenance effort. With this enhancement, implementors can now subscribe to UI Events Framework events at both the page and fragment levels directly within Oracle Visual Builder Studio.

Key benefits include eliminates the need for JavaScript, making event handling more accessible to System Implementors and reduces development time by allowing direct event subscription within Oracle Visual Builder Studio.

Steps to Enable

Leverage the Visual Builder Studio to expose your applications. To learn more about extending your application using Visual Builder, visit Oracle Help Center > your apps service area of interest > Books > Configuration and Extension.

This feature aims to provide a recordLevelEvent on the pages, so that customers can attach event listeners to this event. When record-level events occur, the event will be triggered, and the attached listeners will be executed accordingly. The events OnBeforeSave, OnAfterSave and FieldValueChange are currently supported and it is available to use in the following pages. 

  1. ServiceRequest Create Page
  2. ServiceRequest Edit Page
  3. Contact Create Page
    1. Contact Create Page has a drawer page which can be opened from the smart action. This feature is supported there also.
  4. Case Create Page
  5. Case Edit Page
  6. Customer Work Order Create Page
  7. Customer Work Order Details Page

Supported Record Level Events

  • OnBeforeSave: This event is fired once the Create/Update button is pressed in the supported pages. This supports async and the save operation can be aborted by returning { stopPropagation: true } from the action chain.
  • OnAfterSave:This event is fired once save operation is completed. The event.data has information on the newly created object.
  • FieldValueChangeEvent:This event is fired when a field's value is updated. For fieldValueChange event, the event.data is an array of objects. Each object contains the updated field name, new value and old value. 

How-to Example

Open the extended view of the application and go to sr > create page > Select EventListener

Select EventListener

Add Action chain for vbEnter. This is to register events for recordLevelEvents

This is to register events for recordLevelEvents

Create the action chain

action chain

Open Action Chain

Open the action chain

Drag Register events for recordLevelEvent global function

Global Function

Update events list with the three events array and uefContext as objectContext. For create sr in contact's side drawer, registration should be present for drawer context also.

Update events list with the three events array and uefContext as objectContext

The payload structure of recordLevelEvent

The payload structure of recordLevelEvent

Create event listener for record level event

Create event listener for record level event

Drag code block and console the event

Drag code block and console the event

Create an sr, add title and save. The recordLevelEvents fired can be seen in the console.

Create an sr, add title and save. The recordLevelEvents fired can be seen in the console.

Given below is a detailed usage of how the event listener execution flow is branched based on the event name.

Given below is a detailed usage of how the event listener execution flow is branched based on the event name.

To abort a save operation, use 

return { stopPropagation: true } 

as given below

To abort a save operation, use return { stopPropagation: true } as given below

 

Tips And Considerations

n/a

Key Resources

Oracle Videohub - Oracle Fusion Service Center Extensibility

Access Requirements

Oracle Visual Builder Studio