Event Notifications

The event notifications are meant for the external applications that integrate with Unifier Essentials. When data changes (based on certain triggers), the event notifications (notification records) are generated that can be used by the external applications to pull data from Unifier Essentials.

The Event Notifications node has been set up by Oracle. The event notifications have already been incorporated within the design of the business processes (BPs) forms.

To access the Event Notifications functional node:

Go to the Company Workspace tab and switch to Admin mode.
In the left Navigator, click Integrations > Event Notifications.

The Event Notifications log displays events that happen within the Workflow or Non-workflow BPs.

When a BP record reaches a status that is meant to generate event notifications, an entry gets listed in the Event Notifications log. This applies to both Workflow and Non-workflow BPs.

The Event Notifications log has the following toolbar options:

View
This drop-down list lets you select the system-defined views that are available to all users that have access to view the Event Notifications log. It also lets you create and manage log views. The options are:
- All Notifications
  This is the default view for the log. By default, all rows in this log (sorted by Event Date and in descending order) are visible to the users.
- Group by Object Name
  This means grouping the rows in the grid by the "Object Name" parameter. The user has the ability to create a view and manage views. Any view created by any user who has permissions to this log will be available to all other users who have permissions to this log. Similarly, any view edited or deleted by one user will be edited or deleted for all other users using this log.
- Create New View
  Use this option to create a custom view. Custom views appear in the View list.
- Manage Views
  Use this option to change the order of views, show or hide views, and delete the custom views.
Edit View
Lets you select which columns to display or hide, apply filters, group and sort by available fields, and save custom views.
Refresh
To update the information displayed on the screen.
Print
To print the information displayed on the screen. Your options are:
- Print
- Export To CSV
- Export To Excel
Search
To open a screen and search for a record by applying value operators in columns.
Find on Page
To find items on the displayed page. When you click this option, the system inserts a row that lets you enter filter parameters.

The Event Notifications log has the following columns:

Column Name	Description	Applies to WF BPs	Applies to Non-WF BPs
Shell Number	Populates with the project/shell number where the event was triggered.	Yes	Yes
Shell Name	Populates with the name of the project/shell where the event was triggered	Yes	Yes
Object Type	Populated as "Business Process"	Yes	Yes
Object Sub-Type	When the Object Type = Business Process, the Object Sub-Type is populated as Workflow or Non-workflow, based on the type of the BP.	No	Yes
Object Name	Populated with the name of the Business Process in which the event was triggered	Yes	Yes
Record Number	Populated with the "record_no" value of the BP record that triggered the event	Yes	Yes
Event Date	Populates with the date and time, when the event was triggered. The content of this column is in descending order, which is the default sort format.	Yes	Yes
WF Step From	Populates when the event notification is for a WF BP. This column is populated with the name of the starting step of the record that have triggered the notification generation.	No	Yes
WF Step To	Populates when the event notification is for a Non-WF BP. This column is populated with the name of the final step of the record that have triggered the notification generation.	No	Yes
WF Action Name	Populates with the WF action name that was taken for the BP record that triggered the notification. Note: The same BP could go through several events which trigger the notification generation. Each such event inserts a corresponding row in this log.	No	Yes
Old Status	The original status of the BP record (before the event was triggered)	Yes	Yes
New Status	The final status of the BP record that satisfies the event trigger condition	Yes	Yes

The Event Notifications log lists Workflow BPs and Non-Workflow BPs:

Workflow BPs	Non-Workflow BPs
For the Workflow BPs, the grid displays a record of all the workflow actions that are taken within the BP records, and which are set with the Generate event notification option as checked. A Workflow BP step completion policy does not impact the creation of the notification row. Regardless of the completion policy, if an action (which is set up to generate an event notification) is taken in the Workflow BP record, the notification row is inserted in the log. If there are multiple assignees on a step, the final action on the Workflow BP record, which moves the record to the next step, determines what will be included as an event notification row in the grid, not each action taken by an assignee. If a task is reassigned and the new assignee takes an action that moves the record to the next step, and the record is configured to generate a notification, the system inserts an event notification row in the grid, also.	For the Non-workflow BPs, the notification records are generated when the BP record reaches the status that has been designed to trigger event notification. Upon reaching the status, the system inserts a notification row in the grid. If you click Edit on a Non-workflow BP record and proceed to click Finish Edits with making any changes, but the status change is set to generate notifications per the design, the system inserts a notification row in the grid.

Workflow BPs

Non-Workflow BPs

For the Workflow BPs, the grid displays a record of all the workflow actions that are taken within the BP records, and which are set with the Generate event notification option as checked.

A Workflow BP step completion policy does not impact the creation of the notification row.

Regardless of the completion policy, if an action (which is set up to generate an event notification) is taken in the Workflow BP record, the notification row is inserted in the log.

If there are multiple assignees on a step, the final action on the Workflow BP record, which moves the record to the next step, determines what will be included as an event notification row in the grid, not each action taken by an assignee.

If a task is reassigned and the new assignee takes an action that moves the record to the next step, and the record is configured to generate a notification, the system inserts an event notification row in the grid, also.

For the Non-workflow BPs, the notification records are generated when the BP record reaches the status that has been designed to trigger event notification. Upon reaching the status, the system inserts a notification row in the grid.

If you click Edit on a Non-workflow BP record and proceed to click Finish Edits with making any changes, but the status change is set to generate notifications per the design, the system inserts a notification row in the grid.

Setting Up Permissions for the Event Notifications

The visibility of Event Notifications log is driven by permissions.

To set the permissions:

Go to the Company Workspace tab and switch to Admin mode.
In the left Navigator, click User Administration > Access Control.
The Access Control window displays.
In the Access Control window, expand Administration Mode Access and then expand Integrations.
Click Event Notifications to open the Module Permission Settings window.
Set the View permission to users and groups as needed.
Under the Permission Settings for: Event Notifications block you can select users or groups and either modify (Modify) or remove (Remove) the existing permission.

To add a new user and add permissions, click Add to open the Permission/Access Control window. In the Permissions Settings for: Event Notifications Select Users/Groups block, click Add Users/Groups to add users or groups. In the Permission Settings block, click View to select and click OK to grant this permission to the users or groups that you have selected.

When finished, click Apply and then click OK to close the window. To discard your changes or close the window click Cancel.

Users or groups with the View permission have the ability to:
1. See the Event Notifications node in the left Navigator.
2. Take actions using available options in the log toolbar.
3. View all notifications records within the log.

Last Published Tuesday, June 4, 2024