Professional Documents
Culture Documents
ID 2331021.1 Global HR Configurable Notifications v3
ID 2331021.1 Global HR Configurable Notifications v3
Introduction 1
Role Information 1
Profile Option 4
General Structure 5
Configurable Notifications 8
Translation 24
Advanced Solution 25
Prerequisites 25
Additional Resources 25
Appendix 26
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.
Role Information
Use the delivered job role ‘Application Implementation Consultant’
(ORA_ASM_APPLICATION_IMPLEMENTATION_CONSULTANT_JOB) or add the BI Publisher Data Model
Developer (BIPDataModelDeveloper) and BI Author Role (BIAuthor) to your custom role for accessing the delivered
data model, of which “Strictly Read Only”.
3. Install Template Builder for Word (32 bit) or Template Builder for Word (64 bit) on your computer.
4. Once installed successfully, the Template Builder for Word Tutorial.doc populates and the BI Publisher toolbar
appears.
Note: BI Publisher illustrations in this paper are in Microsoft Word 2016 format.
5. Based on the version of Office, install the add-on in the file directory after BI Publisher.
Enable the products to utilize the BI Publisher email notification feature. Follow these setup steps:
1. Select Navigator – Setup and Maintenance – Search and search for the Manage Administrator Profile
Values task.
2. Search for BIP_EMAIL_NOTIFICATION_HCM% to see the results in the table.
Profile Option Code Description
BIP_EMAIL_NOTIFICATION BIP EMAIL NOTIFICATION PER ORACLE FUSION LEVEL
BIP_EMAIL_NOTIFICATION_HCM Enable Oracle Business Intelligence Publisher notifications for
human capital management applications
BIP_EMAIL_NOTIFICATION_HCM_ANC Enable Business Intelligence Publisher notifications for absence
application
BIP_EMAIL_NOTIFICATION_HCM_COMPENSATION Enable Oracle Business Intelligence Publisher notifications for
compensation applications
BIP_EMAIL_NOTIFICATION_HCM_HXT To enable BIP Email Notification for HXT (Time and Labor)
BIP_EMAIL_NOTIFICATION_HCM_IRC Enable Oracle Business Intelligence Publisher notifications for
recruiting applications
BIP_EMAIL_NOTIFICATION_HCM_PER Enable Oracle Business Intelligence Publisher notifications for
global human resources applications
BIP_EMAIL_NOTIFICATION_HCM_TALENT Enable Oracle Business Intelligence Publisher notifications for
talent management applications
3. The profile values are defaulted to false using Classic format at site level, set to true for the BI Publisher format
deployment. Note that the profile option BI Publisher Notifications Enabled for Human Capital Management
(BIP_EMAIL_NOTIFICATION_HCM) is the lowest level of setting for all products in the Oracle HCM Cloud. Its
profile value ‘true’ can be overridden by individual product profile value ‘false’ in a phase roll out scenario. The
system will always first check individual product profile values.
Enable the products to utilize the BI Publisher email notification feature for worklist notifications, in keeping with the
same look and feel. Follow these setup steps:
» Use short, succinct text and sentences, no more than three columns for a table to fit on mobile devices.
» URLs should not have an underscore.
» All design contents must stay within the main table border, aligning all sections with the correct margins.
» Uptake BI Publisher styles only.
» Select the Access tab, and in the Actions section, specify an array of access levels. These settings determine
the list of actions in the drop-down list in online notifications. To hide, deselect the options.
» The following steps articulate how to add a company logo and department, modify label names such as employee
name, change termination date to last working day, and include hire date onto the BI Publisher email notifications.
b. The selected report is populated in the BI Server Catalog. Place the cursor over the Data Model
hyperlink to reveal the location of the delivered data model this report is executed upon. Click Edit to
download the report in rtf format and save it to your local drive to proceed with customization.
c. To revert customization, delete the artifacts from the Custom folder. Ensure the Default Layout check
box is selected for the predefined rtf template.
d. Open the local report.rtf with Microsoft Word for customization, and select the gridlines view with
formatting marks.
» To modify the report by adding a new Attribute from the delivered data model, follow these steps:
1. Navigate to the Catalog - Workflow Notifications – Data Models folder (Location/Shared Folders/Human
Capital Management/Workflow Notifications/Data Models).
2. In the Data Model folder (Location/Share Folders/Human Capital Management/Workflow Notifications/Data
Models). Click Edit.
3. Data Model Data Sets are a collection of SQL statements to retrieve the processed data from the data
source. Open the data model diagram to find available attributes for custom design.
Important Note: Customers must not modify the seeded data model. Directly making changes to the
seeded data model is unsupported; custom changes are not patching or upgrade safe. Instead, you can
copy the seeded data model then modify from the copy accordingly.
7. Confirmation pop-up dialog confirms that the data loaded successfully. Click OK.
9. Enter a Hire Date label name, and place the cursor where the new attribute legal employer start date
should be inserted. On the BI Publisher tab, click Field, enter a keyword, select Find Next, highlight the
attribute, check the Example output, and click Insert. Repeat this step to add more attributes if necessary.
10. Click Tools – Validate Template to check for errors. Save with the same file name. Once validated, you
can upload the custom report.rtf to the Oracle BI Publisher server and review the update report.
14. In the upload window, browse for the modified BI Publisher report in the local Desktop and select the
template Type as "rtf", and Locale as "English." If this is a repeat test, verify your attempt to overwrite.
§ Make sure the name of the custom report in BI server is same as the original.
17. Enter a transaction ID and click Apply. Verify the report output.
When you make changes to the custom data model and the custom rtf template in the “Custom folder”, the same changes
reflect in the seeded data model and the seeded rtf template. This is the expected behavior.
When you delete both in the custom folder, the seeded data model and the delivered rtf template are restored.
6. Select Data tab, enter a transaction ID and click View. Verify the name of Department. Click Export.
Save the xml to your local drive.
8. Click BI Publisher – Sample XML. Select the latest saved Sample XML data from local drive, and click
Open.
9. Enter a Department label name; place the cursor where the new attribute department is to be inserted.
Choose BI Publisher – Field, enter a keyword, click Find Next, highlight the attribute, check the Example
output, and click Insert.
10. Optionally, add logic to the department row if the value is null, then skip rendering. Place the cursor before
and after the row, select the BI Publisher tab, and then click Conditional Region. See documentation re:
Inserting a Conditional Region. Once validated, you can then upload the report.rtf to the Oracle BI
Publisher server and review the update report.
11. Click Tools – Validate Template. Save the rtf.
a. If the data model for your report doesn't have the BINDISONLINENOTIF attribute, then:
b. In your .rtf report layout template, put your cursor immediately before the content you want to make
conditional.
c. Enter the following code, which functions the same as the C form field:
d. <?if:BINDISONLINENOTIF='true'?> for in-app only
e. <?if:BINDISONLINENOTIF='false'?> for email only
f. Put your cursor immediately after your conditional content.
g. Enter <?end if?>, which functions the same as the EC form field.
h. Save your changes in Word.
13. Locate the custom report by navigating to Catalog – Location/Shared Folders/Custom/Human Capital
Management/Workflow Notifications. Click Edit.
14. Verify the browser url:
https://host:port/xmlpserver/servlet/editor/report?_xdo=/Custom/Human+Capital+Management/Workflow+Notifications/TerminationReport.xdo
15. Search the custom data model and click Open to link the custom rtf. Place the cursor over the
EmploymentWRProceses hyperlink to verify the path.
16. Click Properties. Upload the custom rtf and confirm to overwrite. Click Save and Return.
» Cosmetic Changes. You can modify any header, text, label names and layout, or change font and remove
attributes without using the data model.
» Add a branding logo. Follow these steps:
1. Log in to BI Publisher server (https://host:port/xmlpserver/servlet/home), navigate to the Templates folder
(Location/Shared Folders/Common Content/Templates). On the Workflow Notification Subtemplate
click More and click Customize. Select English to download the FinFunWorkflowNotificationSub.rtf to
your local drive.
2. There are two logo regions in the subtemplate, upload twice. You make global changes from this
subtemplate. If your enterprise is a group of companies and each has a different logo, use case
expression to control the appearance of a specific company logo.
4. Click Upload, select File on local drive, English for Locale, click OK and then click OK to confirm
overwrite. Click Save and Return.
For more information, see topic Locale Selection Logic in the Translation Support Overview and Concepts with
Fusion Middleware Report Designer's Guide for Oracle Business Intelligence Publisher guide.
Abstract Format
User Preference Property Name Format Type Worked Example
Mask
Date Format xslt._XDODEFDATE Java date format XDODEFDATE <?format-date:mydate; 'XDODEFDATE'?>
Note: ISO 4217 defined 'minor unit' will be used to determine the currency value decimal.
Advanced Solution
To selectively disable email notifications but enable Worklist: Notifications and Approvals within the Fusion
Application for certain composites, see how-to in Frequently Asked Questions About Approvals (Doc ID 1987850.1)
p.4, Can I disable email notifications for specific business processes? This option to Delete Notification applies to
(Classic and BI Publisher) Email and bell notification types.
Prerequisites
1. Simple Mail Transfer Protocol (SMTP) email transmission. Incoming and outgoing email server configuration
within Oracle Fusion Applications / SOA Suite are enabled. For unit testing, see How to Set a Global Email
Account for all Notifications for Testing Purposes (Test Address) (Doc ID 1473706.1).
2. HTML is the best message format to use when you want to create emails that look nice with various fonts,
colors, and when you want to show pictures inside your message. See How to configure Exchange Server to
automatically convert RTF messages to the HTML format for reference.
3. Configuration. Check Tools > Transaction Console that Bypass Approvals is disabled. Verify FSM >
Configure Seniority Dates at work relationship level is setup correctly. Confirm BPM Worklist > Task
Configuration composite settings.
Additional Resources
Configurable Workflow Notifications (documentation)
CONNECT WITH US
blogs.oracle.com/oracle
Copyright © 2017, 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. 1021