Configure In-App Approval Notifications With BI Publisher: White Paper / October 24, 2019
Configure In-App Approval Notifications With BI Publisher: White Paper / October 24, 2019
Configure In-App Approval Notifications With BI Publisher: White Paper / October 24, 2019
App Approval
Notifications
with BI
Publisher
WHITE PAPER / OCTOBER 24, 2019
DISCLAIMER
This document in any form, software or printed matter, contains proprietary
information that is the exclusive property of Oracle. Your access to and use of this
confidential material is subject to the terms and conditions of your Oracle software
license and service agreement, which has been executed and with which you
agree to comply. This document and information contained herein may not be
disclosed, copied, reproduced or distributed to anyone outside Oracle without prior
written consent of Oracle. This document is not part of your license agreement nor
can it be incorporated into any contractual agreement with Oracle or its
subsidiaries or affiliates.
This document is for informational purposes only and is intended solely to assist
you in planning for the implementation and upgrade of the product features
described. It is not a commitment to deliver any material, code, or functionality,
and should not be relied upon in making purchasing decisions. The development,
release, and timing of any features or functionality described in this document
remains at the sole discretion of Oracle.
Due to the nature of the product architecture, it may not be possible to safely
include all features described in this document without risking significant
destabilization of the code.
The testing disclaimer in the TM block on the last page (highlighted in yellow) is
provided by the FCC for hardware products. It must appear in the TM block for all
pre-release, pre-GA hardware products. Be sure to remove the yellow highlighting
before publishing. When the product becomes GA, update your collateral by
removing the disclaimer from the TM block. If your product is already GA or if you
are writing about a software product, delete the disclaimer from the TM block.
Important: If your product is not GA, then you cannot include any regulatory
compliance information in the statement of direction. Regulatory compliance
information may be included for GA products only if you have completed all
required safety and emissions testing, and you have received the certificates
issued by the testing organization.
INTRODUCTION .............……………………………………………………4
CONSIDERATIONS …………………………………………………………..30
CONCLUSION ……..…………………………………………………………..36
As business processes and compliance continue to evolve, companies are placing more
and more emphasis on document and spend approvals. Oracle Fusion Procurement
uses Use Oracle BI Publisher Templates to generate online approval notifications.
Oracle BI Publisher offers the flexibility in configuring notifications. This feature has
been leveraged in Oracle Procurement to configure E-Mail approval notifications.
Enabling this feature for online notifications provides complete flexibility for the buying
organization to configure and use flexible layout in their approvals process.
In this whitepaper, you can learn about the features available and the steps required for
setting up Oracle BI Publisher Templates to generate online approval notifications.
KEY COMPONENTS
Release 13 (Update 18A) allows you to opt in to and enable Business Intelligence
Publisher template based Approval email notification.
From Update 18C onwards, this has been enhanced to provide the capability to
configure Approval online notification as per business needs and is controlled by Opt-in.
User can either opt-out of the Business Intelligence Publisher template based Approval
notifications or can Opt-in to get only Email notification or Both.
Figure 1 User should be able to select the opt-in with the options shown in the figure
After this feature is enabled, follow these steps to configure the template for requisition
approval notifications:
Navigation:
1. Login into BI Publisher with the given credentials
2. Click on Catalog link at the right top corner
3. The reports are displayed in two folders, My Folders and Shared Folders
• Shared Folders contains the reports and folders you have been granted
access to based on your role
• My Folders contains the reports and folders your administrator has assigned
to you and the reports you have created (if you have the BI Publisher Developer or
Administrator role).
2. Expand folders: Shared Folder -> Procurement -> Self Service Procurement.
3. Select Requisition Approval Email Report. Click More and select Customize. This
will create a copy of the report in the Custom folder. (Alternatively, user can
copy paste the folder from Seeded path to the custom folder under procurement,
so that seeded template is copied to the custom folder)
Edit Report
5. Edit the content or layout as necessary. For example, if you want to include Line
level attribute Item Source, you can go to BI publisher, Select the field,
ITEM_SOURCE and click insert
If the user wants to customize an item image, add some dummy image where you want
the item image to be displayed.(Screen shot shown below)
It opens a format picture popup, go to alt txt tab, add an alternative text as
"url:{LINE_PICTURE}" as shown below.
Upload Report
1. In the Catalog, expand folders: Shared Folder -> Custom -> Procurement -> Self
Service Procurement.
2. Click on Add New Layout button
3. Click upload icon under Templates.
4. In the Upload Template File pop up, Enter the Layout Name, select modified report in
the Template File, select template type as RTF template, select English (United States)
as Locale, and click Upload.
8. To run the report online, Go to Properties and check the ‘Run Report Online’
checkbox.
9. Click on View Report button and view the report.
Following is the list of Requisition Header, Line and Distribution attributes that are
supported for customizing the template
SUBMISSION_DATE SUBMISSION_DATE
DEFAULT_TAXATION_COU DEFAULT_TAXATION_C
NTRY OUNTRY
DOCUMENT_SUB_TYPE DOCUMENT_SUB_TYP
E
TAX_USER_OVERRIDE_HD TAX_USER_OVERRIDE
R_FLAG _HEADER_FLAG
LINE ATTRIBUTES
DISTRIBUTION ATTRIBUTES
DISTRIBUTION_ID Requisition
distribution unique
identifier
CONSIDERATIONS
The following role is needed to configure the notification data model and template:
Email Notification
This screen shot illustrates the Notification that is generated to Approver to approve
a Requisition. The Approval history shows graph of the user who has submitted,
assigned to the current approver and the future approvers.
Email Notification
The Approval amount can be shown in the Approver’s preferred currency by adding
User preferred Currency attribute in the rtf template.
Don't rename any of the notification reports or sub templates or style template
Never edit the seeded notifications, always customize (for reports and style/sub
templates) and copy to custom folder for data models
Before starting customizations note down which layout is the default layout of the
report and also download the rtf for safe keeping.
If there are multiple layouts for report, select the old one back to revert the
default notification
To revert customizations delete the artifacts from custom folder
When customizing the sub template, do not remove any sub template definition
from it.
CONCLUSION
Oracle BI Publisher offers the flexibility in configuring notifications. User can configure
the layout, style and format of the approval notifications to meet their unique business
requirements. Configure the notification content by adding or removing approval data
model attributes.