Configurable Notification Subject Lines

Oracle HCM Cloud Common Features

O C T O B E R 2021
 Table of Contents

Foreword 1

Technical Capabilities 1

Subject Line Prefixes 1

Locale Error! Bookmark not defined.

Seeded Notification Titles 2

Global Human Resources 3

Use Case: Add Pending Worker for Approval 3

Goal Management 7

Use Case: Worker Goals for Approval (reference only) 7

Performance Management 11

Use Case: Performance Document for Approval 11

Absence Management 16

Use Case: Absence Requests for Approval 16

FAQs 18

Note: In the images or examples included in this document regarding: user details, company names,
addresses, emails, and/or telephone numbers represent a fictitious sample of data (based upon made up
data used in a demo environment). Any similarity to actual persons, living or dead, is purely coincidental
and not intended in any manner.

0 | ORACLE HCM CLOUD RELEASE 12 CONFIGURABLE NOTIFICATION SUBJECT LINES

Foreword
Reading emails and notifications on mobile devices is part of our daily life. Customers may prefer
unique subject lines to accommodate their on-the-go user community for a better user experience.

Every business and regular user is different. When designing BPM task titles:

1. What devices are Fusion Application notifications read on?

2. What is the ideal length of a subject line for your company?

Technical Capabilities
The notification title enhancement will provide you with the ability to:
» Edit the task title: configure the notification title with new corporate terminology.
» Translate the task title: create translations in the Resource Bundle stored in the MDS repository.
» Change attributes: add or remove dynamic expressions (a.k.a tokens) for more captivating content.

Subject Line Prefixes

Subject line prefixes are automatically generated, based on the BPM task status. They are not
configurable. Following are examples:
§ TASK_VIEW_CONTEXT_ALLERTED=Alerted
§ TASK_VIEW_CONTEXT_ASSIGNEE_ASSIGNED=Action Required
§ TASK_VIEW_CONTEXT_ASSIGNEE_COMPLETED=Completed
§ TASK_VIEW_CONTEXT_CLAIMED=Claimed
§ TASK_VIEW_CONTEXT_CREATOR_COMPLETED=Completed
§ TASK_VIEW_CONTEXT_CREATOR_COMPLETED_APPROVE=Approved
§ TASK_VIEW_CONTEXT_CREATOR_COMPLETED_REJECT=Rejected
§ TASK_VIEW_CONTEXT_CREATOR_SUBMITTED=Submitted
§ TASK_VIEW_CONTEXT_DELEGATED=Delegated
§ TASK_VIEW_CONTEXT_DELETED=Deleted
§ TASK_VIEW_CONTEXT_ERRORED=Errored
§ TASK_VIEW_CONTEXT_ESCALATED=Escalated
§ TASK_VIEW_CONTEXT_EXPIRED=Expired
§ TASK_VIEW_CONTEXT_FYI=FYI
§ TASK_VIEW_CONTEXT_FYI_COMPLETED=Dismissed
§ TASK_VIEW_CONTEXT_INFO_REQUESTED=Information Requested
§ TASK_VIEW_CONTEXT_INFO_SUBMITTED=Information Submitted
§ TASK_VIEW_CONTEXT_PUSHED_BACK=Pushed Back
§ TASK_VIEW_CONTEXT_REASSIGNED=Transferred
§ TASK_VIEW_CONTEXT_RELEASED=Released

1 | ORACLE HCM CLOUD RELEASE 12 CONFIGURABLE NOTIFICATION SUBJECT LINES

 § TASK_VIEW_CONTEXT_RENEWED=Renewed
§ TASK_VIEW_CONTEXT_RESUMED=Resumed
§ TASK_VIEW_CONTEXT_ROUTED=Routed
§ TASK_VIEW_CONTEXT_STALE=Stale
§ TASK_VIEW_CONTEXT_SUSPENDED=Suspended
§ TASK_VIEW_CONTEXT_WITHDRAWN=Withdrawn

Seeded Notification Titles

See separate file “Release 12 Configurable Notification Titles for Oracle HCM Cloud.xlsx” for the
mapping of the seeded notification titles, descriptions, and payload attribute mapping.

2 | ORACLE HCM CLOUD RELEASE 12 CONFIGURABLE NOTIFICATION SUBJECT LINES

Global Human Resources
Use Case: Add Pending Worker for Approval
Original Notification Title: Pending Worker Added ({0}, {1}, {2})
Subject line of the notification sent to the approver that a person has been added. {0} represents the name of the
added person (character), {1} represents the person ID (number), and {2} represents the start date (date).

Note: Start Date for Future Hire uses sysdate is tracked via Bug 27800254.

Custom Notification Title: Future Pending Worker {0}, {1} – Approval for Creation
Subject line of the notification sent to the approver that a person has been added. {0} represents the name of the
added person (character) and {1} represents the Job (character).

Log in to BPM Worklist (https://host:port/integration/worklistapp). Or you can navigate to global header - choose
Bell icon for Pending Notifications - select More Details button for Human Capital Management – click open
Username drop-down list - choose Administration - select Task Configuration tab.
1. Search for the task type Pending. Select the AddPendingWorkerApproval composite link and click Edit. On
the General tab, click the Title for the Translation dialog box.

2. Under the English locale, click Add. Enter the Key adhering to project naming convention. Enter a new Title.
Choose Edit to open Edit Arguments dialog box. Click Edit in the first argument.

3 | ORACLE HCM CLOUD RELEASE 12 CONFIGURABLE NOTIFICATION SUBJECT LINES

3. In the expression builder new window, expand the Variables for task:payload. Find ns6:DisplayName for
person’s display name, select and check Preview. Click Insert into Expression then OK to close.

4. Click Edit in the second argument.

4 | ORACLE HCM CLOUD RELEASE 12 CONFIGURABLE NOTIFICATION SUBJECT LINES

5. In the expression builder new window, expand the Variables for task:payload. Find ns6:JobName for the job,
select and check Preview. Click Insert into Expression then OK to close.

6. Click OK and OK to close all dialog boxes.

5 | ORACLE HCM CLOUD RELEASE 12 CONFIGURABLE NOTIFICATION SUBJECT LINES

7. Click Save and OK. Then click Commit Task and OK to proceed with unit testing.

8. Check the results.

6 | ORACLE HCM CLOUD RELEASE 12 CONFIGURABLE NOTIFICATION SUBJECT LINES

Goal Management
Use Case: Worker Goals for Approval (reference only)
Original Notification Title: {1} Requires Your Approval for the Goal Plan {3}
The subject line of an email or a worklist notification that is sent to an approver when a worker submits a goal
plan for approval. Token 1 represents the name of the worker and token 3 represents the name of the goal plan.

Custom Notification Title: {1} submits {3} approval request for your immediate attention
The subject line of an email or a worklist notification that is sent to an approver when a worker submits a goal
plan for approval. Token 1 represents the name of the worker and token 3 represents the name of the goal plan.

Log in to BPM Worklist (https://host:port/integration/worklistapp). Or you can navigate to global header - choose
Bell icon for Pending Notifications - select More Details button for Human Capital Management – click open
Username drop-down list - choose Administration - select Task Configuration tab.
1. Search for the task type ApproveGoal. Select the ApproveGoal composite link and click Edit. On the General
tab, click the Title for the Translation dialog box.

2. Under the English locale, click Add. Enter the Key adhering to project naming convention. Enter a new Title.
Choose Edit to open Edit Arguments dialog box. Click Edit in the first argument.

7 | ORACLE HCM CLOUD RELEASE 12 CONFIGURABLE NOTIFICATION SUBJECT LINES

3. In the expression builder new window, expand the Variables for task:payload. Find ns1:ModuleIdentifier for
worker’s name, select and check Preview. Click Insert into Expression then OK to close.

4. Click Edit in the second argument.

8 | ORACLE HCM CLOUD RELEASE 12 CONFIGURABLE NOTIFICATION SUBJECT LINES

5. In the expression builder new window, expand the Variables for task:payload. Find ns1:Attribute1 for the
goal plan name, select and check Preview. Click Insert into Expression then OK to close.

6. Click OK and OK to close all dialog boxes.

9 | ORACLE HCM CLOUD RELEASE 12 CONFIGURABLE NOTIFICATION SUBJECT LINES

7. Click Save and OK. Then click Commit Task and OK to proceed with unit testing.

8. Check the results.

10 | ORACLE HCM CLOUD RELEASE 12 CONFIGURABLE NOTIFICATION SUBJECT LINES

Performance Management
Use Case: Performance Document for Approval
Original Notification Title: Approval Required for the Performance Document {0} for {1}
Notification to the approver of a performance document when it has been submitted to them for approval. {0}
Represents the performance document name. {1} Represents the worker name.
Custom Notification Title: Performance Review {0} for {1} Awaiting Your Approval
Notification to the approver of a performance document when it has been submitted to them for approval. {0}
Represents the performance document name. {1} Represents the worker name.

Log in to BPM Worklist (https://host:port/integration/worklistapp). Or you can navigate to global header - choose
Bell icon for Pending Notifications - select More Details button for Human Capital Management – click open
Username drop-down list - choose Administration - select Task Configuration tab.
1. Search for the task type PerfDocApproval. Select the PerfDocApprovalTask composite link and click Edit.
On the General tab, click the Title for the Translation dialog box.

11 | ORACLE HCM CLOUD RELEASE 12 CONFIGURABLE NOTIFICATION SUBJECT LINES

2. Under the English locale, click Add. Enter the Key adhering to project naming convention. Enter a new Title.
Choose Edit to open Edit Arguments dialog box. Click Edit in the first argument.

3. In the expression builder new window, expand the Variables for task:payload. Find ns2:Attribute1 for the
performance document name, select and check Preview. Click Insert into Expression then OK to close.

12 | ORACLE HCM CLOUD RELEASE 12 CONFIGURABLE NOTIFICATION SUBJECT LINES

4. Click Edit in the second argument.

5. In the expression builder new window, expand the Variables for task:payload. Find ns2:Attribute3 for
worker’s display name, select and check Preview. Click Insert into Expression then OK to close.

13 | ORACLE HCM CLOUD RELEASE 12 CONFIGURABLE NOTIFICATION SUBJECT LINES

6. Click OK and OK to close all dialog boxes.

7. Click Save and OK. Then click Commit Task and OK to proceed with unit testing.

8. Check the results.

14 | ORACLE HCM CLOUD RELEASE 12 CONFIGURABLE NOTIFICATION SUBJECT LINES

9. Configure other languages only after acceptance testing the English version.

10. Change the Locale for other installed languages.

11. Repeat the steps for a Korean notification title: 성과 검토 {0} 에 대한 {1} 승인을 기다리고 있습니다
Note:
a. The Key should remain unchanged.
b. Save each locale configuration.

12. Check the results.

15 | ORACLE HCM CLOUD RELEASE 12 CONFIGURABLE NOTIFICATION SUBJECT LINES

Absence Management
Use Case: Absence Requests for Approval

This is a typical complex example where there is only one single Human Task is used to control multiple approval notifications, including
dynamically generate the notification title in BPEL activities, and set the corresponding title in Human Task definition.
In BPEL subject to the Absence Record operation (Create, Update, Delete), one of the three titles is set and assigned to Human Task
Title attribute. But SOA XPATH expression does not support the IF Else conditions. Without additional design effort, customizing the
notification title will replace the value of the Human Task metadata title attribute and the new title is then displayed for all three
notifications originated from this human task.

Original Notification Titles:

Create new request Approval of {0} Absence Record for {1} from {2} to {3}
Update existing request {0} Absence Record for {1} from {2} to {3} has been updated
Delete request Withdrawal of {0} Absence Record for {1} from {2} to {3}

Tokens:
{0} Absence Type
{1} Employee Name
{2} Absence Record Start Date
{3} Absence Record End Date

Custom All-purpose Notification Title: {0} {1} Absence Record for {2} from {3} to {4} {5} requested by {6}

New tokens:
{0} ‘Approval of’ for Create, ‘blank’ for Update, ‘Withdrawal of’ for Delete
{1} Absence Type
{2} Employee Name
{3} Absence Record Start Date
{4} Absence Record End Date
{5} ‘blank’ for Create, ‘has been updated’ for Update, ‘blank’ for Delete
{6} Requester's user name

This approach is achieved using concat and starts-with along with substring XPATH functions.

Log in to BPM Worklist (https://host:port/integration/worklistapp). Or you can navigate to global header - choose
Bell icon for Pending Notifications - select More Details button for Human Capital Management – click open
Username drop-down list - choose Administration - select Task Configuration tab.

1. Search for the task type AbsencesApprovalsTask. Select the composite link and click Edit. On the
General tab, click the Title for the Translation dialog box.

2. Under the English locale, click Add. Enter the Key adhering to project naming convention. Enter a new
Title.Choose Edit to open Edit Arguments dialog box. Click Edit in the first argument.

Worked Example: (just copy and paste into the appropriate fields)

{0} concat(substring('Approval of', number(not(starts-

with('CREATE',/task:task/task:payload/ns0:AbsencesApprovalsRequest/ns0:NotificationName)))*12),substring('Withdrawal
of', number(not(starts-with('DELETE',/task:task/task:payload/ns0:AbsencesApprovalsRequest/ns0:NotificationName)))*14))
{1} /task:task/task:payload/ns0:AbsencesApprovalsRequest/ns0:AbsenceType
{2} /task:task/task:payload/ns0:AbsencesApprovalsRequest/ns0:PersonName
{3} /task:task/task:payload/ns0:AbsencesApprovalsRequest/ns0:AbsenceStartDate
{4} /task:task/task:payload/ns0:AbsencesApprovalsRequest/ns0:AbsenceEndDate
{5} substring('has been updated', number(not(starts-
with('UPDATE',/task:task/task:payload/ns0:AbsencesApprovalsRequest/ns0:NotificationName)))*17)
{6} /task:task/task:payload/ns0:AbsencesApprovalsRequest/ns0:Requestor

16 | ORACLE HCM CLOUD RELEASE 12 CONFIGURABLE NOTIFICATION SUBJECT LINES

Run these tests:
1. Create request

2. Update request

3. Delete request

17 | ORACLE HCM CLOUD RELEASE 12 CONFIGURABLE NOTIFICATION SUBJECT LINES

FAQs
1. Is there a function to duplicate the seeded notification title for a minor string change?
No. This requirement is tracked in ENH 27800423 (15).
2. The business cancelled implementation of one custom notification subject line. Is there a way to restore the
original notification title?
No. This requirement is tracked in ENH 27800471 (15).
Use following workarounds:
• P2T or T2T to refresh that stage instance.
• If this occurs in production instance, replicate the original notification tokens in the Translations window.
3. I have experienced browser data cache on Release 12.
This issue is not reproducible on Release 13. The best practice is to clear browser data or use a new browser
session for each title configuration; do not click Save when unsure, choose Reset instead.

4. Is there a way to export/import changes across instances?

Use SOA Composer to export SOA changes from source then import into the target environment. All
environments must be at the same release version and the composite IDs are exactly the same.
See Doc ID 2052137.1 and Doc ID 2329650.1 for details.

18 | ORACLE HCM CLOUD RELEASE 12 CONFIGURABLE NOTIFICATION SUBJECT LINES

 Oracle Corporation, World Headquarters Worldwide Inquiries
500 Oracle Parkway Phone: +1.650.506.7000
Redwood Shores, CA 94065, USA Fax: +1.650.506.7200

CO N N E CT W I T H US

blogs.oracle.com/oracle
Copyright © 2018, Oracle and/or its affiliates. All rights reserved. This document is provided for information purposes only, and the
contents hereof are subject to change without notice. This document is not warranted to be error-free, nor subject to any other
facebook.com/oracle warranties or conditions, whether expressed orally or implied in law, including implied warranties and conditions of merchantability or
fitness for a particular purpose. We specifically disclaim any liability with respect to this document, and no contractual obligations are
formed either directly or indirectly by this document. This document may not be reproduced or transmitted in any form or by any means,
twitter.com/oracle electronic or mechanical, for any purpose, without our prior written permission.

oracle.com Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and
are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are
trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group. 0418

Oracle HCM Cloud Release 12 Configurable Notification Subject Lines

October 2021
Surlina Yin