Send Workflow Notification to Multiple Users Using

Roles.
16/12/2014

Enterprise Solutions

Amit Acharya
Oracle Applications
amit.acharya@tcs.com
 Confidentiality Statement
Include the confidentiality statement within the box provided. This has to be legally
approved
Confidentiality and Non-Disclosure Notice
The information contained in this document is confidential and proprietary to TATA
Consultancy Services. This information may not be disclosed, duplicated or used for any
other purposes. The information contained in this document may not be released in whole or
in part outside TCS for any purpose without the express written permission of TATA
Consultancy Services.

Tata Code of Conduct

We, in our dealings, are self-regulated by a Code of Conduct as enshrined in the Tata Code
of Conduct. We request your support in helping us adhere to the Code in letter and spirit. We
request that any violation or potential violation of the Code by any person be promptly
brought to the notice of the Local Ethics Counselor or the Principal Ethics Counselor or the
CEO of TCS. All communication received in this regard will be treated and kept as
confidential.

2
Table of Content

3
Introduction
Oracle Workflow provides a complete workflow management system that supports business process based
integration. It is often used by Oracle E-Business Suite Application to deliver streamlined business processes that
incorporate human tasks through various types of notifications and messaging to route information to business
decision makers and acquire approval of the same.

Purpose:
Business requirement might arise where a particular notifications needs to be routed to multiple users. This can be
accomplished with the help of HRMS Roles.

This guide will describes the steps which need to be performed:

Addition of Role type attribute in the Workflow defination file.

Defining Global HRMS role.
Set the value of HRMS Role to the Attribute defined

Audience for this Guide :

This document is intended to developers who have working knowledge of Oracle PL/SQL and know the customary
practices involved in developing workflow using Oracle workflow builder.

About Oracle Workflow Builder:

Oracle Workflow Builder Builder is the principal tool used by Oracle Applications developers to create new and
update existing Workflow process definitions.
It is a graphical tool that lets developers to create, view, or modify workflow objects, including activities, item types,
and messages with simple drag and drop operations.

4
How-to Details:

STEP 1: Addition of Role type attribute in the Workflow defination file.

A .Open the workflow defination.

Click on FILE from the menu bar, then OPEN.
B .Create an attribute of type ROLE:

c.Double click on the process containing the notification:

5
 d. We have too add the Role type attribute as the performor of the notification. Open the notification and then
go to the NODE tab. Modify the notification performer:

e. Click on Validate button to validate the workflow defination and then save it.

STEP 2: Defining Global HRMS Role:

6
We will define a HRMS Role from HRMS Manager Responsibilty. This role will contain the list of users to whom the
notification would be sent out.
a. From HRMS Manager Responsibility > Transaction Maintenance > Global Roles

b. Provide a Unique Role Name and the intended persons/Users to receive the Notification. Make sure that the
enabled checkbox is checked.

STEP 3: Set the value of HRMS Role to the Attribute defined

Once HRMS Role defination is completed, it's value needs to be set to the newly defined WF attribute anywhere
before the notification is fired. This can be done by using wf_engine.setitemattrtext api. The value of the role type
attribute should be the HRMS role name.
Sample code snippet is given below:

wf_engine.setitemattrtext (itemtype => v_itemtype,

itemkey => v_itemkey,
aname => 'ROLE_1', --Role Type attribute
avalue => 'XX_GLOBAL_ROLE' ) -Role Name

Additional Informations:
While creating a notification in any process, we can optionally use the 'Expand Role' functionality. If we uncheck
expand roles, the notification will disappear from the queue of all the users once any one user responds to the
notification. If it is checked, the notification remains in the user's queue until the user closes it.

7
References:
a. Oracle Workflow Developers guide
b. Oracle Workflow API Reference