Event Notifications
The event notifications are meant for the external applications that integrate with Unifier. 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.
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 your Company Workspace and switch to the Admin mode.
- From the left Navigator, click the Integrations grouping node to expand it.
- Click Event Notifications. The Event Notifications log or window displays.
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, then an entry gets listed in the Event Notifications log. This applies to both Workflow and Non-workflow BPs.
The Event Notifications log or window has the following toolbar options:
- View
This drop-down list allows you to select the system-defined views that are available to users who have access to view the Event Notifications log. It also allows you to create and manage the 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 new 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 reorder, show or hide views, and delete the custom views.
- All Notifications
- Edit View
Enables you to select which columns to be displayed or remain hidden, apply filters, group and sort by available fields and to save custom views.
- Refresh
To update the information displayed on the screen.
- Print
To print the information displayed on the screen. Your options are:
- 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 open a row on top of the rows within the log and enter values in each column to start a search for a specific item in the log.
The Event Notifications log or window has the following columns:
Column Name | Description | Applies to WF BPs | Applies to Non-WF BPs |
---|---|---|---|
Shell Number | Populates with the project or shell number where the event was triggered. | Yes | Yes |
Shell Name | Populates with the name of the project or 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, then 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 got triggered). | Yes | Yes |
New Status | The final status of the BP record which satisfies the event trigger condition. | Yes | Yes |
The Event Notifications log or window Workflow BPs and Non-Workflow BPs:
Workflow BPs | Non-Workflow BPs |
---|---|
For the Workflow BPs, the grid displays a record of all of the workflow actions that are taken within the BP records, and which are set with the Generate event notification option as checked, in uDesigner. 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 setup to generate an event notification) is taken in the Workflow BP record, then the notification row is inserted in the log. If there are multiple assignees on a step, then 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, then Unifier 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, Unifier 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, then Unifier 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 Event Notifications functional node permissions:
- Go to your Company Workspace and switch to the Admin mode.
- From the left Navigator, click the User Administration grouping node to expand it.
- Click Access Control. The Access Control log or window displays.
- On the right pane, click Administration Mode Access to expand.
- Click Integrations to expand.
- 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. From the Permissions Settings for: Event Notifications Select Users/Groups block click Add Users/Groups to add users or groups. From 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:
- See the Event Notifications node in the left Navigator.
- Take actions using available options in the log toolbar.
- View all notifications records within the log.
Last Published Friday, February 2, 2024