Workflow Administrators Guide
Workflow Administrators Guide
Workflow Administrators Guide
Administrator's Guide
Release 12.2
Part No. E22008-21
October 2023
Oracle Workflow Administrator's Guide, Release 12.2
Contributing Author: Rekha Ayothi, Varsha Bhatia, George Buzsaki, Remy Chen, John Cordes, Mark Craig,
Avinash Dabholkar, David Fang, Mark Fisher, Noriko Gougler, Yongran Huang, Kevin Hudson, Saroja
Kandepuneni, George Kellner, Sai Kilaru, Angela Kung, David Lam, Janet Lee, Jin Liu, Kenneth Ma, Radde
Majeed, Steve Mayze, Santhana Natarajan, Rajesh Raheja, Varadarajan Rajaram, Tim Roveda, Narsimhulu
Sanika, Robin Seiden, Vijay Shanmugam, Sachin Sharma, Sheryl Sheh, Dilbagh Singh, Alejandro Sosa, Allison
Sparshott, Susan Stratton, Roshin Thomas, Shivdas Tomar, Robert Wunderlich
This software and related documentation are provided under a license agreement containing restrictions on
use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your
license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license,
transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse
engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is
prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If
you find any errors, please report them to us in writing.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on
behalf of the U.S. Government, then the following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software,
any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are
"commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-
specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the
programs, including any operating system, integrated software, any programs installed on the hardware,
and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No
other rights are granted to the U.S. Government.
This software or hardware is developed for general use in a variety of information management applications.
It is not developed or intended for use in any inherently dangerous applications, including applications that
may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you
shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its
safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this
software or hardware in dangerous applications.
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.
This software or hardware and documentation may provide access to or information about content, products,
and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly
disclaim all warranties of any kind with respect to third-party content, products, and services unless
otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates
will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party
content, products, or services, except as set forth in an applicable agreement between you and Oracle.
For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at
http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.
Oracle customers that have purchased support have access to electronic support through My Oracle Support.
For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.
com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.
Contents
Preface
iii
Step 10: Adding Worklist Functions to User Responsibilities.............................................2-162
Step 11: Setting the WF: Notification Reassign Mode Profile Option................................. 2-165
Step 12: Setting the WF: Disable Reassign to Submitter Profile Option............................. 2-166
Step 13: Setting the WF: Enable Bulk Notification Response Profile Option..................... 2-167
Step 14: Enabling the Notification Details Pop-up Window............................................... 2-168
Step 15: Displaying the Number of Open Notifications in the Oracle E-Business Suite Home
Page........................................................................................................................................ 2-169
Step 16: Controlling the Display of the Global Worklist Button.........................................2-170
Step 17: Setting Up Notification Handling Options............................................................ 2-170
Step 18: Configuring the Oracle Workflow User List of Values.......................................... 2-172
Step 19: Setting Up for Electronic Signatures....................................................................... 2-181
Step 20: Customizing the Logo on Oracle Workflow Web Pages........................................ 2-185
Step 21: Adding Custom Icons to Oracle Workflow............................................................ 2-186
Step 22: Setting Up the Business Event System....................................................................2-186
iv
Guest Access from Notifications................................................................................. 5-32
Guest Access from Oracle E-Business Suite Forms......................................................5-33
Testing Status Monitor Access................................................................................................ 5-36
Testing Standard Access......................................................................................................... 5-37
Testing Guest Access............................................................................................................... 5-39
Status Monitor Portlets........................................................................................................... 5-42
Error Workflows Portlet.....................................................................................................5-42
Workflows Portlet.............................................................................................................. 5-43
6 Administering Notifications
Searching for Users' Notifications............................................................................................ 6-1
Defining Vacation Rules for Users........................................................................................... 6-7
Reviewing Electronic Signature Details................................................................................. 6-10
Reviewing the Source of Notification Actions....................................................................... 6-13
Defining Specialized Worklist Views with Worklist Flexfields........................................... 6-15
Embedding the Personal Worklist in an Oracle Application Framework Page.................... 6-30
Testing Mailer URL Access..................................................................................................... 6-31
v
Using the Workflow XML Loader........................................................................................... 8-11
vi
A Oracle Workflow Administrator Navigation Paths
Oracle Workflow Administrator Navigation Paths................................................................. A-1
Glossary
Index
vii
Send Us Your Comments
Oracle welcomes customers' comments and suggestions on the quality and usefulness of this document.
Your feedback is important, and helps us to best meet your needs as a user of our products. For example:
• Are the implementation steps correct and complete?
• Did you understand the context of the procedures?
• Did you find any errors in the information?
• Does the structure of the information help you with your tasks?
• Do you need different information or graphics? If so, where, and in what format?
• Are the examples correct? Do you need more examples?
If you find any errors or have any other suggestions for improvement, then please tell us your name, the
name of the company who has licensed our products, the title and part number of the documentation and
the chapter, section, and page number (if available).
Note: Before sending us your comments, you might like to check that you have the latest version of the
document and if any concerns are already addressed. To do this, access the new Oracle E-Business Suite
Release Online Documentation CD available on My Oracle Support and www.oracle.com. It contains the
most current Documentation Library plus all documents revised or released recently.
Send your comments to us using the electronic mail address: appsdoc_us@oracle.com
Please give your name, address, electronic mail address, and telephone number (optional).
If you need assistance with Oracle software, then please contact your support representative or Oracle
Support Services.
If you require training or instruction in using Oracle software, then please contact your Oracle local office
and inquire about our Oracle University offerings. A list of Oracle offices is available on our Web site at
www.oracle.com.
ix
Preface
Intended Audience
Welcome to Release 12.2 of the Oracle Workflow Administrator's Guide.
This guide assumes you have a working knowledge of the following:
• The principles and customary practices of your business area.
See Related Information Sources on page xiii for more Oracle E-Business Suite product
information.
Documentation Accessibility
For information about Oracle's commitment to accessibility, visit the Oracle
Accessibility Program website at http://www.oracle.com/pls/topic/lookup?
ctx=acc&id=docacc.
xi
through My Oracle Support. For information, visit http://www.oracle.
com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?
ctx=acc&id=trs if you are hearing impaired.
Structure
1 Overview of Oracle Workflow
This chapter introduces you to the concept of a workflow process and to the major
features of Oracle Workflow.
2 Setting Up Oracle Workflow
This chapter describes the requirements for Oracle Workflow and the steps necessary
to set up Oracle Workflow at your site.
3 Oracle Workflow Security
This chapter describes the architecture and configuration of security for Oracle
Workflow.
4 Oracle Workflow Home Page
This chapter discusses the Oracle Workflow home page, where administrators can
centrally access the Web-based features of Oracle Workflow.
5 Monitoring Workflow Processes
This chapter discusses how to monitor an instance of a workflow process.
6 Administering Notifications
This chapter describes how to administer users' notifications.
7 Oracle Workflow Manager
This chapter describes how to use the Oracle Workflow Manager component of Oracle
Applications Manager.
8 Oracle Workflow Loaders
This chapter describes access protection for workflow object definitions and how to
load those definitions between a database and a flat file.
9 Workflow Administration Scripts
This chapter describes the SQL scripts that workflow administrators can run against an
Oracle Workflow server installation.
A Oracle Workflow Administrator Navigation Paths
This appendix lists the navigation paths to Oracle Workflow administrator Web pages
in the seeded Oracle Workflow responsibilities for Oracle E-Business Suite.
B Oracle Workflow Administrator Personalizations
This appendix lists features that you can add to Oracle Workflow administrator Web
pages through Oracle Application Framework Personalization.
C Oracle Workflow Performance Concepts
This appendix describes concepts and techniques that you can use to enhance
performance when running Oracle Workflow.
D Oracle Workflow Profile Options
xii
This appendix lists the profile options that you can set to configure Oracle Workflow.
E Oracle Workflow Diagnostic Tests
This appendix describes the diagnostic tests that workflow administrators can run to
check the setup of Oracle Workflow.
Glossary
• Release Notes - For information about changes in this release, including new
features, known issues, and other details, see the release notes for the relevant
product, available on My Oracle Support.
Related Guides
You should have the following related books on hand. Depending on the requirements
of your particular installation, you may also need additional manuals or guides.
Oracle Alert User's Guide
This guide explains how to define periodic and event alerts to monitor the status of
your Oracle E-Business Suite data.
Oracle Application Framework Developer's Guide
xiii
This guide contains the coding standards followed by Oracle E-Business Suite
Development to create applications with Oracle Application Framework. This guide is
available in PDF format on My Oracle Support and as online documentation in
JDeveloper 10g with Oracle Application Extension.
Oracle Application Framework Personalization Guide
This guide covers the design-time and run-time aspects of personalizing applications
built with Oracle Application Framework.
Oracle Diagnostics Framework User's Guide
This manual contains information on implementing and administering diagnostics tests
for Oracle E-Business Suite using the Oracle Diagnostics Framework.
Oracle E-Business Suite Cloud Manager Guide
This guide describes how to manage Oracle E-Business Suite environments on Oracle
Cloud Infrastructure (OCI) using the automated tooling in Oracle E-Business Suite
Cloud Manager.
Oracle E-Business Suite Concepts
This book is intended for all those planning to deploy Oracle E-Business Suite Release
12.2, or contemplating significant changes to a configuration. After describing the
Oracle E-Business Suite architecture and technology stack, it focuses on strategic topics,
giving a broad outline of the actions needed to achieve a particular goal, plus any
installation and configuration choices that are available.
Oracle E-Business Suite Developer's Guide
This guide contains the coding standards followed by Oracle E-Business Suite
Development. It describes the Oracle Application Object Library components needed to
implement the Oracle E-Business Suite user interface described in the Oracle E-Business
Suite User Interface Standards for Forms-Based Products. It provides information to help
you build your custom Oracle Forms Developer forms so that they integrate with
Oracle E-Business Suite. In addition, this guide has information for customizations in
features such as concurrent programs, flexfields, messages, and logging.
Oracle E-Business Suite Electronic Technical Reference Manual User's Guide
This guide describes how to set up and navigate Oracle E-Business Suite Electronic
Technical Reference Manual (eTRM) user interface in Oracle E-Business Suite. It also
explains how to browse and search the Oracle eTRM repository to locate desired FND
and database metadata and objects, and how to view object details, reports, and
diagrams.
Oracle E-Business Suite Installation Guide: Using Rapid Install
This book describes how to run Rapid Install to perform a fresh installation of Oracle E-
Business Suite Release 12.2 or to replace selected technology stack executables in an
existing instance.
Oracle E-Business Suite Integrated SOA Gateway Developer's Guide
xiv
This guide describes how integration developers can perform end-to-end service
integration activities. These include orchestrating discrete web services into meaningful
end-to-end business processes using business process execution language (BPEL), and
deploying BPEL processes at runtime.
This guide also explains how to invoke web services using the Service Invocation
Framework. This includes defining web service invocation metadata, invoking web
services, and testing web service invocation.
Oracle E-Business Suite Integrated SOA Gateway Implementation Guide
This guide explains how integration administrators can manage and administer the web
service activities for integration interfaces including native packaged integration
interfaces, composite services (BPEL type), and custom integration interfaces. It also
describes how to set up and implement Service Invocation Framework to invoke SOAP
and REST services from Oracle E-Business Suite, and how to manage web service
security, configure logs, and monitor both inbound service invocations using Service
Monitor and outbound service invocations through Service Invocation Framework
using Service Invocation Monitor.
Oracle E-Business Suite Integrated SOA Gateway User's Guide
This guide describes the high level service enablement process, explaining how users
can browse and view the integration interface definitions and services residing in
Oracle Integration Repository.
Oracle E-Business Suite Maintenance Guide
This guide explains how to patch an Oracle E-Business Suite system, describing the
adop patching utility and providing guidelines and tips for performing typical patching
operations. It also describes maintenance strategies and tools designed to help keep a
system running smoothly.
Oracle E-Business Suite Mobile Apps Administrator's Guide, Release 12.1 and 12.2
This guide includes the latest mobile release with new underlying technologies, as well
as the earlier mobile releases built with Oracle Mobile Application Framework (MAF).
It explains how to set up an Oracle E-Business Suite instance to support connections
from Oracle E-Business Suite mobile apps. It also describes common administrative
tasks for configuring Oracle E-Business Suite mobile apps. Logging and troubleshooting
information is also included in this book.
Oracle E-Business Suite Mobile Apps Developer's Guide, Release 12.1 and 12.2
This guide includes information for the latest mobile release with new underlying
technologies, as well as the earlier mobile releases built with Oracle Mobile Application
Framework (MAF). For mobile releases built with MAF, this guide describes how to
develop enterprise-distributed mobile apps by using mobile application archive (MAA)
files and how to implement corporate branding. It also explains required tasks on
implementing push notifications for supported mobile apps. In addition, it includes
how to implement Oracle E-Business Suite REST services to develop custom mobile
apps by using the Login component from Oracle E-Business Suite Mobile Foundation or
xv
using any mobile app development framework if desired.
Oracle E-Business Suite Security Guide
This guide contains information on a comprehensive range of security-related topics,
including access control, user management, function security, data security, secure
configuration, and auditing. It also describes how Oracle E-Business Suite can be
integrated into a single sign-on environment.
Oracle E-Business Suite Setup Guide
This guide contains information on system configuration tasks that are carried out
either after installation or whenever there is a significant change to the system. The
activities described include defining concurrent programs and managers, enabling
Oracle Applications Manager features, and setting up printers and online help.
Oracle E-Business Suite User's Guide
This guide explains how to navigate products, enter and query data, and run
concurrent requests by means of the user interfaces (UI) of Oracle E-Business Suite. It
includes basic information on setting preferences and customizing the UI. An
introduction to Oracle Enterprise Command Centers is also included. Lastly, this guide
describes accessibility features and keyboard shortcuts for Oracle E-Business Suite.
Oracle Workflow API Reference
This guide describes the APIs provided for developers and administrators to access
Oracle Workflow.
Oracle Workflow Client Installation Guide
This guide describes how to install the Oracle Workflow Builder and Oracle XML
Gateway Message Designer client components for Oracle E-Business Suite.
Oracle Workflow Developer's Guide
This guide explains how to define new workflow business processes and customize
existing Oracle E-Business Suite-embedded workflow processes. It also describes how
to configure message metadata for Oracle Mobile Approvals for Oracle E-Business Suite
and how to define and customize business events and event subscriptions.
Oracle Workflow User's Guide
This guide describes how users can view and respond to workflow notifications and
monitor the progress of their workflow processes.
Oracle XML Gateway User's Guide
This guide describes Oracle XML Gateway functionality and each component of the
Oracle XML Gateway architecture, including Message Designer, Oracle XML Gateway
Setup, Execution Engine, Message Queues, and Oracle Transport Agent. It also explains
how to use Collaboration History that records all business transactions and messages
exchanged with trading partners.
The integrations with Oracle Workflow Business Event System, and the Business-to-
Business transactions are also addressed in this guide.
xvi
Integration Repository
The Oracle Integration Repository is a compilation of information about the service
endpoints exposed by the Oracle E-Business Suite of applications. It provides a
complete catalog of Oracle E-Business Suite's business service interfaces. The tool lets
users easily discover and deploy the appropriate business service interface for
integration with any system, application, or business partner.
The Oracle Integration Repository is shipped as part of the Oracle E-Business Suite. As
your instance is patched, the repository is automatically updated with content
appropriate for the precise revisions of interfaces in your environment.
xvii
1
Overview of Oracle Workflow
This chapter introduces you to the concept of a workflow process and to the major
features of Oracle Workflow.
This chapter covers the following topics:
• Overview of Oracle Workflow for Administrators
Routing Information
Business processes today involve getting many types of information to multiple people
according to rules that are constantly changing. With so much information available,
and in so many different forms, how do you get the right information to the right
people? Oracle Workflow lets you provide each person with all the information they
need to take action. Oracle Workflow can route supporting information to each decision
maker in a business process, including people both inside and outside your enterprise.
Integrating Systems
Oracle Workflow lets you set up subscriptions to business events which can launch
workflows or enable messages to be propagated from one system to another when
business events occur. You can communicate events among systems within your own
enterprise and with external systems as well. In this way, you can implement point-to-
point messaging integration or use Oracle Workflow as a messaging hub for more
complex system integration scenarios. You can model business processes that include
complex routing and processing rules to handle events powerfully and flexibly.
Electronic Notifications
Oracle Workflow lets you include users in your workflows to handle activities that
cannot be automated, such as approvals for requisitions or sales orders. The
Notification System sends notifications to and processes responses from users in a
workflow. Electronic notifications are routed to a role, which can be an individual user
or a group of users. Any user associated with that role can act on the notification.
Each notification includes a message that contains all the information a user needs to
Internet-Enabled Workflow
Any user with access to a standard Web browser can be included in a workflow. Web
users can access a Notification Web page to see their outstanding work items, then
navigate to additional pages to see more details or provide a response.
Workflow Processes
Oracle Workflow manages business processes according to rules that you define. The
rules, which we call a workflow process definition, include the activities that occur in
the process and the relationship between those activities. An activity in a process
definition can be an automated function defined by a PL/SQL stored procedure or an
external function, a notification to a user or role that may optionally request a response,
a business event, or a subflow that itself is made up of a more granular set of activities.
A workflow process is initiated when an application calls a set of Oracle Workflow
Engine APIs. The Workflow Engine takes over by driving the relevant work item
defined by the application, through a specific workflow process definition. According
to the workflow process definition, the Workflow Engine performs automated steps
and invokes appropriate agents when external processing is required.
The following diagram depicts a simplified workflow process definition that routes a
We refer to the whole drawing as a process or process diagram. The icons represent
activities, and the arrows represent the transitions between the activities. In the above
example, new items are created for the process when a user creates and submits a
requisition in the appropriate application.
This process contains several workflow activities implemented as PL/SQL stored
procedures, including:
• Select Approver - To select, according to your business rules, who should approve
the requisition.
• Verify Authority - To verify that a selected approver has the spending authority to
approve the requisition.
This chapter describes the requirements for Oracle Workflow and the steps necessary
to set up Oracle Workflow at your site.
This chapter covers the following topics:
• Overview of Setting Up
• Step 1: Setting Up Workflow RAC Affinity
• Step 2: Partitioning Workflow Tables
• Step 3: Setting Global User Preferences
• Step 4: Setting Up an Oracle Workflow Directory Service
• Step 5: Setting Up Additional Languages
• Step 6: Setting Up Background Workflow Engines
• Step 7: Implementing Notification Mailers
• Step 8: Modifying Your Message Templates
• Step 9: Configuring Character Encoding for Notification Mailers
• Step 10: Adding Worklist Functions to User Responsibilities
• Step 11: Setting the WF: Notification Reassign Mode Profile Option
• Step 12: Setting the WF: Disable Reassign to Submitter Profile Option
• Step 13: Setting the WF: Enable Bulk Notification Response Profile Option
• Step 14: Enabling the Notification Details Pop-up Window
• Step 15: Displaying the Number of Open Notifications in the Oracle E-Business
Suite Home Page
• Step 16: Controlling the Display of the Global Worklist Button
• Step 17: Setting Up Notification Handling Options
• Step 18: Configuring the Oracle Workflow User List of Values
Overview of Setting Up
After you install Oracle Workflow, implement it for your site by setting up the
preferences and components appropriate for your enterprise.
Related Topics
Oracle Workflow Hardware and Software Requirements, page 2-2
Overview of Required Setup Steps for Oracle Workflow, page 2-4
Optional Setup Steps, page 2-4
Other Workflow Features, page 2-6
Identifying the Version of Your Oracle Workflow Server, page 2-6
Oracle Workflow Setup Checklist, page 2-7
Note: Oracle Net Services require and only support the use of
Microsoft's TCP/IP drivers.
• To send and receive email notifications, you must have an SMTP mail server set up
for outbound messages and an IMAP4 compliant mail server set up for inbound
messages.
If you want to connect through Transport Layer Security (TLS) or Secure Sockets
Layer (SSL) and your SMTP server does not support TLS or SSL natively, then you
must have Stunnel installed on the SMTP server.
• To send and respond to email notifications with HTML attachments, your email
application should support HTML attachments and you should have a Web
browser application that supports JavaScript and Frames to view the attachment.
• To view Workflow Web pages, users need a Web browser application supported for
Oracle E-Business Suite. See: R12: Recommended Browsers for Oracle E-Business Suite,
My Oracle Support Knowledge Document 389422.1.
• If your Oracle E-Business Suite instance uses Java Web Start to launch Java
applications, including the Status Monitor and the digital signature applet in Oracle
Workflow, instead of using the Java Plug-in, then you may need to perform
configuration steps specific to your browser. See: My Oracle Support Knowledge
Document 2188898.1, Using Java Web Start with Oracle E-Business Suite.
• To use the Workflow XML Loader, you must have Java Development Kit (JDK)
installed in a version supported by Oracle E-Business Suite. See: Overview of Using
Java with Oracle E-Business Suite Release 12, My Oracle Support Knowledge
Document 418664.1.
3. Set up background Workflow Engines to control the load and throughput of the
primary Workflow Engine on your system. You can specify the cost threshold level
of your primary and background engines to determine the activities an engine
processes and the activities an engine defers. See: Setting Up Background Workflow
Engines, page 2-46.
4. Set up the Business Event System to communicate business events between systems
using event subscription processing and Workflow process event activities. See:
Setting Up the Business Event System, page 2-186.
2. If you do not use workflow RAC affinity, you can still choose to partition some
workflow runtime tables for performance gain. See: Partitioning Workflow Tables,
page 2-14.
3. Set up additional languages if you want to use Oracle Workflow in languages other
4. Set up one or more notification mailers if you want to allow your users to receive
notifications by email. See: Implementing Notification Mailers, page 2-55.
5. You can modify the templates for your email notifications. See: Modifying Your
Message Templates, page 2-106.
6. You can configure the character encoding that notification mailers use to send email
notifications. See: Configuring Character Encoding for Notification Mailers, page 2-
160.
7. You can give users access to the Advanced Worklist, Personal Worklist, Notification
Search, and Workflow Mailer URL Access Tester pages from any responsibility you
choose. See: Adding Worklist Functions to User Responsibilities, page 2-162.
8. You can control which reassign modes are available to users from the Notification
Details page. See: Setting the WF: Notification Reassign Mode Profile Option, page
2-165.
9. You can control whether a notification recipient can reassign the notification to the
process owner who initiated the workflow or the from role for the notification. See:
Setting the WF: Disable Reassign to Submitter Profile Option, page 2-166.
10. You can specify whether users can respond to a group of notifications collectively
from the Worklist and Notification Search pages, without navigating to the
Notification Details page for each notification individually. See: Setting the WF:
Enable Bulk Notification Response Profile Option, page 2-167.
11. You can enable the Notification Details pop-up window in the Worklist and specify
the size of the pop-up window. See: Enabling the Notification Details Pop-up
Window, page 2-168.
12. You can display a tip message in the Oracle E-Business Suite home page that
informs the user how many open notifications are in his or her worklist. See:
Displaying the Number of Open Notifications in the Oracle E-Business Suite Home
Page, page 2-169.
13. You can control the display of the global Worklist button in the header of Oracle
Application Framework-based pages. See: Controlling the Display of the Global
Worklist Button, page 2-170.
14. You can control the item types for which users can define vacation rules and grant
proxy user worklist access, using the WF: Vacation Rule Item Types lookup type
and the WF: Vacation Rules - Allow All profile option. See: Setting Up Notification
Handling Options, page 2-170.
16. You can set up users to enable electronic signatures in notification responses. See:
Setting Up for Electronic Signatures, page 2-181.
17. You can customize the company logo that appears in the Oracle Workflow Web
pages. See: Customizing the Logo on Oracle Workflow's Web Pages, page 2-185.
18. You can include additional icons to your Oracle Workflow Icons subdirectory to
customize the diagrammatic representation of your workflow processes. Use
custom symbols for each activity you define. See: Adding Custom Icons to Oracle
Workflow, page 2-186.
Setup Checklist
Table Indexes
WF_ITEM_ACTIVITY_STATUSES WF_ITEM_ACTIVITY_STATUSES_PK,
WF_ITEM_ACTIVITY_STATUSES_N1, and
WF_ITEM_ACTIVITY_STATUSES_N2
WF_ITEM_ATTRIBUTE_VALUES WF_ITEM_ATTRIBUTE_VALUES_PK
Before running the partitioning script, you should back up these four tables so that you
can restore them in case the script fails.
To run the script, you must have sufficient free space on the table and index
tablespaces. During the creation of the partitioned tables, the script requires slightly
more diskspace than the underlying tables, in the same tablespace where the
underlying tables are located. Similarly, sufficient free space is required for the index
tablespace.
Additionally, you should allow sufficient time for the script to run. The amount of time
needed depends on the amount of data in the tables. When the tables already contain
Replace <apps_user> with the user name for the APPS user. The user name is usually
apps. Replace <transaction_table_tablespace> with the name of the tablespace
used for transaction tables in your Oracle E-Business Suite database. Replace
<index_tablespace> with the tablespace used for indexes. Then enter the password
for the APPS user at the prompt.
For example:
sqlplus apps @wfracprt APPS_TS_TX_DATA APPS_TS_TX_IDX
Enter password: <password>
After the script finishes, restart the application tier services. However, do not restart
your background engines until you have completed the other setup steps for workflow
RAC affinity.
The first time that you run the script, it creates a number of partitions equal to the
number of active RAC instances in your environment, as indicated by the number of
records in the gv$instance view. When the script completes successfully, the
Workflow Background Process for RAC concurrent program becomes available for use.
If you add another RAC instance to your environment after you set up workflow RAC
affinity, then run the wfracprt.sql script again to add a partition for the new RAC
instance within the Oracle Workflow tables.
Note: The script adds new partitions as needed but does not remove
existing partitions.
Replace <apps_user> with the user name for the APPS user. The user name is usually
apps. Then enter the password for the APPS user at the prompt.
For example:
sqlplus apps @wfracvpd
Enter password: <password>
• The workflow must not contain any event activities that are loosely coupled,
meaning a response to the event or event subscription processing will later progress
or modify the workflow. Consequently, any workflow that contains a Receive event
activity is ineligible for RAC affinity. A workflow that contains a Raise event
activity or a Send event activity is eligible only if the workflow will not be affected
by any subsequent response to the event or event subscription action. Review such
events carefully to ensure that the workflow can be properly handled by RAC
affinity.
To enable RAC affinity for a workflow process, first define a lookup code
corresponding to that workflow process in the "Item types using RAC affinity" lookup
type. Then run the script called wfeitrac.sql to consolidate the records for any
existing active instances of that workflow process into a single partition within each of
the Oracle Workflow runtime tables.
1. Navigate to the Lookup Types page in the Functional Administrator responsibility.
2. Search for the "Item types using RAC affinity" lookup type with the code
WF_RAC_ENABLED_TYPES in the Application Object Library application.
3. Define a new lookup code for this lookup type that corresponds to your workflow
process. Specify the lookup code in the following format:
where <ITEM_TYPE> is the internal name of the item type to which the workflow
process belongs, followed by a colon, and <PROCESS_NAME> is the internal name of
the process. For example, if you choose to enable RAC affinity for the
STANDARD_LINE process within the OEOL item type, define the lookup code as
follows:
OEOL:STANDARD_LINE
Ensure that you enter the internal names of the item type and process in the Code
field exactly as the names are defined in your database. See: Application Utilities
Lookups and Application Object Library Lookups, Oracle E-Business Suite
Developer's Guide.
4. Run the wfeitrac.sql script to consolidate the records for any existing active
instances of your workflow process into a single partition within each of the Oracle
Workflow runtime tables.
You should allow sufficient time for the script to run. The amount of time needed
depends on the amount of data in the tables. To minimize the time required,
perform a purge of obsolete workflow runtime data before you run the wfeitrac.
sql script. See: Purge Obsolete Workflow Runtime Data, page 9-3.
The wfeitrac.sql script is located in the $FND_TOP/patch/115/sql directory.
Use the script as follows:
sqlplus <apps_user> @wfeitrac <item_type> <proc_name> <part_no>
<proc_no>
Enter password: <password>
Replace <apps_user> with the user name for the APPS user. The user name is
usually apps. Replace <item_type> with the internal name of the item type to
which the workflow process belongs. Replace <proc_name> with the internal
name of the process. Replace <part_no> with the number for the partition in
which you want to consolidate the runtime data for this workflow process. Replace
<proc_no> with the number of parallel workers that you want to perform this
database operation. Then enter the password for the APPS user at the prompt.
Note: You can also disable RAC affinity for a previously RAC-enabled
workflow. To do so, remove the corresponding lookup code from the
WF_RAC_ENABLED_TYPES lookup type.
The script partitions four Workflow tables and recreates the associated indexes. The
tables are partitioned by item type and hash subpartitioned by item key. The following
table shows the Workflow tables and indexes on which the script runs.
Table Indexes
WF_ITEM_ACTIVITY_STATUSES WF_ITEM_ACTIVITY_STATUSES_PK,
WF_ITEM_ACTIVITY_STATUSES_N1, and
WF_ITEM_ACTIVITY_STATUSES_N2
WF_ITEM_ATTRIBUTE_VALUES WF_ITEM_ATTRIBUTE_VALUES_PK
Before running the partitioning script, you should back up these four tables so that you
can restore them in case the script fails.
To run the script, you must have sufficient free space on the table and index
tablespaces. During the creation of the partitioned tables, the script requires slightly
more diskspace than the underlying tables, in the same tablespace where the
underlying tables are located. Similarly, sufficient free space is required for the index
tablespace.
Additionally, you should allow sufficient time for the script to run. The amount of time
needed depends on the amount of data in the tables. When the tables already contain
existing data, such as after an upgrade from a previous release, the script requires more
time than it does when the tables are empty, such as after a fresh installation of Oracle
Workflow. To minimize the time required, run the script as early as possible in your
setup process.
Replace <apps_user> with the user name for the APPS user. The user name is usually
apps. Replace <fnd_user> and <fnd_password> with the user name and password
for the user that connects to Oracle Application Object Library data in Oracle E-
Business Suite. The user name is usually applsys. Replace <apps_user> and
<apps_password> with the user name and password for the APPS user. Replace
<utl_dir_location> with a directory that is a database directory defined for
PL/SQL file I/O. Then enter the password for the APPS user at the prompt.
For example:
sqlplus apps @wfpart applsys <fnd_password> apps <apps_password>
/usr/tmp
Enter password: <apps_password>
The script writes a new script, also named wfpart.sql, to the specified directory. You
can optionally edit this second wfpart.sql script to customize it. Then run this script
to perform the partitioning. Logging is turned on for this script by default. If your
database setup permits, you can optionally turn off logging to increase the performance
of the script.
Related Topics
Partitioning for Performance, page C-7
2. In the Workflow System Administrator field, select the role to which you want to
After installing Oracle Workflow, you should change the Workflow System
Administrator preference from the default setting to the role that you want to have
administrator privileges. The default setting after installation is SYSADMIN. You
must log in as the SYSADMIN user to access the Workflow Configuration page and
specify the preferences you want.
Note: The SYSADMIN role is different than the role associated with
the System Administrator responsibility in Oracle E-Business Suite.
If you want to assign workflow administrator privileges to this or
any other Oracle E-Business Suite responsibility, you must set the
Workflow System Administrator preference to the internal name of
the workflow role associated with that responsibility.
You can query the WF_ROLES view to find the role name for a
responsibility. For example, to find the role names for various
administrator responsibilities in Oracle E-Business Suite, use the
following command:
select name, display_name
from wf_roles
where display_name like '%Admin%';
3. If you are integrating with Oracle Directory Services, specify the Lightweight
Directory Access Protocol (LDAP) server information for the LDAP directory to
which you will connect. If you already configured these parameters while installing
your Web server with Oracle E-Business Suite, Oracle Workflow displays those
values here. See: Overview of Single Sign-On Integration, Oracle E-Business Suite
Security Guide.
• Username - The LDAP user account used to connect to the LDAP server. This
user name must have write privileges and is required to bind to the LDAP
directory. For example:
cn=orcladmin
• Old Password - Enter your current LDAP password. Oracle Workflow validates
this password before letting you change it.
• New Password - Enter the new LDAP password you want to use. The
password must be at least five characters long.
• Repeat Password - Enter your new LDAP password again in this field to
confirm it. You must enter exactly the same value that you entered in the New
LDAP Password field.
• Change Log Base Directory - The LDAP node under which change logs are
located. For example:
cn=changelog
• User Base Directory - The LDAP node under which user records can be found.
For example:
cn=Users,dc=oracle,dc=com
4. Specify details about the local system that identifies this installation of Oracle
Workflow in the Business Event System. See: Systems, Oracle Workflow Developer's
Guide.
• System Name - The system name for the database where this installation of
Oracle Workflow is located. Oracle Workflow automatically creates the system
definition for this database in the Event Manager during installation.
• Local Only - Subscriptions are executed only on events raised on the local
system.
• Plain text mail with attachments - Send notifications as plain text email
with the following attachments:
• An HTML-formatted version of the message
• Plain text mail with no attachments - Send notifications as plain text email
without any attachments. If the notification message has 'Content-Attached'
message attributes or Oracle E-Business Suite attachments specified in the
#ATTACHMENTS attribute, then the user must access the notification in the
Notification Details page to view those attachments.
• Plain text summary mail - Send a summary of all notifications as plain text
email. Users must use the Worklist Web pages to view and take action on
individual notifications.
• Do not send me mail - Do not send notifications as email. Users must use
the Worklist Web pages to view and take action on their notifications.
• Browser Signing DLL Location - The location of the Capicom.dll file that is
used for Web page operations with encryption in the Microsoft Internet
Explorer browser. This preference is required only if you plan to use certificate-
based digital signatures to confirm notification responses, and your users access
Oracle E-Business Suite with Microsoft Internet Explorer.
By default, this preference is set to a URL at which the Capicom.dll file can
be downloaded from Microsoft's Web site. In most cases, you do not need to
change this setting. However, you can update this preference if the location of
the Capicom.dll file changes, or if you choose to store a copy of the file on
your local network and point to that location instead.
For more information about setting up for certificate-based signatures, see:
Loading Certificates for Digital Signatures, page 2-181.
6. In the Workflow Status Monitor Diagram Size field, select the display size for the
status diagram within the Administrator Monitor and the Self-Service Monitor. The
sizes you can select are Small, Medium, or Large. The default size is Small. See:
Viewing a Status Diagram (Administrator Monitor), page 5-10 and Viewing a
7. Specify whether you want to defer notification response processing for any item
types when users respond through the Worklist Web pages. By default, Oracle
Workflow processes a notification response entered in the Worklist pages as soon as
the response is submitted, and then continues processing the subsequent activities
in the workflow until another blocking activity is reached. Only then does the page
return control to the user. Alternatively, you can choose to defer the processing of
notification responses and subsequent activities, and instead return control to the
user immediately. For example, you can defer notification response processing for
item types that include costly activities or large numbers of activities following a
notification, to avoid forcing users to wait while the Workflow Engine processes
those activities.
In the Defer Notification Response Processing for Item Types field, select None if
you do not want to defer response processing for any item types, All if you want to
defer response processing for all item types, or Specific if you want to defer
response processing only for particular item types. The default value is None.
If you select Specific, the page displays a list of the workflow item types you
specify. Choose Add Item Type to add a row to the list, and then select an item type
in the Workflow Type field. Repeat these steps to continue adding item types as
needed. To delete an item type from the list, choose the delete icon for that item
type.
If you choose to defer notification response processing for any item types, then
when a user responds to a notification from one of those types through the Worklist
pages, Oracle Workflow saves and validates the response information, but does not
complete the notification activity. Instead, it places the response on the standard
WF_NOTIFICATION_IN agent as an event called oracle.apps.wf.
notification.wl.response.message.
8. Optionally configure the item types and messages for which you want Oracle
Workflow to send email notifications, using the Email Notification Preference field.
• To enable emails for all messages in all item types, select Enable All. The
Email Notification Preference field is set to this value by default.
• If you want to enable emails for all item types and messages except those you
specify, select Disable Specific. In the Select Item Types table, click the
Add Another Row icon and select an item type. Then click the icon in the
Details column for that item type to display the list of messages within that
item type. In the Select Workflow Messages table, select the checkbox for each
message for which you want to disable emails. To select all the messages that
are currently displayed, select the checkbox in the header row of the table.
To add another item type, click the Add Another Row icon again. To remove an
item type, click the icon in the Delete column for that item type.
• If you want to disable emails for all item types and messages except those you
specify, select Enable Specific. In the Select Item Types table, click the Add
Another Row icon and select an item type. Then click the icon in the Details
column for that item type to display the list of messages within that item type.
In the Select Workflow Messages table, select the checkbox for each message for
which you want to enable emails. To select all the messages that are currently
displayed, select the checkbox in the header row of the table.
To add another item type, click the Add Another Row icon again. To remove an
item type, click the icon in the Delete column for that item type.
Note: The global notification style preference and the DLL location
preference are saved to the Oracle Workflow preferences table for a
special user name called -WF_DEFAULT-. The email notification
preference, as well as any item types and messages selected for the
email notification preference, are saved to the Oracle Workflow entity
preferences table for a special user name called -WF_DEFAULT-. The
remaining information is saved to the Oracle Workflow resources table.
Oracle Workflow also provides tables to support extended directory service features.
• WF_LOCAL_ROLES_TL stores translated display name and description values for
multiple language support (MLS) in the WF_USERS and WF_ROLES views.
The Workflow local tables store denormalized user and role information originating
from various other Oracle E-Business Suite modules, so that the directory service views
can access this information with good performance. You can also use these tables to
store ad hoc users and roles by calling the appropriate Workflow directory service
PL/SQL APIs.
• WF_USER_ROLE_ASSIGNMENTS_V is based on
WF_USER_ROLE_ASSIGNMENTS.
Note: You can customize your directory service by creating your own
custom view definitions, provided that you define the required
columns and map to the Workflow local tables. However, note that
only the predefined directory service views provided by Oracle
Workflow are supported by Oracle. See: Oracle Workflow Support
Policy, Oracle Workflow Developer's Guide.
The only roles in WF_LOCAL_ROLES that are marked as individual users with the user
flag set to Y are roles that represent Oracle E-Business Suite users, originating from the
FND_USER table, roles that represent Oracle Trading Community Architecture (TCA)
person parties, roles that represent TCA contacts (relationship parties), or roles that
• FND_USR - FND users, which may or may not be linked to Oracle Human
Resources people
• PER_ROLE - HR people
• POS - HR positions
• HTB_SEC - Healthcare
Role Hierarchies
Roles can be related to each other in a hierarchy so that users assigned to one role
automatically inherit membership in its superior roles as well. Role hierarchies enable
role-based access control in Oracle E-Business Suite.
For example, a company could define a role hierarchy with three roles: sales manager,
sales representative, and employee. A user with the sales manager role automatically
inherits the sales representative role, and a user with the sales representative role
automatically inherits the employee role. If user A is assigned directly to the sales
representative role, then user A will also have an inherited assignment to the employee
role. If user B is assigned directly to the sales manager role, user B will also have
inherited assignments to both the sales representative role and the employee role.
The role to which a user is directly assigned is the assigning role for that assignment
and for all other assignments that the user inherits through that role's hierarchy. For
instance, in the previous example, for user A the sales representative role is the
assigning role for both the sales representative assignment and the employee
assignment. For user B, the sales manager role is the assigning role for the sales
manager assignment, the sales representative role assignment, and the employee role
assignment.
Oracle Workflow stores hierarchical relationships between roles in the
WF_ROLE_HIERARCHIES table. Oracle Workflow also stores denormalized
information about direct and inherited assignments of users to roles in the
WF_USER_ROLE_ASSIGNMENTS table for performance gain. If a user is associated
• For an inherited role, the assigning role is the directly assigned role through
which this role is inherited.
• The assignment
The user, the assigned role, and the assigning role must all be active, that is, unexpired,
in order for the assignment to be valid. The assignment does not become valid until all
three are active, and if any of the three expires, the assignment is no longer valid.
Additionally, the assignment is only valid as of the date it was created.
• User name - To validate user/role associations only for a particular user, specify the
user name. Leave this parameter blank to perform validation for all users.
• Role name - To validate user/role associations only for a particular role, specify the
Note: If you specify both a user name and a role name, the program
validates only user/role associations linking that user with that role.
To validate all user/role associations, leave both parameters blank.
• Fix dangling users - Select Yes to check that all users and roles referenced by
user/role associations exist in the WF_LOCAL_ROLES table. If the user or role or
both are missing for any user/role association, the program removes that user/role
association from the WF_LOCAL_USER_ROLES table. Select No to skip this check.
The default value is No.
• Add missing user/role assignments - Select Yes to check that all user/role
associations in the WF_LOCAL_USER_ROLES table have corresponding user/role
assignments in the WF_USER_ROLE_ASSIGNMENTS table and add any missing
direct assignments. Select No to skip this check. The default value is No.
• Update Who columns in WF tables - Select No to preserve the existing values in the
LAST_UPDATED_BY and LAST_UPDATE_DATE standard Who columns when the
program updates corrupt records in the Workflow directory service tables. Select
Yes if you want the program to update the standard Who columns. The
recommended value, which is also the default value, is No.
• Number of Parallel Processes - Specify the number of parallel processes to use when
running the program. By default, the number of processes to use is the lower of the
database parameters parallel_max_servers and cpu_count. You can
optionally specify a lower number of processes to avoid temporary space issues.
See: Running Reports and Programs, Oracle E-Business Suite User's Guide.
You can also create your own directory service by defining custom views with the
required columns. However, note that only the predefined directory services provided
by Oracle Workflow are supported by Oracle. See: Oracle Workflow Support Policy,
Oracle Workflow Developer's Guide.
If you create your own custom view definitions:
• Each individual user identified by WF_USERS must also appear in the WF_ROLES
view as a role.
• You should set the user flag in the underlying tables to Y for all the roles that also
represent individual users, and set the user flag to N for all other roles.
• You should avoid selecting from DUAL to incorporate additional users and roles
into the directory service views as this allows you to violate the unique constraint
on certain columns of the views and reduces performance with unnecessary joins
between the 'select from DUAL' statements.
• To take advantage of unique indexes when querying users, make sure you initially
enter the usernames in your database in uppercase only. Forcing the usernames to
uppercase in your view definition results in poor performance when accessing these
views.
• You should run the script wfdirchk.sql to validate your directory service data
model. This script is located in the $FND_TOP/sql directory. See: Wfdirchk.sql,
page 9-11.
WF_USERS
The WF_USERS view references information about the individuals in your organization
who may utilize Oracle Workflow functionality or receive workflow notifications.
Note: This view includes only Oracle E-Business Suite users originating
from the FND_USER table, TCA person parties, TCA contacts, and ad
hoc users, although an Oracle E-Business Suite user record may also
include information from Oracle Human Resources if the user is linked
to an Oracle Human Resources person.
• Display_Name - The display name of the user. An example of a display name can
be 'Beech, Matthew'.
Note: For roles that are Oracle E-Business Suite users marked with
an originating system of FND_USR or PER, Oracle Workflow uses
the GetRoleInfo() procedure to find the language for a user, rather
than querying this column in the directory service views.
GetRoleInfo() by default retrieves the language value from the ICX:
Note: For roles that are Oracle E-Business Suite users marked with
an originating system of FND_USR or PER, Oracle Workflow uses
the GetRoleInfo() procedure to find the territory for a user, rather
than querying this column in the directory service views.
GetRoleInfo() by default retrieves the territory value from the ICX:
Territory profile option for that Oracle E-Business Suite user.
However, if the WF_PREFERENCE resource token is defined and set
to FND, then the GetRoleInfo() procedure obtains the territory value
from the Oracle Workflow preferences table instead.
• Email_Address - A valid electronic mail address for this user or a mail distribution
list defined by your electronic mail system. You can enter more than one email
address for a user; in this case Oracle Workflow sends email notifications for the
user to all addresses stored in this column. Enter the email addresses separated by
commas. Do not include spaces between the addresses. The maximum length for
the combined list of email addresses in this column is 320 characters.
• Orig_System - A code that you assign to originating system, which is the directory
repository that this view is ultimately based on. For example, if this view is based
on the personnel data stored in a Human Resource Management System,
Orig_System can be defined as PER.
• Orig_System_ID - The primary key that identifies the user in this repository system.
For example, Orig_System_ID can be defined as the value stored in a column called
PERSON_ID in a Human Resources database table called PER_PEOPLE.
• Parent_Orig_System_ID - The primary key that identifies the parent entity in the
parent originating system.
• Start_Date - The date at which the user becomes valid in the directory service.
• Expiration_Date - The date at which the user is no longer valid in the directory
service. After this date, the user will no longer appear in the seeded WF_USERS
view.
WF_ROLES
The WF_ROLES view references information about all the roles in your organization
who may utilize Oracle Workflow functionality or receive workflow notifications. This
view must contain the following required columns pertaining to the roles in your
repository. Those columns that are preceded by an asterisk (*) are similar to the
corresponding columns described for the WF_USERS view.
• Name - The internal name of the role as referenced by the Workflow Engine and
Notification System.
• *Display_Name
• *Description
• *Notification_Preference
• *Language
• *Territory
• Email_Address - If the email address is null for a given role, notification mailers
send an individual email to each user within the role.
• *Fax
• *Orig_System
• *Orig_System_ID
• *Parent_Orig_System
• *Parent_Orig_System_ID
• *Start_Date
• *Status
• Expiration_Date - The date at which the role is no longer valid in the directory
service. After this date, the role will no longer appear in the seeded WF_ROLES
view.
• *Owner_Tag
Note: A role can contain only individual users as its members. It cannot
contain another role. However, roles can be related to each other in a
hierarchy so that users assigned to one role automatically inherit
membership in its superior roles as well.
• Role_Name - The internal name of the role as listed in the view WF_ROLES.
• User_Orig_System - A code that you assign to the user directory repository as listed
in the view WF_USERS.
• User_Orig_System_ID - The primary key that identifies the user in the user
directory repository as listed in the view WF_USERS.
• Role_Orig_System - A code that you assign to the role directory repository as listed
in the view WF_ROLES.
• Role_Orig_System_ID - The primary key that identifies the role in the role directory
repository as listed in the view WF_ROLES.
• Start_Date - The date at which the association of this user with this role becomes
valid in the directory service.
• Expiration_Date - The date at which the association of this user with this role is no
longer valid in the directory service. After this date, the user and role association
will no longer appear in the seeded WF_USER_ROLES view.
• B - The user has both direct and inherited assignments to this role.
• Parent_Orig_System_ID - The primary key that identifies the parent entity in the
WF_USER_ROLE_ASSIGNMENTS_V
The WF_USER_ROLE_ASSIGNMENTS_V view is an intersection of the users and roles
in WF_USERS and WF_ROLES, that tracks how assignments of users to roles are made
directly or inherited through role hierarchy relationships. The view shows only
currently active assignments.
The WF_USER_ROLE_ASSIGNMENTS_V view contains the following columns:
• User_Name - The internal name of the user as listed in the view WF_USERS.
• Role_Name - The internal name of the role as listed in the view WF_ROLES.
• Assigning_Role - The role from which the user is inheriting assignment to this role.
• Start_Date - The date at which the assignment of this user to this role becomes valid
in the directory service.
• End_Date - The date at which the assignment of this user to this role is no longer
valid in the directory service.
• Assignment_Type - The way in which the user was assigned to membership in this
role, either DIRECT or INHERITED.
WF_ALL_ROLES_VL
The WF_ALL_ROLES_VL view contains role information similar to the WF_ROLES
view. However, WF_ALL_ROLES_VL includes all roles, whether not yet valid,
currently valid, or expired.
The WF_ALL_ROLES_VL view contains the following columns:
• Name - The internal name of the role.
• Orig_System - A code that you assign to originating system on which this view is
ultimately based.
• Orig_System_ID - The primary key that identifies the role in the originating system.
• Start_Date - The date at which the role becomes valid in the directory service.
• Expiration_Date - The date at which the role is no longer valid in the directory
service.
WF_ALL_USER_ROLES
The WF_ALL_USER_ROLES view contains user/role association information similar to
the WF_USER_ROLES view. However, WF_ALL_USER_ROLES includes all user/role
associations, whether not yet valid, currently valid, or expired.
The WF_ALL_USER_ROLES view contains the following columns:
• User_Name - The internal name of the user.
• User_Orig_System_ID - The primary key that identifies the user in the user
originating system.
• Role_Orig_System_ID - The primary key that identifies the role in the role
originating system.
• Parent_Orig_System_ID - The primary key that identifies the parent entity in the
parent originating system.
• B - The user has both direct and inherited assignments to this role.
• Start_Date - The date at which the association of this user with this role becomes
valid in the directory service.
• Expiration_Date - The date at which the association of this user with this role is no
longer valid in the directory service.
WF_ALL_USER_ROLE_ASSIGNMENTS
The WF_ALL_USER_ROLE_ASSIGNMENTS view contains information about how
assignments of users to roles are made directly or inherited through role hierarchy
relationships, similar to the WF_USER_ROLE_ASSIGNMENTS_V view. However,
WF_ALL_USER_ROLE_ASSIGNMENTS includes all user/role assignments, whether
not yet valid, currently valid, or expired.
The WF_ALL_USER_ROLE_ASSIGNMENTS view contains the following columns:
• Assigning_Role - The role from which the user is inheriting assignment to this role.
• Start_Date - The date at which the assignment of this user to this role becomes valid
in the directory service.
• End_Date - The date at which the assignment of this user to this role is no longer
valid in the directory service.
• Assignment_Type - The way in which the user was assigned to membership in this
role, either DIRECT or INHERITED.
WF_LANGUAGES View:
To support additional languages, Oracle Workflow uses a view called
WF_LANGUAGES that identifies the languages defined in your Oracle installation.
This view is automatically created during installation. Oracle Workflow uses the
WF_LANGUAGES view to create, in its translatable tables, a row for each language that
• Installed_Flag - Flag to indicate if the language is installed and available for use.
For more information about setting NLS_LANG, see: Globalization Support, Oracle
Database Installation Guide.
Note: Although you can enter and view property values for your
2. Ensure that the language you want is set up in the database. You select and install
additional languages as part of the Oracle E-Business Suite installation. See:
Selecting NLS Settings, Oracle E-Business Suite Installation Guide.
3. Load the translated workflow definition to your workflow database using either the
Workflow Definitions Loader or the Workflow Builder.
• Before running the Workflow Definitions Loader program, you must set the
NLS_LANG environment variable to the appropriate territory and character set
for the workflow definition you want to load. The character set must match the
character set encoding used to create the workflow definition file, which is
determined by the NLS_LANG value that was set on the client PC before the .
wft file was created in the Workflow Builder. For example, if the .wft file was
created in the Japanese native character set encoding JA16SJIS, then you must
specify JA16SJIS in the character set portion of NLS_LANG before loading the
file, and you cannot specify a different character set such as UTF8.
To set NLS_LANG before running the Workflow Definitions Loader, use the
following format:
_TERRITORY.CHARSET
Note that it is important to include the underscore (_) before the territory name
and the period (.) between the territory name and the character set name in the
NLS_LANG value. For example, if the .wft file was created in the Japanese
native character set encoding JA16SJIS, set NLS_LANG to the following
value:
_JAPAN.JA16SJIS.
You do not need to include the language in this NLS_LANG value because the
Workflow Definitions Loader uses the language specified within the .wft file
to determine the language to load. See: Using the Workflow Definitions Loader,
page 8-8.
2. If the email templates are available for the desired language, Oracle Workflow uses
the language preference for the notification recipient to determine the language for
an email notification.
Oracle E-Business Suite users can set their language preference in the Preferences
page. This preference is also stored in the ICX: Language profile option. See: Set
Preferences, Oracle E-Business Suite User's Guide.
• A process with only one thread loops back, but the pivot activity of the loop has the
On Revisit property set to Ignore.
• An activity returns a result for which no eligible transition exists. For instance, if the
function for a function activity returns an unexpected result value, and no default
transition is modeled after that activity, the process cannot continue.
The background engine sets the status of a stuck process to ERROR:#STUCK and
executes the error process defined for it.
The following table lists the standard queues used in background engine processing.
• Run a background engine to handle only timed out activities every 1 to 24 hours as
needed.
• Run a background engine to handle only stuck processes once a week to once a
month, when the load on the system is low.
If you implement workflow RAC affinity, then you should also run background engines
using the Workflow Background Process for RAC concurrent program. This program
runs background engines that each process only the RAC-enabled workflows that were
launched in a specific RAC instance. Running background engines with RAC affinity
provides faster access to the workflow runtime data and helps avoid contention. See:
Setting Up Workflow RAC Affinity, page 2-9.
You should run the Workflow Background Process for RAC program for deferred
activities, timed out activities, and stuck processes as needed depending on the
requirements of your RAC-enabled workflows. If the RAC-enabled workflows run on a
particular schedule, then you should run the Workflow Background Process for RAC
Note: You cannot submit the Workflow Background Process for RAC
concurrent program through Oracle Workflow Manager. You must
submit this program through the standard request submission UI.
Minimum Threshold Specify the minimum cost that an activity must have
for this background engine to execute it, in hundredths
of a second.
Maximum Threshold Specify the maximum cost that an activity can have for
this background engine to execute it, in hundredths of
a second.
By using Minimum Threshold and Maximum
Threshold you can create multiple background engines
to handle very specific types of activities. The default
values for these arguments are null so that the
background engine runs activities regardless of cost.
Note: Ensure that you have a least one background engine that can
check for timed out activities, one that can process deferred
activities, and one that can handle stuck processes.
5. When you finish modifying the run options to define the schedule for the
background engine, choose Submit to submit the request.
Minimum Threshold Specify the minimum cost that an activity must have
Maximum Threshold Specify the maximum cost that an activity can have for
this background engine to execute it, in hundredths of
a second.
By using Minimum Threshold and Maximum
Threshold you can create multiple background engines
to handle very specific types of activities. The default
values for these arguments are null so that the
background engine runs activities regardless of cost.
Note: Ensure that you have a least one background engine for RAC
that can check for timed out activities, one that can process
deferred activities, and one that can handle stuck processes.
5. When you finish modifying the run options to define the schedule for the
background engine, choose Submit to submit the request.
Related Topics
Activity Cost, Oracle Workflow Developer's Guide
Timeout Transitions, Oracle Workflow Developer's Guide
Deferring Activities, page C-6
Wait Activity, Oracle Workflow Developer's Guide
Background, Oracle Workflow API Reference
You can also optionally create additional notification mailer service components. For
example, you can create a notification mailer that processes only messages that belong
to a particular workflow item type, or only instances of a particular message from a
particular item type. You can create additional mailers that process the same types of
message to increase throughput.
You can also configure any notification mailer service component to process only
inbound messages, or only outbound messages. You associate inbound and outbound
mailers with each other by assigning them the same mailer node name. The mailer node
name indicates which inbound mailer can process incoming responses to outbound
messages sent by a particular outbound mailer.
You can optionally assign the same node name to multiple mailers for load balancing
purposes. However, each mailer that performs inbound processing for a node must
have its own inbox.
• If you enable both outbound and inbound processing for the same mailer, that
mailer will automatically use the same node name for both types of processing,
enabling it to process incoming responses to the outbound messages it sent. You
can optionally also create other notification mailers that share the same node name.
• If you create an outbound-only mailer, but you still want to perform response
processing for email responses to the outbound messages it sends, you should
create at least one other mailer with the same node name that does perform
inbound message processing. Otherwise, there will be no inbound mailer that can
process incoming responses to outbound messages sent by this outbound mailer.
• Create an inbound-only mailer only if you have also created at least one mailer with
the same node name that performs outbound message processing. If no outbound
Note: The node name for each node must be unique. However,
multiple mailers can share the same node. The maximum length for a
node name is eight characters, and the node name cannot include any
spaces or any of the following characters: left bracket ([), right bracket (
]), slash (/), or at sign (@).
Use the Oracle Workflow Manager component of Oracle Applications Manager (OAM)
to configure and run notification mailers. For more information, see: Notification
Mailers, page 7-20.
To set up a notification mailer, you must perform the following steps.
You can optionally configure the SMTP server to require authentication for server
2. Set up an IMAP4 compliant mail server with an email account for the notification
mailer if you want to receive inbound messages.
The notification mailer requires three folders in this email account: the inbox, a
folder to store processed messages, and a folder to store discarded messages.
If the email account does not already include folders named PROCESS and
DISCARD, Oracle Workflow automatically creates these two folders when you
complete the basic notification mailer configuration. You can optionally specify
other folders for the notification mailer using the advanced configuration wizard.
Note: Use your email client to create folders manually for the
notification mailer to use. A notification mailer may not be able to
access folders that were created using command line tools outside
the email client.
However, note that you must not use an email client to access the
notification mailer's email account while the notification mailer is
running. Use the email client only during setup.
3. You can enter the following configuration parameters for the seeded Workflow
• HTML agent name (defaults to the value you enter for the Applications Servlet
Agent parameter)
Note: When you enter the SMTP Server and IMAP Server
parameters, specify each server in the following format:
<server_name>[:<port_number>]
• For the IMAP Server parameter, specify the actual host name.
Do not use localhost as the setting for this parameter.
4. Ensure that the Business Event System status is set to Enabled in the global
workflow preferences, and that the JOB_QUEUE_PROCESSES database initialization
parameter, which is required for the Business Event System, is set to an appropriate
value. The Business Event System status is set to Enabled by default, and usually
you do not need to change this status. If notification processing is not being
5. (Recommended) You can optionally set the WF: Workflow Mailer Framework Web
Agent profile option to the host and port of the Web server that notification mailers
should use to generate the content for Oracle Application Framework regions that
are embedded in notifications. If this profile option is not set, notification mailers
will use the same Web agent specified in the Application Framework Agent profile
option. However, on a load-balanced Web server, notification mailers might not be
able to render Oracle Application Framework content within a notification. In this
case, set the WF: Workflow Mailer Framework Web Agent profile option to a
physical host, instead of a virtual host. The WF: Workflow Mailer Framework Web
Agent profile option should be set at site level. See: Overview of Setting User
Profiles, Oracle E-Business Suite Setup Guide.
• To specify the external web entry point that the notification mailer should use
to generate the links, set the FND Framework External Agent profile option.
See: Overview of Setting User Profiles, Oracle E-Business Suite Setup Guide.
7. (Optional) If you send email notifications to users who are external to your
enterprise and do not have access to your Oracle E-Business Suite instance at all,
8. Before a service component can run, the container which manages it must first be
started. The seeded Workflow Notification Mailer service component belongs to a
container named Workflow Mailer Service. The seeded agent listener service
components that are also required for notification mailer processing belong to a
container named Workflow Agent Listener Service . You should ensure
that these two containers are running, using Oracle Applications Manager. If you
create your own custom containers in OAM for custom service components, ensure
that those containers are running as well.
Note: You can run a diagnostic test to verify the GSM services for
Oracle Workflow. See: Oracle Workflow Diagnostic Tests, page E-
1.
10. Use the notification mailer configuration wizard to configure your notification
mailer service component.
11. (Optional) By default, the seeded Workflow Notification Mailer has a Launch
Summary Notifications event scheduled to send summary notifications once a day.
You can optionally use the notification mailer configuration wizard to modify the
start time and interval for this event's schedule, or to schedule the Launch
Summary Notifications event at the interval you choose for any notification mailer
service component. When this event is processed, a summary notification is sent to
each role with a notification preference of SUMMARY or SUMHTML, listing all the
notifications that are currently open for that role.
12. (Optional) You can optionally configure a notification mailer to connect to the
SMTP server and IMAP server through Transport Layer Security (TLS) or Secure
Sockets Layer (SSL) to encrypt the data exchanged. See: Connecting to Mail Servers
Through TLS or SSL, page 2-72.
13. (Optional) You can optionally set the internal mailer parameter named
HTML_DELIMITER to specify which characters the notification mailer uses to
delimit response values in response templates for HTML-formatted email
notifications. Valid values for the HTML_DELIMITER parameter are:
• DEFAULT - The notification mailer uses the default delimiters, currently set as
the single quote (') for both the opening and the closing delimiter. The
notification mailer also uses the default delimiters if the HTML_DELIMITER
parameter value is left null.
• APOS - The notification mailer uses the single quote, or apostrophe (') , as both
the opening and the closing delimiter. This setting is currently the same as the
default.
• QUOTE - The notification mailer uses the double quote (") as both the opening
and the closing delimiter.
• BRACKET - The notification mailer uses the left bracket ([) as the opening
delimiter and the right bracket (]) as the closing delimiter.
By default, the HTML_DELIMITER parameter is set to the value DEFAULT. Use the
afsvcpup.sql script to change the parameter value to specify the delimiters you
want to use. See: To Set Internal Mailer Parameters, page 2-65.
If a particular notification message has the special #WFM_HTML_DELIMITER
message attribute defined, however, the notification mailer will use the
#WFM_HTML_DELIMITER attribute value to determine which delimiters to use for
that notification, instead of using the HTML_DELIMITER parameter value.
14. (Optional) You can optionally set the internal mailer parameter named
SET_WFNTF_AUTO_GEN_HEADER if you want the notification mailer to include a
header in the emails it sends indicating that they are auto-generated. The header
appears as follows:
Auto-Submitted: auto-generated
Including this header can help enable message filtering and avoid automatic
responses being returned to the notification mailer.
By default, the SET_WFNTF_AUTO_GEN_HEADER parameter is set to the value N. If
you want to include the Auto-Submitted: auto-generated header in the
emails, use the afsvcpup.sql script to change the parameter value to Y. See: To
Set Internal Mailer Parameters, page 2-65.
15. (Optional) You can optionally set the internal mailer parameter named
OUTBOUND_THREAD_WAIT_TIMEOUT if you want to specify an outbound thread
wait timeout period for the notification mailer. This period is the maximum amount
16. (Optional) You can optionally configure Oracle Workflow for OAuth-2.0–based
inbound connections to the Microsoft Office 365 Exchange Online server, or OAuth-
2.0–based inbound and outbound connections to the Google Workspace Gmail
server. By default, notification mailers use a basic authentication scheme to
authenticate user credentials with mail servers through a user name and password.
In OAuth-2.0–based authentication, a notification mailer requests an access token
and sends that access token along with the user name to connect to Microsoft Office
365 Exchange Online or Google Workspace Gmail and process messages. For
detailed steps, see My Oracle Support Knowledge Document 2884072.1, Configuring
Oracle Workflow for OAuth 2.0 with Microsoft Office 365 Exchange Online in Oracle E-
Business Suite Release 12.2 and Release 12.1.3 or My Oracle Support Knowledge
Document 2966503.1, Configuring Oracle Workflow for OAuth 2.0 with Google
Workspace Gmail in Oracle E-Business Suite Release 12.2.
17. (Optional) You can optionally limit the size of Oracle Workflow email notifications,
including the email body and any attachments, using the "Workflow Mailer SMTP
server size limit" profile option. For example, if your mail server restricts the size of
emails that can be sent, you can use this profile option to ensure that Oracle
Workflow emails remain within the allowed size.
Out of the size limit you specify in this profile option, Oracle Workflow reserves
200 KB for the email body. If adding the attachments would cause the email to
exceed the specified size, then Oracle Workflow does not include those attachments
in the email, but instead displays a note in the email indicating that one or more
attachments could not be included. In this case, the user must access the notification
through the Worklist pages to view the attachments.
You can set the "Workflow Mailer SMTP server size limit" profile option in the
System Profile Values window. This profile option can be set at site level only. The
internal name for this profile option is WF_MAIL_SMTP_SIZE_LIMIT. See:
Overview of Setting User Profiles, Oracle E-Business Suite Setup Guide.
18. (Optional) The seeded Workflow Notification Mailer uses the Automatic startup
mode by default and will be started automatically when you complete its
configuration. If you select the Manual startup mode for a notification mailer
service component, use the Service Components page in Oracle Workflow Manager
to start that notification mailer. You can also use this page to manage any
2. At the prompts, enter the component ID for your notification mailer service
component, the parameter ID for the parameter to set, and the value to assign to
that parameter. You can find the IDs to enter in the lists displayed by the script,
which show first the service components defined in your installation of Oracle
Workflow and then the parameters defined for the specified service component.
You can also find the component ID for a notification mailer in the Define page of
the configuration wizard.
• Resolves the notification recipient role to one or more email addresses defined for
the role; an email address can itself be a mail list.
• Switches its database session to the recipient role's preferred language and territory
as defined in the directory service.
The email notifications are based on message templates defined in Oracle Workflow
Builder. Oracle Workflow provides a set of standard templates in the System: Mailer
item type, which are used by default. It is not recommended to modify the standard
templates. However, you can customize the message templates used to send your email
notifications by creating your own custom message templates in a custom item type
using the Workflow Builder. Then assign these templates to a particular notification in a
workflow process by defining special message attributes. In this case the templates
assigned to the notification override any other templates. See: Modifying Your Message
Templates, page 2-106 and Notification Mailer Message Template Attributes, Oracle
Workflow Developer's Guide.
You can also create your own custom message templates in the System: Mailer item
type using the Workflow Builder, and assign these templates to a particular notification
mailer service component in the mailer configuration parameters. The templates
assigned to a mailer override the default System: Mailer templates. However, if any
notifications have templates specifically assigned to them through message attributes,
the notification-level templates still override the templates assigned to the mailer. See:
Modifying Your Message Templates, page 2-106.
• Sets the mail status of the notification to FAILED if the email could not be delivered
to any email address defined for the recipient. This mail status indicates that an
exception prevented this email notification from being delivered but does not
prevent the mailer from processing other notifications.
• Adds the email address or addresses to its invalid email address list. To avoid
unnecessary processing, each notification mailer stores a list of email addresses to
which it could not deliver messages, and does not attempt to send any further
messages to those addresses. If all the addresses for a recipient are invalid, then for
any subsequent notifications to the listed addresses, the notification mailer simply
sets the mail status directly to FAILED. If at least one address for the recipient was
valid, then the notification mailer continues sending notifications to the valid
address or addresses, but does not attempt to send any further messages to the
invalid addresses.
• Changes the notification preference of the recipient to DISABLED, if all the email
addresses for the recipient are invalid. To further help avoid unnecessary
processing, if a recipient has a notification preference of DISABLED, Oracle
Workflow does not generate a complete XML representation of any notifications to
that recipient, and a notification mailer does not attempt to send email notifications
to that recipient. Instead, the notification mailer simply sets the mail status of the
notifications directly to FAILED. The change in notification preference also
indicates to the user that email notifications cannot be delivered. You or the user
must correct the issue that caused the failure and then reset the notification
preference in order for the user to receive email notifications.
If at least one email address for the recipient was valid, then the notification
preference of the recipient is not changed. In this case the notification mailer
continues sending notifications to the valid address or addresses, but does not
attempt to send any further messages to the invalid addresses.
• Sends a notification to the SYSADMIN user. If all the email addresses for a recipient
Note: When a notification does not have the Expand Roles option
checked, only one copy of the notification is sent to the recipient role as
a whole, even if the role includes multiple users. That is, the
notification is sent with the same notification ID to all users in the role.
If the notification mailer cannot deliver the email notification to one or
more of the users in the role, then in addition to the other actions in this
list, the notification mailer adds a record to the Oracle Workflow entity
preferences table for each user with an invalid email address, indicating
that sending this notification ID failed for that user. If you later retry
the notification, the notification is sent only to those users for whom it
previously failed.
If the email notification is successfully delivered to one of these users
when the notification is retried, then the notification mailer removes the
record of the send failure for that user, for that notification ID only,
from the Oracle Workflow entity preferences table. If email delivery
fails again for a particular user, then the record of the send failure is
retained in the table to allow the notification to be retried again later.
Individual users whose notification preference was set to DISABLED can reset their
notification preference manually using the Preferences page in Oracle E-Business Suite.
You can also run the Workflow Directory Services Bulk Reset DISABLED Notification
Preference concurrent program to reset the notification preference for multiple users at
once. See: Handling Mailer Errors, page 2-93.
After correcting the email issues and resetting DISABLED notification preferences, you
can run the Resend Failed/Error Workflow Notifications concurrent program to retry
open notifications that previously could not be sent. See: Handling Mailer Errors, page
2-93.
• Checks the inbox folder for messages. If a message exists, the notification mailer
reads the message, checking for the notification ID (NID) and node identifier in the
NID line.
• If the message is not a notification response, meaning it does not contain an
NID line, the notification mailer moves the message to the discard folder and
treats it as an unsolicited message. For the first unsolicited message from a
particular email address, the notification mailer also sends a warning message
back to the sender of the message.
However, to avoid sending unnecessary warnings due to bounced or auto-reply
messages, each mailer node stores a list of email addresses from which it has
received unsolicited mail, and does not send any further warning messages to
those addresses. Instead, if the node receives a second unsolicited message from
a particular address, the notification mailer discards the message and raises the
oracle.apps.wf.mailer.unsolicited event. You can optionally define a
subscription to this event if you want to perform some other action in response
to the second unsolicited message. For all subsequent unsolicited messages, the
notification mailer simply discards the message.
Note: You can optionally use the Send Warning for Unsolicited
Email mailer parameter to prevent notification mailers from
The notification mailer performs the following steps for messages that belong to its
node.
• Retrieves the notification ID.
• Checks to see if the message bounced by referring to the tags specified in the
configuration parameters, if any. If the message bounced, the notification mailer
updates the notification's status and stops any further processing, based on the
specifications of the tag list.
• Checks the Oracle Workflow database for this notification based on the NID line.
• If the notification does not exist, meaning the notification ID or the access key in
the NID line is invalid, the notification mailer moves the message to the discard
folder. If the NID line is incorrectly formatted, the notification mailer moves the
message to the discard folder and and treats it as an unsolicited message.
• If the notification exists, but is closed or canceled, the notification mailer moves
the message to the processed folder and sends a Workflow Closed Mail or
Workflow Canceled Mail message to the recipient role, respectively.
Note: You can optionally use the Send E-mails for Canceled
Notifications mailer parameter to prevent notification mailers
from sending any notification cancellation messages. See:
Notification Mailer Configuration Wizard, page 7-36.
• If the inbound message is a response to a request for more information that has
already been answered, or if the message is formatted as a more information
response but no information was requested for that notification, then the
notification mailer moves the message to the discard folder and sends a
Workflow More Info Answered Mail message to the sender of the message.
• If the notification exists and is open, the notification mailer generates an XML
Finally, if there are no more unprocessed messages in the inbox, the notification mailer
logs out of the email account.
Oracle Workflow provides a seeded agent listener named Workflow Inbound
Notifications Agent Listener that runs on the WF_NOTIFICATION_IN agent to
continue notification processing for the valid response messages placed on that agent.
When an event message is dequeued from WF_NOTIFICATION_IN, Oracle Workflow
executes a seeded subscription that calls the appropriate notification response function.
This function verifies the response values with the definition of the notification
message's response attributes in the database. If a response value is invalid, or if no
response value is included, the notification mailer sends a Workflow Invalid Mail
message to the recipient role, or, for an invalid response to a request for more
information, the notification mailer sends a Workflow Invalid Open Mail (More
Information Request) message to the recipient role. If the responses are valid, the
notification response function records the response and completes the notification.
See: Workflow Warning Mail Message, page 2-140, Workflow Closed Mail Message,
page 2-137, Workflow Canceled Mail Message, page 2-129, Workflow More Info
Answered Mail Message, page 2-156, Workflow Invalid Mail Message, page 2-132, and
Workflow Invalid Open Mail (More Information Request) Message, page 2-153.
Note: If you will use this certificate solely for testing purposes or to
secure communications within your own enterprise, you can set up
your own certificate authority to issue the certificate. However, to
secure communications with third parties, you must obtain a certificate
from a publicly recognized certificate authority.
For a notification mailer to connect with TLS v1.2, your Oracle E-Business Suite instance
If your SMTP server does not support TLS or SSL natively, then you must have Stunnel
installed on the SMTP server to connect through TLS or SSL. Stunnel is a program that
lets you encrypt connections inside TLS or SSL. For more information, see: https://www.
stunnel.org/.
2. (Conditionally Required) If you want a notification mailer to connect with TLS v1.
2, ensure that your Oracle E-Business Suite instance is configured with JDK 1.7.0
_131 or a later version of JDK 7 and with JavaMail version 1.5.4.
3. (Conditionally Required) If you are using Stunnel, start an Stunnel process on the
SMTP server, specifying the location of the certificate file in the arguments.
For example, if the certificate file is named imapd.pem and is located in the
/usr/share/ssl/certs/ directory on the SMTP server, use the following
Stunnel command to redirect TLS or SSL connections from port 465 to port 25 on
the SMTP server.
stunnel -d 465 -r 25 -o /tmp/stunnel.log -p
/usr/share/ssl/certs/imapd.pem
5. (Conditionally Required) If you set up your own certificate authority to issue the
certificate as a self-signed certificate, then you must also load the local certificate
authority's certificate (CA certificate) into a local trust store.
• If possible, load the CA certificate into the default local trust store on the
concurrent manager host (the trust store for the concurrent manager JDK)
where the notification mailer resides.
If the concurrent processing tier and Web tier are on different nodes, then you
must import the CA certificate into the default local trust store on each Web tier
node as well.
• Otherwise, load the CA certificate to an alternate trust store, and specify the
location of that trust store in the internal mailer parameter named
MAILER_SSL_TRUSTSTORE. You can use the keytool command line utility to
create the local trust store.
7. In the notification mailer configuration wizard, set the inbound Connection Security
parameter to enable the notification mailer to use a secure protocol for connections
to the IMAP server. Choose SSL/TLS to use TLS or SSL directly or STARTTLS to
upgrade to an encrypted TLS or SSL connection using STARTTLS. See: Notification
Mailer Configuration Wizard, page 7-36.
8. (Conditionally Required) If you set up your own certificate authority to issue the
certificate as a self-signed certificate, then follow the instructions in step 4 above.
Notification Preferences:
Oracle Workflow lets users determine how they view notifications by setting a
notification style preference, also known simply as a notification preference. As a
workflow administrator, you can set the default notification preference for all users in
your enterprise using the Notification Style field in the Workflow Configuration page.
Users can override the default by modifying their individual notification style
preference setting in the Preferences page in Oracle E-Business Suite. See: Setting Global
User Preferences, page 2-16 and Set Preferences, Oracle E-Business Suite User's Guide.
Often, the functionality of a user's mail reader determines what the user's notification
preference should be. Some mail readers can only display plain text, others can display
HTML formatting, while still others can only display HTML formatting in an
attachment. Also, some users may prefer to receive any attachments in email for easy
access. Other users may prefer to save space in their email accounts by excluding
attachments from email notifications and accessing any attachment content only by
logging in to Oracle E-Business Suite.
The following notification preferences are available:
• Plain text mail with attachments (MAILATTH) - The notification message appears as
plain text. The email includes the following:
• An HTML-formatted version of the message
• A link to the notification in the Notification Details page, unless the recipient
has been assigned the WF_EXTERNAL_ROLE_NOEBS_ACCESS role
• Plain text summary mail (SUMMARY) - The message is a plain text summary of all
open notifications. To respond to the individual notifications in the summary, the
user must access the notifications from the Worklist pages.
• Do not send me mail (QUERY) - The notification mailers do not send the user email
notifications. Instead the user must query and respond to notifications from the
Worklist pages.
Tip: You can run a diagnostic test to check that all users with a
notification preference to receive email have an email address defined.
See: Reviewing Notifications via Electronic Mail, Oracle Workflow User's Guide, Viewing
Notifications from a Web Browser, Oracle Workflow User's Guide, and Reviewing a
Summary of Your Notifications via Electronic Mail, Oracle Workflow User's Guide.
• URL attributes are token replaced with the display name of the URL attribute,
followed by a colon and the URL:
<URL_Attribute_Display_Name>:<URL>
The email does not include any attachments. If the notification message has any
workflow attachments defined as message attributes that have the Attach Content
option checked in their Attributes property page, such as URLs or PL/SQL documents,
or any Oracle E-Business Suite attachments specified in the #ATTACHMENTS attribute,
then the recipient must access the notification in the Notification Details page to view
those attachments. See: Viewing Notifications from a Web Browser, Oracle Workflow
User's Guide.
A recipient of this type of notification responds by manually replying to the email and
entering response values following the instructions provided in the notification. See: To
Respond to a Plain Text Email Notification Using Templated Response, Oracle Workflow
User's Guide and To Respond to a Plain Text Email Notification Using Direct Response,
Oracle Workflow User's Guide.
In addition to these standard attachments, the notification can also include custom
attachments.
• If the notification does not include Oracle Application Framework regions, then
message attributes that have the Attach Content option checked in their Attributes
property page are appended as attachments.
• If the message attribute is a URL attribute, an attachment called Notification
References is appended to the email message. This attachment includes a link to
each URL attribute for the message that has Attach Content checked. The
recipient can navigate to a URL by choosing its link.
• Select the HTML Message Body attachment to display the HTML-formatted version
of the email message, and click the HTML link that represents the desired response.
The response link generates a plain text email response that includes a response
template updated with the selected response value.
Note: You can use the Inline Attachment configuration parameter to set
the Content-Disposition MIME header to either inline or
attachment for attachments to notification messages, including the
Notification Detail Link, HTML Message Body, Notification References
containing attached URLs, and attached PL/SQL, PL/SQL CLOB, or
PL/SQL BLOB documents. Note, however, that some email clients may
not support the Content-Disposition header, or may support it in
varying ways. Consequently, the Inline Attachment setting may not
always have the desired effect, depending on the email clients with
which users read their email messages.
• URL attributes that point to an image file are token replaced with <IMG>...
</IMG> HTML tags to display the image inline within the message body.
Notification mailers treat URL attributes as inline images if the URL points to a file
with an extension of gif, jpg, png, tif, bmp, or jpeg, and the attribute value
begins with the prefix IMG: or no prefix.
• URL attributes other than images, as well as image URL attributes that begin with
the LNK: prefix, are token replaced with HTML links. When the recipient selects
such a link, the email reader opens the target URL page in a browser.
The email does not include any attachments. If the notification message has any
workflow attachments defined as message attributes that have the Attach Content
option checked in their Attributes property page, such as URLs or PL/SQL documents,
or any Oracle E-Business Suite attachments specified in the #ATTACHMENTS attribute,
then the recipient must access the notification in the Notification Details page to view
those attachments. See: Viewing Notifications from a Web Browser, Oracle Workflow
User's Guide.
A recipient of this type of notification responds by clicking a link that represents the
desired response in the HTML message body. The response link generates a plain text
email response that includes a response template modified with the selected response
value. See: To Respond to an HTML Email Notification, Oracle Workflow User's Guide.
• URL attributes that point to an image file are token replaced with <IMG>...
</IMG> HTML tags to display the image inline within the message body.
Notification mailers treat URL attributes as inline images if the URL points to a file
with an extension of gif, jpg, png, tif, bmp, or jpeg, and the attribute value
begins with the prefix IMG: or no prefix.
• URL attributes other than images, as well as image URL attributes that begin with
the LNK: prefix, are token replaced with HTML links. When the recipient selects
such a link, the email reader opens the target URL page in a browser.
For most users, the notification mailer includes a standard attachment called
Notification Detail Link. When a user selects the Notification Detail Link attachment,
In addition to this standard attachment, the notification can also include custom
attachments.
• If the notification does not include Oracle Application Framework regions, then
message attributes that have the Attach Content option checked in their Attributes
property page are appended as attachments.
• If the message attribute is a URL attribute, an attachment called Notification
References is appended to the email message. This attachment includes a link to
each URL attribute for the message that has Attach Content checked. The
recipient can navigate to a URL by choosing its link. Note that the Notification
References attachment does not display images inline. If Attach Content is
checked, a URL attribute always appears as a link in the Notification References
Note: You can use the Inline Attachment configuration parameter to set
the Content-Disposition MIME header to either inline or
attachment for attachments to notification messages, including the
Notification Detail Link, Notification References containing attached
URLs, and attached PL/SQL, PL/SQL CLOB, or PL/SQL BLOB
documents. Note, however, that some email clients may not support
the Content-Disposition header, or may support it in varying ways.
Consequently, the Inline Attachment setting may not always have the
desired effect, depending on the email clients with which users read
their email messages.
• The notification access key is a distinct random key generated by the Notification
System for each NID. The access key must be included in a response to the
notification in order for a notification mailer to accept the response, thereby serving
as a password that allows only users who actually received the notification
containing the key to respond to that notification.
• The node identifier specifies the notification mailer node to which the message
belongs.
Responses by Email
When a user responds to a notification by email, the response message must include the
NID line from the original notification message. A notification mailer accepts the
response only if the correct NID and access key combination is included in the response.
Users can ensure that the response message contains the NID and access key either by
including the entire original message when replying or by using a response template
that includes the NID line.
A user who receives an email notification message can forward the message to another
user through the email application. When you configure a notification mailer, you can
choose whether to allow a user to respond by email to an email notification that has
been forwarded from another role.
• If you deselect the Allow Forwarded Response configuration parameter, the
notification mailer will check whether the "From:" email address of the notification
response exactly matches the email address of the recorded recipient role, or the
email address of a user in that role. If the two email addresses match exactly,
meaning the notification was not forwarded or was forwarded according to a valid
vacation routing rule, the notification mailer treats the response as a valid response.
If the two email addresses do not match exactly, meaning the notification was
simply forwarded using the email Forward command, the notification mailer does
not process the response and treats it as unsolicited mail.
Important: Note that there are limitations when you deselect the
Allow Forwarded Response parameter. For example, suppose a
notification is sent to a distribution list mail alias that does not have
a user/role relationship in the Oracle Workflow directory service. If
any user from the distribution list responds to the notification, the
notification mailer will always treat their notification response as
unsolicited mail, because the "From:" email address, which is an
individual user's email address, will never match the distribution
list mail alias.
• You can optionally enable guest access to the Notification Details page. Guest
access lets users access this page from email notifications without logging in to
Oracle E-Business Suite with an individual user name and password. This feature is
not recommended due to security considerations. However, if you choose to allow
guest access, you can perform the following steps to enable it:
• Set the WF: GUEST Access to Notification profile option to Enabled at the site
level. See: Overview of Setting User Profiles, Oracle E-Business Suite Setup Guide.
With guest access, if a user navigates to the Notification Details page and is not
already logged in to Oracle E-Business Suite, the user is logged in automatically as
the GUEST user. The user can then respond to the notification, and can also reassign
the notification or request more information if those actions are available for that
notification. However, the user cannot access any other notification in the
Notification Details page, nor any other Oracle Workflow pages.
Note: If you enabled guest access but no longer want to allow it,
you can disable it by setting the WF: GUEST Access to Notification
profile option to Disabled and setting an end date for the grant
you created. Then stop and restart Oracle HTTP Server and, in
Oracle Applications Manager, stop and restart the service
component container named Workflow Mailer Service. Users
will then always be required to log in before they can access the
Notification Details page from the Notification Detail Link.
If your Oracle E-Business Suite instance is set up in a DMZ configuration, you can
optionally configure the link for the Notification Detail Link attachment to be generated
using the external web entry point for users whom you designate as external users
without access to your intranet. To designate users as external users who must access
Oracle E-Business Suite through the external web entry point, assign them the role
WF_EXTERNAL_ROLE. When a notification is sent to a recipient with the role
WF_EXTERNAL_ROLE, the notification mailer uses the external agent specified in the
FND Framework External Agent profile option to generate the link for the Notification
Detail Link attachment.
If you send email notifications to users who are external to your enterprise and do not
have access to your Oracle E-Business Suite instance at all, you can optionally exclude
the Notification Detail Link attachment from emails sent to those users. To designate
users as external users who cannot access Oracle E-Business Suite, assign them the role
WF_EXTERNAL_ROLE_NOEBS_ACCESS. When a notification is sent to a recipient with
the role WF_EXTERNAL_ROLE_NOEBS_ACCESS, the notification mailer does not include
the Notification Detail Link attachment, even if the recipient's notification style
preference is MAILATTH or MAILHTML.
See: Setting Up Notification Mailers, page 2-57.
SMTP Authentication
You can configure the SMTP server to require authentication for server connections
through the Simple Authentication and Security Layer (SASL). The Oracle Workflow
notification mailer supports the PLAIN, LOGIN, and DIGEST-MD5 authentication
mechanisms. Additionally, if you have applied patch 9452181 for JavaMail version 1.4.x,
then the notification mailer can also support the Microsoft NTLM authentication
mechanism. See: Setting Up a Notification Mailer, page 7-23.
• Use the Notification Detail Link, for users with the MAILHTML and MAILATTH
notification preferences who are not assigned the
WF_EXTERNAL_ROLE_NOEBS_ACCESS role.
• Use a "Click here to respond" link included in the HTML-formatted version of the
message, for users with the MAILHTML, MAILHTM2, and MAILATTH notification
preferences.
Users must log in to Oracle E-Business Suite before they can access the Notification
Details page from the Notification Detail Link or "Click here to respond" link.
Note: If you enable guest access to the Notification Details page, the
"Click here to respond" link does not appear in the HTML-formatted
message. See: Responses Through the Notification Detail Link
Attachment, page 2-88.
Use the special message attribute #WF_SIG_POLICY to specify the signature policy for
a notification. See: #WF_SIG_POLICY Attribute, Oracle Workflow Developer's Guide.
You can use the Signature Evidence Store to review details about the electronic
signatures requested or submitted for notifications that require signatures. You can also
view some signature details in the Notification Response Details page in the Status
Monitor. See: Reviewing Electronic Signature Details, page 6-10 and Viewing
Responses, page 5-13.
Tip: The settings in the Email Notification Preference field control only
the messages that are sent to users with a notification style preference
for receiving individual email notifications, either MAILHTML,
MAILHTM2, MAILTEXT, or MAILATTH. The Email Notification
Preference settings do not affect users whose notification style
preference is set to SUMMARY, SUMHTML, QUERY, or DISABLED.
• If the notification allows responses by email and you select the Allow Forwarded
Response mailer configuration parameter, then CC and BCC recipients can respond
to the notification by email. If you do not want CC and BCC recipients to respond
by email, deselect the Allow Forwarded Response mailer configuration parameter,
or choose notification options that require users to respond through the Notification
Details page. For example, users must use the Notification Details page to respond
to notifications that require electronic signatures and notifications marked as
including secure content not sent by email. See: Responses By Email, page 2-86,
Confirming Responses with Electronic Signatures, page 2-90, and Excluding
Notification Content From Email, page 2-91.
Note: You must particularly check the notification preference and email
address for the SYSADMIN user. This user is the default recipient for
several types of notifications such as error notifications. By default, the
You can also run command-line diagnostic tests for notification mailers through
oracle.apps.fnd.wf.mailer.Mailer to check mail server and Web server
connectivity and check the size or number of messages in an IMAP folder. See: Running
Command-Line Notification Mailer Diagnostics, page 2-100.
You can use the Workflow Mailer URL Access Tester page to test whether Oracle
Application Framework content can be generated correctly for email notifications. See:
Testing Mailer URL Access, page 6-31.
The Generic Service Component Framework lets you control how errors are handled
through the component-level Max Error Count parameter and the container-level
SVC_COMP_MAX_ERROR_COUNT parameter.
• The Max Error Count (PROCESSOR_MAX_ERROR_COUNT) parameter for a service
component determines how many consecutive errors the component can encounter
before its container stops it and changes its status to Stopped with Error. If the
component's startup mode is Automatic or On-Demand, the container will then
restart the component. The default value for this parameter is 10.
The total number of errors before a mailer is permanently stopped consists of the Max
Error Count value multiplied by the SVC_COMP_MAX_ERROR_COUNT value. For
example, using the default values, a mailer can encounter 10 * 5 = 50 errors before
it becomes System Deactivated.
If a mailer encounters multiple consecutive errors, it may be advantageous to let the
container restart the mailer. Restarting causes the mailer to establish new connections
and instantiate new objects, which may resolve the errors. Consequently, if you want to
allow more errors before you must manually intervene to restart the mailer, it is usually
better to increase the SVC_COMP_MAX_ERROR_COUNT value than the Max Error Count
value.
You must stop the service component containers for notification mailers and agent
listeners before you run this script, and restart the containers after the script
completes. The container for notification mailers is named Workflow Mailer
Service. The container for agent listeners is named Workflow Agent
Listener Service.
Use the script as follows:
sqlplus <user> @wfntfqup
Enter password: <password>
Run this script as the APPS user. The user name is usually apps.
Replace <APPSuser> and <APPSpwd> with the user name and password for the
APPS user. The user name is usually apps. Replace <FND_schema> with the
ORACLE username that connects to Oracle Application Object Library data in
Oracle E-Business Suite, usually applsys.
• wfntfsnd.sql - This script updates the MAIL_STATUS from null to MAIL for
notifications of the specified item type that were sent on or after the specified date.
The recipient role of each notification must have a valid email address defined.
Then the script enqueues those notifications on the WF_DEFERRED queue for
reprocessing by the mailer.
For example, if users change their notification preference from not receiving email
to receiving email, run this script to send any existing open notifications to those
users by email.
Use the script as follows:
sqlplus <user> @wfntfsnd <item_type> <begin_date_after>
Enter password: <password>
Replace <item_type> with the internal name of the item type for the notifications
to update. Replace <begin_date_after> with the earliest sent date for the
notifications to update.
Oracle Workflow also provides concurrent programs that help enable mass
reprocessing of notifications. See: Running Reports and Programs, Oracle E-Business
Suite User's Guide.
• Workflow Directory Services Bulk Reset DISABLED Notification Preference (
FNDWFBULKRESETNTFPREF) - This program lets you reset the notification
preference from DISABLED back to the original value for multiple users at once.
Oracle Workflow sets a user's notification preference to DISABLED if the
notification mailer cannot deliver an email notification to any of that user's email
addresses. If an issue affected multiple users, such as a problem with the mail
server, you can use this program to reset the users' notification preferences in bulk,
instead of requiring individual users to reset their notification preferences
• Recipient Role - Specify the recipient role whose notifications you want to
resend, or leave this parameter blank to resend notifications to all recipient
roles.
• Notifications sent on or after - Optionally specify the earliest original send date
for the notifications to resend.
• Notifications sent on or before - Optionally specify the latest original send date
for the notifications to resend.
Note: For a notification that does not have the Expand Roles option
checked, meaning the same notification ID was sent to all users in
the recipient role, the notification mailer checks the Oracle
Workflow entity preferences table to determine the specific users
for whom the email previously failed. The notification mailer then
resends the email notification only to those users for whom an
email has not yet been delivered.
If the email notification is successfully delivered to one of these
users when the notification is retried, then the notification mailer
removes the record of the send failure for that user, for that
notification ID only, from the Oracle Workflow entity preferences
table. If email delivery fails again for a particular user, then the
record of the send failure is retained in the table to allow the
notification to be retried again later.
If one or more email addresses for a user are invalid, but at least one email address for
the user is valid, then the user's notification preference is not changed, and email
notifications are still sent to the valid address or addresses. However, Oracle Workflow
sends a notification about the invalid email addresses to the SYSADMIN user. You
should either correct those addresses or remove them from the list of email addresses
defined for the user, and then stop and restart the notification mailer. Oracle Workflow
will not attempt to send any further notifications to these addresses until the
notification mailer is restarted and its invalid address list is cleared.
• Sets the mail status to null for all notifications that formerly had a mail status of
MAIL, ERROR, or FAILED, indicating that they were eligible to be sent by email.
The wfmlpcln.sql script is located in the $FND_TOP/sql directory. Use the script as
follows:
sqlplus <user> @wfmlpcln
Enter password: <password>
If you later want to send email notifications from the cloned instance, you can use
Oracle Workflow Manager to reconfigure the notification mailers as appropriate for that
instance. When you do so, Oracle Workflow automatically re-enables the seeded
subscription to the oracle.apps.wf.notification.send.group event group.
See: Notification Events, Oracle Workflow Developer's Guide and Cloning, Oracle E-
Business Suite Concepts.
• Test connectivity to the Web tier, which is required for the notification mailer to
generate notifications that include Oracle Application Framework content.
• Check the number of messages in an IMAP folder or the total size of the messages
in the folder in bytes, which indicates how much space you can regain by purging
messages from the folder.
Use the following command to test connectivity to the IMAP mail server.
• -Dport - Optionally specify the port number to use on that server. If you do not
specify a port number, the default is port 143.
• -Daccount and -Dpassword - Specify the user name and password of the mail
account that the notification mailer uses to receive email messages.
• -Dfolder - Optionally specify the name of the folder that the notification mailer
uses as its inbox folder.
• -Dsecurity - Optionally specify the security protocol to use for connections to the
server. Valid values for this parameter are NONE, SSL, TLS, or STARTTLS. The
default is NONE.
• -Dtruststore - If you are using a secure protocol, optionally specify the location
of the trust store where the IMAP server's certificate is loaded.
• -Ddebug - Optionally specify Y to run in debug mode and report more extensive
debugging information in the program output or N to run in normal mode. The
default is N.
• -Dlogfile - Optionally specify the name of the log file for the program output.
The default is test.log.
Use the following command to test connectivity to the SMTP mail server.
• -Dport - Optionally specify the port number to use on that server. If you do not
specify a port number, the default is port 25.
• -Daccount - Optionally specify the user name of the mail account that the
notification mailer uses.
• -Dsecurity - Optionally specify the security protocol to use for connections to the
server. Valid values for this parameter are NONE, SSL, TLS, or STARTTLS. The
default is NONE.
• -Dtruststore - If you are using a secure protocol, optionally specify the location
of the trust store where the SMTP server's certificate is loaded.
• -Ddebug - Optionally specify Y to run in debug mode and report more extensive
debugging information in the program output or N to run in normal mode. The
default is N.
• -Dlogfile - Optionally specify the name of the log file for the program output.
The default is test.log.
• -Dnid or -Durl - Either specify the notification ID for a notification that includes
Oracle Application Framework content, or specify the URL for an Oracle
Application Framework application page to which you want to connect.
• -Dappuser - Optionally specify the numerical user ID for the user through which
the notification mailer accesses Oracle Application Framework content. The default
is 0, which is the user ID for the SYSADMIN user.
• -Dhtp - Optionally specify http to connect using the HTTP protocol or https to
connect using the HTTPS (HTTP over Secure Sockets Layer) protocol.
• -Durltimeout - Optionally specify the number of seconds wait to access the URL
for Oracle Application Framework content before timing out. The default is 30
seconds.
• -Dlogfile - Optionally specify the name of the log file for the program output.
The default is test.log.
Use the following command to check the number of messages in an IMAP folder or the
total size of the messages in the folder in bytes.
$AFJVAPRG -classpath $AF_CLASSPATH -Dprotocol=imap \
( -Ddbcfile=<dbcfileLocation> | -Ddbuser -Ddbpassword -Ddburl )\
-Dserver=<server_name> [-Dport=<port>] \
-Daccount=<account_name> -Dpassword=<password> \
[ -Dsecurity=<NONE|SSL|TLS|STARTTLS> ] \
[ -Dtruststore=<truststore> ]\
[ -Dconnect_timeout=<seconds> ] \
[ -Ddebug=<Y|N> ]\
[ -Dlogfile=<log_file_name> ]\
-Dfolder=<folder_name> \
-Dfolder_usage=<count | size> \
[ -Dcheck_age=<age_in_days> \
[ -Dinclude_flag=<2 | 4 | 8 | 14> \
oracle.apps.fnd.wf.mailer.Mailer
• -Dport - Optionally specify the port number to use on that server. If you do not
specify a port number, the default is port 143.
• -Dsecurity - Optionally specify the security protocol to use for connections to the
server. Valid values for this parameter are NONE, SSL, TLS, or STARTTLS. The
default is NONE.
• -Dtruststore - If you are using a secure protocol, optionally specify the location
of the trust store where the IMAP server's certificate is loaded.
• -Ddebug - Optionally specify Y to run in debug mode and report more extensive
debugging information in the program output or N to run in normal mode. The
default is N.
• -Dlogfile - Optionally specify the name of the log file for the program output.
The default is test.log.
• -Dcheck_age - If you are checking the folder size, optionally specify the minimum
age in days of the messages to include in the check. With this option, you can check
how many bytes are occupied by messages of a certain age or older.
• -Dinclude_flag - If you are checking the folder size, optionally specify one of the
following values to indicate the status of the messages to include in the check.
• 2 - Include only unseen messages.
With this option, you can check how many bytes are occupied by messages in a
particular status. The default is to include all messages.
The templates in the System: Mailer item type have message attributes that represent
every part of the notification message. Within the body of a template, the message
attributes are token substituted to insert the specific information for a particular
instance of a notification into the message outline.
Note: Do not modify, add new attributes to, or delete existing attributes
from the standard message templates in the System: Mailer item type.
If you create new custom templates, your custom templates should contain only the
high-level notification layout and general information common to all email
notifications. You must name the message attributes for these templates with the same
standard names as the message attributes for the standard templates. Do not create any
new custom message attributes in your templates with nonstandard names, and do not
reference any nonstandard attribute tokens in the template message body. A
notification mailer can only token substitute the attributes in the message body if you
use the standard attribute names. To include additional information in a custom
message template, enter that information directly into the template message body,
without using tokens.
You can optionally omit some of the standard tokens from your custom templates, if
you do not want to send the information they represent. However, you should not omit
the tokens that represent the key information to be conveyed in the notification. For
example, if you define a custom version of a template that includes the &BODY token,
you must include the &BODY token in the custom template as well, in order to include
the body text of the particular notification that is being sent into the template outline.
Oracle Workflow provides the following message templates.
• Orig. Workflow Open Mail (More Information Request) Message, page 2-148
• Workflow Invalid Open Mail (More Information Request) Message, page 2-153
See: Reviewing Notifications via Electronic Mail, Oracle Workflow User's Guide.
The response instructions in the plain text message body describe how to reply
manually using the templated response method. This message is used for notifications
sent to performers with a notification preference of MAILTEXT or MAILATTH. The
response instructions in the HTML-formatted message body describe how to reply
using the automatically generated response template. This message is used for
notifications sent to performers with a notification preference of MAILHTML or
MAILHTM2, and is also attached to notifications sent to performers with a notification
preference of MAILATTH.
The Workflow Open Mail (Templated) message has the following message attributes.
The values are drawn from the message definition associated with a notification
activity.
START_DATE The date the message is sent.
MAILTO The content of the HTML tag that a recipient would click
on to respond to a notification. This attribute is used only
for HTML email notifications.
You can customize the boilerplate text that appears in the body of the Workflow Open
Mail (Templated) message, where attributes preceded by an ampersand (&) are token
substituted with runtime values when the notification is sent.
The boilerplate text for a plain text message body is as follows:
Oracle Workflow Notification
&TIMEZONE
______________________Start of Response Template______________________
&RESPONSE
Notification Details:
&HEADER
&BODY
&HISTORY
The response instructions in the plain text message body describe how to reply
manually using the templated response method. This message is used for notifications
sent to performers with a notification preference of MAILTEXT or MAILATTH. The
response instructions in the HTML-formatted message body describe how to reply
using the automatically generated response template. This message is used for
notifications sent to performers with a notification preference of MAILHTML or
MAILHTM2, and is also attached to notifications sent to performers with a notification
preference of MAILATTH.
The Orig. Workflow Open Mail (Templated) message has the following message
attributes. The values are drawn from the message definition associated with a
notification activity.
MAILTO The content of the HTML tag that a recipient would click
on to respond to a notification. This attribute is used only
for HTML email notifications.
CLICK_HERE_RESPONSE The content of the HTML tag that a recipient would click
on to access the Notification Details page to respond to a
notification. This attribute is not currently used.
&RESPONSE
Notification Details:
&BODY
Note: To select the direct response method for a notification mailer, you
must select the Direct Response parameter in the notification mailer
configuration wizard. See: Notification Mailer Configuration Wizard,
page 7-36.
The response instructions in the plain text message body describe how to reply using
the direct response method. This message is used for notifications sent to performers
with a notification preference of MAILTEXT or MAILATTH. The response instructions in
the HTML-formatted message body describe how to reply using the automatically
generated response template. This message is used for notifications sent to performers
with a notification preference of MAILHTML or MAILHTM2, and is also attached to
notifications sent to performers with a notification preference of MAILATTH.
The Workflow Open Mail (Direct) message has the following message attributes. The
values are drawn from the message definition associated with a notification activity.
START_DATE The date the message is sent.
MAILTO The content of the HTML tag that a recipient would click
on to respond to a notification. This attribute is used only
for HTML email notifications.
CLICK_HERE_RESPONSE The content of the HTML tag that a recipient would click
on to access the Notification Details page to respond to a
notification. This attribute is not currently used.
You can customize the boilerplate text that appears in the body of the Workflow Open
Mail (Direct) message, where attributes preceded by an ampersand (&) are token
substituted with runtime values when the notification is sent.
The boilerplate text for a plain text message body is as follows:
Oracle Workflow Notification
&TIMEZONE
________________________________________________________________________
&RESPONSE
________________________________________________________________________
Notification Details:
&HEADER
&BODY
&HISTORY
Note: To select the direct response method for a notification mailer, you
must select the Direct Response parameter in the notification mailer
configuration wizard. See: Notification Mailer Configuration Wizard,
page 7-36.
The response instructions in the plain text message body describe how to reply using
the direct response method. This message is used for notifications sent to performers
with a notification preference of MAILTEXT or MAILATTH. The response instructions in
the HTML-formatted message body describe how to reply using the automatically
generated response template. This message is used for notifications sent to performers
with a notification preference of MAILHTML or MAILHTM2, and is also attached to
notifications sent to performers with a notification preference of MAILATTH.
The Orig. Workflow Open Mail (Direct) message has the following message attributes.
The values are drawn from the message definition associated with a notification
activity.
START_DATE The date the message is sent.
MAILTO The content of the HTML tag that a recipient would click
on to respond to a notification. This attribute is used only
for HTML email notifications.
CLICK_HERE_RESPONSE The content of the HTML tag that a recipient would click
on to access the Notification Details page to respond to a
notification. This attribute is not currently used.
&RESPONSE
________________________________________________________________________
Notification Details:
&BODY
Note: If you select the Workflow Open Mail (Outlook Express) message
template for a notification mailer, then you should also select the
Workflow More Information Request (Outlook Express) message
template for that notification mailer. See: Workflow More Information
Request (Outlook Express) Message, page 2-150.
The response instructions in the plain text message body describe how to reply
manually using the templated response method. This message is used for notifications
sent to performers with a notification preference of MAILATTH. The HTML-formatted
message body includes a link called "Click here to respond" which lets users access the
notification in the Notification Details Web page to respond to the notification. This
message is used for notifications sent to performers with a notification preference of
MAILHTML or MAILHTM2, and is also attached to notifications sent to performers with a
notification preference of MAILATTH.
The Workflow Open Mail (Outlook Express) message has the following message
MAILTO The content of the HTML tag that a recipient would click
on to respond to a notification. This attribute is not
currently used.
CLICK_HERE_RESPONSE The content of the HTML tag that a recipient would click
on to access the Notification Details page to respond to a
notification. This attribute is used only for HTML email
notifications.
You can customize the boilerplate text that appears in the body of the Workflow Open
Mail (Outlook Express) message, where attributes preceded by an ampersand (&) are
token substituted with runtime values when the notification is sent.
The boilerplate text for a plain text message body is as follows:
Oracle Workflow Notification
&TIMEZONE
&RESPONSE
Notification Details:
&HEADER
&BODY
&HISTORY
Note: If you select the Orig. Workflow Open Mail (Outlook Express)
message template for a notification mailer, then you should also select
the Workflow More Information Request (Outlook Express) message
template for that notification mailer. See: Workflow More Information
Request (Outlook Express) Message, page 2-150.
The response instructions in the plain text message body describe how to reply
manually using the templated response method. This message is used for notifications
sent to performers with a notification preference of MAILATTH. The HTML-formatted
message body includes a link called "Click here to respond" which lets users access the
notification in the Notification Details Web page to respond to the notification. This
message is used for notifications sent to performers with a notification preference of
MAILHTML or MAILHTM2, and is also attached to notifications sent to performers with a
notification preference of MAILATTH.
The Orig. Workflow Open Mail (Outlook Express) message has the following message
attributes. The values are drawn from the message definition associated with a
notification activity.
START_DATE The date the message is sent.
MAILTO The content of the HTML tag that a recipient would click
on to respond to a notification. This attribute is not
currently used.
CLICK_HERE_RESPONSE The content of the HTML tag that a recipient would click
on to access the Notification Details page to respond to a
notification. This attribute is used only for HTML email
notifications.
&RESPONSE
Notification Details:
&BODY
You can customize the text that appears in the body of the Workflow Open FYI Mail
template, where attributes preceded by an ampersand (&) are token substituted with
runtime values when the notification is sent. The boilerplate text for the plain text
message body is as follows:
Oracle Workflow Notification (FYI)
&TIMEZONE
________________________________________________________________________
&HEADER
&BODY
&HISTORY
The boilerplate text for the plain text message body is as follows:
Oracle Workflow Notification (FYI)
From: &SENDER
&COMMENT
________________________________________________________________________
&BODY
You can customize the boilerplate text that appears in the body of the Workflow View
From UI message, where attributes preceded by an ampersand (&) are token substituted
with runtime values when the notification is sent.
The boilerplate text for a plain text message body is as follows:
Oracle Workflow Notification
&TIMEZONE
Notification Details:
&HEADER
&HISTORY
You can customize the boilerplate text that appears in the body of the Workflow View
FYI From UI message, where attributes preceded by an ampersand (&) are token
substituted with runtime values when the notification is sent.
The boilerplate text for a plain text message body is as follows:
Oracle Workflow Notification
&TIMEZONE
Notification Details:
&HEADER
&HISTORY
The Workflow URL Attachment message has the following message attributes. The
values are drawn from the message definition associated with a notification activity.
URLLIST The list of URLs to be included in the attachment.
You can customize the text that appears in the body of the Workflow URL Attachment
template, where an attribute preceded by an ampersand (&) is token substituted with a
runtime value when the notification is sent. The boilerplate text for the HTML-
formatted message body is as follows:
<HTML> <HEAD> <TITLE> Oracle Workflow Notification References </TITLE>
<STYLE>
<!--
&TEMPLATE_STYLE
-->
</STYLE> </HEAD>
<BODY BGCOLOR="#FFFFFF" >
<P><h2 class="OraHeader">Notification References</h2>
<HR WIDTH="100%">
<BR>
&URLLIST
<BR>
<HR WIDTH="100%">
<BR>
</BODY>
</HTML>
The boilerplate text for the plain text message body is as follows:
&TIMEZONE
&HEADER
&BODY
The boilerplate text for the plain text message body is as follows:
You earlier received the notification shown below. That
notification is now canceled, and no longer requires your
response. You may simply delete it along with this message.
________________________________________________________________________
&BODY
CLICK_HERE_RESPONSE The content of the HTML tag that a recipient would click
on to access the Notification Details page to respond to a
notification. This attribute is not currently used.
The boilerplate text for the plain text message body is as follows:
Oracle Workflow Notification
&TIMEZONE
Remarks: &MAIL_EXP_VALUES
________________________________________________________________________
&RESPONSE
________________________________________________________________________
Notification Details:
&HEADER
&BODY
&HISTORY
CLICK_HERE_RESPONSE The content of the HTML tag that a recipient would click
on to access the Notification Details page to respond to a
notification. This attribute is not currently used.
The boilerplate text for the plain text message body is as follows:
Remarks: &MAIL_EXP_VALUES
________________________________________________________________________
&RESPONSE
________________________________________________________________________
Notification Details:
&BODY
The boilerplate text for the plain text message body is as follows:
&TIMEZONE
&HEADER
&BODY
The boilerplate text for the plain text message body is as follows:
You earlier received the notification shown below. That
notification is now closed, and no longer requires your
response. You may simply delete it along with this message.
________________________________________________________________________
&BODY
The HTML-formatted message body is used for notifications sent to performers with a
notification preference of SUMHTML. The boilerplate text for the HTML-formatted
message body is as follows:
<HTML><HEAD>
<STYLE>
&TEMPLATE_STYLE
</STYLE>
<TITLE>Summary Notification</TITLE>
</HEAD>
<BODY><SPAN class="OraTipLabel">&TIMEZONE</SPAN>
<P>&SUMMARY
</BODY>
</HTML>
Note: You can optionally use the Send Warning for Unsolicited E-mail
mailer parameter to prevent notification mailers from sending any
warning messages. See: Notification Mailer Configuration Wizard, page
7-36.
The Workflow Warning Mail message has the following message attributes, with values
that are drawn from the unsolicited mail:
UBODY The text of the unsolicited mail message body.
UFROM The address of the user that sent the unsolicited mail.
The boilerplate text for the plain text message body is as follows:
________________________________________________________________________
From: &UFROM
Subject: &USUBJECT
&UBODY
<P>&UBODY
</body></html>
The Workflow Signature Required Mail message has the following message attributes.
The values are drawn from the message definition associated with a notification
activity.
DUE_DATE The date by which a response is required, specified in the
notification activity.
CLICK_HERE_RESPONSE The content of the HTML tag that a recipient would click
on to access the Notification Details page to respond to a
notification. This attribute is used only for HTML email
notifications.
You can customize the boilerplate text that appears in the body of the Workflow
Signature Required Mail message, where attributes preceded by an ampersand (&) are
token substituted with runtime values when the notification is sent.
The boilerplate text for a plain text message body is as follows:
Oracle Workflow Notification
&TIMEZONE
Notification Details:
&HEADER
&BODY
&HISTORY
You can customize the boilerplate text that appears in the body of the Workflow
Signature Warning Mail message, where attributes preceded by an ampersand (&) are
token substituted with runtime values when the notification is sent.
The boilerplate text for a plain text message body is as follows:
Oracle Workflow Notification
&TIMEZONE
&COMMENT
&HEADER
&BODY
You can customize the boilerplate text that appears in the body of the Workflow Secure
Mail Content message, where attributes preceded by an ampersand (&) are token
substituted with runtime values when the notification is sent.
The boilerplate text for a plain text message body is as follows:
Notification &NOTIFICATION
You can customize the boilerplate text that appears in the body of the Workflow Open
Mail (More Information Request) message, where attributes preceded by an ampersand
(&) are token substituted with runtime values when the notification is sent.
The boilerplate text for a plain text message body is as follows:
Question: &QUESTION
&RESPONSE
______________________End of Response Template______________________
Notification Details:
&HEADER
&BODY
&HISTORY
<P>
<P>Question: <B>&QUESTION</B>
<P><B>Please click on the following link to automatically
generate an E-mail response for this question. Before
sending the E-mail response, ensure desired comments within
quotes.</B>
<P>&MAILTO
<P><B>Notification Details:</B>
<P>&HEADER
<P>&BODY
<BR>
Question: <B>&QUESTION</B>
<P><B>Please click on the following link to automatically
generate an E-mail response for this question. Before
sending the E-mail response, ensure desired comments within
quotes.</B>
<P>&MAILTO
<P>&HISTORY
</BODY>
</HTML>
Question: &QUESTION
&RESPONSE
______________________End of Response Template______________________
Notification Details:
&BODY
&HISTORY
Note: You can use the Open Notification (More Information Request)
The response instructions in the plain text message body describe how to reply
manually using the templated response method. This message is used for notifications
sent to performers with a notification preference of MAILATTH. The HTML-formatted
message body includes a link called "Click here to respond" which lets users access the
notification in the Notification Details Web page to respond to the request for
information. This message is used for notifications sent to performers with a notification
preference of MAILHTML or MAILHTM2, and is also attached to notifications sent to
performers with a notification preference of MAILATTH.
The Workflow More Information Request (Outlook Express) message has the following
message attributes. The values are drawn from the message definition associated with a
notification activity.
DUE_DATE The date by which a response is required, specified in the
notification activity.
CLICK_HERE_RESPONSE The content of the HTML tag that a recipient would click
on to access the Notification Details page to respond to a
request for more information. This attribute is used only
for HTML email notifications.
You can customize the boilerplate text that appears in the body of the Workflow More
Information Request (Outlook Express) message, where attributes preceded by an
ampersand (&) are token substituted with runtime values when the notification is sent.
The boilerplate text for a plain text message body is as follows:
Oracle Workflow Notification
&TIMEZONE
______________________Start of Response Template______________________
Question: &QUESTION
&RESPONSE
______________________End of Response Template______________________
Notification Details:
&HEADER
&BODY
&HISTORY
You can customize the boilerplate text that appears in the body of the Workflow Invalid
Open Mail (More Information Request) message, where attributes preceded by an
ampersand (&) are token substituted with runtime values when the notification is sent.
The boilerplate text for a plain text message body is as follows:
Remarks: &MAIL_EXP_VALUES
______________________Start of Response Template______________________
Question: &QUESTION
&RESPONSE
______________________End of Response Template______________________
Notification Details:
&HEADER
&BODY
&HISTORY
You can customize the boilerplate text that appears in the body of the Workflow More
Info Answered Mail message, where attributes preceded by an ampersand (&) are token
substituted with runtime values when the notification is sent.
The boilerplate text for a plain text message body is as follows:
You earlier received a more information request for notification
mentioned below. That request is now answered, and no longer
requires your response. You may simply delete it along with this
message.
Notification Details:
Notification ID : &NOTIFICATION
Question : &QUESTION
From : &FROM
The boilerplate text for the plain text message body is as follows:
The notification with the ID of &NOTIFICATION_ID experienced
problems when attempting to dispatch an email notification
to the role &ROLE. Subsequently the notification preference
for the following users has been set to DISABLED. Please
correct the issue and re-enable their notification preference.
------------------------------------------------------------------------
--------
&UPDATED_USER_REPORT
The boilerplate text for the plain text message body is as follows:
The notification with the ID of &NOTIFICATION_ID experienced
problems when attempting to dispatch an email notification
to the role &ROLE of the below specified email address or
addresses. Please correct these email addresses or remove
them from the role's email address list if they are invalid,
and then stop and restart the notification mailer. Oracle
Workflow will not attempt to send any further notifications
to these addresses until the notification mailer is restarted.
------------------------------------------------------------------------
--------
&USER_INVALID_EMAIL
• If you want to use different character encoding instead, then you can specify
the override character encoding in the Character Encoding Configuration page.
• If the Reset NLS parameter is selected at the notification mailer level and is not
overridden at the message level, or if the #WFM_RESET_NLS message attribute is set
to Y at the message level, then the notification mailer encodes each notification
message with character encoding according to the notification recipient's preferred
language.
• By default, the notification mailer uses the following logic to determine the
character encoding for the message.
• If the notification recipient has specified both a preferred language and a
preferred territory, then the notification mailer uses the character encoding
listed in the WF_LANGUAGES table for that language and territory.
• If you want to use different character encoding instead, then you can use the
Character Encoding Configuration page to specify the override character
encoding for each language installed in your database. In this case the
notification mailer uses the override character encoding configured for the
notification recipient's preferred language.
The Character Encoding Configuration page also lets you review and update the Reset
NLS parameter setting for each notification mailer that you have configured. Any
changes you make in this page will be reflected in the notification mailer configuration
wizard in the Workflow Manager component of Oracle Applications Manager as well.
2. The page displays the default character encoding used when the Reset NLS
parameter is deselected at the notification mailer level and is not overridden at the
message level, or when the #WFM_RESET_NLS message attribute is set to N at the
message level. Select the override character encoding that you want to use instead.
3. Next, the page displays the default character encoding used for each installed
language when the Reset NLS parameter is selected at the notification mailer level
and is not overridden at the message level, or when the #WFM_RESET_NLS message
attribute is set to Y at the message level. Select the override character encoding that
you want to use for each language instead.
4. Finally, the page displays the Reset NLS parameter for each notification mailer that
you have configured. Deselect this parameter if you want a notification mailer to
use the same character encoding for all notification messages. Select this parameter
if you want the notification mailer to encode each notification message with
character encoding according to the notification recipient's preferred language. Any
changes you make in this page will be reflected in the notification mailer
configuration wizard in the Workflow Manager component of Oracle Applications
Manager as well.
5. Select Apply to save your changes. You can also select Reset to revert to the last
saved values.
6. In Oracle Applications Manager, stop and restart the service component container
named Workflow Mailer Service for the updated character encoding to take
effect. See: Service Components, page 7-7.
Related Topics
Notification Mailer Configuration Wizard, page 7-36
Notification Mailer Attributes, Oracle Workflow Developer's Guide
The following table shows the menu that corresponds to the Workflow Mailer URL
Access Tester page.
The Notification Search page is seeded on the menu for the Workflow Administrator
Web Applications responsibility by default. You can also add this function to other
responsibilities from which you want users to be able to search for notifications. For
example, if you want users with the Workflow User Web Applications responsibility to
have access to the Notification Search page, you can add this function to the
FND_WFUSER (Workflow User) menu with a prompt such as Notification Search.
A user must have workflow administrator privileges to access other users' notifications
in the Notification Search page. If a user does not have administrator privileges, that
user can only search for and access his or her own notifications. Workflow
administrator privileges are assigned in the Workflow Configuration page. See: Setting
Global User Preferences, page 2-16.
The Workflow Mailer URL Access Tester page is an optional feature that is not seeded
on the menu for any Oracle Workflow responsibility. If you want users to access this
page, you must first add either the Workflow Mailer URL Access Test Function or the
Workflow Mailer URL Access Test Menu to the menu for a responsibility assigned to
those users.
Step 11: Setting the WF: Notification Reassign Mode Profile Option
You can use the WF: Notification Reassign Mode profile option to control which
reassign modes are available to users. Oracle Workflow provides the following reassign
modes.
• Delegate - This mode lets users give another user authority to respond to a
notification on their behalf, while still retaining ownership of the notification
themselves. For example, a manager might delegate all vacation scheduling
approvals to an assistant.
• Transfer - This mode lets users give another user complete ownership of and
responsibility for a notification. For example, users might select this option if they
should not have received a certain notification and they want to send it to the
correct recipient or to another recipient for resolution. A transfer may have the
effect of changing the approval hierarchy for the notification. For example, a
manager might transfer a notification about a certain project to another manager
who now owns that project.
You can specify which reassign modes users can select by setting the WF: Notification
Reassign Mode profile option to one of the following values.
• Reassign - This setting provides users access to both the Delegate and Transfer
reassign modes. With this setting, the Advanced Worklist, the Personal Worklist,
and the Response section of the Notification Details page display a Reassign button.
Users can select this button to navigate to a Reassign page that lets them choose to
either delegate or transfer the notification to another user. The Reassign setting is
the default value for the WF: Notification Reassign Mode profile option.
• Delegate - This setting provides users access only to the Delegate reassign mode.
With this setting, the Advanced Worklist, the Personal Worklist, and the Response
section of the Notification Details page display a Delegate button in place of the
Reassign button. Users can select the Delegate button to navigate to a Reassign page
that only lets them delegate the notification to another user.
• Transfer - This setting provides users access only to the Transfer reassign mode.
With this setting, the Advanced Worklist, the Personal Worklist, and the Response
section of the Notification Details page display a Transfer button in place of the
You can set the WF: Notification Reassign Mode profile option in the System Profile
Values window. This profile option can be set at site, application, responsibility, and
user levels. The internal name for this profile option is FND_NTF_REASSIGN_MODE.
Note: Users can access the Worklist pages from different contexts. For
example, if users navigate to the Worklist pages from the Oracle E-
Business Suite home page or from a Notification Detail Link attachment
to an email notification, no responsibility context is set. If users
navigate to the Worklist pages from within another Oracle E-Business
Suite product, then the context is set according to the responsibility
through which the pages were accessed. Consequently, if you set the
WF: Notification Reassign Mode profile option at responsibility level,
that setting applies only when users access the Worklist pages through
the corresponding responsibility. Check how users access the Worklist
pages in your Oracle E-Business Suite installation, and ensure that you
set the WF: Notification Reassign Mode profile option for all levels
needed for the reassign modes you want to enforce.
Note: The WF: Notification Reassign Mode profile option does not
affect a user's ability to transfer a request for more information about a
notification to another user. Transfer mode is the only mode in which a
user can reassign a request for more information to another user. The
WF: Notification Reassign Mode profile option controls only the modes
available for reassigning the original notification.
Related Topics
Overview of Setting User Profiles, Oracle E-Business Suite Setup Guide
To View Notifications from the Advanced Worklist, Oracle Workflow User's Guide
To View Notifications from the Personal Worklist, Oracle Workflow User's Guide
To View the Details of a Notification, Oracle Workflow User's Guide
To Reassign a Notification to Another User, Oracle Workflow User's Guide
Step 12: Setting the WF: Disable Reassign to Submitter Profile Option
You can use the WF: Disable Reassign to Submitter profile option to specify whether a
notification recipient can reassign the notification to the following users:
• The process owner who initiated the workflow
The default value is No, allowing such reassignments. To help prevent users from
responding to their own transactions or requests, you can disable such reassignments
by setting the profile option to Yes.
Note: This profile option does not apply to requests for more
information about a notification. Responding to a request for more
information is not subject to the same security concerns as responding
to the original notification, so a request for more information can be
transferred to the process owner or the from role, even if the WF:
Disable Reassign to Submitter profile option is set to Yes.
You can set the WF: Disable Reassign to Submitter profile option in the System Profile
Values window. This profile option can be set at site, application, responsibility, and
user levels. The internal name for this profile option is
WF_DISABLE_REASSIGN_SUBMITTER.
Related Topics
Overview of Setting User Profiles, Oracle E-Business Suite Setup Guide
To Reassign a Notification to Another User, Oracle Workflow User's Guide
Vacation Rules, Oracle Workflow User's Guide
Defining Vacation Rules for Users, page 6-7
Step 13: Setting the WF: Enable Bulk Notification Response Profile Option
You can use the WF: Enable Bulk Notification Response profile option to specify
whether users can respond to a group of notifications collectively from the Worklist and
Notification Search pages, without navigating to the Notification Details page for each
notification individually. If you enable bulk notification response by setting this profile
option to Yes, a Respond button appears on the Advanced Worklist, Personal Worklist,
Personal Worklist Simple Search, Personal Worklist Advanced Search, and
administrator Notification Search pages. If you set the profile option to No, the Respond
button is hidden, and users must always respond to each notification individually from
Note: Users can access the Worklist pages from different contexts. For
example, if users navigate to the Worklist pages from the Oracle E-
Business Suite home page or from a Notification Detail Link attachment
to an email notification, no responsibility context is set. If users
navigate to the Worklist pages from within another Oracle E-Business
Suite product, then the context is set according to the responsibility
through which the pages were accessed. Consequently, if you set the
WF: Enable Bulk Notification Response profile option at responsibility
level, that setting applies only when users access the Worklist pages
through the corresponding responsibility. Check how users access the
Worklist pages in your Oracle E-Business Suite installation, and ensure
that you set the WF: Enable Bulk Notification Response profile option
for all levels needed for the type of responses you want to enable.
Related Topics
Overview of Setting User Profiles, Oracle E-Business Suite Setup Guide
To View Notifications from the Advanced Worklist, Oracle Workflow User's Guide
Viewing Notifications from the Personal Worklist, Oracle Workflow User's Guide
Searching for Users' Notifications, page 6-1
To Respond to a Group of Notifications, Oracle Workflow User's Guide
Note: If the value specified for the profile option does not follow the
correct format, then Oracle Workflow uses the default size instead.
You can set the WF: Notification Pop-up Window Size profile option in the System
Profile Values window. This profile option can be set at site, application, responsibility,
and user levels. The internal name for this profile option is
WF_NTF_POPUP_WINDOW_SIZE.
Related Topics
Overview of Setting User Profiles, Oracle E-Business Suite Setup Guide
Accessing the Oracle Workflow Administrator Home Page, page 4-1
Accessing the Oracle Workflow Self-Service Home Page, Oracle Workflow User's Guide
To View Notifications from the Advanced Worklist, Oracle Workflow User's Guide
Viewing Notifications from the Personal Worklist, Oracle Workflow User's Guide
Related Topics
Overview of Setting User Profiles, Oracle E-Business Suite Setup Guide
By default, the WF: Enable Worklist Global Header Quick Actions profile option is set
to Y to display the quick action buttons. To hide the buttons, set the profile option to N.
You can set the WF: Enable Worklist Global Header Quick Actions profile option in the
System Profile Values window. This profile option can be set at site, application,
responsibility, and user levels. Users can also specify their own setting for this profile
option. The internal name for this profile option is
WF_ENABLE_WORKLIST_GLOBAL_HEADER_QUICK_ACTIONS.
Related Topics
Overview of Setting User Profiles, Oracle E-Business Suite Setup Guide
Getting Started, Oracle E-Business Suite User's Guide
2. Query the WF_RR_ITEM_TYPES lookup type with the meaning WF: Vacation
Rule Item Types in the Application Object Library application.
3. Define the item type you want as a new lookup code for this lookup type. Ensure
that you enter the item type internal name in the Code field exactly as the name is
defined in your database. See: Application Utilities Lookups and Application Object
Library Lookups, Oracle E-Business Suite Developer's Guide.
Note: This profile option does not apply to proxy user worklist access
Related Topics
Defining Vacation Rules for Users, page 6-7
Vacation Rules, Oracle Workflow User's Guide
Worklist Access, Oracle Workflow User's Guide
Managing Proxy Users, Oracle E-Business Suite Security Guide
2. A list of the users and roles within the selected partition. Oracle Workflow retrieves
these values from the WF_ROLE_LOV_VL view, which provides access to the roles
stored in the WF_LOCAL_ROLES table.
By default, these lists include all partitions and all users and roles defined in the
directory service. You can optionally configure the user list of values for these fields by
defining grants to restrict the partitions that appear in the first list and the users and
roles that appear in the second list.
The Oracle Workflow pages that contain fields with the two-part user list of values
include the following:
• Notification Details page - Any response fields for Respond attributes of type role
and Assignee field for Transfer Request for More Information option
• Request More Information page - Request More Information From: Any User field
• Vacation Rule: Response page - Assignee field and any response fields for Respond
• Administrator Notifications search page - Owner field, To field, and From field
If you define a grant that restricts the values in the Oracle Workflow user list of values,
then that grant controls the values available to the grantee in all these pages and fields.
The following table lists the objects that Oracle Workflow provides for use in
configuring the user list of values, as well as the generic object instance sets provided on
those objects.
&TABLE_ALIAS.
Workflow Directory Partition Generic Partition Instance Set ORIG_SYSTEM IN
(WF_PARTITION) (WF_PARTITION_ISET) (&GRANT_ALIAS.
PARAMETER1,
&GRANT_ALIAS.
PARAMETER2,
&GRANT_ALIAS.
PARAMETER3,
&GRANT_ALIAS.
PARAMETER4,
&GRANT_ALIAS.
PARAMETER5,
&GRANT_ALIAS.
PARAMETER6,
&GRANT_ALIAS.
PARAMETER7,
&GRANT_ALIAS.
PARAMETER8,
&GRANT_ALIAS.
PARAMETER9,
&GRANT_ALIAS.
PARAMETER10)
&TABLE_ALIAS.USER_NAME
Workflow Role LOV Generic Role LOV Instance IN
(WF_ROLE_LOV) Set (WF_ROLE_LOV_ISET) (SELECT USER_NAME FROM
WF_USER_ROLES
WHERE ROLE_NAME IN
(&GRANT_ALIAS.
PARAMETER1,
&GRANT_ALIAS.
PARAMETER2,
&GRANT_ALIAS.
PARAMETER3,
&GRANT_ALIAS.
PARAMETER4,
&GRANT_ALIAS.
PARAMETER5,
&GRANT_ALIAS.
PARAMETER6,
&GRANT_ALIAS.
PARAMETER7,
&GRANT_ALIAS.
PARAMETER8,
&GRANT_ALIAS.
PARAMETER9,
&GRANT_ALIAS.
PARAMETER10))
The Generic Partition Instance Set lets you grant access to specific originating system
partitions in the Oracle Workflow directory service, up to a maximum of ten, which is
the maximum number of parameters you can specify for a grant. The Generic Role LOV
Instance Set lets you grant access to specific roles in the Oracle Workflow directory
For more information about partitions, see: Setting Up a Directory Service for Oracle
Workflow, page 2-26.
Note: The list of partitions in the two-part user list of values can also
include the value All Employees and Users (
VIRTUAL_ORIG_SYS). This value represents the PER, FND_USR, and
PQH_ROLE originating system partitions, grouped together to make it
easier to search for roles within any of these three partitions. However,
you cannot use VIRTUAL_ORIG_SYS as a grant parameter to grant
access to these partitions. You must grant access to each of the PER,
FND_USR, and PQH_ROLE partitions directly.
If the generic instance sets do not meet your needs, you can also define your own
instance sets on these objects with predicates that define the access you want to grant.
Example 1
To grant access to specific originating system partitions in the Oracle Workflow
directory service, create a grant using the Generic Partition Instance Set. First, specify
appropriate security context information such as grantee and responsibility. Then
specify the following data context information:
• Object - Workflow Directory Partition
Example 2
To grant access to specific roles in the Oracle Workflow directory service, create a grant
using the Generic Role LOV Instance Set. First, specify appropriate security context
information such as grantee and responsibility. Then specify the following data context
information:
• Object - Workflow Role LOV
• Parameter 1 through Parameter 10 - The roles to which you want to grant access.
Example 3
To grant a supplier user access only to other supplier users from the same supplier, first
create an instance set on the Workflow Role LOV object with a predicate that defines
the available users. The following excerpt shows a sample predicate.
&TABLE_ALIAS.ORIG_SYSTEM = 'FND_USR'
AND &TABLE_ALIAS.ORIG_SYSTEM_ID IN
(SELECT PV2.FND_USER_ID
FROM PO_SUPPLIER_USERS_V PV2
WHERE PV2.PO_VENDOR_ID =
(SELECT PV3.PO_VENDOR_ID
FROM PO_SUPPLIER_USERS_V PV3
WHERE PV3.FND_USER_ID = FND_GLOBAL.USER_ID))
Then, create a grant with the supplier user as the grantee. In the data context
information, specify the Workflow Role LOV object, the instance set you created, and
the Workflow Role LOV Permission Set.
Example 4
To grant access only to Oracle E-Business Suite users who are not supplier users, first
create an instance set on the Workflow Role LOV object with a predicate that defines
the available users. The following excerpt shows a sample predicate.
&TABLE_ALIAS.ORIG_SYSTEM = 'FND_USR'
AND &TABLE_ALIAS.ORIG_SYSTEM_ID NOT IN
(SELECT PS.FND_USER_ID
FROM PO_SUPPLIER_USERS_V PS)
AND NOT EXISTS
(SELECT 1
FROM PO_SUPPLIER_USERS_V PV1
WHERE PV1.FND_USER_ID = FND_GLOBAL.USER_ID)
Then, create a grant with appropriate security context information, such as grantee and
responsibility. In the data context information, specify the Workflow Role LOV
object, the instance set you created, and the Workflow Role LOV Permission Set.
Example 5
To grant access only to users who are employees, first create an instance set on the
Workflow Role LOV object with a predicate that defines the available users. The
following excerpt shows a sample predicate.
&TABLE_ALIAS.ORIG_SYSTEM = 'PER'
AND &TABLE_ALIAS.PARTITION_ID = 1
Then, create a grant with appropriate security context information, such as grantee and
responsibility. In the data context information, specify the Workflow Role LOV
object, the instance set you created, and the Workflow Role LOV Permission Set.
Example 6
To grant access only to users who are not employees, not Oracle E-Business Suite users,
and not supplier users, first create an instance set on the Workflow Role LOV object
with a predicate that defines the available users. The following excerpt shows a sample
predicate.
Then, create a grant with appropriate security context information, such as grantee and
responsibility. In the data context information, specify the Workflow Role LOV
object, the instance set you created, and the Workflow Role LOV Permission Set.
Insert your custom predicate at the indicated place in the template, removing any
occurrences of &TABLE_ALIAS. For example, suppose you want to test the following
predicate from example 3.
For purposes of the test, you would remove the two occurrences of &TABLE_ALIAS
from this predicate as follows:
ORIG_SYSTEM = 'FND_USR'
AND ORIG_SYSTEM_ID IN
(SELECT PV2.FND_USER_ID
FROM PO_SUPPLIER_USERS_V PV2
WHERE PV2.PO_VENDOR_ID =
(SELECT PV3.PO_VENDOR_ID
FROM PO_SUPPLIER_USERS_V PV3
WHERE PV3.FND_USER_ID = FND_GLOBAL.USER_ID))
The second SQL template lets you verify which roles your predicate makes available
when the grantee chooses any specific partition - that is, any value other than All
Employees and Users - in the first part of the two-part user list of values.
SELECT *
FROM
(SELECT WU.NAME AS USER_NAME,
WU.DISPLAY_NAME,
WDP.ORIG_SYSTEM,
WU.EMAIL_ADDRESS,
WU.ORIG_SYSTEM_ID,
WU.PARTITION_ID
FROM WF_ROLE_LOV_VL WU,
WF_DIRECTORY_PARTITIONS WDP
WHERE WU.PARTITION_ID = WDP.PARTITION_ID
AND WU.PARTITION_ID <> 1
UNION ALL
SELECT WU.NAME AS USER_NAME,
WU.DISPLAY_NAME,
WU.ORIG_SYSTEM,
WU.EMAIL_ADDRESS,
WU.ORIG_SYSTEM_ID,
WU.PARTITION_ID
FROM WF_ROLE_LOV_VL WU
WHERE WU.PARTITION_ID = 1
) QRSLT
WHERE (ORIG_SYSTEM = '&PARTITION_CODE'
AND (
-- Custom predicate goes here
)
)
ORDER BY DISPLAY_NAME;
Insert your custom predicate at the indicated place in the template, removing any
2. Ensure that these users have valid passwords defined in Oracle Application Object
Library. See: Users Window, Oracle E-Business Suite Security Guide.
For more information, see: Overview of Single Sign-On Integration, Oracle E-
Business Suite Security Guide.
• The personal certificate itself, in the DER encoded binary X.509 format. The
certificate should be provided as a file with an extension of .cer.
• The root certificate of the certificate authority that issued the personal
certificate, as well as any intermediate certificates required for this type of
personal certificate.
• A URL for each root and intermediate certificate, specifying the location from
which the corresponding Certificate Revocation List (CRL) can be downloaded.
Note: You only need to load the root certificate for a particular
certificate authority, and the intermediate certificates for a
particular type of certificate, once. If you already loaded the root
and intermediate certificates required for a new personal certificate,
you can simply load the personal certificate without reloading the
others.
2. If you want to load several certificates at once, create a data file for the Workflow
Certificate Loader that specifies the location of the certificates to be loaded and the
users to whom they belong. The data file should be a text file containing one entry
for each root, intermediate, or personal certificate to be loaded.
All certificate entries in the file must appear in the order of the certification path,
beginning with the root certificate for the certificate authority, followed by any
intermediate certificates and then by the personal certificate. However, if the root or
intermediate certificates required for a particular personal certificate were loaded
previously, you do not need to reload them.
Each certificate entry must be a single line. For a root or intermediate certificate,
where <certificate_file> is the full path and file name specifying the location
of the certificate file, and <URL> is the location from which the corresponding
Certificate Revocation List (CRL) can be downloaded.
For a personal certificate, use the following format:
user=<user_name>; domain=U; filename=<certificate_file>
where <user_name> is the Oracle E-Business Suite user name of the user to whom
the certificate belongs, and <certificate_file> is the full path and file name
specifying the location of the certificate file.
You can also include comments in the data file. Start each comment line with a
number sign (#).
The following example shows a sample data file. Note that although the lines may
appear to wrap in this document, each certificate entry is a single line in the data
file.
#Root certificate for certificate authority myCA
user=CA; domain=CA; filename=/certs/myCA.cer;
crl_url=http://example.com/myCA.crl
#
#Personal certificate for user EXAMPLE
user=EXAMPLE; domain=U; filename=/certs/example.cer
3. To load several certificates at once using a data file, run the Workflow Certificate
Loader with the following command:
java oracle.apps.fnd.wf.DigitalSignature.loader.CertificateLoader
[-v] <user_name> <password> <connect_string> <data_file>
You can optionally specify the -v option to run the Workflow Certificate Loader in
verbose mode, displaying additional diagnostic information in the output.
Replace the variables with your parameters as follows:
• <user_name> - The user name of your Oracle E-Business Suite database
account.
• <connect_string> - The connect string for the database, including the host
name, TNS port number, and database system identifier (SID) in the following
format:
<host_name>:<port_number>:<database_SID>
• <data_file> - The full path and file name specifying the location of the data
file you created in the previous step.
For example:
4. To load a single certificate without using a data file, run the Workflow Certificate
Loader specifying the certificate information in the command line. For a root or
intermediate certificate, use the following command:
java oracle.apps.fnd.wf.DigitalSignature.loader.CertificateLoader
[-v] -s <user_name> <password> <connect_string> user=CA
domain=CA filename=<certificate_file> crl_url=<URL>
You can optionally specify the -v option to run the Workflow Certificate Loader in
verbose mode, displaying additional diagnostic information in the output.
Replace the variables with your parameters as follows:
• <user_name> - The user name of your Oracle E-Business Suite database
account.
• <connect_string> - The connect string for the database, including the host
name, TNS port number, and database system identifier (SID) in the following
format:
<host_name>:<port_number>:<database_SID>
• <user_name> - The Oracle E-Business Suite user name of the user to whom the
personal certificate belongs.
• <certificate_file> - The full path and file name specifying the location of
the certificate file.
• <URL> - The location from which the corresponding Certificate Revocation List
(CRL) for the root or intermediate certificate can be downloaded.
For example:
java oracle.apps.fnd.wf.DigitalSignature.loader.CertificateLoader
-s apps <password> myserv:4105:mySID user=EXAMPLE domain=U
filename=/certs/example.cer
Note: You can display a help message describing the usage of the
Workflow Certificate Loader by specifying the -h option with the
following command:
java oracle.apps.fnd.wf.DigitalSignature.loader.
CertificateLoader -h
• Unable to create certificate object from file - The data in the certificate file may
be corrupted. Check that the certificate is valid by double-clicking the certificate
file and viewing its status. Also, ensure that the certificate is stored in the DER
encoded binary X.509 format.
• FND USER does not exist - The user name specified in a certificate entry in the
data file is not defined as an Oracle E-Business Suite user. Ensure that the user
name is specified as either CA for a certificate authority or a valid Oracle E-
Business Suite user name for an individual user.
• Certificate already associated with another user - The certificate has already
been loaded to the database and assigned to a different user. If a certificate is
incorrectly assigned, the user to whom it belongs must revoke it and obtain a
new certificate instead.
• Certdatafile not in proper format - The data file for the loader does not follow
the required format. Ensure that the data file contains only certificate entries
and comments, each certificate entry is a single line containing the appropriate
arguments, and each comment line begins with a number sign (#).
• The Network Adapter could not establish the connection - The loader was
unable to connect to the database using the specified parameters. Ensure that
you specify the correct database user name, password, and connect string when
you run the loader.
• Illegal Argument Exception - The loader could not process the parameters
provided in the run command. Ensure that you specify the loader parameters in
the required format.
2. Move the file to the physical directory that your Web server's /OA_MEDIA/ virtual
directory points to.
2. Copy the .gif files to the physical directory that your Web server's /OA_MEDIA/
virtual directory points to, so that the Workflow Monitor can access them.
2. If you want to use custom queues for propagating events, set up your queues, page
2-188.
6. Synchronize event and subscription license statuses with product license statuses,
page 2-198.
8. You can optionally change the maximum cache size used in Business Event System
subscription processing, page 2-200.
9. You can optionally enable static function calls for custom PL/SQL functions, page 2-
201.
10. If you have event subscriptions that invoke business process execution language
(BPEL) processes, you can optionally specify the BPEL server, page 2-203.
You should recheck your setup whenever you make changes to your agents that affect
the physical implementation required for propagation. See: Agents, Oracle Workflow
Developer's Guide.
Note: Oracle Workflow sets the status of the local system to Enabled by
default. After you finish setting up the Business Event System, you can
update your global workflow preferences to set the system status that
you want for event processing. See: Setting Global User Preferences,
page 2-16.
Oracle Workflow provides scripts to help diagnose Business Event System processing
and retry failed events. See: Handling Business Event System Errors, page 2-204.
For example:
CREATE DATABASE LINK wf10g.example.com CONNECT TO
wfuser IDENTIFIED BY <password>
USING 'wf10g';
If you have multiple installations of Oracle Workflow on both the local database and the
remote database, and you want to use the same username and password to access both
systems, you can omit the CONNECT TO <user> IDENTIFIED BY <password>
clause. In this case, the database link uses the username and password of the user who
is connected to the database.
CREATE DATABASE LINK <database link name>
USING '<connect string>';
If you want to create a public database link available to all users, specify the parameter
PUBLIC.
CREATE PUBLIC DATABASE LINK <database link name> CONNECT TO
<user> IDENTIFIED BY <password>
USING '<connect string>';
To verify the names of your database links, use the following syntax:
SELECT db_link FROM all_db_links;
Setting Up Queues:
The Business Event System uses Oracle Advanced Queuing (AQ) to communicate event
messages between systems. You must associate a queue with each agent on a
Workflow-enabled system that you define in the Event Manager.
When you install Oracle Workflow, several standard queues are created automatically
for the standard Workflow agents. These queues all use either the standard
WF_EVENT_T structure or JMS Text messages as their payload type. See: Standard
Agents, Oracle Workflow Developer's Guide, Event Message Structure, Oracle Workflow
API Reference, and Mapping Between WF_EVENT_T and SYS.
AQ$_JMS_TEXT_MESSAGE, Oracle Workflow API Reference.
The following table lists the standard queues.
If necessary, you can change the default retention time set for consumed messages on
the standard Workflow queues, using the PL/SQL procedure DBMS_AQADM.
Alter_Queue. You must not change any other part of the setup of these queues.
You can also set up your own queues for event message propagation. You can either set
up queues manually, or use Oracle Enterprise Manager to perform this step. Oracle
Enterprise Manager allows workflow administrators to quickly and easily create and
administer database links, queue tables, queues, and queue propagation without
requiring knowledge of the SQL DDL commands. For more information, see the Oracle
For queues that should use the standard Workflow format, specify the queue
payload type as WF_EVENT_T. These queues can use the standard queue handler
provided with Oracle Workflow, WF_EVENT_QH. For queues that should use the
JMS Text message format, specify the queue payload as $AQ_JMS_TEXT_MESSAGE.
These queues can use the standard JMS queue handler provided with Oracle
Workflow, WF_EVENT_OJMSTEXT_QH. If you define a queue with a different
payload type, you must create a queue handler to translate between the standard
Workflow format and the format required by the queue. See: Standard APIs for a
Queue Handler, Oracle Workflow Developer's Guide.
You can also use the storage_clause parameter to specify the tablespace where
you want to create the queue table. You may want to specify a tablespace if you
expect a queue to be very large.
Oracle Workflow provides a sample script called wfevquc2.sql which you can
modify to set up your queues, as well as a sample script called wfevqued.sql which
you can modify to drop queues. These scripts are located on your server in the
Then restart your database to make this change effective. Be aware that
using this parameter may generate large trace files.
• The SQL_TRACE_LEVEL parameter lets you enable SQL tracing at various levels or
disable SQL tracing for the agent listener. You can specify the following trace level
values:
• -1 - SQL tracing is disabled
If you enable SQL tracing at a particular level, then the SQL Trace utility generates a
trace file at the location specified in the USER_DUMP_DEST parameter as listed in
the V$PARAMETER view. The file name for the trace file follows this format:
<INSTANCE>_ora_<PID>_WFAL_<componentId>_<timestamp>.trc
For example:
WF11G_ora_254_WFAL_10002_20100302.trc
Each time the agent listener processes a set of messages, as specified by the
Also, for both PL/SQL and Java agent listeners, in addition to the parameters in the
configuration wizard you can optionally set an internal agent listener parameter named
NAVIGATION_RESET_THRESHOLD. By default, when an agent listener starts processing
messages on an agent's queue, it determines the order in which it will navigate through
the waiting messages based on the message priorities, and then does not check for new
messages again until it has dequeued all the messages that were initially waiting on the
queue. You can use the NAVIGATION_RESET_THRESHOLD parameter to periodically
reset the navigation to include newly arrived messages, so that new high priority
messages are processed sooner. Specify the threshold value as follows:
• 0 - The agent listener does not reset its navigation until all initially waiting
messages have been processed. This option increases performance because the
queue is checked less frequently.
• 1 or higher - The agent listener resets its navigation to the FIRST_MESSAGE option
after dequeueing the specified number of messages. For example, if you set the
threshold value to 1, the agent listener resets its navigation after every message,
ensuring that new high priority messages are processed before any lower priority
messages that arrived earlier.
For more information about queue navigation options, see: Navigation of Messages in
Dequeuing, Oracle Streams Advanced Queuing User's Guide.
Service components must be hosted by a service component container. If you create
custom agent listener service components, you can assign them to the seeded container
for agent listeners.
A service component container is implemented as a Generic Service Management
(GSM) service. The seeded container for agent listeners is named Workflow Agent
Listener Service.
Based on the volume to be handled by the seeded container, you can also choose to
create your own custom containers as GSM services in Oracle Applications Manager. If
you create a custom GSM service in OAM, you can copy the service parameters from
the seeded Workflow Agent Listener Service to your new service in order to
specify how to run the new service.
Before agent listener service components can run, the container which manages them
must first be started. In order to run the seeded agent listeners, you should ensure that
the Workflow Agent Listener Service container is running using Oracle
Applications Manager. If you create your own custom containers in OAM for custom
service components, ensure that those containers are running as well.
Note: You can run a diagnostic test to verify the GSM services for
Oracle Workflow. See: Oracle Workflow Diagnostic Tests, page E-1.
Additionally, if the status of an agent listener service component
changes to Stopped with Error or System Deactivated, Oracle
Workflow posts a system alert to the System Alerts and Metrics page in
Oracle Applications Manager. See: System Alerts, Metrics, and Logs,
Oracle E-Business Suite Maintenance Guide.
See: Agents, Oracle Workflow Developer's Guide and Listen, Oracle Workflow API Reference.
2. At the prompts, enter the component ID for your agent listener service component,
the parameter ID for the parameter to set, and the value to assign to that parameter.
• An agent listener repeatedly attempts to process a message but rolls back the
transaction due to an error, and the number of attempts exceeds the queue's retry
limit.
You can run the Move Messages from Exception to Normal Queue of Workflow Agent
concurrent program (FNDWF_MOVE_MSGS_EXCEP2NORMAL) to transfer such messages
back to the agent's normal queue. This program helps enable mass reprocessing in case
of a large number of errors. Use Standard Request Submission to run the program,
specifying the inbound agent for which you want to transfer messages back to the
normal queue. After the program completes, run the appropriate agent listener to
reattempt normal processing for these event messages. See: Running Reports and
Programs, Oracle E-Business Suite User's Guide and Exception Handling, Oracle Streams
Advanced Queuing User's Guide and Reference.
If you want to use the standard WF_OUT and WF_JMS_OUT agents or custom agents
for event message propagation, ensure that you schedule propagation for those agents.
You do not need to schedule propagation for the WF_CONTROL,
See: Events, Oracle Workflow Developer's Guide and Event Subscriptions, Oracle Workflow
Developer's Guide.
2. Select the Synchronize Product License and Workflow BES License concurrent
program as the request to run. This program does not require any parameters. See:
Running Reports and Programs, Oracle E-Business Suite User's Guide.
3. When you finish modifying the print and run options to define the schedule for this
request, choose Submit to submit the request.
2. Select the Workflow Control Queue Cleanup concurrent program as the request to
run. This program does not require any parameters. See: Running Reports and
Programs, Oracle E-Business Suite User's Guide.
3. When you finish modifying the print and run options to define the schedule for this
request, choose Submit to submit the request.
You can run a diagnostic test to check that the Workflow control queue is properly
accessible. See: Oracle Workflow Diagnostic Tests, page E-1.
See: Business Event System Control Events, Oracle Workflow Developer's Guide, Standard
Agents, Oracle Workflow Developer's Guide, and Business Event System Cleanup API,
Oracle Workflow API Reference.
Changing the Maximum Cache Size for the Business Event System:
The Business Event System caches event, subscription, and agent definitions to enhance
performance during subscription processing. The default maximum size of the cache is
50 records. You can optionally increase the maximum cache size to reduce the database
queries performed by the Business Event System, or decrease the maximum cache size
The initial seeded versions of these packages include static function calls only for
seeded Oracle Workflow functions, such as the rule function WF_RULE.Default_Rule
and the queue handler APIs WF_EVENT_QH.Enqueue and WF_EVENT_QH.Dequeue.
You can use the wfbesfngen.sql script to add functions from other Oracle E-
Business Suite products or your own custom functions to these packages.
1. Run the wfbesfngen.sql script as follows:
sqlplus <user> @wfbesfngen <type> <name>
Enter password: <password>
• <name> - Specify the names of the events or agents with which the functions
you want to add are associated. You can specify one or more object names
For example:
sqlplus apps @wfbesfngen EVENTS oracle.apps.ap%,oracle.apps.ar%
Enter password: <password>
or:
sqlplus apps @wfbesfngen AGENTS WF_IN,WF_OUT,WF_CONTROL
Enter password: <password>
2. The script generates a file containing a new package body in a database directory
defined for PL/SQL file I/O. See My Oracle Support Knowledge Document
2525754.1, Using UTL_FILE_DIR or Database Directories for PL/SQL File I/O in Oracle
E-Business Suite Releases 12.1 and 12.2.
• For the EVENTS type, the script generates a new package body for the
WF_BES_DYN_FUNCS package in a file named WFBESDFNB<timestamp>.
pls.
• For the AGENTS type, the script generates a new package body for the
WF_AGT_DYN_FUNCS package in a file named WFAGTDFNB<timestamp>.
pls.
Review the file to verify that the package body was generated successfully. The
header of the file lists the object names for whose associated functions the package
body contains static function calls. Ensure that you keep backup copies of the files
containing your customized package bodies.
3. Compile the new package body in your database. You should perform this step
during a patching window or maintenance downtime when there is no Business
Event System activity and no agent listeners are running.
If the new package body does not compile successfully, you can edit the generated
file manually to correct the package body. Alternatively, if the generated package
body does not compile, you can revert back to the corresponding original package
body provided by Oracle Workflow in the following files:
If you drop a custom function from your database, you should edit the file containing
the corresponding customized package body to comment out the static function call for
that function, and then recompile the package body.
Note: The profile option value must end with a slash (/) in order to
form the final WSDL description URL correctly.
This profile option must be set at site level. See: Overview of Setting User Profiles,
Oracle E-Business Suite Setup Guide.
Replace <APPSuser> and <APPSpwd> with the user name and password for the
APPS user. The user name is usually apps. Replace <FND_schema> with the
ORACLE username that connects to Oracle Application Object Library data in
Oracle E-Business Suite, usually applsys. Replace <event_name> with the
internal name of the event whose instances have errors.
The script prompts you to select one of these actions:
• Abort - Abort subscription processing by dequeuing each event instance
without performing any further processing.
• Retry with Key - Reraise each event instance with only the event name and
event key.
• Retry with Key & Data - Reraise each event instance with only the event name,
event key, and event data.
• Retry with Key, Data, & Parameters - Reraise each event instance with the event
name, event key, event data, and parameters.
You can choose the level of information to provide to the Event Manager when
reraising the event instances. For example, if an error exists in the event data that
was originally provided, the event instances can be reraised with only the event
name and the event key, forcing the Event Manager to regenerate the event data
using the event's generate function. You can also attempt to correct the error before
reraising the event instances.
• wfntfrsp.sql - This script lets you abort or retry event subscription processing
Replace <event_name> with the internal name of the event whose instances have
errors.
The script prompts you to select one of these actions:
• Abort - Abort subscription processing by closing the error notification without
performing any further processing.
• Retry with Key - Reraise each event instance with only the event name and
event key.
• Retry with Key & Data - Reraise each event instance with only the event name,
event key, and event data.
• Retry with Key, Data, & Parameters - Reraise each event instance with the event
name, event key, event data, and parameters.
You can choose the level of information to provide to the Event Manager when
reraising the event instances. For example, if an error exists in the event data that
was originally provided, the event instances can be reraised with only the event
name and the event key, forcing the Event Manager to regenerate the event data
using the event's generate function. You can also attempt to correct the error before
reraising the event instances.
This chapter describes the architecture and configuration of security for Oracle
Workflow.
This chapter covers the following topics:
• Oracle Workflow Security
• Set global workflow preferences and their own individual user preferences.
• View and respond to any user's notifications through the Worklist pages.
• View and update any user's processes in the administrator Status Monitor.
• Define worklist flexfields rules and perform rule simulations. Access to worklist
flexfields rules functionality requires only an Oracle Workflow administrator
responsibility.
• Workflow users - Oracle E-Business Suite users who have an Oracle Workflow user
responsibility, can:
• Access the Oracle Workflow Self-service Home page.
• View and respond to their own notifications through the Worklist pages.
• View and respond to notifications for other users who have granted access to
their worklists.
• View their own processes in the self-service Status Monitor. Users who are
associated with the workflow administrator role can also reassign notifications
or cancel workflows in the self-service Status Monitor.
Additionally, administrators who manage Oracle Workflow must have the Oracle E-
Resources Protected
Oracle Workflow provides security to protect the following resources.
• Oracle Workflow Web pages - Oracle E-Business Suite users must log into Oracle E-
Business Suite before they can access Oracle Workflow Web pages.
• Oracle Workflow Builder - No login is required to run the Oracle Workflow Builder
development tool on a client PC. However, in order to view or save item type
definitions in the database using Oracle Workflow Builder, a developer must
provide the Oracle Workflow schema name and password.
• LDAP preferences, if you are integrating with Oracle Directory Services. LDAP
preferences include LDAP host, LDAP port, LDAP password, LDAP changelog
base directory, and LDAP user base directory. LDAP password values are masked
as asterisks in the display and are stored in encrypted form.
This chapter discusses the Oracle Workflow home page, where administrators can
centrally access the Web-based features of Oracle Workflow.
This chapter covers the following topics:
• Accessing the Oracle Workflow Administrator Home Page
2. To set your Oracle E-Business Suite general preferences, including language and
notification preferences, select Settings and then Preferences. See: Set Preferences,
Oracle E-Business Suite User's Guide.
• To view the complete list of all your notifications in the Advanced Worklist,
select the Full List button. The Full List button displays in parentheses the
number of open notifications in your worklist. See: To View Notifications from
the Advanced Worklist, Oracle Workflow User's Guide.
• To define vacation rules for yourself, select the Vacation Rules link. See: To
View and Maintain Vacation Rules, Oracle Workflow User's Guide.
• If your site is configured to grant proxy users worklist access with implicit
Oracle Workflow responsibility access, then a Worklist Access tip link appears.
To grant access to your worklist to another user, select this link. See: Granting
Worklist Access with Implicit Oracle Workflow Responsibility Access., Oracle
E-Business Suite Security Guide.
• If you have been granted access to another user's worklist and your site is
configured to grant proxy users worklist access with implicit Oracle Workflow
responsibility access, then a Switch User button appears. To view another user's
worklist, select this button and select the user whose worklist you want to view.
See: Acting as a Worklist Proxy User with Implicit Oracle Workflow
Responsibility Access, Oracle E-Business Suite Security Guide.
4. To view workflow definitions and run test workflow processes, select Developer
Studio in the top level menu. See: Testing Workflow Definitions Using the
Developer Studio, Oracle Workflow Developer's Guide.
5. To manage Business Event System events, subscriptions, systems, and agents, select
Business Events in the top level menu. See: Event Manager, Oracle Workflow
Developer's Guide.
6. To view the administrator version of the Status Monitor, select Status Monitor in
the top level menu. See: Accessing the Administrator Monitor, page 5-1.
7. To view notifications in the Worklist, select Notifications in the top level menu. See:
8. To set global workflow preferences, select Administration in the top level menu,
and then select the Workflow Configuration tab. See: Setting Global User
Preferences, page 2-16.
10. To access notifications belonging to another user, select Administration in the top
level menu, and then select the Notification Search tab. See: Searching for Users'
Notifications, page 6-1.
11. To review details about the electronic signatures requested or submitted for
notifications, select Administration in the top level menu, and then select the
Signature Evidence Store tab. See: Reviewing Electronic Signature Details, page 6-
10.
12. To configure the character encoding that notification mailers use to compose email
notifications, select Administration in the top level menu, and then select the
Character Encoding tab. See: Configuring Character Encoding for Notification
Mailers, page 2-160.
You can also use the Oracle Workflow Manager component of Oracle Applications
Manager as an additional administration tool to review and manage work items. See:
Oracle Workflow Manager Overview, page 7-1.
You can use the Retry Errored Workflow Activities concurrent program to retry
multiple errored activities for a particular item type at once. See: Retry Errored
Workflow Activities (FNDWFRET), page 9-5.
Additionally, Oracle Workflow provides a view called
WF_ITEM_ACTIVITY_STATUSES_V that lets you programmatically access workflow
status information. See: Oracle Workflow Views, Oracle Workflow API Reference.
1. Viewing Workflows in the Status Monitor, page 5-3
2. In the Workflows page, search for the workflows you want to review. The search
criteria are:
• Workflow Type - Select the workflow item type you want to review. The
display name for the workflow type you select populates the Workflow Type
field, and the internal name for the workflow type you select populates the
Type Internal Name field.
If you do not have workflow administrator privileges, you can only search for
workflows that you own. In this case, Oracle Workflow displays your name as a
non-editable value in the Workflow Owned By field.
• Item Key - Enter the item key that uniquely identifies the workflow you want to
review. You can enter a partial value to search for workflows whose item keys
begin with that value.
• User Key - Enter the user key that identifies the workflow you want to review.
You can enter a partial value to search for workflows whose user keys begin
with that value.
• Workflow Status - Choose the status of the workflows you want to review, or
choose Any Status to display workflows in any status.
• In Process - Workflows that do not have an end date (including errored
workflows)
• Error - Workflows that do not have an end date and have at least one
errored activity
• Workflow Started - Choose Today, This Week (last seven days), Last 2 Weeks
(last fourteen days), Last 30 Days, Last 60 Days, or Any Time to specify the start
date of the workflows you want to review. All the start date ranges include the
current date; for example, Last 2 Weeks includes today as well as the previous
thirteen days.
Note: You must enter at least one of the following criteria when
you search in order to limit the size of the results list.
• Workflow Type
• Workflow Owned By
You can also enter the following additional search criteria to search for workflows
by activity characteristics.
• Activity Status - Select an activity status to display workflows with one or more
activities in that status, or select Any Status to display workflows with activities
in any status. You can choose the following statuses:
• Active
• Complete
• Deferred
• Error
• Notified
• Suspended
• Waiting
• Waiting for Response From - Enter a role to display workflows with activities
that are waiting for a response from the specified recipient.
3. The results region displays the workflows that match your search criteria.
• To view the error details for an errored workflow, select the error icon or the
error link in the Status column.
• To send email to the owner of a workflow, select the user link in the Owned By
column.
• To view child workflows for a workflow, select the child icon in the Child
Workflows column.
4. Use the monitor buttons to drill down to additional information for a workflow.
• To review the activities executed within a workflow, select the workflow and
select the Activity History button.
• To view the status diagram for a workflow, select the workflow and select the
Status Diagram button.
• To view details for a workflow, including the workflow type definition and
current workflow attribute values, select the workflow and select the Workflow
Details button.
Related Topics
Accessing the Administrator Monitor, page 5-1
• To send email to the owner of a child workflow, select the user link in the Owned
By column.
Use the monitor buttons to drill down to additional information for a child workflow.
• To review the activities executed within a workflow, select the workflow and select
• To view the status diagram for a workflow, select the workflow and select the
Status Diagram button.
• To view details for a workflow, select the workflow and select the Workflow Details
button.
Related Topics
Accessing the Administrator Monitor, page 5-1
• To send email to the owner of a workflow, select the user link in the Owned By
column.
Specify the activity type and activity status of the activities you want to view. All
activity types and statuses are selected by default. To search for specific activities,
deselect any activity types and statuses you do not want to view. At least one activity
type and one activity status must be selected for a search to be performed.
• To view details about the definition and current status of an activity, select the
activity name link in the Activity column.
• To view the Notification Details page for a notification activity, select the details
icon in the Notification column.
• To send email to the performer of a notification, select the user link in the Performer
column.
If you have the appropriate workflow administrator privileges, you can use the activity
administration icons to perform administrative operations on notification or process
activities that are not yet complete.
Note: The reassign icon appears only for notification activities that
are not yet complete. Additionally, you cannot reassign a
notification from the Status Monitor if the Expand Roles option is
selected for the notification or if it is a voting notification that tallies
the recipients' responses. See: Voting Activity, Oracle Workflow
Developer's Guide.
• To suspend a process activity that is not yet complete, select the suspend icon in the
Suspend/Resume column. All further processing for the process is suspended until
the process is resumed.
Note: The suspend icon appears only for process activities that are
not yet complete.
Note: The resume icon appears only for process activities that are
suspended.
If you have the appropriate workflow administrator privileges, you can use the activity
administration buttons to perform administrative operations on any activities that are
not yet complete.
• To skip an activity and force the workflow to transition to the next activity, select
the activity and select the Skip button. In the Skip page, enter the result value to
assign to the activity if required.
Note: You can also use the Retry Errored Workflow Activities
concurrent program to retry multiple errored activities for a
particular item type at once. See: Retry Errored Workflow Activities
(FNDWFRET), page 9-5.
If you have the appropriate workflow administrator privileges and you are viewing a
workflow that is not yet complete, you can use the workflow administration buttons to
perform administrative operations on the workflow.
• To view the status diagram for the workflow, select the View Diagram button.
• To change the values of any item attributes, select the Update Attributes button. In
the Update Workflow Attributes page, enter the new values you want.
• To rewind the workflow to an earlier activity stage, select the Rewind button. In the
Rewind page, select the activity you want from the list of activities that the
Workflow Engine has reached. Oracle Workflow stops processing at the current
activity and resumes processing at the specified activity.
• To suspend the workflow, select the Suspend Workflow button. All further
processing for the workflow is suspended until the process is resumed, and all
subprocesses are suspended as well.
• To cancel the workflow, select the Cancel Workflow button. In the Cancel page,
select Apply. The Workflow Engine sets the status of the workflow to #FORCE, and
all processing for the workflow is canceled and cannot be restarted.
Process Title:
The process title appears in the upper left of the Current Status region and displays the
workflow process name, type, and user key. If no user key has been set, then the item
key is displayed instead. If you drill down into a subprocess in the process diagram, the
process title displays the subprocess name.
You can select the display size for the status diagram in the Workflow Configuration
page. See: Setting Global User Preferences, page 2-16.
The process diagram window provides graphical cues about the status of the process
and its activities.
• An activity icon may be highlighted with a colored box to indicate that it is in an
"interesting" state. The following table shows what state each color indicates.
• Any transition (arrow) that has been traversed appears as a thick green line, while
an untraversed transition appears as a thin black line.
• Click an activity icon in the diagram to select it and update the detail tab window to
display information about the activity.
• Click any empty space in the diagram to deselect the currently selected activity icon
and to refresh the detail tab window to display information about the current
process as a whole.
Usage Tab
• Current Location - Process display name/activity display name
Status Tab
• Current Location - Process display name/activity display name
Notification Tab
• Current Location - Process display name/activity display name
Administration Buttons:
If you have the appropriate workflow administrator privileges and you are viewing a
workflow that is not yet complete, you can use the administration buttons to perform
administrative operations on the workflow.
• To change the values of any item attributes, select the Update Attributes button. In
the Update Workflow Attributes page, enter the new values you want.
• To rewind the workflow to an earlier activity stage, select the Rewind button. In the
Rewind page, select the activity you want from the list of activities that the
Workflow Engine has reached. Oracle Workflow stops processing at the current
activity and resumes processing at the specified activity.
• To suspend the workflow, select the Suspend Workflow button. All further
processing for the workflow is suspended until the process is resumed, and all
subprocesses are suspended as well.
• To cancel the workflow, select the Cancel Workflow button. In the Cancel page,
select Apply. The Workflow Engine sets the status of the workflow to #FORCE, and
all processing for the workflow is canceled and cannot be restarted.
Related Topics
Accessing the Administrator Monitor, page 5-1
Viewing Responses
The Monitor Responses page shows information about notifications sent by a workflow
and responses from workflow participants. For example, you can use this page to view
individual responses to a voting activity. The page identifies the displayed workflow by
• To send email to the owner of a workflow, select the user link in the Owned By
column.
Specify the type and status of the notifications you want to view.
• Select the Response Notifications option to view response-required notifications,
the FYI Notifications option to view information-only (FYI) notifications, or both.
• Select the Closed Notifications option to view only closed notifications of the
selected type. Deselect this option to view both open and closed notifications.
• To send email to the recipient of a notification, select the user link in the Recipient
column.
• To view details about a notification and the recipient's response, select the details
icon in the View Response Details column.
• Respondent - The user who responded to the notification. To send email to the
respondent, select the user link.
• Original Recipient - The user to whom the notification was originally sent. If the
original recipient is different than the respondent, then the original recipient
reassigned responsibility for replying to the respondent. To send email to the
original recipient, select the user link.
• Notification Sent - The date and time when the notification was sent.
The Signature Details region specifies whether the notification required an electronic
signature, and if so, the signature type, either a password-based signature or a
certificate-based digital signature. For a notification that required a signature, the region
also displays the following information:
• Signature ID - The numerical identifier for the signature request. This information is
shown only for certificate-based signatures.
• Signature - The text string representing the signature created using the signer's
certificate. This information is shown only for certificate-based signatures.
• Creation Date - The date when the request for a signature was created.
• Signed Date - The date when the user submitted the signature.
The Additional Response Information region lists any further response values
requested in the notification in addition to the result response.
Related Topics
Accessing the Administrator Monitor, page 5-1
#WF_SIG_POLICY Attribute, Oracle Workflow Developer's Guide
Reviewing Electronic Signature Details, page 6-10
The Workflow Definition region displays the following information about the workflow
type:
• Internal Name - The workflow type internal name.
• Persistence Type - The persistence type, either Permanent if the runtime status
information is maintained indefinitely until it is specifically purged, or Temporary
if the runtime status information is maintained for a specified number of days after
the workflow completion date before it can be purged.
• Persistence Days - If the persistence type is Temporary, the number of days from
the time a workflow of this workflow type completes before its status audit trail can
be purged.
The Workflow Attributes region lists the names and values of the item attributes for the
workflow. For an attribute of type event, select the event message link to view the event
message details.
If you have the appropriate workflow administrator privileges and you are viewing a
workflow that is not yet complete, you can use the administration buttons to perform
administrative operations on the workflow.
• To view the status diagram for the workflow, select the View Diagram button.
• To change the values of any item attributes, select the Update Attributes button. In
the Update Workflow Attributes page, enter the new values you want.
• To rewind the workflow to an earlier activity stage, select the Rewind button. In the
Rewind page, select the activity you want from the list of activities that the
Workflow Engine has reached. Oracle Workflow stops processing at the current
activity and resumes processing at the specified activity.
• To suspend the workflow, select the Suspend Workflow button. All further
• To cancel the workflow, select the Cancel Workflow button. In the Cancel page,
select Apply. The Workflow Engine sets the status of the workflow to #FORCE, and
all processing for the workflow is canceled and cannot be restarted.
Related Topics
Accessing the Administrator Monitor, page 5-1
• Activity Type - The activity type, either Function, Notification, Event, or Process.
• Error Stack - Context information to help you locate the source of the error.
To view the status diagram for the workflow, select the View Diagram button.
If the Workflow Errors page shows only one errored activity, and you have the
appropriate workflow administrator privileges, you can use the activity administration
buttons to respond to the error.
• To reassign an errored notification activity, select the Reassign button. See: To
• To suspend an errored process activity, select the Suspend button. All further
processing for the process is suspended until the process is resumed.
• To resume an errored process activity that is suspended, select the Resume button.
Processing for the process is resumed and any activities that were transitioned to
while the process was suspended are now executed.
• To skip the errored activity and force the workflow to transition to the next activity,
select the Skip button. In the Skip page, enter the result value to assign to the
activity if required.
Note: You can also use the Retry Errored Workflow Activities
concurrent program to retry multiple errored activities for a
particular item type at once. See: Retry Errored Workflow Activities
(FNDWFRET), page 9-5.
You can also grant access to multiple item types, up to a maximum of ten,
which is the maximum number of parameters you can specify for a grant. For
example, the following excerpt shows a sample predicate for granting access to
ten item types:
&TABLE_ALIAS.ITEM_TYPE = &GRANT_ALIAS.PARAMETER1
OR &TABLE_ALIAS.ITEM_TYPE = &GRANT_ALIAS.PARAMETER2
OR &TABLE_ALIAS.ITEM_TYPE = &GRANT_ALIAS.PARAMETER3
OR &TABLE_ALIAS.ITEM_TYPE = &GRANT_ALIAS.PARAMETER4
OR &TABLE_ALIAS.ITEM_TYPE = &GRANT_ALIAS.PARAMETER5
OR &TABLE_ALIAS.ITEM_TYPE = &GRANT_ALIAS.PARAMETER6
OR &TABLE_ALIAS.ITEM_TYPE = &GRANT_ALIAS.PARAMETER7
OR &TABLE_ALIAS.ITEM_TYPE = &GRANT_ALIAS.PARAMETER8
OR &TABLE_ALIAS.ITEM_TYPE = &GRANT_ALIAS.PARAMETER9
OR &TABLE_ALIAS.ITEM_TYPE = &GRANT_ALIAS.PARAMETER10
The following excerpt shows another alternative for a sample predicate for
granting access to ten item types:
&TABLE_ALIAS.ITEM_TYPE in (&GRANT_ALIAS.PARAMETER1,
&GRANT_ALIAS.PARAMETER2,
&GRANT_ALIAS.PARAMETER3,
&GRANT_ALIAS.PARAMETER4,
&GRANT_ALIAS.PARAMETER5
&GRANT_ALIAS.PARAMETER6,
&GRANT_ALIAS.PARAMETER7,
&GRANT_ALIAS.PARAMETER8,
&GRANT_ALIAS.PARAMETER9,
&GRANT_ALIAS.PARAMETER10)
• Create a grant using the instance set you created. First, specify appropriate
security context information such as grantee and responsibility. Then specify
the following data context information:
• Object - WORKFLOW_ITEMS
2. If you want to restrict access based on criteria specific to a particular functional area
using item attributes, perform the following steps.
• Create an instance set on the object WORKFLOW_ITEM_ATTR_VALUES with a
predicate that defines those criteria. For example, the following excerpt shows a
sample predicate defining criteria for HR data, using the
CURRENT_PERSON_ID item attribute:
&TABLE_ALIAS.NAME='CURRENT_PERSON_ID'
and EXISTS (SELECT 'Y' FROM per_people_f
WHERE person_id = &TABLE_ALIAS.TEXT_VALUE
AND TRUNC (SYSDATE) BETWEEN effective_start_date
AND effective_end_date)
• Create a grant using the instance set you created. First, specify appropriate
security context information such as grantee and responsibility. Then specify
the following data context information:
• Object - WORKFLOW_ITEM_ATTR_VALUES
Menu Setup
Before you can add Status Monitor access to your application, you must set up the
menu for the appropriate responsibility to include Status Monitor functionality through
Standard Access
Standard Status Monitor access provides loosely coupled access from an Oracle
Application Framework-based Web page or Oracle E-Business Suite form, to a Status
Monitor page within the full Oracle Workflow application. In this mode, the specified
Status Monitor page is displayed with the full Oracle Workflow menu, allowing users
to navigate out of the Status Monitor and perform other tasks within Oracle Workflow.
Locator links, also known as breadcrumbs, let users navigate from the Status Monitor
back to the calling application.
With standard access, users are fully authenticated. Only users with workflow
administrator privileges, as specified in the Workflow Configuration page, can view
workflows owned by others and perform administrative operations in the Status
Monitor. See: Setting Global User Preferences, page 2-16.
When you provide standard access to the Status Monitor from your application, you
can optionally specify a workflow item type and item key to query and specify which
page you want to initially display.
• If you specify both the item type and item key for a workflow, that workflow is
automatically queried in the Status Monitor. You can choose to initially display the
workflow in the main Workflows search page, the Activity History page in the
Administrator Monitor or Notification History page in the Self-Service Monitor, the
Status Diagram page, or the Monitor Responses page. If you provide an item type
and item key but do not specify an initial page, the workflow is initially displayed
in the Activity History page in the Administrator Monitor or Notification History
page in the Self-Service Monitor.
• If you specify only a workflow item type, the main Workflows search page is
displayed, and workflows of the specified type that were started within the last two
weeks are automatically queried.
• If you do not specify a workflow item type, the main Workflows search page is
displayed. No automatic query is performed.
When calling these methods, you must provide the following parameters to indicate
how you want to display the Status Monitor:
• pageContext - The OAPageContext of the calling page.
• firstPage - The Status Monitor page that you want to initially display (optional).
All method calls for standard access should be made from within an Oracle Application
Framework-based Web page.
Function Description
See: Overview of Form Development Steps, Oracle E-Business Suite Developer's Guide and
Menus Window, Oracle E-Business Suite Developer's Guide.
Menu Setup
If you use a standard access function within your responsibility, you must add the
menu containing that function to the top-level menu for your responsibility. The
WF_STATUS_MONITOR function is seeded on the Workflow Administrator
Application (WF_ADMINISTRATOR_APPLICATION) menu, and the
WF_SS_STATUS_MONITOR function is seeded on the Workflow Self-Service
Application (WF_SELF_SERVICE_APPLICATION) menu.
Note: You cannot add the Status Monitor functions to your menu
directly. To include these functions, you must add the Oracle Workflow
menu that contains the function you want.
Related Topics
Migrating to Guest Access Functions, page 5-35
Note: The workflow is only displayed if the specified item type, item
key, and administrator mode are valid. Otherwise, an error message is
displayed. The Workflow tabs are not displayed, so the user cannot
navigate to any other part of Oracle Workflow.
You must also set the administrator mode to determine whether to grant the user
privileges to perform administrative operations within the Status Monitor. You can
choose one of the following options:
• Never grant administrator privileges, regardless of whether the user belongs to the
workflow administrator role specified in the Workflow Configuration page. This
option is the default if you do not specify an administrator mode.
• Check whether the user belongs to the workflow administrator role specified in the
Workflow Configuration page and grant administrator privileges accordingly.
When calling these methods, you must provide the following parameters to indicate
how you want to display the Status Monitor:
• pageContext - The OAPageContext of the calling page.
• adminMode - Specify 'Y' to grant administrator privileges to the user accessing the
Status Monitor, 'N' to withhold administrator privileges from the user, or 'U' to
check whether the user belongs to the workflow administrator role specified in the
Workflow Configuration page and grant administrator privileges accordingly. The
default is 'N'.
• firstPage - The Status Monitor page that you want to initially display.
• HISTORY - Activity History page in the Administrator Monitor or Notification
All method calls for guest access should be made from within an Oracle Application
Framework-based Web page.
Example
The following code excerpt shows an example of how to provide guest access to the
Status Monitor in Java code. This example calls the getGuestAdvanceUrl() method in the
oracle.apps.fnd.wf.monitor.webui.Monitor class.
...
import oracle.apps.fnd.wf.monitor.webui.Monitor;
...
...
try
{
url = Monitor.getGuestAdvanceUrl(pageContext, itemType,
itemKey, adminMode, firstPage,
returnToLabel, retainCallingAM);
}
catch (MonitorURLException me)
{
// Handle not being able to obtain a valid redirectUrl for
// the parameters.
}
OAStaticStyledTextBean monitorLink =
(OAStaticStyledTextBean)findIndexedChildRecursive
("AdvancedMonitorLink");
monitorLink.setDestination(url);
...
} // end processRequest()
When calling these methods, you must provide the following parameters to indicate
how you want to display the Status Monitor:
• x_agent - This parameter is no longer used. Set this parameter to null.
You can use these URLs to provide access to the Administrator Monitor from a PL/SQL
application, for example, or include a URL in a workflow notification message to allow
a user to access the Administrator Monitor from the notification.
Function Description
When you call one of the guest access functions, you must pass the function the
following parameters:
• itemType - A valid workflow item type, determined by your application. The item
type and item key together identify the workflow process to display. You must
specify the same item type as you used to obtain the encrypted access key. You
should use the ICX_CALL.Encrypt() function to encrypt this value.
• itemKey - A valid item key, determined by your application. The item type and
item key together identify the workflow process to display. You must specify the
same item key as you used to obtain the encrypted access key. You should use the
ICX_CALL.Encrypt() API to encrypt this value.
• wa - An encrypted access key for a specified item type, item key, and administrator
mode combination. Call the PL/SQL function WF_FWKMON.
GetEncryptedAccessKey() to obtain this value for the item type, item key, and
administrator mode you want. See: GetEncryptedAccessKey, Oracle Workflow API
Reference.
Note: Because users are authenticated in guest access, you can call
the PL/SQL function WF_FWKMON.IsMonitorAdministrator() to
determine whether a the user has administrator privileges based on
the workflow administrator setting in the Workflow Configuration
page. If you use this function, you should use its result when
obtaining both the encrypted access key and the encrypted
administrator mode, in order to avoid a discrepancy between these
two values. See: IsMonitorAdministrator, Oracle Workflow API
Reference.
You can also choose to grant or withhold administrator privileges
in the Status Monitor by specifying the administrator mode as Y or
N, respectively, regardless of the workflow administrator setting in
the Workflow Configuration page.
• fExt - An external flag used within Oracle Workflow. Set this parameter to X.
itemKey := icx_call.encrypt('<your_item_key>');
adminMode := wf_fwkmon.isMonitorAdministrator('<user_name>');
wm := wf_fwkmon.getEncryptedAdminMode(adminMode);
wa := wf_fwkmon.getEncryptedAccessKey('<your_item_type>',
'<your_item_key>', adminMode);
FND_FUNCTION.EXECUTE(
FUNCTION_NAME => 'WF_G_ACTIVITIES',
OPEN_FLAG => 'Y',
SESSION_FLAG => 'Y',
OTHER_PARAMS =>
'itemType='||(wfa_html.conv_special_url_chars(itemType))
||'&'||'itemKey='||(wfa_html.conv_special_url_chars(itemKey))
||'&'||'wm='||(wfa_html.conv_special_url_chars(wm))
||'&'||'wa='||(wfa_html.conv_special_url_chars(wa))
||'&'||'retainAM=Y'
||'&'||'fExt=X'
);
See: Overview of Form Development Steps, Oracle E-Business Suite Developer's Guide and
Menus Window, Oracle E-Business Suite Developer's Guide.
Menu Setup
If you use a guest access function within your responsibility, you must add the menu
containing that function to the top-level menu for your responsibility. The
WF_G_ACTIVITIES and WF_G_DIAGRAM functions are seeded on the Workflow
Guest Monitor Application (WF_G_MONITOR_APPLICATION) menu, and the
WF_SSG_ACTIVITIES and WF_SSG_DIAGRAM functions are seeded on the Workflow
Guest Self-Service Monitor Application (WF_SSG_MONITOR_APPLICATION) menu.
Note: You cannot add the Status Monitor functions to your menu
directly. To include these functions, you must add the Oracle Workflow
menu that contains the function you want.
FND_WFMON_ADV WF_G_ACTIVITIES
Related Topics
Migrating to Standard Access Functions, page 5-27
Menu Setup
The Workflow Monitor Test Application is available in Oracle E-Business Suite, but it is
not seeded on any Oracle E-Business Suite menu. Before you can use this module, your
system administrator must add its menu to a top-level menu for a responsibility. The
menu for the Workflow Monitor Test Application module is named Workflow Monitor
Test Application (WFMON_TEST_APPLICATION). For example, you can add this
menu to the Workflow Administrator (New) menu (FND_WFADMIN_NEW), which is
associated with the Workflow Administrator Web (New) responsibility, or to the
Workflow User (New) menu (FND_WFUSER_NEW), which is associated with the
Related Topics
Accessing the Administrator Monitor, page 5-1
Accessing the Self-Service Monitor, Oracle Workflow User's Guide
Overview of Function Security, Oracle E-Business Suite Security Guide
Overview of Menus and Function Security, Oracle E-Business Suite Developer's Guide
3. In the Test "Standard" Access region, enter the test options you want. Each option
corresponds to a method parameter for the method in the oracle.apps.fnd.wf.
monitor.webui.Monitor class that is being simulated. See: Standard Access in
Java, page 5-25.
The test options include:
• Item Type - Optionally enter the internal name of a workflow item type to
automatically query in the Status Monitor.
• Item Key - Optionally enter an item key to automatically query in the Status
Monitor.
• First Page - Specify the Status Monitor page that you want to initially display.
• MAIN - Main Workflows search page
For example, you can set this URL as a destination link on an OAWebBean using
the call <OAFrameworkBean>.setDestination(String url).
The parameter retainAM=Y or retainAM=N is appended to the URL
depending on the value you specified for the Retain Calling AM option.
When you perform this action, Oracle Workflow retrieves a URL according to
the test options using Monitor.getAdvanceUrl( ) and displays that URL as a
hyperlink in a text message bean. To navigate to the Status Monitor, select the
link.
• Get Simple Monitor URL - Corresponds to a call to the Java method Monitor.
getSimpleUrl( ). This call returns a URL for the Self-Service Monitor page
specified by the test options in the following format, suitable for use within an
Oracle Application Framework application page:
/OA_HTML/OA.jsp?OAFunc=[parameters...]
For example, you can set this URL as a destination link on an OAWebBean using
the call <OAFrameworkBean>.setDestination(String url).
The parameter retainAM=Y or retainAM=N is appended to the URL
depending on the value you specified for the Retain Calling AM option.
When you perform this action, Oracle Workflow retrieves a URL according to
the test options using Monitor.getSimpleUrl( ) and displays that URL as a
hyperlink in a text message bean. To navigate to the Status Monitor, select the
link.
3. In the Test "Guest" Access region, enter the test options you want. Each option
corresponds to a method parameter for the method in the oracle.apps.fnd.wf.
monitor.webui.Monitor class that is being simulated. See: Guest Access in Java,
page 5-29.
The test options include:
• Item Type - Enter the internal name of the workflow item type to automatically
query in the Status Monitor.
• Item Key - Enter the item key to automatically query in the Status Monitor.
• First Page - Specify the Status Monitor page that you want to initially display.
• HISTORY - Activity History page in the Administrator Monitor or
Notification History page in the Self-Service Monitor
If you leave the First Page field blank, this option defaults to HISTORY.
• Administrator Mode - Specify a value to indicate whether the user should have
privileges to perform administrative operations when accessing the Status
Monitor.
• Y - The user is granted administrator privileges, regardless of whether the
user belongs to the workflow administrator role or not.
If you leave the Administrator Mode field blank, this option defaults to N.
For example, you can set this URL as a destination link on an OAWebBean using
the call <OAFrameworkBean>.setDestination(String url).
The parameter retainAM=Y or retainAM=N is appended to the URL
depending on the value you specified for the Retain Calling AM option.
When you perform this action, Oracle Workflow retrieves a URL according to
the test options using Monitor.getGuestAdvanceUrl( ) and displays that URL as a
hyperlink in a text message bean. To navigate to the Status Monitor, select the
link.
• Get Simple Monitor URL - Corresponds to a call to the Java method Monitor.
getGuestSimpleUrl( ). This call returns a URL for the Self-Service Monitor page
specified by the test options in the following format, suitable for use within an
Oracle Application Framework application page:
/OA_HTML/OA.jsp?OAFunc=[parameters...]
For example, you can set this URL as a destination link on an OAWebBean using
the call <OAFrameworkBean>.setDestination(String url).
The parameter retainAM=Y or retainAM=N is appended to the URL
depending on the value you specified for the Retain Calling AM option.
When you perform this action, Oracle Workflow retrieves a URL according to
the test options using Monitor.getGuestSimpleUrl( ) and displays that URL as a
hyperlink in a text message bean. To navigate to the Status Monitor, select the
link.
• Add the FND_WFADMIN_NEW menu to the menu for another existing or custom
responsibility and assign you that responsibility
Workflows Portlet
The Workflows portlet provides self-service information about workflows that you
own. The portlet displays all workflows owned by you that were started within the last
two weeks. You can select the workflow identifier link in the Workflow column to view
the notification history for a workflow in the Notification History page of the Self-
Service Monitor. The workflow identifier is the user key if one is specified for the
workflow, or the item key if no user key is specified.
• Add the FND_WFUSER_NEW menu to the menu for another existing or custom
responsibility and assign you that responsibility
2. Search for the notifications you want to access. The following search criteria are
available only if you have workflow administrator privileges:
• Notification ID - Enter the numerical notification ID for a specific notification.
Note that if you specify a notification ID, all other search criteria are ignored.
Note: Usually, the Owner role and the To role for a notification are
the same. However, you can specify different roles in the Owner
• Status - Select the status of the notifications. You can search for notifications
that are open, closed, or canceled, or to which an invalid reply was submitted,
or choose All to display notifications in any status.
• Workflow Type - Select the workflow item type to which the notifications
belong. The display name for the workflow type you select populates the
Workflow Type field, and the internal name for the workflow type you select
populates the Type Internal Name field.
• Type Internal Name - Enter the internal name of the workflow type to which
the notifications belong, if you want to enter the internal name directly instead
of selecting a value.
• Subject - Enter the subject line of the notifications. This field is case-sensitive.
You can use the percent sign (%) as a wildcard character to search for a partial
subject line value.
• Sent - Choose Today, This Week (last seven days), Last 2 Weeks (last fourteen
days), Last 30 Days, Last 60 Days, or Any Time to specify when the notifications
were sent. All the sent date ranges include the current date; for example, Last 2
Weeks includes today as well as the previous thirteen days.
• Due Date - Choose Last 2 Weeks (last fourteen days), This Week (last seven
days), Today, Next 2 Weeks (next fourteen days), Next 30 Days, Next 60 Days,
or Any Time to specify when the notifications should be completed. All the due
date ranges include the current date; for example, Next 2 Weeks includes today
as well as the next thirteen days.
• Priority - Select High, Normal, or Low as the notification priority, or choose All
to display notifications of any priority.
• Owner
• To
• From
3. To view and respond to a notification in the Notification Details page, select the
notification subject link in the Subject column, or select the notification and then
select the Open button. See: To View the Details of a Notification, Oracle Workflow
User's Guide.
To manage requests for more information about a notification, select the More
Information Request button in the Notification Details page. See: To Manage
Requests for More Information, page 6-5.
• The Delegate button appears if you only have access to delegate the
notifications.
• The Transfer button appears if you only have access to transfer ownership of
the notifications.
See: To Reassign a Notification to Another User, Oracle Workflow User's Guide and
Setting the WF: Notification Reassign Mode Profile Option, page 2-165.
5. If a workflow administrator has enabled the Respond button on this page, you can
respond to a group of notifications collectively. To do so, select the notifications you
want and select the Respond button. The notifications must all belong to the same
workflow type and message definition so that the response values you provide will
match all the notifications in the group.
6. To collectively close a group of FYI notifications, select the notifications you want
and select the Close button. In the confirmation page, choose Apply.
Note: You can only use the Close button to close notifications that
are open and do not require a response.
3. In the Request Information page, select the action you want to perform.
• Request More Information - Submit a request for more information about this
notification.
• To specify any user listed in the directory service, select the Any User
option, and select a type of user or role. Then select the user or role you
want within that type.
• Enter details about what information you are requesting in the Information
Requested field.
• To transfer the request to another user, select the Transfer Request for More
Information option. In the Assignee fields, select the type of user or role to
which you want to reassign the request. Then select the user or role you want
within that type. Enter any additional comments, and choose Submit.
• Deliver the notification to the original recipient's worklist as usual, with no further
action
Use the Vacation Rules administrator page to define rules for automatic notification
processing for your users. Each rule is specific to a role.
A vacation rule can apply to messages of all item types, to all messages belonging to a
specific item type, or to a specific type of message belonging to a specific item type.
Each time a notification is sent to a user, Oracle Workflow tests the notification against
that user's vacation rules. First Oracle Workflow checks whether the user has any active
rules for that specific message type. If not, it checks whether the user has any active
rules for that specific item type. Finally, it checks whether the user has any active rules
for messages of all item types. As soon as it finds a match, Oracle Workflow applies the
rule and discontinues any further rule matching.
If a rule reassigns a notification, Oracle Workflow performs rule matching again against
the new recipient role's list of rules. Oracle Workflow maintains a count of the number
of times it forwards a notification to detect perpetual forwarding cycles. If a notification
is automatically forwarded more than ten times, Oracle Workflow assumes that a
forwarding cycle has occurred and ceases executing any further forwarding rules,
marking the notification as being in error.
If a user receives a request for more information about another notification, Oracle
Workflow applies the same vacation rule that would apply for the message name and
message type of the original notification.
• For a reassign rule, Oracle Workflow transfers the request for more information to
the specified user with a comment that conveys the rule information. A request for
more information cannot be delegated, only transferred, so in this case Oracle
Workflow always transfers the request, even if the reassign rule is defined to use
delegate mode.
• For a respond rule, Oracle Workflow answers the request for more information
with a response informing the requester that the recipient of the request is absent.
• For a deliver rule, Oracle Workflow delivers the request for more information to the
recipient's worklist as usual.
Note: Vacation rules do not apply for responses to requests for more
information. If a user requested more information about a notification
and receives a response to that request, both the response and the
original notification remain in that user's own worklist.
2. Search for the role for which you want to define vacation rules.
The list of existing rules for the selected role includes rules defined by the
individual user as well as rules defined by an administrator for that user. A rule's
active or inactive status depends on whether the current date falls within the rule's
effective dates.
3. To update a rule, select the Update icon for that rule. See: To Create or Update a
Vacation Rule, Oracle Workflow User's Guide.
Note: You can optionally use the wfvcrdlt.sql script to delete end-
dated vacation rules for a user all at once instead of needing to
5. To create a new rule, select the Create Rule button. See: To Create or Update a
Vacation Rule, Oracle Workflow User's Guide.
Related Topics
Vacation Rules, Oracle Workflow User's Guide
Setting Up Notification Handling Options, page 2-170.
2. Search for the signatures you want to review. The search criteria are:
• Notification ID - Enter the numerical notification ID for a specific notification
that requires a signature. Note that if you specify a notification ID, all other
search criteria are ignored.
• Signature Policy - Select the policy that identifies the type of signature and
• Status - Select the status of the signatures you want to review, or select Any to
display signatures in any status.
• Requested - Oracle Workflow has requested a signature from a user by
sending a notification that requires a signature.
• Signed - The user has submitted a signature with the notification response.
• Verified - Oracle Workflow has verified that the signature was well formed,
that it was created with a private key corresponding to the offered signing
certificate, and that it is signing the plain text that it purports to sign.
• Authorized - Oracle Workflow has confirmed that the user who submitted
the signature is authorized to sign the notification by checking that the
certificate is assigned to a user who is a member of the recipient role for the
notification.
• Request Failed - The request for a signature was not successfully created.
An error may have occurred in notification processing.
• Signature Failed - The user attempted to submit a signature but did not
successfully complete the signature.
• Authorization Failed - Oracle Workflow could not confirm that the user
who submitted the signature was authorized to sign the notification,
because the certificate used to create the signature was not assigned to a
user who was a member of the recipient role for the notification.
• Validation Failed - Oracle Workflow could not confirm that the certificate
used to create the signature was valid at the time the signature was
received. The certificate may have been expired or revoked.
• Creation Date - Enter the date when the request for a signature was created.
• Signed Date - Enter the date when the user submitted the signature.
• Verified Date - Enter the date when Oracle Workflow confirmed that the
signature was well formed, that it was created with a private key corresponding
to the offered signing certificate, and that it signed the plain text that it
purported to sign.
• Validated Complete Date - Enter the date when Oracle Workflow successfully
validated the signature against a CRL issued by the certificate authority after
the time the signature was received.
Note: You must enter at least one of the following criteria when
you search in order to limit the size of the results list.
• Notification ID
• Requested Signer
• Creation Date
• Signed Date
• Verified Date
Related Topics
Setting Up for Electronic Signatures, page 2-181
#WF_SIG_POLICY Attribute, Oracle Workflow Developer's Guide
Electronic Signatures, Oracle Workflow User's Guide
You can use a query such as the following example to obtain the action source
information for a notification:
You can also obtain this information by running the wfmlrdbg.sql debugging script.
The output from the script displays the source for each action performed on the
notification. See: wfmlrdbg.sql, page 9-12.
Note: Worklist flexfields are separate from the key flexfields and
descriptive flexfields used in Oracle E-Business Suite. For information
about key and descriptive flexfields, see the Oracle E-Business Suite
Flexfields Guide.
Users must have access to the Personal Worklist to take advantage of a specialized
worklist view. See: Adding Worklist Functions to User Responsibilities, page 2-162.
To define a specialized worklist view using worklist flexfields, perform these steps:
1. Define a worklist flexfields rule that maps message attributes from one or more
workflow item types to worklist flexfields columns. See: Defining a Worklist
Flexfields Rule, page 6-22.
2. Optionally define a securing function to secure access to your new worklist view.
3. Create a Personal Worklist view that displays the columns mapped by a worklist
flexfields rule and that includes only notifications from the corresponding item
types. See: Creating a Personalized View for the Personal Worklist, page 6-29.
4. If you secured access to the view with a securing function, restart Oracle HTTP
Server. See: Restarting Oracle HTTP Server, page 6-30.
Some Oracle E-Business Suite products also provide seeded worklist flexfields rules and
Personal Worklist views. For more information, consult your product-specific
documentation or help.
• Number
• Form
• URL
• Date
Worklist flexfields rules cannot map message attributes of type lookup, role, document,
or event.
Note: Do not assign the same phase number to more than one rule
for the same item type. To ensure that the rules you want take
effect, assign a different phase number to each rule for an item
type.
• The customization level for a rule determines which worklist flexfields columns the
rule can map and whether you can update the rule definition. Oracle Workflow
uses the customization level to protect Oracle E-Business Suite seed data and to
preserve your customizations in an upgrade.
Rules seeded by Oracle E-Business Suite can have a customization level of Core or
Limit. For rules that you define, Oracle Workflow automatically sets the
customization level to User.
Core rules represent key Oracle E-Business Suite features. You cannot make any
changes to the rule definitions. Core rules use a different set of worklist flexfields
columns than limit and user rules, so core rules cannot override or be overridden by
limit and user rules. However, a core rule with a higher phase number can override a
core rule for the same item type with a lower phase number. Core rules use phase
numbers from 1 to 99.
Core rules can map the following worklist flexfields columns.
Text PROTECTED_TEXT_ATTRIBUTE1
PROTECTED_TEXT_ATTRIBUTE2
PROTECTED_TEXT_ATTRIBUTE3
PROTECTED_TEXT_ATTRIBUTE4
PROTECTED_TEXT_ATTRIBUTE5
PROTECTED_TEXT_ATTRIBUTE6
PROTECTED_TEXT_ATTRIBUTE7
PROTECTED_TEXT_ATTRIBUTE8
PROTECTED_TEXT_ATTRIBUTE9
PROTECTED_TEXT_ATTRIBUTE10
Number PROTECTED_NUMBER_ATTRIBUTE1
PROTECTED_NUMBER_ATTRIBUTE2
PROTECTED_NUMBER_ATTRIBUTE3
PROTECTED_NUMBER_ATTRIBUTE4
PROTECTED_NUMBER_ATTRIBUTE5
Form PROTECTED_FORM_ATTRIBUTE1
PROTECTED_FORM_ATTRIBUTE2
PROTECTED_FORM_ATTRIBUTE3
PROTECTED_FORM_ATTRIBUTE4
PROTECTED_FORM_ATTRIBUTE5
URL PROTECTED_URL_ATTRIBUTE1
PROTECTED_URL_ATTRIBUTE2
PROTECTED_URL_ATTRIBUTE3
PROTECTED_URL_ATTRIBUTE4
PROTECTED_URL_ATTRIBUTE5
Date PROTECTED_DATE_ATTRIBUTE1
PROTECTED_DATE_ATTRIBUTE2
PROTECTED_DATE_ATTRIBUTE3
PROTECTED_DATE_ATTRIBUTE4
PROTECTED_DATE_ATTRIBUTE5
Usually, core rules map message attributes that appear in a seeded worklist view within
a particular application. You can also include message attributes mapped by core rules
in your own worklist views. If a core rule does not meet your requirements, you can
choose not to include its message attributes in your views; however, Oracle Workflow
still stores the message attributes in the mapped columns.
Limit rules represent optional Oracle E-Business Suite features. You can update the
status of limit rules to Enabled or Disabled, but you cannot make any other changes to
the rule definitions.
User rules are the custom rules that you define. You can update any property in the rule
definitions.
Note: You cannot delete worklist flexfields rules. If you no longer want
a rule to take effect, disable the rule.
Limit rules and user rules share the same set of worklist flexfields columns. However,
limit rules use phase numbers from 1 to 99, while user rules use phase numbers of 100
or higher. Consequently, a limit rule can be overridden both by another limit rule for
the same item type with a higher phase number and by a user rule for the same item
type. However, a user rule can only be overridden by another user rule for the same
item type with a higher phase number. A limit rule cannot override a user rule.
Limit rules and user rules can map the following worklist flexfields columns.
Text TEXT_ATTRIBUTE1
TEXT_ATTRIBUTE2
TEXT_ATTRIBUTE3
TEXT_ATTRIBUTE4
TEXT_ATTRIBUTE5
TEXT_ATTRIBUTE6
TEXT_ATTRIBUTE7
TEXT_ATTRIBUTE8
TEXT_ATTRIBUTE9
TEXT_ATTRIBUTE10
Number NUMBER_ATTRIBUTE1
NUMBER_ATTRIBUTE2
NUMBER_ATTRIBUTE3
NUMBER_ATTRIBUTE4
NUMBER_ATTRIBUTE5
Form FORM_ATTRIBUTE1
FORM_ATTRIBUTE2
FORM_ATTRIBUTE3
FORM_ATTRIBUTE4
FORM_ATTRIBUTE5
URL URL_ATTRIBUTE1
URL_ATTRIBUTE2
URL_ATTRIBUTE3
URL_ATTRIBUTE4
URL_ATTRIBUTE5
Date DATE_ATTRIBUTE1
DATE_ATTRIBUTE2
DATE_ATTRIBUTE3
DATE_ATTRIBUTE4
DATE_ATTRIBUTE5
The message attributes mapped by limit rules may appear in a seeded worklist view
within a particular application. You can also include these message attributes in your
own worklist views. If a limit rule does not meet your requirements and you want to
override some of its mappings while allowing others to take effect, define a user rule
that maps the attributes you want to the relevant columns in place of the attributes you
do not need. If you no longer want any mappings from a limit rule to take effect, disable
that rule.
Define user rules for any message attributes you want that are not made available by
default through core or limit rules. While defining a rule, you can check whether its
column mappings conflict with any existing rules for the same item type, and whether
the new rule will override or be overridden by the conflicting rules. Review each
conflict to decide whether to accept the current overrides or update the rule definitions
to make a different rule take effect. See: To Create or Update a Worklist Flexfields Rule,
page 6-24.
When you finish defining a worklist flexfields rule, Oracle Workflow submits the
Denormalize Worklist Flexfields concurrent program (FNDWFDCC) once for each
workflow item type in the rule. The program stores the message attributes for any
currently open notifications from that item type in the mapped columns, except for
columns overridden by another rule. Subsequently, whenever Oracle Workflow sends a
new notification from an item type covered by the rule, the Notification System stores
the message attributes for the notification in the mapped columns.
To review the net set of message attributes that are currently available for a particular
item type, or for a particular message within an item type, perform a worklist flexfields
rules simulation. The simulation results also let you drill down to review any
overridden rules for each column and create or update rules if necessary. After you are
satisfied with the available attributes, use the simulation results to choose the columns
to include when you create a Personal Worklist view. See: To Simulate the Effect of
Worklist Flexfields Rules, page 6-27.
Example - Worklist Flexfields Rules
This example demonstrates how worklist flexfields rules operate, using the sample
Requisition item type. For more details about this sample item type, see: The
Requisition Item Type, Oracle Workflow Developer's Guide.
Also, suppose a limit rule named EXL02 is seeded for the Requisition item type with a
phase of 60 and the following column mappings:
• TEXT_ATTRIBUTE1 column : Requisition Description attribute
You prefer to display the Note attribute instead of the Requisition Description attribute,
and you also want to display the Monitor URL attribute. To do so, you define a user
rule named EXU03 for the Requisition item type with a phase of 110 and the following
column mappings:
• TEXT_ATTRIBUTE1 column : Note attribute
These rules combine to produce a net set of four message attributes that you can display
in a Personal Worklist view for the Requisition item type.
2. Search for the rules you want to display. The search criteria are:
• Display Name - Select the user-friendly name of the rule. You can enter a
partial value to search for rules whose display names contain that value. This
field is case-sensitive.
• Phase - Enter the phase number that determines whether the rule overrides or is
overridden by other rules.
• Message Attribute - Select a message attribute that the rule maps to a worklist
flexfields column. If you specified a workflow type, you can only select a
message attribute belonging to that workflow type. Otherwise, you can select a
message attribute belonging to any workflow type
• Column Name - Select a worklist flexfields column to which the rule maps a
message attribute.
You must enter at least one of the following criteria when you search to limit the
size of the results list.
• Rule Name
• Display Name
• Level
• Workflow Type
If you search only by the Level option or the Workflow Type option, you must
select a specific value for that option. You cannot use one of these criteria with the
Any value as your only search option.
The Workflow Type, Message Attribute, and Column Name search options only list
values for which a rule exists.
3. To update a rule, choose the update icon for that rule. See: To Create or Update a
Worklist Flexfields Rule, page 6-24.
4. To create a new rule, select the Create Rule button. See: To Create or Update a
2. Enter the internal name that uniquely identifies the rule and the user-friendly
display name for the rule.
• Limit - You can update the rule status to Enabled or Disabled, but you cannot
make any other changes to the rule definition. This level is used only for rules
seeded by Oracle E-Business Suite.
• User - You can update any property in the rule definition. This level is
automatically set for rules that you define.
5. Enter a phase number for the rule to specify the order in which rules for the same
workflow item type take effect. Rules with a higher phase number override rules
with a lower phase number. Rules seeded by Oracle E-Business Suite use phase
numbers from 1 to 99. You can assign your rules phase numbers of 100 or higher.
Note: Do not assign the same phase number to more than one rule
for the same item type. To ensure that the rules you want take
effect, assign a different phase number to each rule for an item
type.
7. Identify the application that owns the rule by entering the application name in the
Owner Name field and the application ID in the Owner Tag field.
9. Select the item types you want in the Available Filter Criteria list and move them to
the Selected Filter Criteria list.
Select an item type in either list to view its description.
If you perform a new search to show different item types in the Available Filter
Criteria list, Oracle Workflow still preserves the item types that you already added
to the Selected Filter Criteria list.
11. Optionally specify the data type of the message attributes to display in the
Available list.
12. Select the message attributes to map in the Available list and move them to the
Selected list. You can select a maximum of ten text attributes, five number
attributes, five form attributes, five URL attributes, and five date attributes.
The lists show the display name and data type for each message attribute. Select a
message attribute in either list to view in the Description field the display name and
internal name of the message to which the attribute belongs.
If multiple messages in the selected workflow item types have a message attribute
with the same internal name, display name, and data type, that message attribute
appears only once in the lists. In this case the Description field indicates that the
message attribute occurs in multiple messages
Note: Oracle Workflow treats all message attributes with the same
internal name and data type as the same attribute for purposes of
worklist flexfields column mapping. Although attributes with
different display names appear separately in the Available and
Selected lists, if you select at least one attribute with a particular
internal name and data type, all attributes that share that internal
name and data type will be included in the column mapping.
If you display message attributes of a different data type in the Available list,
Oracle Workflow still preserves the message attributes that you already added to
the Selected list.
14. To remove a message attribute from the column mappings for the rule, choose the
remove icon for that attribute.
15. To review any conflicts with other rules' column mappings, choose the Find
Conflicts button.
16. In the Find Worklist Flexfields Rule Map Conflicts page, review the columns that
other rules map to different attributes for the same workflow item types. The
Conflict field indicates whether the current rule overrides or is overridden by the
other rule, based on the rule phase numbers.
Note: Check that no two rules for the same item type have the same
phase number. To ensure that the rules you want take effect, each
rule for an item type must have a different phase number.
To resolve a conflict:
• If you want a worklist view to display the mapped attributes from all rules
simultaneously, change the column mappings for one of the rules to use
separate columns for the different attributes.
• If you no longer want any column mappings from a particular rule to take
effect, disable that rule.
• If you want to override some column mappings from a particular rule while
allowing others to take effect, either decrease the phase number for that rule or
increase the phase number for the overriding rule.
• If the appropriate rules already override any others, accept the existing rule
definitions.
17. To return to your rule definition, choose the Return to Pending Rule link.
18. If you need to change this rule definition to resolve conflicts, return to the previous
pages to make your changes.
• Perform a Limit and User Rules simulation to verify that any other message
attributes you require are available in worklist flexfields columns. If necessary, you
can adjust the rules' effect by enabling or disabling limit rules and creating,
updating, enabling, or disabling user rules.
• After you are satisfied with the net set of message attributes available for the item
type, use the simulation results to choose the columns to include when you create a
Personal Worklist view.
1. Use a Web browser to navigate to the Worklist Flexfields Rules Simulation page,
using a responsibility and navigation path specified by your system administrator.
See: Oracle Workflow Administrator Navigation Paths, page A-1.
• Select the customization level to review, either core rules or limit and user rules
together.
4. Review the list of mapped attributes and columns, which shows the net effect of the
enabled rules for the selected item type and customization level. If you specified a
message, the list shows only mapped attributes belonging to that message.
6. In the Find Worklist Flexfields Rule Conflicts page, review the columns that
overridden rules map to different attributes than the effective rule. The Conflict
field indicates that the effective rule overrides the other rules, based on the rule
phase numbers.
Note: Check that no two rules for the same item type have the same
phase number. To ensure that the rules you want take effect, each
rule for an item type must have a different phase number.
To resolve a conflict:
• If you want a worklist view to display the mapped attributes from all rules
simultaneously, change the column mappings for one of the rules to use
separate columns for the different attributes.
• If you no longer want any column mappings from a particular rule to take
effect, disable that rule.
• If you want to override some column mappings from a particular rule while
allowing others to take effect, either decrease the phase number for that rule or
increase the phase number for the overriding rule.
• If the appropriate rules already override any others, accept the existing rule
definitions.
7. To return to the simulation results, choose the Return to Worklist Flexfields Rule
Simulation link.
8. To update a rule, choose the update icon for that rule. See: To Create or Update a
Worklist Flexfields Rule, page 6-24.
9. To create a new rule, select the Create Rule button. See: To Create or Update a
Worklist Flexfields Rule, page 6-24.
2. Navigate to the Personal Worklist and choose the Personalize Page global link or
the Personalize region link for the "Customizable and searchable worklist" region.
In the Page Hierarchy Personalization page, select the Seeded User Views icon for
the "Table: Customizable and ..." item. In the Personalize Views page, select the
Create View button.
• Select the columns to display in the view, including the worklist flexfields
columns that are mapped to message attributes. Rename the columns as
appropriate to identify the attributes stored in them.
A view can include worklist flexfields columns that are mapped by different
• Specify the columns by which to sort the view, including worklist flexfields
columns if appropriate.
• To display only notifications from the relevant item types, add the Type
parameter or the Type Internal Name parameter to the search query for the
view, and specify the item type display name or internal name, respectively.
You can add multiple instances of these parameters to include multiple item
types in the view. In this case, select the Search results where each may
contain any value entered option.
If you do not limit the item types included in the view, then the view may
display notifications from other item types with blank values or unrelated
values in the worklist flexfields columns.
For more information, see: Create View, Update View, and Duplicate View Pages,
Oracle Application Framework Personalization Guide.
2. Define page features specific to your application, including branding, headers, and
footers. The subsidiary pages accessed from the Personal Worklist will have the
same features you define here for the top-level page.
3. Add the Personal Worklist by creating a new region in the page and setting the
Extends property to the following value:
/oracle/apps/fnd/wf/worklist/webui/FullWorklistPG.FullWorklistRN
The Personal Worklist code automatically provides a link to let users return from
the worklist pages to your application.
2. Select the region type to test, either Notification Details or Notification Summary.
• Content Type - Specify whether to test the notification content in HTML format
or as plain text.
5. Choose Go. Oracle Workflow displays the test URL to generate the notification
content that you specified.
6. Establish a browser session with the same context values as those that are set for the
notification mailer in the Framework User, Framework Responsibility, and
7. In this browser session, navigate to the test URL and verify that the generated
content appears correctly.
Note: The test URL provided by the Workflow Mailer URL Access
Tester page contains an nlsCalendar parameter that is set
according to the preferences of the recipient role for the notification
content that you are testing. When you navigate to the test URL,
your Oracle E-Business Suite session switches to the calendar
preference setting specified in this parameter, if it is different than
your current setting, and displays any pages you subsequently visit
according to that preference setting. To return to your own
calendar preference setting, log out of Oracle E-Business Suite after
using the Workflow Mailer URL Access Tester page, and then log
in again.
This chapter describes how to use the Oracle Workflow Manager component of Oracle
Applications Manager.
This chapter covers the following topics:
• Oracle Workflow Manager Overview
• Service Components
• Notification Mailers
• Agent Listeners
• Java Agent Listeners
• Web Services Outbound
• Background Engines
• Purging Workflow Data
• Workflow Control Queue Cleanup
• Active Work Items
• Deferred Work Items
• Suspended Work Items
• Errored Work Items
• Agents
• Queue Propagation
• Choose Site Map, choose the Administration tab, and then choose the Home link in
the Workflow region of the Site Map page. You can also choose one of the other
links in the Workflow region to navigate directly to the corresponding page within
Oracle Workflow Manager.
Navigation: Applications Dashboard > (pull-down menu) Workflow Manager > (B) Go
You can also use other features to help manage Oracle Workflow.
• Use Oracle Diagnostics Framework to run diagnostic tests that check the setup of
your Oracle Workflow installation and review debugging information.
• Use Oracle E-Business Suite Logging to review Oracle Workflow logs. Oracle
Workflow uses the Oracle E-Business Suite Logging framework to standardize and
centralize in the database logging activities related to the Oracle Workflow Business
Event System and Oracle XML Gateway.
These concurrent programs are scheduled to run every 24 hours by default. They do not
require any parameters. You can optionally cancel the default scheduled requests and
run the programs with a different schedule if you want to gather statistics at a different
frequency.
Each of these graphs and lists displays the date and time when its statistics were last
updated, as well as a refresh icon that you can select to refresh the statistics
immediately if necessary. However, note that if your Oracle E-Business Suite instance
contains very large volumes of workflow data, you may encounter delays or page
timeouts when refreshing the data.
The Workflow System status page shows the up, down, or unavailable summary status
of the following Workflow features:
• Notification Mailers - To manage notification mailer service components, click the
Notification Mailers status icon.
• Service Components - To manage all types of service components, click the Service
Components status icon.
For service component features, including notification mailer service components, agent
listener service components, and all types of service components grouped together, the
summary status icons represent the following statuses:
• Down - At least one service component of this type has a status of Stopped with
Error or System Deactivated. You should investigate the error.
To submit a concurrent request for a feature that runs as a concurrent program, choose
the program you want from the Submit Request For pull-down menu and click the Go
button. You can submit requests for the following programs:
• Background Engines
• Purge
Note: In Oracle Database 10g and later, you do not need to set the
AQ_TM_PROCESSES parameter.
Workflow Metrics
This region displays summary information about work items and Business Event
System agent activity.
Work Items
This graph displays the distribution of all work items with the following statuses:
Active, Deferred, Suspended, and Error.
• To show this graph if it is hidden, click the Show link.
• The graph header displays the date and time when the work item statistics were
last updated. To refresh this information, click the refresh icon. See: Gathering
Oracle Workflow Statistics, page 7-2.
• To view the distribution of item types within a status, either click the bar for that
status in the graph, or click the status name link.
• To view the number of work items with a particular status, position the mouse
pointer over the bar for that status in the graph.
Note: A work item can be counted in more than one status. For
example, all work items that do not have an end date are counted as
Active work items, including deferred, suspended, and errored work
items as well as running work items. Also, if an activity within an item
is deferred, and the work item as a whole is suspended, the work item
is included in the count for both the Deferred and Suspended statuses.
Consequently, the total of the counts for all the statuses is greater than
the actual number of work items.
Agent Activity
This graph displays the distribution of all event messages on Business Event System
agents with the following statuses: Ready, Waiting, Expired, Undeliverable, and Error.
• The graph header displays the date and time when the agent activity statistics were
last updated. To refresh this information, click the refresh icon. See: Gathering
Oracle Workflow Statistics, page 7-2.
• To view the number of event messages with a particular status, position the mouse
pointer over the bar for that status in the graph.
Related Links
This region provides links to other Oracle Workflow management features.
Configuration
Click the Service Components link to configure service components, including
notification mailers and agent listeners.
Click the Queue Propagation link to view database initialization parameters required
for queue propagation and a list of propagation schedules for Business Event System
agents.
Throughput
• Click the Work Items link to view the distribution of completed work items across
different item types.
• Click the Notification Mailers link to view the notification mailer throughput. This
graph shows the throughput of the notification mailers by displaying the
distribution of notifications in the WF_NOTIFICATIONS table with the following
statuses:
• Processed - Outbound notifications for which an email message has been sent
by a notification mailer service component.
• Waiting - Outbound notifications for which an email message has not yet been
sent.
• Click the Agent Activity link to view the distribution of event messages with
different statuses on different agents.
Service Components
The Generic Service Component Framework helps to simplify and automate the
management of background Java services. Service component containers and their
service components are run through Generic Service Management (GSM), which you
can control through Oracle Applications Manager (OAM).
A service component container is an instance of a service that manages the running of
the individual service components that belong to it. The container monitors the status of
its components and handles control events for itself and for its components. These
actions are recorded in a log for the container.
A service component is an instance of a Java program which has been defined
according to the Generic Service Component Framework standards so that it can be
managed through this framework. Currently, Oracle Workflow provides four service
component types: Workflow Mailer, Workflow Agent Listener, Workflow Java Agent
Listener, and Workflow Web Services Outbound.
Oracle Workflow provides several seeded service components of these types, within
seeded containers, to perform standard processing. You can optionally create additional
service components to perform custom processing. If you create custom service
components, you can either assign them to the seeded containers, or, based on the
volume to be handled by the seeded containers, you can also choose to create your own
custom containers.
All service components have certain attributes required by the Generic Service
Component Framework. General definition attributes for a component include the
component name, startup mode, container type, inbound agent, outbound agent, and
correlation ID. Detail attributes include the container that owns the component, the
maximum idle time for an on-demand component, maximum error count, number of
inbound and outbound processing threads, component log level, read timeout period,
minimum sleep time, maximum sleep time, error sleep time, and whether to close
connections when the read timeout period expires.
A service component can have one of three startup modes.
• Manual - You must manually start and stop the service component through
Workflow Manager. The component container does not start or stop its manual
service components.
All service components use the Oracle Applications GSM container type. A component
can have either an inbound agent to process inbound messages, an outbound agent to
process outbound messages, or both. An Oracle Advanced Queuing (AQ) correlation ID
can be assigned to a component to limit its processing to only messages marked with
that correlation ID.
Oracle Workflow provides three predefined containers in which you can create
components, the Workflow Mailer Service, the Workflow Agent Listener Service, and
the Workflow Document Web Services Service. For an on-demand service component,
you can specify the maximum amount of time that the service component can remain
idle before it is stopped by its container. A service component can have either one
inbound processing thread, to enable inbound processing, or none, to disable inbound
processing. A service component can have one or more outbound processing threads, to
enable outbound processing depending on the volume of outbound messages, or none,
to disable outbound processing. Some types of service components perform only
inbound processing or only outbound processing. For example, agent listeners only
process inbound event messages and consequently should always have an outbound
thread count of zero.
A diagnostic log is recorded for each component container, from the time the container
starts to the time it stops. When a container is restarted, a new log is begun. You can
view the log through Workflow Manager. Each log entry is marked with the container
ID, and, if applicable, with the ID of the service component that generated it. You can
specify the level of detail of the information you want to record for each component
container. You can also specify a separate log level for an individual service component
within the container. The log levels you can select, in order from most detailed to least
detailed, are as follows:
• 1 - Statement
• 2 - Procedure
• 3 - Event
• 5 - Error
• 6 - Unexpected
The default log level for both containers and service components is Error. This level is
the recommended setting for normal usage.
A processing thread for a service component runs in a loop in which it reads messages
from the queue associated with its assigned agent and then waits during a specified
amount of sleep time before checking the queue for messages again. The read timeout
period defines the amount of time the service component continues attempting to read
messages from the queue, after the last message has been dequeued, before timing out.
If another message is received before this time expires, that message is processed and
the timeout period begins again. If the timeout period expires and no more messages
have been received, the service component stops reading and its sleep time begins.
The minimum sleep time for a service component defines the minimum amount of time
during which the service component waits, after its read timeout period expires, before
it checks the queue for messages again. If a queue receives messages infrequently, you
can choose to increase the sleep time between read attempts when no messages are
received by setting a maximum sleep time greater than the minimum sleep time. In this
case, the service component initially waits for the minimum sleep time after it finishes
reading messages from its queue. If no messages are read in subsequent attempts, then
the sleep time between read attempts gradually increases until the maximum sleep time
is reached. Increasing the sleep time can help enhance performance if messages are
received infrequently. You can also set the maximum sleep time parameter to 0 (zero) to
indicate that the sleep time should not be increased. In this case, the service component
always waits for the minimum sleep time between read attempts.
The error sleep time for a service component defines the amount of time during which
the service component waits, after an error occurs, before it attempts to begin
processing again. Additionally, a service component processing thread can either close
its connections after its read timeout period expires, when its sleep time begins, or the
connections can remain open until the processing thread stops.
A service component may also have additional configuration parameters that are
specific to the type of processing it performs. For example, a notification mailer service
component has configuration parameters to specify the inbound and outbound email
servers it uses.
Among both the common and the type-specific configuration parameters, some
parameters can be refreshed dynamically while a service component is running. These
parameters are identified by a refresh icon in the configuration pages for the
component. For example, the component log level, inbound thread count, and
outbound thread count are refreshable parameters.
The control events you can perform for a service component include:
• Suspending a running service component, so that the threads stop processing but
connections are not closed
A service component may also have additional control commands that are specific to
the type of processing it performs. For example, Workflow Mailer components include
a command to launch summary notifications.
You can perform these control events manually at runtime by choosing the relevant
command for the component in the Service Components page. You can also schedule
single or repeating control events when you are configuring a service component.
A service component can have one of the following statuses.
• Not Configured - Some required configuration parameters for the component have
not been completed. The component cannot be started until its configuration is
complete.
• Suspended - The component's thread has stopped processing, but its connections
remain open. When a component is suspended, you can either resume its
processing or stop it altogether.
• Stopped with Error - The component reached the maximum number of errors
specified in its Max Error Count parameter and has stopped. The component
container will restart an automatic component in this status, or an on-demand
component in this status that has messages waiting to be processed.
• To verify that the statuses displayed for the service components in the list are
current, click the Verify All button.
• To edit a service component's configuration, select the service component and click
the Edit button. The steps to edit the configuration depend on the service
component type.
• To view the diagnostic log of the service component container in which this service
component is running, select the service component and click the View Log button.
The log includes log messages for this component and any other component
belonging to that container.
• To view details about a service component, either click the service component link
in the Name column, or select the service component and click the View Details
button. The information that is displayed depends on the service component type.
• To review the events that have been scheduled to control the running of the service
component, click the View Event History button. For each event, the Event History
page displays the event name, status, user who requested the event, component
status before the event was processed, date and time the event processing was
completed, container for the service component, container type, and any event
parameters for a refresh event. You can use this event history as an audit trail to
review who scheduled control events for the service component. The status of an
event may be Pending, Skipped, In Progress, Completed, or Error. In some cases, an
event may be skipped if the component is not in an appropriate status at the time
for which the event is scheduled. For example, a refresh event cannot be executed if
the component is stopped at the scheduled time.
• To delete a service component, select the service component and click the Delete
button. If the service component is currently active, you must stop it before you can
delete it.
• Resume
• Start
• Stop
• Suspend
• To manage the service instances for the container of a service component through
GSM, click the container link in the Container column.
• Workflow Java Agent Listener - Service components that process inbound messages
on Business Event System agents in the application tier.
Navigation: Applications Dashboard > (pull-down menu) Workflow Manager > (B) Go > Service
Components status icon > Create
• For Workflow Mailer service components only, to send test messages, click the Test
Mailer button. In the Test Notification Mailer page, select the recipient role to which
the messages should be sent, and click the Send Test Message button.
Oracle Workflow sends two test messages to the recipient role: one message with
content built using PL/SQL and one message with Oracle Application Framework
content. Check the email account for the recipient role to view the test messages and
reply to them with the Acknowledge response. If you did not implement inbound
email processing for this mailer, use the Worklist pages to respond to the test
messages after viewing the outbound messages in email. After you acknowledge
both test messages, Oracle Workflow sends a confirmation message to the same
recipient role to show that the notification mailer successfully processed the
inbound response emails.
If you do not receive the test messages or the response confirmation message, or if
the message content does not appear correctly, check the notification mailer setup,
including the mail servers and the mailer configuration parameters. In particular, if
the Oracle Application Framework content does not appear correctly, check the
Application Framework Agent and WF: Workflow Mailer Framework Web Agent
profile options, as well as the Framework User, Framework Responsibility,
Framework Application ID, and Framework URL Timeout parameters in the
• For Workflow Mailer service components only, to set an override address where
you want to send all outgoing email notifications, click the Set Override Address
button. Use an override address when you are testing workflow definitions or
mailer processing so that you can automatically receive all the test notifications at
one email address, instead of having to check or change each individual recipient's
email address. To ensure that the override address is accessible and that its use is
authorized, you must verify the request before the notification mailer can use the
address.
In the Set Override Address page, review the current override address, if any. Enter
the email address you want to set as the new override address, and choose Submit.
Then check the email account you specified for the verification email message.
In the Verify Override Address page, enter the verification code shown in the email
message, and choose Apply. If necessary, you can use the link provided in the
verification email message to navigate back to the Verify Override Address page.
You must log in to Oracle Applications Manager before you can access this page.
To remove the override address, navigate to the Set Override Address page and
choose the Clear Override Address button. The notification mailer then resumes
sending email notifications to the individual recipients' email addresses.
• To review the events that have been scheduled to control the running of the service
component, click the View Event History button. For each event, the Event History
page displays the event name, status, user who requested the event, component
status before the event was processed, date and time the event processing was
completed, container for the service component, container type, and any event
parameters for a refresh event. You can use this event history as an audit trail to
review who scheduled control events for the service component. The status of an
event may be Pending, Skipped, In Progress, Completed, or Error. In some cases, an
event may be skipped if the component is not in an appropriate status at the time
for which the event is scheduled. For example, a refresh event cannot be executed if
the component is stopped at the scheduled time.
• To view the diagnostic log of the Generic Service Management (GSM) service
component container in which this component is running, click the View Log
button. The log includes log messages for this component and any other component
• To change the values of the configuration parameters or the scheduled events, click
the Edit button and navigate to the appropriate page within the service component
configuration wizard.
• 2 - Procedure
• 3 - Event
• 4 - Exception
• 5 - Error
• 6 - Unexpected
You can also optionally specify the following service parameters for proxy settings. You
should set these parameters if components in this container need to use a proxy server
to access web content that is outside a firewall. For example, a mailer component may
need to access outside web content that is to be included in an email notification. The
Generic Service Component Framework uses the values you set in these service
parameters to set the relevant Java System Properties.
• SVC_PROXY_HOST - Specify the host machine for the proxy. The default value is
NONE.
• SVC_PROXY_PORT - Specify the port on which the proxy is listening. The default
value is NONE.
Note: If you use AutoConfig to specify proxy settings for your Oracle
E-Business Suite instance, then you do not need to set the proxy-related
service parameters here. In this case it is recommended that you
continue to use AutoConfig to manage your proxy settings.
Use the proxy-related service parameters only if you do not use a proxy
setup elsewhere, but you do require it for service components such as
workflow mailers or agent listeners.
For Workflow Mailer service components only, you can also set one additional
parameter that does not appear in the Edit Service Parameters field by default. The
IGNORE_BASE64_DECODE_ERRORS parameter lets you specify whether to ignore or
throw any BASE64 decoding errors that occur during response processing for Workflow
Mailer components. If this parameter is not specified, as is the default, or if it is set to
TRUE, then any BASE64 decoding errors are ignored. If you want to retain the decoding
errors, add this parameter to the list for the Workflow Mailer service component you
want, and set its value to FALSE. This parameter does not apply for any other type of
service component.
• 2 - Procedure
• 3 - Event
• 4 - Exception
• 5 - Error
• 6 - Unexpected
Note that the log level you set dynamically in the Service Status page applies only for
the duration of the current container session, and does not change the log level stored
for the container in the service parameters. To set the log level permanently, so that the
container starts with that log level in each new session, edit the value of the
SVC_CONTAINER_LOG_LEVEL service parameter in the Edit Service Parameters
page. See: Editing Service Parameters for a Container, page 7-16.
If the log level has been changed dynamically for the current session, the Service Status
page may not display the log level that is currently in effect for the container. However,
you can always review the current log level in the container log file by choosing View
Log in the Service Components page or the Component Details page.
Notification Mailers
A notification mailer is a Java program that performs email send and response
processing for the Oracle Workflow Notification System, using the JavaMail API. You
need to implement one or more notification mailers only if you want to have your
workflow users receive their notifications by email, as well as from the Worklist Web
pages.
Note: Oracle Alert also uses the Workflow Notification Mailer to send
and receive alert email messages. If you use Oracle Alert, ensure that
the configuration of the Workflow Notification Mailer meets your alert
requirements. See: Setup Steps, Oracle Alert User's Guide.
You can also optionally create additional notification mailer service components. For
example, you can create a notification mailer that processes only messages that belong
to a particular workflow item type, or instances of a particular message from a
particular item type. You can create additional mailers that process the same types of
message to increase throughput.
To ensure consistency in message handling, all notification mailers that can process the
same messages must share the same values for certain parameters. Multiple mailers can
process the same messages in the following cases:
• A general mailer runs at the same time as any dedicated mailers.
• Multiple dedicated mailers for the same item type or message definition run at the
same time.
In these cases, the notification mailers must share the same values for the following
parameters:
• HTML Agent
• Autoclose FYI
• Direct Response
• Inline Attachments
However, these mailers can have different values for the From and Reply-to Address
parameters. The headers of each notification email message will contain the From and
Reply-to Address values of the notification mailer that actually sent the message, unless
the message itself has the special #WFM_FROM and #WFM_REPLYTO message attributes
defined to override the notification mailer's parameters. See: Notification Mailer
Attributes, Oracle Workflow Developer's Guide.
You can also configure any notification mailer service component to process only
inbound messages, or only outbound messages. You associate inbound and outbound
mailers with each other by assigning them the same mailer node name. The mailer node
name indicates which inbound mailer can process incoming responses to outbound
messages sent by a particular outbound mailer.
You can optionally assign the same node name to multiple mailers for load balancing
purposes. However, each mailer that performs inbound processing for a node must
have its own inbox.
• If you enable both outbound and inbound processing for the same mailer, that
mailer will automatically use the same node name for both types of processing,
enabling it to process incoming responses to the outbound messages it sent. You
can optionally also create other notification mailers that share the same node name.
• If you create an outbound-only mailer, but you still want to perform response
processing for email responses to the outbound messages it sends, you should
create at least one other mailer with the same node name that does perform
inbound message processing. Otherwise, there will be no inbound mailer that can
process incoming responses to outbound messages sent by this outbound mailer.
• Create an inbound-only mailer only if you have also created at least one mailer with
Dedicated mailers for different item types or message definitions should use different
node names.
If you create custom notification mailer service components, you can either assign them
to the seeded container for notification mailers, named Workflow Mailer Service, or,
based on the volume to be handled by the seeded container, you can also choose to
create your own custom containers.
2. Set up an IMAP4 compliant mail server with an email account for the notification
mailer if you want to receive inbound messages.
The notification mailer requires three folders in this email account: the inbox, a
folder to store processed messages, and a folder to store discarded messages. If the
email account does not already include folders named PROCESS and DISCARD,
Oracle Workflow automatically creates these two folders when you complete the
basic notification mailer configuration. You can optionally specify other folders for
the notification mailer using the advanced configuration wizard.
3. You can use AutoConfig to enter the following configuration parameters for the
seeded Workflow Notification Mailer service component during installation. For
more information about running AutoConfig, see: Technical Configuration, Oracle
E-Business Suite Setup Guide, and Technical Configuration Tools, Oracle E-Business
Suite Concepts.
• SMTP Server
• HTML Agent Name - This parameter defaults to the value you enter for the
Applications Servlet Agent parameter in AutoConfig. Use the following format:
Note: When you enter the SMTP Server and IMAP Server
parameters, specify each server in the following format:
<server_name>[:<port_number>]
• For the IMAP Server parameter, specify the actual host name.
Do not use localhost as the setting for this parameter.
4. Ensure that the Business Event Local System status is set to Enabled in the
Workflow Configuration page, and that the JOB_QUEUE_PROCESSES database
initialization parameter, which is required for the Business Event System, is set to
an appropriate value. The Business Event Local System status is set to Enabled by
default, and usually you do not need to change this status. If notification processing
is not being completed, however, you should check this preference value.
5. (Recommended) You can optionally set the WF: Workflow Mailer Framework Web
Agent profile option to the host and port of the Web server that notification mailers
should use to generate the content for Oracle Application Framework regions that
are embedded in notifications. If this profile option is not set, notification mailers
will use the same Web agent specified in the Application Framework Agent profile
option. However, on a load-balanced Web server, notification mailers might not be
able to render Oracle Application Framework content within a notification. In this
case, set the WF: Workflow Mailer Framework Web Agent profile option to a
physical host, instead of a virtual host. The WF: Workflow Mailer Framework Web
Agent profile option should be set at site level. See: Overview of Setting User
Profiles, Oracle E-Business Suite Setup Guide.
• To specify the external web entry point that the notification mailer should use
to generate the links, set the FND Framework External Agent profile option.
See: Overview of Setting User Profiles, Oracle E-Business Suite Setup Guide.
7. (Optional) If you send email notifications to users who are external to your
enterprise and do not have access to your Oracle E-Business Suite instance at all,
you can optionally exclude the Notification Detail Link attachment from emails sent
to those users. To designate users as external users who cannot access Oracle E-
Business Suite, assign them the role WF_EXTERNAL_ROLE_NOEBS_ACCESS. Users
with this role can receive email notifications, but will not receive a link to the
notification in the Notification Details page as an attachment.
Use the WF_DIRECTORY.AddUsersToAdHocRole() API to add the users you want to
the WF_EXTERNAL_ROLE_NOEBS_ACCESS role. See: AddUsersToAdHocRole,
Oracle Workflow API Reference.
8. Before a service component can run, the container which manages it must first be
started. The seeded Workflow Notification Mailer service component belongs to a
container named Workflow Mailer Service, while the seeded agent listener service
components that are also required for notification mailer processing belong to a
container named Workflow Agent Listener Service. You should ensure that these
10. Use the notification mailer configuration wizard to configure your notification
mailer service component. The Basic Configuration page lets you configure a
notification mailer quickly by entering only the minimum required parameters,
while the advanced configuration wizard lets you specify additional parameters to
control how the notification mailer processes messages.
If you entered configuration parameters for the seeded Workflow Notification
Mailer through AutoConfig, you only need to enter the password for the email
inbox in order to complete the configuration for that mailer and begin running it. If
you did not enter parameters for the seeded mailer through AutoConfig, then in
order to complete the configuration for that mailer you need to enter only the SMTP
server, IMAP server, email inbox username, email inbox password, and reply-to
email address. All other configuration parameters for the seeded Workflow
Notification Mailer are initially set to default values and do not need to be changed,
although you can optionally do so if you choose.
11. (Optional) By default, the seeded Workflow Notification Mailer has a Launch
Summary Notifications event scheduled to send summary notifications once a day.
You can optionally use the notification mailer configuration wizard to modify the
start time and interval for this event's schedule, or to schedule the Launch
Summary Notifications event at the interval you choose for any notification mailer
service component. When this event is processed, a summary notification is sent to
each role with a notification preference of SUMMARY or SUMHTML, listing all the
notifications that are currently open for that role.
12. (Optional) You can configure a notification mailer to connect to the SMTP server
and IMAP server through TLS or SSL to encrypt the data exchanged. See:
Connecting to Mail Servers Through TLS or SSL, page 2-72.
• APOS - The notification mailer uses the single quote, or apostrophe (') , as both
the opening and the closing delimiter. This setting is currently the same as the
default.
• QUOTE - The notification mailer uses the double quote (") as both the opening
and the closing delimiter.
• BRACKET - The notification mailer uses the left bracket ([) as the opening
delimiter and the right bracket (]) as the closing delimiter.
Using single quotes as the delimiters accommodates email applications that cannot
process double quotes in the <A HREF="mailto:"> tag for the response template link,
but can accept single quotes. However, if you want users to be able to use
apostrophes or single quotes in their response values without entering an escape
character, you can use double quotes or brackets as the delimiters, depending on
what your email application supports. See: To Respond to an HTML Email
Notification, Oracle Workflow User's Guide.
By default, the HTML_DELIMITER parameter is set to the value DEFAULT. Use the
afsvcpup.sql script to change the parameter value to specify the delimiters you
want to use. See: To Set Internal Mailer Parameters, page 2-65.
If a particular notification message has the special #WFM_HTML_DELIMITER
message attribute defined, however, the notification mailer will use the
#WFM_HTML_DELIMITER attribute value to determine which delimiters to use for
that notification, instead of using the HTML_DELIMITER parameter value.
Including this header can help enable message filtering and avoid automatic
responses being returned to the notification mailer.
By default, the SET_WFNTF_AUTO_GEN_HEADER parameter is set to the value N. If
you want to include the Auto-Submitted: auto-generated header in the
emails, use the afsvcpup.sql script to change the parameter value to Y. See: To
Set Internal Mailer Parameters, page 2-65.
15. (Optional) You can optionally set the internal mailer parameter named
OUTBOUND_THREAD_WAIT_TIMEOUT if you want to specify an outbound thread
wait timeout period for the notification mailer. This period is the maximum amount
of time in seconds that an outbound thread continues to wait, when attempting to
send a message, before timing out. If the timeout period expires and the message
has not yet been successfully sent, then the notification mailer sets the mail status of
the notification to ERROR and sends an error notification to the system
administrator.
By default, no outbound thread timeout period is configured. If you want to
configure a timeout period, use the afsvcpup.sql script to set the
OUTBOUND_THREAD_WAIT_TIMEOUT parameter value to the number of seconds
you want the thread to wait. See: To Set Internal Mailer Parameters, page 2-65.
16. (Optional) You can optionally configure Oracle Workflow for OAuth-2.0–based
inbound connections to the Microsoft Office 365 Exchange Online server, or OAuth-
2.0–based inbound and outbound connections to the Google Workspace Gmail
server. By default, notification mailers use a basic authentication scheme to
authenticate user credentials with mail servers through a user name and password.
In OAuth-2.0–based authentication, a notification mailer requests an access token
and sends that access token along with the user name to connect to Microsoft Office
365 Exchange Online or Google Workspace Gmail and process messages. For
detailed steps, see My Oracle Support Knowledge Document 2884072.1, Configuring
Oracle Workflow for OAuth 2.0 with Microsoft Office 365 Exchange Online in Oracle E-
Business Suite Release 12.2 and Release 12.1.3 or My Oracle Support Knowledge
Document 2966503.1, Configuring Oracle Workflow for OAuth 2.0 with Google
Workspace Gmail in Oracle E-Business Suite Release 12.2.
17. (Optional) You can optionally limit the size of Oracle Workflow email notifications,
including the email body and any attachments, using the "Workflow Mailer SMTP
server size limit" profile option. For example, if your mail server restricts the size of
emails that can be sent, you can use this profile option to ensure that Oracle
Workflow emails remain within the allowed size.
18. (Optional) The seeded Workflow Notification Mailer uses the Automatic startup
mode by default and will be started automatically when you complete its
configuration. If you select the Manual startup mode for a notification mailer
service component, use the Service Components page to start that notification
mailer. You can also use this page to manage any notification mailer service
component.
• Resolves the notification recipient role to one or more email addresses defined for
the role; an email address can itself be a mail list.
• Switches its database session to the recipient role's preferred language and territory
as defined in the directory service.
• Sets the mail status of the notification to FAILED if the email could not be delivered
to any email address defined for the recipient. This mail status indicates that an
exception prevented this email notification from being delivered but does not
prevent the mailer from processing other notifications.
• Adds the email address or addresses to its invalid email address list. To avoid
unnecessary processing, each notification mailer stores a list of email addresses to
which it could not deliver messages, and does not attempt to send any further
messages to those addresses. If all the addresses for a recipient are invalid, then for
any subsequent notifications to the listed addresses, the notification mailer simply
sets the mail status directly to FAILED. If at least one address for the recipient was
valid, then the notification mailer continues sending notifications to the valid
address or addresses, but does not attempt to send any further messages to the
invalid addresses.
• Changes the notification preference of the recipient to DISABLED, if all the email
addresses for the recipient are invalid. To further help avoid unnecessary
processing, if a recipient has a notification preference of DISABLED, Oracle
Workflow does not generate a complete XML representation of any notifications to
that recipient, and a notification mailer does not attempt to send email notifications
to that recipient. Instead, the notification mailer simply sets the mail status of the
notifications directly to FAILED. The change in notification preference also
indicates to the user that email notifications cannot be delivered. You or the user
must correct the issue that caused the failure and then reset the notification
preference in order for the user to receive email notifications.
If at least one email address for the recipient was valid, then the notification
preference of the recipient is not changed. In this case the notification mailer
continues sending notifications to the valid address or addresses, but does not
attempt to send any further messages to the invalid addresses.
• Sends a notification to the SYSADMIN user. If all the email addresses for a recipient
are invalid, this notification informs the administrator that an email notification
could not be sent to one or more recipients, that the notification preference for those
recipients has been set to DISABLED, and that those recipients' original notification
preferences, which are listed, should be reset after the issues that caused the failures
are corrected. See: User Notification Preference Update Report Message, page 2-157.
If at least one email address for the recipient was valid, then this notification
informs the administrator that an email notification could not be sent to one or
more email addresses for the recipient, that those addresses should be either
corrected or removed from the list of email addresses defined for the recipient, and
that Oracle Workflow will not attempt to send any further notifications to these
addresses until the notification mailer is restarted. See: Invalid Email Address
Warning Message Template, page 2-158.
Note: When a notification does not have the Expand Roles option
checked, only one copy of the notification is sent to the recipient role as
a whole, even if the role includes multiple users. That is, the
notification is sent with the same notification ID to all users in the role.
If the notification mailer cannot deliver the email notification to one or
more of the users in the role, then in addition to the other actions in this
Individual users whose notification preference was set to DISABLED can reset their
notification preference manually using the Preferences page in Oracle E-Business Suite.
You can also run the Workflow Directory Services Bulk Reset DISABLED Notification
Preference concurrent program to reset the notification preference for multiple users at
once. See: Handling Mailer Errors, page 2-93.
After correcting the email issues and resetting DISABLED notification preferences, you
can run the Resend Failed/Error Workflow Notifications concurrent program to retry
open notifications that previously could not be sent. See: Handling Mailer Errors, page
2-93.
• Checks the inbox folder for messages. If a message exists, the notification mailer
reads the message, checking for the notification ID (NID) and node identifier in the
NID line.
• If the message is not a notification response, meaning it does not contain an NID
line, the notification mailer moves the message to the discard folder and treats it as
an unsolicited message. For the first unsolicited message from a particular email
address, the notification mailer also sends a warning message back to the sender of
the message. However, to avoid sending unnecessary warnings due to bounced or
auto-reply messages, each mailer node stores a list of email addresses from which it
Note: Each mailer node can store up to 100 email addresses in its
warned list. If the node receives unsolicited messages from
additional addresses when the list is already full, the notification
mailer removes the oldest addresses from the list and adds the new
addresses in their place. Also, the notification mailer clears the list
by removing all addresses when you start the mailer for the first
time, and again whenever you stop and restart its container. In
these cases, the mailer may send another warning message if it
receives further unsolicited email from an address that is no longer
on the warned list.
Note: You can optionally use the Send Warning for Unsolicited E-
mail mailer parameter to prevent notification mailers from sending
any warning messages at all. See: Notification Mailer Configuration
Wizard, page 7-36.
• If the message is a notification response, but for a different node, the notification
mailer leaves the message in the inbox and adds the email's Unique Message ID
(UID) to its ignore list.
• If the message is a notification response for the current node, meaning it contains an
NID line including the node identifier of the current node, the notification mailer
processes the message.
The notification mailer performs the following steps for messages that belong to its
node.
• Retrieves the notification ID.
• Checks to see if the message bounced by referring to the tags specified in the
configuration parameters, if any. If the message bounced, the notification mailer
updates the notification's status and stops any further processing, based on the
specifications of the tag list.
• Checks the Oracle Workflow database for this notification based on the NID line.
• If the notification does not exist, meaning the notification ID or the access key in
• If the notification exists, but is closed or canceled, the notification mailer moves
the message to the processed folder and sends a Workflow Closed Mail or
Workflow Canceled Mail message to the recipient role, respectively.
Note: You can optionally use the Send E-mails for Canceled
Notifications mailer parameter to prevent notification mailers
from sending any notification cancellation messages. See:
Notification Mailer Configuration Wizard, page 7-36.
• If the inbound message is a response to a request for more information that has
already been answered, or if the message is formatted as a more information
response but no information was requested for that notification, then the
notification mailer moves the message to the discard folder and sends a
Workflow More Info Answered Mail message to the sender of the message.
• If the notification exists and is open, the notification mailer generates an XML
representation of the message and places it on the standard
WF_NOTIFICATION_IN agent as an event called oracle.apps.wf.notification.
receive.message. The notification mailer then moves the message for the
completed notification to the processed folder.
Finally, if there are no more unprocessed messages in the inbox, the notification mailer
logs out of the email account.
Oracle Workflow provides a seeded agent listener named Workflow Inbound
Notifications Agent Listener that runs on the WF_NOTIFICATION_IN agent to
continue notification processing for the valid response messages placed on that agent.
When an event message is dequeued from WF_NOTIFICATION_IN, Oracle Workflow
executes a seeded subscription that calls the appropriate notification response function.
This function verifies the response values with the definition of the notification
message's response attributes in the database. If a response value is invalid, or if no
response value is included, the notification mailer sends a Workflow Invalid Mail
message to the recipient role, or, for an invalid response to a request for more
information, the notification mailer sends a Workflow Invalid Open Mail (More
Information Request) message to the recipient role. If the responses are valid, the
Navigation: Applications Dashboard > (pull-down menu) Workflow Manager > (B) Go >
Notification Mailers status icon > (B) Create > (B) Continue
Navigation: Applications Dashboard > (pull-down menu) Workflow Manager > (B) Go >
Notification Mailers status icon > (B) Edit
Basic Configuration
This page lets you configure a notification mailer quickly by entering only the
Details
• Name - The name of the service component. This name must be unique. The name
of the seeded notification mailer service component is Workflow Notification
Mailer, and you cannot change this value.
• Outbound Protocol - Oracle Workflow currently supports the SMTP protocol for
outbound email.
• Authentication Type - Select the authentication type to use for connections to the
outbound mail server, either BASIC or OAUTH. By default, notification mailers use a
basic authentication scheme to authenticate user credentials with mail servers
through a user name and password.
You can optionally implement OAuth-2.0–based authentication instead to
authenticate through a user name and a valid access token for connections to the
Google Workspace Gmail server. For detailed steps, including additional
parameters to specify in this region, see My Oracle Support Knowledge Document
2966503.1, Configuring Oracle Workflow for OAuth 2.0 with Google Workspace Gmail in
Oracle E-Business Suite Release 12.2.
• Server Name - The name of the outbound SMTP mail server. Oracle strongly
recommends that you specify the actual host name for the SMTP server. However,
you can specify localhost as the setting for this parameter if you ensure that an
SMTP server is configured to send emails to all valid domains on each host where
concurrent managers run. If you have implemented Parallel Concurrent Processing
to allow concurrent processing activities to be distributed across multiple nodes in a
cluster system, then you must configure an SMTP server on every node. Otherwise,
if a concurrent manager attempts to execute outbound notification mailer
processing on a node without an SMTP server, the processing will fail. Also, when
you save the configuration, Oracle Workflow Manager tests the connection to the
SMTP server from within the Web tier host. Consequently, if you set the outbound
server name to localhost, you should ensure that an SMTP server is configured
on the Web tier host as well.
You can optionally specify the port number to use on that server. If you do not
specify a port number, the notification mailer uses port 25 by default. Specify the
server in the following format: <server_name>[:<port_number>]
• Connection Security - Select the type of protocol to use for connections to the SMTP
server.
• Choose None if you do not want to use a secure protocol.
You can optionally specify a different port number along with the
SMTP server name in the outbound Server Name parameter.
Before you can use a secure protocol, you must also complete additional setup
steps. See: Connecting to Mail Servers Through TLS or SSL, page 2-72.
• Inbound Protocol - Oracle Workflow currently supports the IMAP protocol for
inbound email.
• Authentication Type - Select the authentication type to use for connections to the
inbound mail server, either BASIC or OAUTH. By default, notification mailers use a
basic authentication scheme to authenticate user credentials with mail servers
through a user name and password.
You can optionally implement OAuth-2.0–based authentication instead to
authenticate through a user name and a valid access token for connections to the
Microsoft Office 365 Exchange Online server or the Google Workspace Gmail
server. For detailed steps, including additional parameters to specify in this region,
see My Oracle Support Knowledge Document 2884072.1, Configuring Oracle
Workflow for OAuth 2.0 with Microsoft Office 365 Exchange Online in Oracle E-Business
Suite Release 12.2 and Release 12.1.3 or My Oracle Support Knowledge Document
2966503.1, Configuring Oracle Workflow for OAuth 2.0 with Google Workspace Gmail in
Oracle E-Business Suite Release 12.2.
• Server Name - The name of the inbound IMAP mail server. Note that you must
specify the actual host name for the server. Do not use localhost as the setting for
this parameter. You can optionally specify the port number to use on that server. If
you do not specify a port number, the notification mailer uses port 143 by default.
Specify the server in the following format: <server_name>[:<port_number>]
For example: myimapserver.example.com:143
• Username - The user name of the mail account that the notification mailer uses to
receive email messages.
• Password - For basic authentication, the password for the mail account specified in
the Username parameter. The password value is masked as asterisks in the display
and is stored in encrypted form.
• Reply-To Address - The address of the email account that receives incoming
messages, to which notification responses should be sent. This value must be a full
RFC822-compliant email address.
If a particular notification message has the special #WFM_REPLYTO message
attribute defined, however, the notification mailer will use the #WFM_REPLYTO
attribute value as the reply address for that message, instead of the Reply-To
Address parameter value.
• Connection Security - Select the type of protocol to use for connections to the IMAP
server.
• Choose None if you do not want to use a secure protocol.
You can optionally specify a different port number along with the
IMAP server name in the inbound Server Name parameter.
Before you can use a secure protocol, you must also complete additional setup
steps. See: Connecting to Mail Servers Through TLS or SSL, page 2-72.
Note: The notification mailer requires three folders in the IMAP mail
account: the inbox, a folder to store processed messages, and a folder to
store discarded messages. If you enable inbound processing and the
mail account you specify in the Username parameter does not already
Note: If you enable inbound processing, the notification mailer uses the
Workflow Open Mail (Templated) message, which provides a response
template for sending responses by email, as the default message
template for email notifications that require a response. If you disable
inbound processing, the notification mailer uses the Workflow Open
Mail (Outlook Express) message, which provides a link in HTML
notifications for entering responses in the Notification Details page, as
the default message template for email notifications that require a
response. To specify other message templates, navigate to the advanced
configuration wizard.
Note that the plain text version of the Workflow Open Mail (Outlook
Express) message requests a response by email. If you disable inbound
processing, ensure that your users do not have a notification preference
of MAILTEXT or MAILATTH. Alternatively, if you disable inbound
processing and you want users to receive plain text notifications, use
the advanced configuration wizard to specify a message template that
directs recipients to respond from the Notification Details Web page,
such as the standard Workflow View From UI message template or a
custom message template.
Oracle Workflow sends two test messages to the recipient role: one message with
To set additional parameters for this notification mailer in the advanced configuration
wizard, click the Advanced button.
Define
This page lets you define general attributes for the service component. Some attributes
are already set to required values and cannot be modified. You must set attributes
marked with an asterisk (*) to appropriate values for your environment before you can
run the service component.
• ID - The configuration wizard displays the identifier for the service component.
• Status - The configuration wizard displays the status of the service component.
• Name - The name of the service component. This name must be unique. You can
only edit the name when the notification mailer is not running. The name of the
seeded notification mailer service component is Workflow Notification
Mailer, and you cannot change this value.
• Startup Mode - Select Automatic, Manual, or On-Demand as the startup mode for
the service component. You can only edit the startup mode when the notification
mailer is not running. The seeded Workflow Notification Mailer is assigned the
Automatic startup mode by default, but you can optionally change this value.
• Inbound Agent - The Business Event System agent for inbound processing. The
inbound agent for a notification mailer service component is always
WF_NOTIFICATION_IN.
• Outbound Agent - The Business Event System agent for outbound processing. The
outbound agent for a notification mailer service component is always
WF_NOTIFICATION_OUT.
For example:
WFDEMO:%
For example:
WFDEMO:APPROVE_REQUISITION
Details
This page lets you define detail attributes for the service component. You must set
attributes marked with an asterisk (*) to appropriate values for your environment
before you can run the service component. A refresh icon identifies attributes that can
be refreshed dynamically while the service component is running.
• ID - The configuration wizard displays the identifier for the service component.
• Status - The configuration wizard displays the status of the service component.
• Name - The configuration wizard displays the name defined for the service
component.
• Container - The container to which the service component will belong. Oracle
Workflow provides a container called Workflow Mailer Service for notification
mailer service components.
• Maximum Idle Time - If you selected the On-Demand startup mode for the service
component, enter the maximum time in minutes that the service component can
remain idle before it is stopped. An on-demand component that is stopped in this
way will be restarted by its container when it is needed again to process new
messages.
• Max Error Count - The number of consecutive errors the service component can
encounter before its container stops it and changes its status to Stopped with Error.
If an error is resolved and processing can continue, the error count is reset. The
default value for the maximum error count is 10.
• Inbound Thread Count - Set the inbound processing thread count to 1 (one) to
enable inbound message processing with this notification mailer. Select 0 (zero) to
disable inbound message processing for this notification mailer and dedicate the
notification mailer solely to outbound processing. If you selected the Inbound
Processing parameter in the Basic Configuration page, the inbound thread count is
set to 1; if you deselected the Inbound Processing parameter, the inbound thread
count is set to 0.
The inbound thread count cannot be greater than 1, because only one thread can
access the email inbox at a time. If you disable inbound message processing for this
notification mailer, but you still want to perform email response processing, you
should create at least one other notification mailer with the same node name that
• Outbound Thread Count - Specify the number of outbound processing threads you
want to execute simultaneously with this notification mailer. You can set the
outbound thread count to 1 (one) or more depending on the volume of outbound
messages you need to send. Specify 0 (zero) to disable outbound message
processing for this notification mailer and dedicate the notification mailer solely to
inbound processing. If you disable outbound message processing for this
notification mailer, you should create at least one outbound notification mailer with
the same node name. Otherwise, no inbound response messages will be marked
with that node name and this inbound mailer will have no messages to process. The
default value for the outbound thread count is 1.
• Log Level - Select the level of detail for the information you want to record in the
service component container log. The recommended log level, which is also the
default value, is Error. Usually the log level only needs to be changed if you want to
record additional detailed information for debugging purposes. You can choose the
following levels:
• 1 - Statement
• 2 - Procedure
• 3 - Event
• 4 - Exception
• 5 - Error
• 6 - Unexpected
• Processor Read Wait Timeout - Specify the amount of time in seconds that the
service component's processing thread continues to wait, after reading the last
message from its assigned queue, before timing out. If another message is received
before this time expires, that message is processed and the timeout period begins
again. If the timeout period expires and no more messages have been received, the
service component stops reading and its sleep time begins. The default read timeout
period for a notification mailer is 10 seconds.
• Processor Min Loop Sleep - Specify the minimum sleep time in seconds during
which the service component waits, after its read timeout period expires, before it
checks its queue for messages again. The default minimum sleep time for a
notification mailer is 5 seconds.
• Processor Max Loop Sleep - Specify the maximum sleep time in seconds if you
• Processor Error Loop Sleep - Specify the sleep time in seconds during which the
service component waits, after an error occurs, before it attempts to begin
processing again. The default error sleep time for a notification mailer is 60 seconds.
• Processor Close on Read Timeout - Select this parameter to specify that the service
component should close its connections after its read timeout period expires, when
its sleep time begins. Deselect this parameter to specify that the connections should
remain open until the processing thread stops.
Selecting this parameter lets the notification mailer close its session with the IMAP
server or SMTP server if it could not read a message from the IMAP inbox or from
the database, respectively, before the read timeout period ended. For example, if an
external process is accessing the IMAP inbox, the notification mailer may not be
able to read or access the inbox for some time. In this case it may be advantageous
for the notification mailer to close the existing connection, wait for a while, and then
try to re-establish a new connection. Additionally, some IMAP servers may cause
an idle session to time out and become invalid. In this case also, it is advantageous
for the notification mailer to close the existing connection and re-establish a new
one.
Email Servers
This page lets you define email server parameters for the notification mailer. Some
parameters are already set to required values and cannot be modified. You must set
parameters marked with an asterisk (*) to appropriate values for your environment
before you can run the notification mailer. A refresh icon identifies attributes that can be
refreshed dynamically while the service component is running. If the notification mailer
is currently running, then parameters marked with a refresh icon will be refreshed
immediately when you select the Next button.
Note: The node name for each node must be unique. However,
multiple mailers can share the same node.
• Email Parser - The Java class used to parse an incoming notification response email
formatted according to the templated response method and to create an XML
document for the response. The notification mailer uses this parser when the Direct
Response parameter is deselected. The default standard email parser provided by
Oracle Workflow is named oracle.apps.fnd.wf.mailer.TemplatedEmailParser.
Usually you do not need to change this value.
If you are not implementing inbound email processing for this mailer, leave the
default as a placeholder value.
Note: You do not need to change the value of the Email Parser
parameter if you select the Direct Response parameter. The
notification mailer automatically switches to the alternate email
parser when the Direct Response parameter is selected.
• Alternate Email Parser - The Java class used to parse an incoming notification
response email formatted according to the direct response method and to create an
XML document for the response. The notification mailer uses this parser when the
Direct Response parameter is selected. The default alternate email parser provided
by Oracle Workflow is named oracle.apps.fnd.wf.mailer.DirectEmailParser. Usually
you do not need to change this value.
Note: You do not need to change the value of the Alternate Email
Parser parameter if you deselect the Direct Response parameter.
The notification mailer automatically switches to the standard
email parser when the Direct Response parameter is deselected.
• Expunge Inbox on Close - Select this parameter to purge deleted messages from the
inbox folder when the notification mailer closes this folder. If you do not select this
parameter, copies of messages that were moved to the discard or processed folders
remain in the inbox, in a deleted state, until you manually expunge them using
your email application.
• Inbound Protocol - Oracle Workflow currently supports the IMAP protocol for
inbound email.
• Authentication Type - Select the authentication type to use for connections to the
inbound mail server, either BASIC or OAUTH. By default, notification mailers use a
basic authentication scheme to authenticate user credentials with mail servers
through a user name and password.
You can optionally implement OAuth-2.0–based authentication instead to
authenticate through a user name and a valid access token for connections to the
Microsoft Office 365 Exchange Online server or the Google Workspace Gmail
server. For detailed steps, including additional parameters to specify in this region,
see My Oracle Support Knowledge Document 2884072.1, Configuring Oracle
Workflow for OAuth 2.0 with Microsoft Office 365 Exchange Online in Oracle E-Business
Suite Release 12.2 and Release 12.1.3 or My Oracle Support Knowledge Document
2966503.1, Configuring Oracle Workflow for OAuth 2.0 with Google Workspace Gmail in
Oracle E-Business Suite Release 12.2.
• Inbound Server Name - The name of the inbound mail server. Note that you must
specify the actual host name for the server. Do not use localhost as the setting for
this parameter. You can optionally specify the port number to use on that server. If
you do not specify a port number, the notification mailer uses port 143 by default.
Specify the server in the following format: <server_name>[:<port_number>]
For example: myimapserver.example.com:143
If you are not implementing inbound email processing for this mailer, enter a
• Username - The user name of the mail account that the notification mailer uses to
receive email messages.
If you are not implementing inbound email processing for this mailer, enter a
placeholder value.
• Password - For basic authentication, the password for the mail account specified in
the Username parameter. The password value is masked as asterisks in the display
and is stored in encrypted form.
If you are not implementing inbound email processing for this mailer, enter a
placeholder value.
• Inbox Folder - The name of the folder from which the notification mailer receives
inbound messages. This value is case-insensitive. The default value is INBOX. The
inbox must be separate from the processed and discard folders. Each notification
mailer that performs inbound processing should have its own separate inbox.
If you are not implementing inbound email processing for this mailer, leave the
default as a placeholder value.
• Inbound Connection Timeout - The maximum amount of time, in seconds, that the
notification mailer will wait to establish a connection to the inbound server before
timing out. The default inbound connection timeout period for a notification mailer
is 120 seconds.
• Inbound Message Fetch Size - The maximum number of messages that the
notification mailer can fetch from the inbox at one time. The default inbound
message fetch size is 100 messages.
• Connection Security - Select the type of protocol to use for connections to the IMAP
server.
• Choose None if you do not want to use a secure protocol.
You can optionally specify a different port number along with the
IMAP server name in the Inbound Server Name parameter.
Before you can use a secure protocol, you must also complete additional setup
steps. See: Connecting to Mail Servers Through TLS or SSL, page 2-72.
• Authentication Type - Select the authentication type to use for connections to the
outbound mail server, either BASIC or OAUTH. By default, notification mailers use a
basic authentication scheme to authenticate user credentials with mail servers
through a user name and password.
You can optionally implement OAuth-2.0–based authentication instead to
authenticate through a user name and a valid access token for connections to the
Google Workspace Gmail server. For detailed steps, including additional
parameters to specify in this region, see My Oracle Support Knowledge Document
2966503.1, Configuring Oracle Workflow for OAuth 2.0 with Google Workspace Gmail in
Oracle E-Business Suite Release 12.2.
• Outbound Server Name - The name of the outbound mail server. Oracle strongly
recommends that you specify the actual host name for the SMTP server. However,
you can specify localhost as the setting for this parameter if you ensure that an
SMTP server is configured to send emails to all valid domains on each host where
concurrent managers run. If you have implemented Parallel Concurrent Processing
to allow concurrent processing activities to be distributed across multiple nodes in a
cluster system, then you must configure an SMTP server on every node. Otherwise,
if a concurrent manager attempts to execute outbound notification mailer
processing on a node without an SMTP server, the processing will fail. Also, when
you save the configuration, Oracle Workflow Manager tests the connection to the
SMTP server from within the Web tier host. Consequently, if you set the outbound
server name to localhost, you should ensure that an SMTP server is configured
on the Web tier host as well.
You can optionally specify the port number to use on that server. If you do not
specify a port number, the notification mailer uses port 25 by default. Specify the
server in the following format: <server_name>[:<port_number>]
For example: mysmtpserver.example.com:25
If you are not implementing outbound email processing for this mailer, enter a
placeholder value.
• Test Address - This parameter has been replaced by the override email address,
which is available through the Component Details page for a notification mailer.
• Connection Security - Select the type of protocol to use for connections to the SMTP
server.
• Choose None if you do not want to use a secure protocol.
You can optionally specify a different port number along with the
SMTP server name in the Outbound Server Name parameter.
Before you can use a secure protocol, you must also complete additional setup
steps. See: Connecting to Mail Servers Through TLS or SSL, page 2-72.
Email Processing
• Processed Folder - The name of the mail folder where the notification mailer places
successfully processed notification messages. This value is case-insensitive. The
processed folder must be separate from the inbox and the discard folder.
The default value for this parameter is PROCESS. If you enabled inbound
processing in the Basic Configuration page and the mail account you specified did
not already include a folder named PROCESS, Oracle Workflow automatically
created a folder with this name in that account when you completed the basic
notification mailer configuration.
You can optionally specify the name of a different folder in this parameter. In this
If you are not implementing inbound email processing for this mailer, leave the
default as a placeholder value.
• Discard Folder - The name of the mail folder where the notification mailer places
incoming messages that are not recognized as notification messages. This value is
case-insensitive. The discard folder must be separate from the inbox and the
processed folder.
The default value for this parameter is DISCARD If you enabled inbound processing
in the Basic Configuration page and the mail account you specified did not already
include a folder named DISCARD, Oracle Workflow automatically created a folder
with this name in that account when you completed the basic notification mailer
configuration.
You can optionally specify the name of a different folder in this parameter. In this
case, ensure that you use your email client to create the folder. A notification mailer
may not be able to access folders that were created using command line tools
outside the email client.
If you are not implementing inbound email processing for this mailer, leave the
default as a placeholder value.
Note: Note that there are limitations when you deselect Allow
Forwarded Response. For example, suppose a notification is
Note: When you click the Next button, the configuration wizard
validates the parameters you entered. If the inbound thread count is set
to 1, the configuration wizard also verifies that it can connect to the
email account on the specified inbound mail server with the specified
user name and password, and that the folders specified in the
Processed Folder and Discard Folder parameters exist in that email
account. If the parameters are successfully validated, and the
Message Generation
This page lets you define message generation parameters for the notification mailer.
Some parameters are already set to required values and cannot be modified. You must
set parameters marked with an asterisk (*) to appropriate values for your environment
before you can run the notification mailer. A refresh icon identifies attributes that can be
refreshed dynamically while the service component is running. If the notification mailer
is currently running, parameters marked with a refresh icon will be refreshed
immediately when you select the Next button or the Finish button.
Send
• From - A value that appears in the From field of the message header of a
notification email. You can specify the From parameter value either as a display
name only, or as a full RFC822-compliant address.
• If you specify a display name only, the notification mailer adds the email
address from the Reply-to Address parameter to create a full RFC822-compliant
address for the From message header. The full address is created in the
following format: "Display Name" <reply_to_address>
• If you specify a full RFC822-compliant address, the notification mailer uses only
that From parameter value in the From message header, and does not include
the Reply-to Address value.
If you deselected the Inbound Processing parameter in the Basic Configuration page
of the wizard, then Oracle Workflow by default sets the Reply-to Address
parameter to nobody@<server_name>, where <server_name> is the name of
the outbound SMTP mail server specified in the Basic Configuration page. If you
are not implementing inbound email processing for this mailer, leave the default as
a placeholder value.
• HTML Agent - The base URL that identifies the HTML agent that handles HTML
notification responses. This URL is required to support email notifications with
HTML attachments. Usually the HTML agent specified here can match the value of
the Applications Servlet Agent profile option; however, you can optionally specify a
different HTML agent for a particular notification mailer. The HTML agent should
be specified in the following format:
http://<server_name:port>/OA_HTML/
Note: The notification mailer can also still handle an HTML agent
value in the previous format:
http://<server_name:port>/pls/wf
• Framework User - The numerical user ID for the user through which a notification
mailer accesses Oracle Application Framework content for inclusion in email
Note: You can use the Workflow Mailer URL Access Tester page to
test whether Oracle Application Framework content can be
generated correctly for email notifications. See: Testing Mailer URL
Access, page 6-31.
• Framework URL Timeout - The maximum amount of time, in seconds, that the
notification mailer will wait to access a URL for Oracle Application Framework
content before timing out. The default Framework URL timeout period for a
notification mailer is 30 seconds.
• Attach Images to Outbound Emails - Select this parameter to attach any images
referenced in HTML content included in a message, such as Oracle Application
Framework content, to outbound notification email messages. Deselect this
parameter to display the image references as off-page URLs instead of attaching the
images.
• With the direct response method, a notification mailer sends plain text
notifications requiring a direct response to users with a notification preference
of MAILTEXT or MAILATTH. Users must enter their response values directly as
the first lines of a reply.
See: Workflow Open Mail (Templated) Message, page 2-108, Workflow Open Mail
(Direct) Message, page 2-113, To Respond to a Plain Text Email Notification Using
Templated Response, Oracle Workflow User's Guide, To Respond to a Plain Text
Email Notification Using Direct Response, Oracle Workflow User's Guide, and
Example 'Respond' Message Attributes, Oracle Workflow Developer's Guide.
• Reset NLS - Select this parameter if you want the notification mailer to encode each
notification message with character encoding according to the notification
recipient's preferred language. Deselect this parameter if you want the notification
• If you want to use different character encoding instead, then you can
specify the override character encoding in the Character Encoding
Configuration page.
• If the Reset NLS parameter is selected at the notification mailer level and is not
overridden at the message level, or if the #WFM_RESET_NLS message attribute
is set to Y at the message level, then the notification mailer encodes each
notification message with character encoding according to the notification
recipient's preferred language.
• By default, the notification mailer uses the following logic to determine the
character encoding for the message.
• If the notification recipient has specified both a preferred language and
a preferred territory, then the notification mailer uses the character
encoding listed in the WF_LANGUAGES table for that language and
territory.
• If you want to use different character encoding instead, then you can use
Note: You can also review and update the Reset NLS parameter
setting for your notification mailers in the Character Encoding
Configuration page Any changes you make in that page will be
reflected in the notification mailer configuration wizard as well.
• Send Warning for Unsolicited E-mail - Select this parameter to allow the
notification mailer to send back a warning message the first time it receives an
unsolicited email message from a particular email address. Deselect this parameter
to prevent the notification mailer from sending warning messages.
• Send E-mails for Canceled Notifications - Select this parameter to allow the
notification mailer to send cancellation messages to users when previously sent
notifications are canceled. Deselect this parameter to prevent the notification mailer
from sending cancellation messages.
If you set up multiple notification mailers in the same Oracle E-Business Suite
instance, you must set this parameter to the same setting for all the notification
mailers.
Templates
This region lets you specify the message templates you want to use to generate email
notifications. The template for a particular type of email notification determines the
basic format of the notification, including what header information to include, and
whether and where to include details such as the message due date and priority.
Oracle Workflow provides a set of standard templates in the System: Mailer item type,
which are used by default. It is not recommended to modify the standard templates.
• Open Notification - If you are using the default response method, which is
templated response, the notification mailer uses this template to send open
notifications that require a response. This message template must provide a
response template for the recipient as well as instructions on how to use the
response template.
If you are configuring this notification mailer for outbound message processing
only and you are not implementing any corresponding inbound email response
processing, then you should set the Open Notification parameter to a message
template that does not request a response by email, but instead directs recipients to
respond from the Notification Details Web page. For example, you can select the
Workflow View From UI message template provided by Oracle Workflow, or create
your own custom message template.
If you selected the Inbound Processing parameter in the Basic Configuration page,
the Open Notification parameter is set to the Workflow Open Mail (Templated)
message template by default. If you deselected the Inbound Processing parameter,
the Open Notification parameter is set to the Workflow Open Mail (Outlook
Express) message template by default.
Note: The plain text version of the Workflow Open Mail (Outlook
Express) message requests a response by email. If you disable
inbound processing, ensure that your users do not have a
notification preference of MAILTEXT or MAILATTH.
Alternatively, if you disable inbound processing and you want
users to receive plain text notifications, specify a message template
that directs recipients to respond from the Notification Details Web
page.
• Open Notification (Direct Response Parsing) - If you select the Direct Response
parameter, the notification mailer uses this template to send open notifications that
require a response. The response instructions in the plain text message body must
describe how to reply using the direct response method. This message is used for
notifications sent to performers with a notification preference of MAILTEXT or
MAILATTH. The response instructions in the HTML-formatted message body must
describe how to reply using the automatically generated response template. This
message is used for notifications sent to performers with a notification preference of
MAILHTML or MAILHTM2, and is also attached to notifications sent to performers
with a notification preference of MAILATTH.
See: Workflow Open Mail (Templated) Message, page 2-108, Workflow Open Mail
(Direct) Message, page 2-113, To Respond to a Plain Text Email Notification Using
Templated Response, Oracle Workflow User's Guide, To Respond to a Plain Text
Email Notification Using Direct Response, Oracle Workflow User's Guide, and
Example 'Respond' Message Attributes, Oracle Workflow Developer's Guide.
• Open FYI Notification - The notification mailer uses this template to send
notifications that do not require a response. The template must indicate that the
notification is for your information (FYI) and does not require a response.
• Open Notification (More Information Request) - The notification mailer uses this
template to send a request for more information about a notification from one user
to another user.
Note: When you click the Next or Finish button, the configuration
wizard validates the parameters you entered. If the parameters are
successfully validated, and the notification mailer is currently running,
then Oracle Workflow Manager immediately refreshes the notification
mailer with the new parameters.
Scheduling Events
This page lets you schedule events to control the running of the service component. The
events are raised at the scheduled time by DBMS jobs. For a notification mailer service
component, you can schedule the following events:
• Start
• Refresh
• Suspend
• Resume
• Stop
For each event, the list displays the event name, date and time when the event is first
scheduled to be raised, the interval in minutes at which the event is reraised, and, for a
Refresh event, any parameters to be refreshed. You can specify the following
• 2 - Procedure
• 3 - Event
• 4 - Exception
• 5 - Error
• 6 - Unexpected
• FROM - From
To schedule events:
• If no events are currently scheduled, click the Add a Row button to add a new row
to the list of events and enter the information for the event.
• Select the event for the command you want to schedule.
• Select the date when you want the event to be raised first.
• Select the hour and minute to specify the time on the specified date when you
want the event to be raised first. The hour values are in a twenty-four hour
format. For example, select 00 for midnight, or 23 for 11 PM.
Note: Specify the date and time according to your client time
zone.
• If you want to raise the event periodically, enter the time interval in minutes at
which you want to raise the event. If you do not specify a repeating interval, the
event is raised only once.
• If you choose the refresh event, you can optionally enter any parameters you
want to include with the event in order to refresh the notification mailer
configuration parameters with those values when the event is raised. Specify
the parameter names and values in the following format, separating the
parameters with a colon (:):
internal_parameter_name=parameter_value
For example: PROCESSOR_OUT_THREAD_COUNT=3
If a parameter value itself contains a colon (:), then precede the colon with a
backslash (\) as an escape character, as follows:
\:
• To schedule another event, click the Add Another Row button and enter the
information for the event.
• To remove an event, select the event and click the Remove button.
Tags
This page lets you enter patterns of text found in unusual messages and the status you
want to assign to an inbound message if it contains any of those patterns. For example,
unusual messages include bounced or returned messages and auto-reply messages such
as those sent by vacation daemons, mass mailing lists, and so on. Since different mail
systems vary in how they identify bounced, undeliverable, or otherwise invalid
messages, you can use notification mailer tags to specify how your mail system
identifies those stray messages and how you want the notification mailer to handle
those messages should it come across them.
Oracle Workflow provides several predefined tags for text commonly found in
undeliverable or auto-reply messages. For each tag, the list displays the pattern, which
is the string of text to look for in the From line, Subject line, or body of the message, and
the action, which is the mail status to assign to the message if that pattern is found. The
notification mailer handles messages according to these mail status values, as follows:
• Undelivered - Moves the message to the discard folder and updates the
notification's mail status to FAILED. Additionally, the notification preference of the
recipient of the notification is updated to DISABLED. No error process is initiated
for this notification activity. However, after correcting the issues that prevented the
email from being sent, you can reset the user's notification preference and then run
the Resend Failed/Error Workflow Notifications program to re-enqueue failed
notifications on the notification mailer's outbound queue. See: Handling Mailer
Errors, page 2-93.
• Ignore - Moves the message to the discard folder and continues waiting for a valid
reply to the open notification. The notification's status is still OPEN and its mail
status is still SENT.
• Error - Moves the message to the discard folder and updates the notification's mail
status to ERROR.
You can define additional tags for other patterns you want the notification mailer to
handle automatically.
• To add a new tag, click the Add Another Row button, enter the text pattern in the
Pattern column, and select the status you want to assign to messages containing
that pattern in the Action column.
• To remove a tag, select the tag and click the Remove button. You can only remove
custom tags that you defined. You cannot remove predefined tags provided by
Oracle Workflow.
Note: If a message response matches more than one pattern in the list of
tags, the message is tagged with the status of the first tag it matches.
That is, the notification mailer performs a top to bottom comparison
Note: When defining custom tags, take care to choose a text pattern that
is specific to the type of message you want to process, in order to avoid
possible false positives. If a pattern for a tag appears in more message
contexts than you intend, then the notification mailer might apply the
tag action to a received email unnecessarily.
Test
This page lets you test the configuration for a notification mailer that performs
outbound email processing by sending sample notification messages. Select the
recipient role to which the messages should be sent, and click the Send Test Message
button.
Oracle Workflow sends two test messages to the recipient role: one message with
content built using PL/SQL and one message with Oracle Application Framework
content. Check the email account for the recipient role to view the test messages and
reply to them with the Acknowledge response. If you did not implement inbound email
processing for this mailer, use the Worklist pages to respond to the test messages after
viewing the outbound messages in email. After you acknowledge both test messages,
Oracle Workflow sends a confirmation message to the same recipient role to show that
the notification mailer successfully processed the inbound response emails.
Review
This page lets you review the configuration parameter values that you set, the events
that you scheduled, and the tags that you defined for this notification mailer service
component.
• If you want to change any of these settings, return to the appropriate step in the
configuration wizard to make your changes. To return to the previous step, click the
Back button.
• To save these settings and finish the configuration, click the Finish button.
Agent Listeners
The Oracle Workflow Business Event System requires agent listeners to be scheduled to
receive inbound event messages. An agent listener monitors a Business Event System
agent for incoming messages and dequeues messages using the agent's queue handler.
You should run agent listeners for your local inbound agents. Run PL/SQL agent
listeners to process event subscriptions with a PL/SQL rule function in the database,
and run Java agent listeners to process event subscriptions with a Java rule function in
the application tier.
When an event message is dequeued, the Event Manager begins subscription
processing for the event. The Event Manager searches for and executes any active
subscriptions by the local system to that event with a source type of External, and also
You cannot delete the seeded agent listeners or edit their names, assigned agents,
correlation ID values, or containers. However, if necessary you can update other
configuration parameters, schedule control events, or manually choose control
commands to start, stop, suspend, resume, or refresh the agent listeners.
You can also optionally create additional agent listener service components. For
example, you can configure agent listeners for other inbound agents that you want to
use for event message propagation, such as the standard WF_IN and WF_JMS_IN
agents, or any custom agents. You can also configure an agent listener that only
processes messages on a particular agent that are instances of a specific event.
In addition to the parameters in the configuration wizard, for both seeded and custom
PL/SQL agent listeners, you can optionally set the following internal agent listener
parameters.
• SQL_TRACE_LEVEL - Lets you enable SQL tracing at various levels or disable SQL
tracing for the agent listener.
Use the afsvcpup.sql script to set these parameters. See: Scheduling Listeners for
Local Inbound Agents, page 2-192 and To Set Internal Agent Listener Parameters, page
2-196.
If you create custom agent listener service components, you can either assign them to
the seeded container for agent listeners, named Workflow Agent Listener Service, or,
based on the volume to be handled by the seeded container, you can also choose to
create your own custom containers.
Before the seeded agent listener service components can run, the Workflow Agent
Listener Service container which manages them must be first be started. You should
ensure that this container is running. If you create your own custom containers for
custom service components, ensure that those containers are running as well. Use the
Service Instances page to start each container as a service instance in Generic Service
Management (GSM). When the Workflow Agent Listener Service container is running,
it automatically starts the Workflow Deferred Agent Listener, Workflow Deferred
Notification Agent Listener, Workflow Error Agent Listener, and Workflow Inbound
Notifications Agent Listener.
Define
This page lets you define general attributes for the service component. Some attributes
are already set to required values and cannot be modified. You must set attributes
marked with an asterisk (*) to appropriate values for your environment before you can
run the service component.
• Status - When you edit a previously created service component, the configuration
wizard displays the status of the service component.
• Name - The name of the service component. This name must be unique.
• Startup Mode - Select Automatic, Manual, or On-Demand as the startup mode for
the service component.
• Container Type - The container type to which this service component belongs,
which is always Oracle Applications Generic Service Management (Oracle
Applications GSM).
• Inbound Agent - The Business Event System agent that you want to monitor for
inbound event messages.
• Outbound Agent - Leave this field blank. Agent listener service components do not
use an outbound agent.
• For all other agents, a general agent listener can process all messages on the
agent. Even if you have configured a dedicated listener for a particular agent, a
message that matches the dedicated agent listener's correlation ID may still be
processed by a general listener if that listener is the first to access the message.
For example, the seeded Workflow Error Agent Listener and Workflow
Inbound Notifications Agent Listener do not have any correlation ID specified
so that they can process all event messages on their respective agents.
To cancel the configuration without saving any changes, click the Cancel button.
To save these settings and proceed to the next step of the configuration wizard, click the
Next button.
Details
This page lets you define detail attributes for the service component. You must set
attributes marked with an asterisk (*) to appropriate values for your environment
before you can run the service component. A refresh icon identifies attributes that can
be refreshed dynamically while the service component is running.
• ID - When you edit a previously created service component, the configuration
wizard displays the identifier for the service component.
• Status - When you edit a previously created service component, the configuration
wizard displays the status of the service component.
• Name - The configuration wizard displays the name defined for the service
component.
• Container - The container to which the service component will belong. Oracle
Workflow provides a container called Workflow Agent Listener Service for agent
listener service components.
• Max Error Count - The number of consecutive errors the service component can
encounter before its container stops it and changes its status to Stopped with Error.
If an error is resolved and processing can continue, the error count is reset. The
default value for the maximum error count is 10.
• Inbound Thread Count - Set the inbound processing thread count to 1 (one) or
higher to enable inbound message processing with this agent listener. Set the
inbound thread count to 0 (zero) to disable this agent listener. The default value is 1.
If this agent listener receives a high volume of inbound messages, you can set the
inbound thread count to a higher value to increase throughput.
• Outbound Thread Count - Leave this parameter set to the default value of 0 (zero).
Agent listener service components do not perform outbound message processing.
• Log Level - Select the level of detail for the information you want to record in the
service component container log. The recommended log level, which is also the
default value, is Error. Usually the log level only needs to be changed if you want to
record additional detailed information for debugging purposes. You can choose the
following levels:
• 1 - Statement
• 2 - Procedure
• 3 - Event
• 4 - Exception
• 5 - Error
• 6 - Unexpected
• Processor Read Wait Timeout - Specify the amount of time in seconds that the
service component's processing thread continues to wait, after reading the last
message from its assigned queue, before timing out. If another message is received
before this time expires, that message is processed and the timeout period begins
again. If the timeout period expires and no more messages have been received, the
service component stops reading and its sleep time begins. The default read timeout
period for an agent listener is 0 (zero) seconds.
• Processor Min Loop Sleep - Specify the minimum sleep time in seconds during
• Processor Max Loop Sleep - Specify the maximum sleep time in seconds if you
want to increase the sleep time between read attempts when no messages are
received. If you specify a maximum sleep time that is greater than the minimum
sleep time, then the service component initially waits for the minimum sleep time
after it finishes reading messages from its queue. If no messages are read in
subsequent attempts, then the sleep time between read attempts gradually increases
until the maximum sleep time is reached. Increasing the sleep time can help
enhance performance if messages are received infrequently. You can also specify 0
(zero) for this parameter to indicate that the sleep time should not be increased. In
this case, the service component always waits for the minimum sleep time between
read attempts. The default value for an agent listener is 0 (zero).
• Processor Error Loop Sleep - Specify the sleep time in seconds during which the
service component waits, after an error occurs, before it attempts to begin
processing again. The default error sleep time for an agent listener is 60 seconds.
• Processor Close on Read Timeout - Select this parameter to specify that the service
component should close its connections after its read timeout period expires, when
its sleep time begins. Deselect this parameter to specify that the connections should
remain open until the processing thread stops.
Scheduling Events
This page lets you schedule events to control the running of the service component. The
events are raised at the scheduled time by DBMS jobs. For an agent listener service
component, you can schedule the following events:
• Start
• Refresh
• Suspend
• Resume
For each event, the list displays the event name, date and time when the event is first
scheduled to be raised, the interval in minutes at which the event is reraised, and, for a
refresh event, any parameters to be refreshed. You can specify the following refreshable
parameters, using the parameters' internal names, when you refresh the agent listener.
• PROCESSOR_IN_THREAD_COUNT - Inbound Thread Count
• 2 - Procedure
• 3 - Event
• 4 - Exception
• 5 - Error
• 6 - Unexpected
To schedule events:
• If no events are currently scheduled, click the Add a Row button to add a new row
to the list of events and enter the information for the event.
• Select the event for the command you want to schedule. Oracle Workflow
provides events to let you start, stop, refresh, suspend, or resume the service
component.
• Select the date when you want the event to be raised first.
• Select the hour and minute to specify the time on the specified date when you
want the event to be raised first. The hour values are in a twenty-four hour
format. For example, select 00 for midnight, or 23 for 11 PM.
Note: Specify the date and time according to your client time
zone.
• If you want to raise the event periodically, enter the time interval in minutes at
which you want to raise the event. If you do not specify a repeating interval, the
event is raised only once.
• If you choose the refresh event, you can optionally enter any parameters you
want to include with the event in order to refresh the agent listener
• To schedule another event, click the Add Another Row button and enter the
information for the event.
• To remove an event, select the event and click the Remove button.
Review
This page lets you review the configuration parameter values that you set and the
events that you scheduled for this service component.
• If you want to change any of these settings, return to the appropriate step in the
configuration wizard to make your changes. To return to the previous step, click the
Back button.
• To save these settings and finish the configuration, click the Finish button.
You can optionally update the configuration of the Web Services IN Agent listener or
delete this service component if necessary. You cannot delete the Workflow Java
Deferred Agent Listener and Workflow Java Error Agent Listener or edit their names,
assigned agents, correlation ID values, or containers. However, if necessary you can
update other configuration parameters, schedule control events, or manually choose
control commands to start, stop, suspend, resume, or refresh these Java agent listeners.
You can also optionally create additional Java agent listener service components. For
example, you can configure Java agent listeners for other inbound agents that you want
to use for event message propagation in the application tier, such as custom agents. You
can also configure a Java agent listener that only processes messages on a particular
agent that are instances of a specific event.
In addition to the parameters in the configuration wizard, for both seeded and custom
Java agent listeners, you can optionally set an internal agent listener parameter named
NAVIGATION_RESET_THRESHOLD. This parameter lets you reset the agent listener's
navigation through waiting messages to include newly arrived messages, so that new
high priority messages are processed sooner. Use the afsvcpup.sql script to set this
parameter. See: Scheduling Listeners for Local Inbound Agents, page 2-192 and To Set
Internal Agent Listener Parameters, page 2-196.
Define
This page lets you define general attributes for the service component. Some attributes
are already set to required values and cannot be modified. You must set attributes
marked with an asterisk (*) to appropriate values for your environment before you can
run the service component.
• ID - When you edit a previously created service component, the configuration
wizard displays the identifier for the service component.
• Status - When you edit a previously created service component, the configuration
wizard displays the status of the service component.
• Name - The name of the service component. This name must be unique.
• Startup Mode - Select Automatic, Manual, or On-Demand as the startup mode for
the service component.
• Container Type - The container type to which this service component belongs,
which is always Oracle Applications Generic Service Management (Oracle
Applications GSM).
• Outbound Agent - Leave this field blank. Java agent listener service components do
not use an outbound agent.
• For all other agents, a general Java agent listener can process all messages on
the agent. Even if you have configured a dedicated listener for a particular
agent, a message that matches the dedicated Java agent listener's correlation ID
may still be processed by a general listener if that listener is the first to access
the message.
To cancel the configuration without saving any changes, click the Cancel button.
To save these settings and proceed to the next step of the configuration wizard, click the
Next button.
Details
This page lets you define detail attributes for the service component. You must set
attributes marked with an asterisk (*) to appropriate values for your environment
before you can run the service component. A refresh icon identifies attributes that can
be refreshed dynamically while the service component is running.
• ID - When you edit a previously created service component, the configuration
wizard displays the identifier for the service component.
• Status - When you edit a previously created service component, the configuration
wizard displays the status of the service component.
• Name - The configuration wizard displays the name defined for the service
component.
• Container - The container to which the service component will belong. Oracle
Workflow provides a container called Workflow Agent Listener Service for Java
agent listener service components.
• Maximum Idle Time - If you selected the On-Demand startup mode for the service
component, enter the maximum time in minutes that the service component can
remain idle before it is stopped. An on-demand component that is stopped in this
way will be restarted by its container when it is needed again to process new
messages.
• Max Error Count - The number of consecutive errors the service component can
encounter before its container stops it and changes its status to Stopped with Error.
If an error is resolved and processing can continue, the error count is reset. The
default value for the maximum error count is 10.
• Inbound Thread Count - Set the inbound processing thread count to 1 (one) or
higher to enable inbound message processing with this Java agent listener. Set the
inbound thread count to 0 (zero) to disable this Java agent listener. The default
value is 1. If this Java agent listener receives a high volume of inbound messages,
• Outbound Thread Count - Leave this parameter set to the default value of 0 (zero).
Java agent listener service components do not perform outbound message
processing.
• Log Level - Select the level of detail for the information you want to record in the
service component container log. The recommended log level, which is also the
default value, is Error. Usually the log level only needs to be changed if you want to
record additional detailed information for debugging purposes. You can choose the
following levels:
• 1 - Statement
• 2 - Procedure
• 3 - Event
• 4 - Exception
• 5 - Error
• 6 - Unexpected
• Processor Read Wait Timeout - Specify the amount of time in seconds that the
service component's processing thread continues to wait, after reading the last
message from its assigned queue, before timing out. If another message is received
before this time expires, that message is processed and the timeout period begins
again. If the timeout period expires and no more messages have been received, the
service component stops reading and its sleep time begins. The default read timeout
period for a Java agent listener is 10 seconds.
• Processor Min Loop Sleep - Specify the minimum sleep time in seconds during
which the service component waits, after its read timeout period expires, before it
checks its queue for messages again. The default minimum sleep time for a Java
agent listener is 5 seconds.
• Processor Max Loop Sleep - Specify the maximum sleep time in seconds if you
want to increase the sleep time between read attempts when no messages are
received. If you specify a maximum sleep time that is greater than the minimum
sleep time, then the service component initially waits for the minimum sleep time
after it finishes reading messages from its queue. If no messages are read in
subsequent attempts, then the sleep time between read attempts gradually increases
until the maximum sleep time is reached. Increasing the sleep time can help
enhance performance if messages are received infrequently. You can also specify 0
(zero) for this parameter to indicate that the sleep time should not be increased. In
this case, the service component always waits for the minimum sleep time between
• Processor Error Loop Sleep - Specify the sleep time in seconds during which the
service component waits, after an error occurs, before it attempts to begin
processing again. The default error sleep time for a Java agent listener is 60 seconds.
• Processor Close on Read Timeout - Select this parameter to specify that the service
component should close its connections after its read timeout period expires, when
its sleep time begins. Deselect this parameter to specify that the connections should
remain open until the processing thread stops.
Scheduling Events
This page lets you schedule events to control the running of the service component. The
events are raised at the scheduled time by DBMS jobs. For a Java agent listener service
component, you can schedule the following events:
• Start
• Refresh
• Suspend
• Resume
• Stop
For each event, the list displays the event name, date and time when the event is first
scheduled to be raised, the interval in minutes at which the event is reraised, and, for a
refresh event, any parameters to be refreshed. You can specify the following refreshable
parameters, using the parameters' internal names, when you refresh the Java agent
listener.
• PROCESSOR_IN_THREAD_COUNT - Inbound Thread Count
• 3 - Event
• 4 - Exception
• 5 - Error
• 6 - Unexpected
To schedule events:
• If no events are currently scheduled, click the Add a Row button to add a new row
to the list of events and enter the information for the event.
• Select the event for the command you want to schedule. Oracle Workflow
provides events to let you start, stop, refresh, suspend, or resume the service
component.
• Select the date when you want the event to be raised first.
• Select the hour and minute to specify the time on the specified date when you
want the event to be raised first. The hour values are in a twenty-four hour
format. For example, select 00 for midnight, or 23 for 11 PM.
Note: Specify the date and time according to your client time
zone.
• If you want to raise the event periodically, enter the time interval in minutes at
which you want to raise the event. If you do not specify a repeating interval, the
event is raised only once.
• If you choose the refresh event, you can optionally enter any parameters you
want to include with the event in order to refresh the Java agent listener
configuration parameters with those values when the event is raised. Specify
the parameter names and values in the following format, separating the
parameters with a colon (:):
internal_parameter_name=parameter_value
For example: PROCESSOR_IN_THREAD_COUNT=1
If a parameter value itself contains a colon (:), then precede the colon with a
backslash (\) as an escape character, as follows:
\:
• To schedule another event, click the Add Another Row button and enter the
information for the event.
Review
This page lets you review the configuration parameter values that you set and the
events that you scheduled for this service component.
• If you want to change any of these settings, return to the appropriate step in the
configuration wizard to make your changes. To return to the previous step, click the
Back button.
• To save these settings and finish the configuration, click the Finish button.
Define
This page lets you define general attributes for the service component. Some attributes
are already set to required values and cannot be modified. You must set attributes
marked with an asterisk (*) to appropriate values for your environment before you can
run the service component.
• ID - When you edit a previously created service component, the configuration
wizard displays the identifier for the service component.
• Status - When you edit a previously created service component, the configuration
wizard displays the status of the service component.
• Name - The name of the service component. This name must be unique.
• Startup Mode - Select Automatic, Manual, or On-Demand as the startup mode for
the service component.
• Container Type - The container type to which this service component belongs,
• Inbound Agent - Leave this field blank. Web services outbound components do not
use an inbound agent.
• Outbound Agent - The agent/queue that you want to monitor for outbound Web
services messages.
To cancel the configuration without saving any changes, click the Cancel button.
To save these settings and proceed to the next step of the configuration wizard, click the
Next button.
Details
This page lets you define detail attributes for the service component. You must set
attributes marked with an asterisk (*) to appropriate values for your environment
before you can run the service component. A refresh icon identifies attributes that can
be refreshed dynamically while the service component is running.
• ID - When you edit a previously created service component, the configuration
wizard displays the identifier for the service component.
• Status - When you edit a previously created service component, the configuration
wizard displays the status of the service component.
• Name - The configuration wizard displays the name defined for the service
component.
• Container - The container to which the service component will belong. Oracle
Workflow provides a container called Workflow Document Web Services Service
for Web services outbound components.
• Maximum Idle Time - If you selected the On-Demand startup mode for the service
component, enter the maximum time in minutes that the service component can
remain idle before it is stopped. An on-demand component that is stopped in this
way will be restarted by its container when it is needed again to process new
messages.
• Max Error Count - The number of consecutive errors the service component can
encounter before its container stops it and changes its status to Stopped with Error.
If an error is resolved and processing can continue, the error count is reset. The
default value for the maximum error count is 10.
• Inbound Thread Count - Leave this parameter set to the default value of 0 (zero).
Web services outbound components do not perform inbound message processing.
• Log Level - Select the level of detail for the information you want to record in the
service component container log. The recommended log level, which is also the
default value, is Error. Usually the log level only needs to be changed if you want to
record additional detailed information for debugging purposes. You can choose the
following levels:
• 1 - Statement
• 2 - Procedure
• 3 - Event
• 4 - Exception
• 5 - Error
• 6 - Unexpected
• Processor Read Wait Timeout - Specify the amount of time in seconds that the
service component's processing threads continue to wait, after reading the last
message from the assigned queue, before timing out. If another message is received
before this time expires, that message is processed and the timeout period begins
again. If the timeout period expires and no more messages have been received, the
service component stops reading and its sleep time begins. The default read timeout
period for a Web services outbound component is 10 seconds.
• Processor Min Loop Sleep - Specify the minimum sleep time in seconds during
which the service component waits, after its read timeout period expires, before it
checks its queue for messages again. The default minimum sleep time for a Web
services outbound component is 5 seconds.
• Processor Max Loop Sleep - Specify the maximum sleep time in seconds if you
want to increase the sleep time between read attempts when no messages are
received. If you specify a maximum sleep time that is greater than the minimum
sleep time, then the service component initially waits for the minimum sleep time
after it finishes reading messages from its queue. If no messages are read in
subsequent attempts, then the sleep time between read attempts gradually increases
until the maximum sleep time is reached. Increasing the sleep time can help
enhance performance if messages are received infrequently. You can also specify 0
(zero) for this parameter to indicate that the sleep time should not be increased. In
this case, the service component always waits for the minimum sleep time between
read attempts. The default maximum sleep time for a Web services outbound
• Processor Error Loop Sleep - Specify the sleep time in seconds during which the
service component waits, after an error occurs, before it attempts to begin
processing again. The default error sleep time for a Web services outbound
component is 60 seconds.
• Processor Close on Read Timeout - Select this parameter to specify that the service
component should close its connections after its read timeout period expires, when
its sleep time begins. Deselect this parameter to specify that the connections should
remain open until the processing thread stops.
Scheduling Events
This page lets you schedule events to control the running of the service component. The
events are raised at the scheduled time by DBMS jobs. For a Web services outbound
component, you can schedule the following events:
• Start
• Refresh
• Suspend
• Resume
• Stop
For each event, the list displays the event name, date and time when the event is first
scheduled to be raised, the interval in minutes at which the event is reraised, and, for a
refresh event, any parameters to be refreshed. You can specify the following refreshable
parameters, using the parameters' internal names, when you refresh the Web services
outbound component.
• PROCESSOR_OUT_THREAD_COUNT - Outbound Thread Count
• 3 - Event
• 4 - Exception
• 5 - Error
• 6 - Unexpected
To schedule events:
• If no events are currently scheduled, click the Add a Row button to add a new row
to the list of events and enter the information for the event.
• Select the event for the command you want to schedule. Oracle Workflow
provides events to let you start, stop, refresh, suspend, or resume the service
component.
• Select the date when you want the event to be raised first.
• Select the hour and minute to specify the time on the specified date when you
want the event to be raised first. The hour values are in a twenty-four hour
format. For example, select 00 for midnight, or 23 for 11 PM.
Note: Specify the date and time according to your client time
zone.
• If you want to raise the event periodically, enter the time interval in minutes at
which you want to raise the event. If you do not specify a repeating interval, the
event is raised only once.
• If you choose the refresh event, you can optionally enter any parameters you
want to include with the event in order to refresh the Web services outbound
configuration parameters with those values when the event is raised. Specify
the parameter names and values in the following format, separating the
parameters with a colon (:):
internal_parameter_name=parameter_value
For example: PROCESSOR_OUT_THREAD_COUNT=3
If a parameter value itself contains a colon (:), then precede the colon with a
backslash (\) as an escape character, as follows:
\:
• To schedule another event, click the Add Another Row button and enter the
information for the event.
Review
This page lets you review the configuration parameter values that you set and the
events that you scheduled for this service component.
• If you want to change any of these settings, return to the appropriate step in the
configuration wizard to make your changes. To return to the previous step, click the
Back button.
• To save these settings and finish the configuration, click the Finish button.
Background Engines
Background engine processes serve three purposes in Oracle Workflow: to handle
activities deferred by the Workflow Engine, to handle timed out notification activities,
and to handle stuck processes.
When the Workflow Engine initiates and performs a process, it completes all necessary
activities before continuing to the next eligible activity. In some cases, an activity can
require a large amount of processing resource or time to complete. Oracle Workflow
lets you manage the load on the Workflow Engine by setting up supplemental engines
to run these costly activities as background tasks. In these cases, the costly activity is
deferred by the Workflow Engine and run later by a background engine. The main
Workflow Engine can then continue to the next available activity, which may occur on
some other parallel branch of the process.
A background engine must also be set up to handle timed out notification activities.
When the Workflow Engine comes across a notification activity that requires a
response, it calls the Notification System to send the notification to the appropriate
performer, and then sets the notification activity to a status of 'NOTIFIED' until the
performer completes the notification activity. Meanwhile, a background engine set up
• A process with only one thread loops back, but the pivot activity of the loop has the
On Revisit property set to Ignore.
• An activity returns a result for which no eligible transition exists. For instance, if the
function for a function activity returns an unexpected result value, and no default
transition is modeled after that activity, the process cannot continue.
The background engine sets the status of a stuck process to ERROR:#STUCK and
executes the error process defined for it.
You can define and start up as many background engines as you like to check for
deferred and timed out activities.
You run a background engine by submitting the Workflow Background Process
concurrent program (FNDWFBG). Background engines can be restricted to handle
activities associated with specific item types, and within specific cost ranges. A
background engine runs until it completes all eligible activities at the time it was
initiated. Generally, you should set the background engine up to run periodically.
Ensure that you have at least one background engine that can check for timed out
activities, one that can process deferred activities, and one that can handle stuck
processes. At a minimum, you need to set up one background engine that can handle
both timed out and deferred activities as well as stuck processes. Generally, you should
run a separate background engine to check for stuck processes at less frequent intervals
than the background engine that you run for deferred activities, normally not more
often than once a day. Run the background engine to check for stuck processes when
the load on the system is low.
Note: If you implement workflow RAC affinity, then you should also
run background engines using the Workflow Background Process for
RAC concurrent program (FNDWFBGRAC). This program runs
background engines that each process only the RAC-enabled
workflows that were launched in a specific RAC instance. Running
background engines with RAC affinity provides faster access to the
workflow runtime data and helps avoid contention. However, you
Navigation: Applications Dashboard > (pull-down menu) Workflow Manager > (B) Go
Parameters
When you submit the Workflow Background Process concurrent program, specify the
following parameters.
• Item Type - Specify an item type to restrict this engine to activities associated with
that item type. If you do not specify an item type, the engine processes any activity
regardless of its item type.
• Minimum Threshold - Specify the minimum cost that an activity must have for this
background engine to execute it, in hundredths of a second.
• Maximum Threshold - Specify the maximum cost that an activity can have for this
background engine to execute it, in hundredths of a second. By using Minimum
Threshold and Maximum Threshold you can create multiple background engines to
handle very specific types of activities. The default values for these arguments are
null so that the background engine runs activities regardless of cost.
• Process Deferred - Specify whether this background engine checks for deferred
activities. Setting this parameter to Yes allows the engine to check for deferred
activities.
• Process Timeout - Specify whether this background engine checks for activities that
have timed out. Setting this parameter to Yes allows the engine to check for timed
out activities.
Note: Make sure you have a least one background engine that can
check for timed out activities, one that can process deferred activities,
and one that can handle stuck processes. At a minimum, you need to
set up one background engine that can handle both timed out and
deferred activities as well as stuck processes.
• To hide the details for a request if they are shown, click the Hide link in the Details
column.
• To search for concurrent requests with different criteria, click the New Search
button or click one of the Quick Search links.
• To modify the search criteria from this search, click the Modify Search button.
• To add the information from this page to your support cart, click the Add to
Support Cart button.
Note: This program does not delete ad hoc users or roles whose
expiration date is null. To ensure that ad hoc users and roles are purged
in a timely fashion after they are no longer needed, estimate how long
they should be active and specify an appropriate expiration date when
you call WF_DIRECTORY.CreateAdHocUser(), WF_DIRECTORY.
CreateAdHocRole(), or WF_DIRECTORY.CreateAdHocRole2() to create
them.
To preserve electronic signature evidence for future reference, this program by default
does not delete any notifications that required signatures or their associated signature
information. If you do not need to maintain signature evidence, you can choose to
delete signature-related information as well.
You can also optionally use this program to purge cached data from the
WF_ATTRIBUTE_CACHE and WF_ENTITY_CHANGES tables. These tables contain
cached data related to defining users as well as integration with LDAP and Oracle
Directory Services.
Note: You can also use the Purge Obsolete ECX Data concurrent
program to purge Oracle XML Gateway transactions according to
Oracle XML Gateway-specific parameters. For information about this
program and about the ECX: Purge ECX data with WF profile option,
see: Purge Obsolete ECX Data Concurrent Program, Oracle XML
Gateway User's Guide and Purge Obsolete Workflow Runtime Data
Concurrent Program, Oracle XML Gateway User's Guide.
Workflow Purge
The Workflow Purge page shows summary information about the next scheduled and
last completed purge requests and about completed work items.
Requests Summary
This region displays summary information about the next scheduled and last completed
Purge Obsolete Workflow Runtime Data concurrent requests.
• To show information in this region if it is hidden, click the Show link.
Next Scheduled
For the next scheduled Purge Obsolete Workflow Runtime Data concurrent request,
Oracle Workflow Manager displays the request ID, requestor, status, requested start
time, wait time, and parameters.
Last Completed
For the last completed Purge Obsolete Workflow Runtime Data concurrent request,
Oracle Workflow Manager displays the request ID, requestor, status, completed time,
duration, and parameters.
To view the log file for the request, click the Request Log link.
For each work item type in the Completed Work Items list, Oracle Workflow Manager
displays the work item type name, the persistence type, the retention period in days, the
number of completed work items of that type, and the number of items of that type that
are available for purging. Click any column heading to sort the list by that column.
• To filter the item types displayed in the list, select an item type property and an
operator from the Filter pull-down menus, enter a filter value in the text field, and
click the Go button. You can filter by the following properties:
• Work item type display name
• Persistence type
• Retention period
• To view details for work items of a particular item type, either click the item type
link in the Work Item Type column, or select the item type and click the View
Details button.
• To view Purge Obsolete Workflow Runtime Data concurrent requests, click the
View Purge Requests button in the Completed Work Items region of the Workflow
Purge page.
Parameters
When you submit the Purge Obsolete Workflow Runtime Data concurrent program,
specify the following parameters.
• Item Key - Specify the item key to purge. The item key is a unique identifier for an
item within an item type. Leave this field blank to purge the runtime data for all
items of the specified item type.
• Age - Specify the minimum age of data to purge, in days, if you are purging items
with a Temporary persistence type. The default is 0 days.
• Persistence Type - Specify the persistence type of the data you want to purge,
either Permanent or Temporary. The default is Temporary.
• Core Workflow Only - Enter 'Y' to purge only obsolete runtime data associated
with work items, or 'N' to purge all obsolete runtime data as well obsolete design
data. The default is 'N'.
• Commit Frequency - Enter the number of records to purge before the program
commits data. To reduce rollback size and improve performance, set this parameter
to commit data after a smaller number of records. The default is 500 records.
• Other Cached Data - Enter 'Y' to purge cached user definition data from the
WF_ATTRIBUTE_CACHE and WF_ENTITY_CHANGES tables. Enter 'N' if you do
not want to purge this data. The default is 'N'.
• Parallel Thread Count - The number of parallel threads used to perform the purge
processing, which is controlled through the DBMS_PARALLEL_EXECUTE API.
The default value for this parameter is 4.
The value you can set for the Parallel Thread Count parameter depends on the
value of the JOB_QUEUE_PROCESSES database initialization parameter. If you
want to increase the Parallel Thread Count value to improve the performance of the
purge processing, you should first check the value of the JOB_QUEUE_PROCESSES
parameter to determine how many job queue processes are available and decide
how many to use for the purge processing. Do not set the Parallel Thread Count
• To hide the details for a request if they are shown, click the Hide link in the Details
column.
• To search for concurrent requests with different criteria, click the New Search
button or click one of the Quick Search links.
• To modify the search criteria from this search, click the Modify Search button.
• To add the information from this page to your support cart, click the Add to
Support Cart button.
• To view details about the work items that ended at a particular activity stage, either
click the activity stage link in the Work Item Activity Stage column, or select the
activity stage and click the View Details button.
Oracle Workflow Manager displays a list of all completed work items of the selected
item type that ended at the selected activity stage. By default, the list shows completed
work items that ended within the last 30 days. For each work item, the list displays the
internal name of the activity at which the work item ended, the activity start date, end
date, user assigned to perform the activity, and item key. Click any column heading to
sort the list by that column.
• To launch the Workflow Monitor for a work item, select the work item and click the
Launch Workflow Monitor button.
• To view Workflow Control Queue Cleanup concurrent requests, click the Control
Queue Cleanup status icon in the Workflow System status page.
Navigation: Applications Dashboard > (pull-down menu) Workflow Manager > (B) Go
• To search for concurrent requests with different criteria, click the New Search
button or click one of the Quick Search links.
• To modify the search criteria from this search, click the Modify Search button.
• To add the information from this page to your support cart, click the Add to
Support Cart button.
The page displays the date and time when the work item statistics were last updated.
To refresh this information, click the refresh icon. See: Gathering Oracle Workflow
Statistics, page 7-2.
For each work item type, the Active Work Items page displays the work item type name
and the number of active work items of that type. Click any column heading to sort the
list by that column.
• To filter the item types displayed in the list, select an item type property and an
operator from the Filter pull-down menus, enter a filter value in the text field, and
click the Go button. You can filter by the following properties:
• Work item type display name
To view details about active work item activities within a particular item type, either
click the item type link in the Work Item Type column, or select the item type and click
the View Details button.
Navigation: Applications Dashboard > (pull-down menu) Workflow Manager > (B) Go >
Workflow Metrics > Work Items > Active > (B) View Details
To view work items with a different status, choose the status you want from the View
pull-down menu and click the Go button. You can view items with the following
statuses:
• Completed Work Items
• To view details about the work items at a particular activity stage, either click the
activity stage link in the Work Item Activity Stage column, or select the activity
stage and click the View Details button.
Oracle Workflow Manager displays a list of all active activities of the selected stage for
work items of the selected item type. Active work item activities include only activities
with a status of Active, Waiting, or Notified. By default, the list shows active work
items that started within the last 30 days. For each activity, the list displays the activity
internal name, start date, due date, user assigned to perform the activity, and item key
of the work item. Click any column heading to sort the list by that column.
• To filter the work items displayed in the list, select an activity property from the
Filter pull-down menu, enter a filter value in the text field, and click the Go button.
You can filter by the following properties:
• Internal name of the active activity
• To abort all work items in the list, click the Abort All button. If you have filtered the
list, only the work items currently displayed in the list are aborted.
• To suspend all activities in the list, click the Suspend All button. If you have filtered
the list, only the work items currently displayed in the list are suspended.
• To abort a single work item, select the activity you want and click the Abort button.
• To suspend a single activity, select the activity you want and click the Suspend
button.
• To launch the Workflow Monitor for a work item, select the activity you want and
click the Launch Workflow Monitor button.
The page displays the date and time when the work item statistics were last updated.
To refresh this information, click the refresh icon. See: Gathering Oracle Workflow
Statistics, page 7-2.
• To view details for work items of a particular item type, either click the item type
link in the Work Item Type column, or select the item type and click the View
Details button.
Oracle Workflow Manager displays a list of all deferred activities of the selected stage
for work items of the selected item type. By default, the list shows deferred work items
that started within the last 30 days. For each activity, the list displays the activity
internal name, start date, due date, user assigned to perform the activity, and item key
of the work item. Click any column heading to sort the list by that column.
• To filter the work items displayed in the list, select an activity property from the
Filter pull-down menu, enter a filter value in the text field, and click the Go button.
You can filter by the following properties:
• Internal name of the deferred activity
• To abort all work items in the list, click the Abort All button. If you have filtered the
list, only the work items currently displayed in the list are aborted.
• To abort a single work item, select the activity you want and click the Abort button.
• To suspend a single activity, select the activity you want and click the Suspend
button.
• To launch the Workflow Monitor for a work item, select the activity you want and
click the Launch Workflow Monitor button.
The page displays the date and time when the work item statistics were last updated.
To refresh this information, click the refresh icon. See: Gathering Oracle Workflow
Statistics, page 7-2.
For each work item type, the Suspended Work Items page displays the work item type
name and the number of suspended work items of that type. Click any column heading
to sort the list by that column.
• To filter the item types displayed in the list, select an item type property and an
operator from the Filter pull-down menus, enter a filter value in the text field, and
• To view details for an item type, either click the item type link in the Work Item
Type column, or select the item type and click the View Details button.
• To view details about the work items at a particular activity stage, either click the
activity stage link in the Work Item Activity Stage column, or select the activity
stage and click the View Details button.
Oracle Workflow Manager displays a list of all suspended activities of the selected stage
for work items of the selected item type. For each activity, the list displays the activity
internal name, start date, due date, user assigned to perform the activity, and item key
of the work item. Click any column heading to sort the list by that column.
• To filter the work items displayed in the list, select an activity property from the
Filter pull-down menu, enter a filter value in the text field, and click the Go button.
You can filter by the following properties:
• Internal name of the suspended activity
• To abort all work items in the list, click the Abort All button. If you have filtered the
list, only the work items currently displayed in the list are aborted.
• To resume all activities in the list, click the Resume All button. If you have filtered
the list, only the work items currently displayed in the list are resumed.
• To abort a single work item, select the activity you want and click the Abort button.
• To launch the Workflow Monitor for a work item, select the activity you want and
click the Launch Workflow Monitor button.
The page displays the date and time when the work item statistics were last updated.
To refresh this information, click the refresh icon. See: Gathering Oracle Workflow
Statistics, page 7-2.
For each work item type, the Errored Work Items page displays the work item type
name and the number of errored work items of that type. Click any column heading to
sort the list by that column.
• To filter the item types displayed in the list, select an item type property and an
operator from the Filter pull-down menus, enter a filter value in the text field, and
click the Go button. You can filter by the following properties:
• Work item type display name
• To view details for an item type, either click the item type link in the Work Item
Type column, or select the item type and click the View Details button.
• To view details about the work items at a particular activity stage, either click the
activity stage link in the Work Item Activity Stage column, or select the activity
stage and click the View Details button.
Oracle Workflow Manager displays a list of all errored activities of the selected stage for
work items of the selected item type. For each activity, the list displays the activity
internal name, start date, due date, user assigned to perform the activity, and item key
of the work item. Click any column heading to sort the list by that column.
• To filter the work items displayed in the list, select an activity property from the
Filter pull-down menu, enter a filter value in the text field, and click the Go button.
You can filter by the following properties:
• Internal name of the errored activity
• To abort all work items in the list, click the Abort All button. If you have filtered the
list, only the work items currently displayed in the list are aborted.
• To retry all activities in the list, click the Retry All button. If you have filtered the
list, only the work items currently displayed in the list are retried.
• To abort a single work item, select the activity you want and click the Abort button.
• To retry a single activity, select the activity you want and click the Retry button.
• To launch the Workflow Monitor for a work item, select the activity you want and
click the Launch Workflow Monitor button.
Note: You can also use the Retry Errored Workflow Activities
concurrent program to retry multiple errored activities for a particular
item type at once. See: Retry Errored Workflow Activities
(FNDWFRET), page 9-5.
Agents
The Agent Activity page shows the distribution of event messages with different
statuses on different Business Event System agents in your instance of Oracle
Workflow.
Navigation: Applications Dashboard > (pull-down menu) Workflow Manager > (B) Go >
Workflow Metrics > Agent Activity
The page displays the date and time when the agent activity statistics were last
updated. To refresh this information, click the refresh icon. See: Gathering Oracle
Workflow Statistics, page 7-2.
For each agent, the list displays the agent name as well as the number of event messages
on that agent with the following statuses: Ready, Waiting, Processed, Expired, and
Undeliverable. Click any column heading to sort the list by that column.
• To view queue details for an agent, click the agent link in the Agent column.
• To view details about the messages being held on an agent, select the agent and
click the Search Agent Entry Details button.
• Queue Table - The name of the table in which the queue data resides.
• Retry Delay - The time interval between retry attempts, when dequeuing a message
from the queue.
• Retention - The time interval during which processed messages are retained in the
queue.
After reviewing the agent queue details, choose the OK button to return to the Agent
Activity page.
Message Details
The Search Queue page lets you search for messages being held on a particular agent
and review details about those messages. This page displays different message details
depending on the payload type of the agent's queue.
Navigation: Applications Dashboard > (pull-down menu) Workflow Manager > (B) Go >
Workflow Metrics > Agent Activity > (B) Search Agent Entry Details
• Event key
• Enqueue date either within the last seven days or prior to the last seven days
• Dequeue date either within the last seven days, prior to the last seven days, or on
any date
• Status
Oracle Workflow Manager displays the event messages on the queue for the selected
agent that match your filter criteria. For each message, the list displays the event name,
event key, correlation ID, event parameters, From System that sent the message, To
System that received the message, date the message was sent, error message, error
stack, and the message status.
The list also includes any messages on the exception queue associated with the selected
queue. Messages are transferred from a user queue to the associated exception queue if
Oracle Advanced Queuing cannot retrieve or process them for some reason. For more
information, see: Oracle Streams AQ Exception Handling, Oracle Streams Advanced
Queuing User's Guide and Reference.
Note: Each queue table contains one default exception queue that is
shared by all the user queues in that queue table. When you search for
messages on a particular queue, the search result list includes all
messages on the associated exception queue as well, regardless of the
user queue from which they originated. Consequently, if you create
more than one user queue in the same queue table, the search result list
may display exception messages that originated from other queues
than the queue you selected.
• To review the event data for a message as an XML document, choose the message
details icon in the View XML column.
Note: The message details icon is disabled if the event data for a
message is empty.
• To add the information from this page to your support cart, click the Add to
Support Cart button.
APPS_NE.ECXMSG
This page lets you review messages on queues with a payload type of APPS_NE.
• Document number
• Party site ID
• Enqueue date either within the last seven days or prior to the last seven days
• Dequeue date either within the last seven days, prior to the last seven days, or on
any date
• Status
Oracle Workflow Manager displays the messages on the queue for the selected agent
that match your filter criteria. For each message, the list displays the message type,
message standard, transaction type and subtype, document number, party ID, party site
ID, party type, protocol type, protocol address, first, second, third, fourth, and fifth
attributes, and the message status.
• To review the XML document for a message, choose the message details icon in the
View XML column.
Note: The message details icon is disabled if the XML document for
a message is empty.
• To add the information from this page to your support cart, click the Add to
Support Cart button.
APPS_NE.ECX_INENGOBJ
This page lets you review messages on queues with a payload type of APPS_NE.
ECX_INENGOBJ, including the standard Oracle XML Gateway ECX_IN_OAG_Q
queue.
Enter filter criteria to locate the messages you want to review and click the Go button.
You can filter by the following message properties:
• Message ID
• Dequeue date either within the last seven days, prior to the last seven days, or on
any date
• Status
Oracle Workflow Manager displays the messages on the queue for the selected agent
that match your filter criteria. For each message, the list displays the message ID, debug
mode, and the message status.
To add the information from this page to your support cart, click the Add to Support
Cart button.
Queue Propagation
You should schedule propagation for your local outbound agents to send event
messages to their destinations. You can schedule Oracle Advanced Queueing (AQ)
propagation for agents that use the SQLNET protocol by the following methods:
• Use the Distributed Database Management feature to manage AQ through Oracle
Enterprise Manager. See: Oracle Enterprise Manager Support, Oracle Streams
Advanced Queuing User's Guide and Reference.
If you want to use the standard WF_OUT and WF_JMS_OUT agents or custom agents
for event message propagation, ensure that you schedule propagation for those agents.
You do not need to schedule propagation for the WF_CONTROL or
WF_NOTIFICATION_OUT agents, however, because the application tier processes that
use WF_CONTROL dequeue messages directly from its queue, and a notification mailer
sends messages placed on the WF_NOTIFICATION_OUT queue.
Navigation: Applications Dashboard > (pull-down menu) Workflow Manager > (B) Go > Related
Links > Configuration > Queue Propagation
Queue Propagation
Use the Queue Propagation page to review the database initialization parameters
required for queue propagation, as well as the existing propagation schedules for
Business Event System agents in your instance of Oracle Workflow.
Note: In Oracle Database 10g and later, you do not need to set the
AQ_TM_PROCESSES parameter.
Queue Schedules
For each propagation schedule, the list displays the outbound queue, destination
database link, job queue process executing the schedule, whether the schedule is
enabled or disabled, and the error date and error message of the last unsuccessful
execution. Click any column heading to sort the list by that column.
If no process is allocated to execute the schedule, you may need to increase the
JOB_QUEUE_PROCESSES database initialization parameter to ensure that processes
are available for propagation.
To view details for a propagation schedule, either click the queue link in the Queue
column, or select the schedule and click the View Details button.
• Process Name - The name of the job queue process executing this schedule.
• Last Error Message - The error message of the last unsuccessful execution.
• Session ID - The session ID (SID, SERIAL#) of the job executing this schedule;
NULL if not currently executing.
• Failures - The number of times that execution of the schedule failed. If the number
of failures reaches 16, the schedule will be disabled.
• Latency - The latency time in seconds that specifies how long to wait, after all
messages have been propagated, before rechecking the queue for new messages to
the destination. The latency represents the maximum wait time during the
propagation window for a message to be propagated after it is enqueued.
• Next Run Date - The date at which the next propagation window of this schedule
will be started.
• Next Run Time - The time at which the next propagation window of this schedule
will be started, in HH:MI:SS format.
• Current Start Date - The date at which the current propagation window of this
schedule was started.
• Current Start Time - The time at which the current propagation window of this
schedule was started, in HH:MI:SS format.
• Start Date - The date when propagation should be started, in the default date
format.
• Start Time - The time when propagation should be started, in HH:MI:SS format.
• Last Run Time - The time of the last successful execution, in HH:MI:SS format.
• Total Time - The total time, in seconds, spent by the system in executing this
schedule.
This chapter describes access protection for workflow object definitions and how to
load those definitions between a database and a flat file.
This chapter covers the following topics:
• Overview of Oracle Workflow Access Protection
• Access Protection for Business Event System Data
• Using the Workflow Definitions Loader
• Using the Workflow XML Loader
For example, the Oracle Workflow development team is a provider of seed data called
the Standard item type. The Standard item type contains standard activities that can be
dropped into any custom workflow process. The development team at your
organization's headquarters may create a custom workflow process definition that
references activities from the Standard item type. This makes the headquarters team a
consumer of the Standard item type seed data.
Now suppose the headquarters team wants to deploy the custom workflow definition
that it created to teams at other regional offices. The headquarters team, as seed data
• Designate certain objects in its deployed process as customizable for the regional
offices to alter to their offices' needs.
The headquarters team can satisfy both requirement using the access protection feature
in Oracle Workflow. Access protection lets seed data providers protect certain data as
'read-only', while allowing other data to be customized. Also during a seed data
upgrade, access protection lets the seed data provider overwrite any existing protected
seed data with new versions of that seed data, while preserving any customizations
made to customizable seed data.
Oracle Workflow assigns a protection and customization level to every workflow object
definition stored in the database and requires every user of Oracle Workflow to operate
at a certain access level. The combination of protection, customization, and access levels
makes up the access protection feature and determines whether a user can modify a
given workflow object. The level, in all three cases, is a numeric value ranging from 0 to
1000 that indicates the relationship between different organizations as providers and
consumers of seed data.
The following range of levels are presumed by Oracle Workflow:
0-9 Oracle Workflow
1000 Public
Access Level
Each user of Oracle Workflow operates the system at a certain access level according to
the range of levels listed above. A "user of Oracle Workflow" in this case, represents
someone who is operating Oracle Workflow Builder, or the Workflow Definitions
Loader program, which loads workflow process definitions from a file into a database.
As a seed data provider, you should always operate Oracle Workflow Builder at the
same consistent access level because the level you work at affects the protection level of
the seed data you create.
You can view your access level as follows:
• If you are going to run the Workflow Definitions Loader program to download
workflow process definitions from the database to a file, check the value for the
environment variable WF_ACCESS_LEVEL on your workflow server. See: Using
the Workflow Definitions Loader, page 8-8.
Protection Level
Whenever you create a workflow object in Oracle Workflow Builder, you have the
option of protecting the object at a certain level. An object's protection level helps
control whether other users can modify the object based on their access levels, by
allowing only users with an access level equal to or lower than the object's protection
level to modify the object.
Note: The range of access levels allowed to modify the object may be
further restricted by the object's customization level.
To set the protection level of an object, display the Access tab of the object's property
page and either check or clear the Lock at this Access Level checkbox. The protection
level that you set for an object is dependent on the setting of the Lock at this Access
Level checkbox and on your current access level.
• If you check the Lock at this Access Level checkbox, the protection level for the
object is set to your current access level. Users with an access level higher than your
current access level will not be able to modify the object. These users will see a
small lock on the workflow object's icon, indicating that the object can be used but
not modified. For users with an access level equal to or lower than your current
access level, the customization level for the object will determine whether they can
modify the object.
Customization Level
Every workflow object, in addition to having a protection level, also records a
customization level when you modify the object and save it to a database or file. An
object's customization level helps control whether other users can modify the object
based on their access levels, by allowing only users with an access level equal to or
higher than the object's customization level to modify the object.
Note: The range of access levels allowed to modify the object may be
further restricted by the object's protection level.
Setting the customization level ensures that a customizable object that has been
customized never gets overwritten during a seed data upgrade, because the upgrade
always occurs with the Workflow Definitions Loader operating at an access level below
the customized object's customization level.
To set the customization level of an object, display the Access tab of the object's
property page and either check or clear the Preserve Customizations checkbox. The
customization level that you set for an object is dependent on the setting of the Preserve
Customizations checkbox and on your current access level.
• If you check the Preserve Customizations checkbox, the customization level for the
object is set to your current access level. Users with an access level lower than your
current access level will not be able to modify the object. These users will see a
small lock on the workflow object's icon, indicating that the object can be used but
not modified. For users with an access level equal to or lower than your current
access level, the protection level for the object will determine whether they can
modify the object.
• If you do not check the Preserve Customizations checkbox, the customization level
for the object is set to 0. In this case all users who are not restricted by the protection
level can modify the object.
• Limit access to users with access levels equal to your own or higher - If you check
the Preserve Customizations checkbox but do not check the Lock at this Access
Level checkbox, you designate the object as being customizable by anyone with an
access level equal to or higher than your current access level. However, users with a
lower access level will not be able to modify the object. That is, the protection level
is 1000 and the customization level is your current access level. You should only
mark objects as customizable in this way if you are sure that you will not be
providing upgraded versions of this object in the future that would overwrite other
users' customizations to it.
• Limit access to users with access levels equal to your own or lower - If you check
the Lock at this Access Level checkbox but do not check the Preserve
Customizations checkbox, you protect the object and ensure that the object can only
be modified by users with an access level equal to or lower than your current access
level. Users with a higher access level will not be able to modify the object. That is,
the protection level is your current access level and the customization level is 0.
Protect any objects that you want to define as standard components that will not
change unless you provide a global upgrade. For this reason, it is important that
you always operate at the same consistent access level.
• Limit access to users with access levels equal to your own - If you check both the
Lock at this Level and Preserve Customizations checkboxes, you ensure that the
object cannot be modified by anyone other than users operating at your current
access level. That is, the protection level and customization level are both set to
your current access level.
The following table summarizes which access levels can access an object under different
settings of the Preserve Customizations and Lock at this Access Level options.
The protection and access levels in Oracle Workflow are present to remind you that
certain workflow objects should not be modified or should only be modified by
someone accessing the tool at an authorized access level. This feature is not intended as
a means of securing or source controlling your workflow objects.
See: To Set the Access Level for an Object, Oracle Workflow Developer's Guide.
Caution: Although you can modify your access level, Oracle Workflow
does not support any customizations to seed data originally protected
at a level 99 or lower. We STRONGLY RECOMMEND that you not
change your access level to an unauthorized level for modifying
protected data.
• Limit - This level is used only for events and subscriptions seeded by Oracle. At this
level, you can update the event or subscription status to Enabled or Disabled, but
you cannot make any other changes to the object definition. Conversely, an Oracle
seed data upgrade cannot change the status setting, but can change any other
property in the definition.
• User - This level is automatically set for events and subscriptions that you define.
At this level, you can change any property in the event or subscription definition.
However, an Oracle seed data upgrade cannot make any changes in the definition.
During an Oracle E-Business Suite seed data upgrade, the Workflow XML Loader loads
Business Event System object definitions in normal upload mode, preserving any
Related Topics
Events, Oracle Workflow Developer's Guide
Event Subscriptions, Oracle Workflow Developer's Guide
File Specify the full path and name of the file that you want
to download a process definition to, or upgrade or
upload a process definition from.
Item Type If you set Mode to "Download", use the List button to
choose the item type for the process definition you
5. When you finish modifying the print and run options for this request, choose
Submit to submit the request.
6. Rather than use the Submit Requests form, you can also run the Workflow
Definitions Loader concurrent program from the command line by entering the
following commands:
• To upgrade:
WFLOAD apps 0 Y UPGRADE file.wft
ORACLE Password:
• To upload:
WFLOAD apps 0 Y UPLOAD file.wft
ORACLE Password:
• To force:
WFLOAD apps 0 Y FORCE file.wft
ORACLE Password:
• To download:
WFLOAD apps 0 Y DOWNLOADfile.wftITEMTYPE1 [ITEMTYPE2 ...
ITEMTYPEN]
ORACLE Password:
Replace apps with the username for the APPS schema, replace file.wft with the
file specification of a workflow process definition file, and replace ITEMTYPE1,
ITEMTYPE2, ... ITEMTYPEN with the one or more item type(s) you want to
download. You can also download all item types simultaneously by replacing
ITEMTYPE1 with '*' (make sure you enclose the asterisk in single quotes).
A file specification is specified as:
or
<native path>
Related Topics
Overview of Oracle Workflow Access Protection, page 8-1
XML files uploaded or downloaded by the Workflow XML Loader should have the
extension .wfx to identify them as Workflow object XML definitions.
You can download Business Event System object definitions in either normal download
mode or exact download mode.
• Normal download mode lets you save a generic copy of object definitions from one
system that you can use to create similar definitions in other systems. In this mode,
the Workflow XML Loader replaces certain system-specific data within the object
definitions with tokens. Choose normal download mode, for example, when you
want to save Business Event System object definitions from a development system
as seed data that can be uploaded to a production system.
In normal download mode, the Workflow XML Loader uses the following tokens to
replace system-specific data within Business Event System object definitions. The
tokens are prefixed by #.
• #NEW - Replaces the global unique identifier for an agent within an agent definition,
or for an event subscription within a subscription definition.
• #LOCAL - Replaces the global unique identifier for the local system wherever it
appears within an agent or subscription definition.
• #OWNER - Replaces the name of the schema that owns a queue when the schema
appears as part of the queue name and agent address within an agent definition.
• #SID - Replaces the database system identifier (SID) when it appears as part of the
agent address within an agent definition.
• #WF_IN - Replaces the global unique identifier for the WF_IN agent on the local
system when it appears as the Source Agent, Out Agent, or To Agent within an
event subscription definition.
• #WF_OUT - Replaces the global unique identifier for the WF_OUT agent on the local
system when it appears as the Source Agent, Out Agent, or To Agent within an
event subscription definition.
• #WF_ERROR - Replaces the global unique identifier for the WF_ERROR agent on the
local system when it appears as the Source Agent, Out Agent, or To Agent within
an event subscription definition.
Note: Because the Workflow XML Loader replaces the global unique
identifier for a subscription with a token in normal download mode,
each subscription must be identified instead by a unique combination
of subscribing system, source type, triggering event, source agent,
owner name, and owner tag.
However, to ensure the portability of the downloaded Business Event System object
• In force upload mode, the Workflow XML Loader loads the object definitions from
the source XML file into the Business Event System tables in the database and
overwrites any existing definitions, even for events or subscriptions with a
customization level of User. Use this mode when you want to update the
definitions for your own custom events and subscriptions.
See: Access Protection for Business Event System Data, page 8-7 and Managing Business
Events, Oracle Workflow Developer's Guide.
For example, on UNIX, use the following command to run the Workflow XML Loader:
When running the Workflow XML Loader, use either the -d option or the -de option to
specify the download mode that you want.
• -d - Normal download mode. The loader converts system-specific data within the
object definitions to tokens prefixed with #, where appropriate.
• -de - Exact download mode. The loader copies the object definitions as they are
specified in the database and does not convert the system-specific data to tokens.
Additionally, replace the variables in the download command with your parameters as
follows:
• <user> - The user name of your database account.
• <connect_string> - The connect string for the database. The format of the
connect string depends on the JDBC driver type.
• For a JDBC OCI8 driver, the connect string should be the database name as
specified in its TNSNAMES entry, in the following format:
<database_name>
• For a JDBC THIN driver, you can use two different types of connect string. For
the first type, the connect string should include the host name, port number,
and database system identifier (SID) in the following format:
<host_name>:<port_number>:<database_SID>
For the second type, the connect string should include an Oracle Net name-
value pair with the host name, protocol, port number, and SID in the following
format:
(description=(address=(host=<host_name>)(protocol= <protocol>)
(port=<port_number>))(connect_data=(sid=<database_SID>)))
• <lang> - The abbreviation for the language of the XML file. This parameter is case
insensitive. Use the standard language abbreviations for the Oracle Database, such
as US for American or JA for Japanese. For a list of the standard language
abbreviations, see: Locale Data, Oracle National Language Support Guide.
• <output_file> - The name and full path of the output file to which you want to
save the definitions. The output file should have the extension .wfx.
Note: This object type includes only the definitions of the event
groups themselves, without any information about their
member events.
• EVENTS - Event definitions for individual events and definitions for those
events' memberships in any event groups
• <key> - An optional key to restrict the definitions that are downloaded. If you
specify a key, the loader retrieves definitions only for those objects whose internal
names include that key. The key value is case sensitive and cannot contain any
spaces. To retrieve all object definitions of the specified type, you can omit this
parameter.
For example, on UNIX, use the following command to run the Workflow XML Loader:
java -classpath "$<JREPATH>/rt.jar:$<Workflow_JAR_file_directory>:
$<Workflow_JAR_file_directory>/wfjava.jar:
$<Workflow_JAR_file_directory>/wfapi.jar:
$<Workflow_JAR_file_directory>/fndctx.jar:
$<ORACLE_HOME>/jdbc/lib/classes111.zip:"
oracle.apps.fnd.wf.WFXLoad -u[f] <user> <password>
<connect_string> <protocol> <lang> <source_file>
When running the Workflow XML Loader, use either the -u option or the -uf option to
specify the upload mode that you want.
• -u - Normal upload mode. The Workflow XML Loader loads the object definitions
from the source XML file into the Business Event System tables in the database, but
does not make any updates to events or subscriptions with a customization level of
User.
• <connect_string> - The connect string for the database. The format of the
connect string depends on the JDBC driver type.
• For a JDBC OCI8 driver, the connect string should be the database name as
specified in its TNSNAMES entry, in the following format:
<database_name>
• For a JDBC THIN driver, the connect string should include the host name, port
number, and database system identifier (SID) in the following format:
<host_name>:<port_number>:<database_SID>
• <protocol> - The JDBC driver type you want to use to connect to the database.
The JDBC driver type can be either oci8 or thin.
• <lang> - The abbreviation for the language of the XML file. This parameter is case
insensitive. Use the standard language abbreviations for the Oracle Database, such
as US for American or JA for Japanese. For a list of the standard language
abbreviations, see: Locale Data, Oracle National Language Support Guide.
• <source_file> - The name and full path of the source file from which you want
to upload definitions. The source file should have the extension .wfx.
Each subscription definition that you want to upload must include a phase number,
owner name, and owner tag. The Workflow XML Loader cannot upload a source file
containing subscription definitions that are missing this information.
If the source file contains subscription definitions downloaded in exact mode, the
subscriptions are loaded into the Business Event System tables according to their global
unique identifiers. However, if the subscription definitions were downloaded in normal
mode, using tokens, each subscription is identified instead by a unique combination of
subscribing system, source type, triggering event, source agent, owner name, and
owner tag.
This chapter describes the SQL scripts that workflow administrators can run against an
Oracle Workflow server installation.
This chapter covers the following topics:
• Workflow Administration SQL Scripts
• Show activities deferred for the next background engine execution - wfbkgchk.sql,
page 9-8.
• Handle errored activities - wfretry.sql, page 9-14 and Retry Errored Workflow
Activities (FNDWFRET), page 9-5.
• Purge obsolete data - Purge Obsolete Workflow Runtime Data (FNDWFPR), page 9-
3.
• Display the version of the Oracle Workflow server - wfver.sql, page 9-17.
• Run a listener to monitor an agent for inbound event messages - wfagtlst.sql, page
9-7.
Note: This program does not delete ad hoc users or roles whose
expiration date is null. To ensure that ad hoc users and roles are purged
in a timely fashion after they are no longer needed, estimate how long
they should be active and specify an appropriate expiration date when
you call WF_DIRECTORY.CreateAdHocUser(), WF_DIRECTORY.
CreateAdHocRole(), or WF_DIRECTORY.CreateAdHocRole2() to create
To preserve electronic signature evidence for future reference, this program by default
does not delete any notifications that required signatures or their associated signature
information. If you do not need to maintain signature evidence, you can choose to
delete signature-related information as well.
You can also optionally use this program to purge cached data from the
WF_ATTRIBUTE_CACHE and WF_ENTITY_CHANGES tables. These tables contain
cached data related to defining users as well as integration with LDAP and Oracle
Directory Services.
Navigate to the Submit Requests form in Oracle E-Business Suite to submit the Purge
Obsolete Workflow Runtime Data concurrent program. When you install and set up
Oracle E-Business Suite and Oracle Workflow, your system administrator needs to add
this concurrent program to a request security group for the responsibility that you want
to run this program from. See: Overview of Concurrent Programs and Requests, Oracle
E-Business Suite Setup Guide and Running Reports and Programs, Oracle E-Business Suite
User's Guide.
You can supply the following parameters for the Purge Obsolete Workflow Runtime
Data concurrent program:
• Item Type - The item type to purge. Leaving this field blank defaults to purging the
runtime data for all item types.
• Item Key - The item key to purge. Leaving this field blank defaults to purging the
runtime data for all item keys.
• Core Workflow Only - Enter 'Y' to purge only obsolete runtime data associated with
work items, or 'N' to purge all obsolete runtime data as well obsolete design data.
The default is 'N'.
• Commit Frequency - The number of records to purge before the program commits
data. To reduce rollback size and improve performance, set this parameter to
commit data after a smaller number of records. The default is 500 records.
• Other Cached Data - Enter 'Y' to purge cached user definition data from the
WF_ATTRIBUTE_CACHE and WF_ENTITY_CHANGES tables. Enter 'N' if you do
not want to purge this data. The default is 'N'.
• Parallel Thread Count - The number of parallel threads used to perform the purge
processing, which is controlled through the DBMS_PARALLEL_EXECUTE API.
The default value for this parameter is 4.
The value you can set for the Parallel Thread Count parameter depends on the
value of the JOB_QUEUE_PROCESSES database initialization parameter. If you
want to increase the Parallel Thread Count value to improve the performance of the
purge processing, you should first check the value of the JOB_QUEUE_PROCESSES
parameter to determine how many job queue processes are available and decide
how many to use for the purge processing. Do not set the Parallel Thread Count
parameter to the same value as the JOB_QUEUE_PROCESSES parameter, so that
some job queue processes will remain available for other processing.
Note: You can use Oracle Workflow Manager to submit and manage
the Purge Obsolete Workflow Runtime Data concurrent program. See:
Purging Workflow Data, page 7-96.
Additionally, you can use the Purge Obsolete ECX Data concurrent
program to purge Oracle XML Gateway transactions according to
Oracle XML Gateway-specific parameters. For information about this
program and about the ECX: Purge ECX data with WF profile option,
see: Purge Obsolete ECX Data Concurrent Program, Oracle XML
Gateway User's Guide and Purge Obsolete Workflow Runtime Data
Concurrent Program, Oracle XML Gateway User's Guide.
• Item Key - Optionally, to retry only activities that belong to a particular work item,
select the item key that identifies that work item within the item type. The list of
values includes only item keys for work items that have activities with a status of
ERROR.
• Errored On or After - Optionally specify the earliest error date for the activities to
retry.
• Errored On or Before - Optionally specify the latest error date for the activities to
retry.
• Maximum Retries - Optionally specify the maximum number of times that the Retry
Errored Workflow Activities program can retry a particular activity. For example, if
you schedule this program as a recurring request, then you can set this parameter to
limit automatic retries for activities that may need manual intervention to resolve
the errors. The highest value you can specify for this parameter is 99. The default
value is 5.
Note: You can still retry an activity manually using the Status
Monitor, Workflow Manager, or WF_ENGINE.HandleError API,
even after the Retry Errored Workflow Activities program reaches
its maximum number of retries.
See: Running Reports and Programs, Oracle E-Business Suite User's Guide, Accessing the
Administrator Monitor, page 5-1, Errored Work Items, page 7-114, and Wfretry.sql,
page 9-14.
WFNLADD.sql
If you enable a new language in your Oracle installation, use WFNLADD.sql to add the
missing rows for that language to the Oracle Workflow translation tables. See: Setting
Up Additional Languages, page 2-43 and wfnlena.sql, page 9-13.
Use the script as follows:
sqlplus <user> @WFNLADD
Enter password: <password>
Wfagtlst.sql
Use wfagtlst.sql to run a PL/SQL agent listener to monitor an agent for inbound
event messages. When a message is received, the Event Manager searches for and
executes any enabled subscriptions by the local system to the event with a source type
of External, and also any enabled subscriptions by the local system to the Any event
with a source type of External.
Use the script as follows:
sqlplus <user> @wfagtlst <agent_name>
Enter password: <password>
Replace <agent_name> with the internal name of the agent that you want to monitor
for inbound event messages.
Note: You should use this script primarily for debugging purposes.
Related Topics
Listen, Oracle Workflow API Reference
Wfbesdbg.sql
Use wfbesdbg.sql to display debugging information for an event that you can use to
• WF_JAVA_DEFERRED
• WF_ERROR
• WF_JAVA_ERROR
Replace <event_name> with the name of the event and <event_key> with the event
key that identifies the particular instance of the event. The event name and event key
parameters are case-sensitive.
Note: You can also obtain this information by running the Event
Diagnostic Test in Oracle Diagnostics Framework. See: Event
Diagnostic Test, page E-8.
Wfbkgchk.sql
Use wfbkgchk.sql to get a list of all activities waiting to be processed by the
background engine the next time it runs.
Use the script as follows:
sqlplus <user> @wfbkgchk <WF_schema>
Enter password: <password>
Related Topics
Background, Oracle Workflow API Reference
Setting up Background Workflow Engines, page 2-46
Wfchact.sql
Use wfchact.sql to change the internal name of an activity and update all references
to the activity. See: Change the internal name of a workflow object, page 9-2.
Use the script as follows:
Replace <act_type> with the item type that the activity you wish to update is
associated with, replace <old_act> with the current internal name of the activity, and
replace <new_act> with the new internal name of the activity.
Wfchacta.sql
Use wfchacta.sql to change the internal name of an activity attribute and update all
references to the activity attribute. See: Change the internal name of a workflow object,
page 9-2.
Use the script as follows:
sqlplus <user> @wfchacta <act_type> <old_acta> <new_acta>
Enter password: <password>
Replace <act_type> with the item type that the activity attribute you wish to update
is associated with, replace <old_acta> with the current internal name of the activity
attribute, and replace <new_acta> with the new internal name of the activity attribute.
Wfchita.sql
Use wfchita.sql to change the internal name of an item attribute and update all
references to the item attribute. See: Change the internal name of a workflow object,
page 9-2.
Use the script as follows:
sqlplus <user> @wfchita <item_type> <old_attr> <new_attr>
Enter password: <password>
Replace <item_type> with the item type that the item attribute you wish to update is
associated with, replace <old_attr> with the current internal name of the item
attribute, and replace <new_attr> with the new internal name of the item attribute.
Wfchitt.sql
Use wfchitt.sql to change the internal name of an item type and update all
references to the item type. See: Change the internal name of a workflow object, page 9-
2.
Use the script as follows:
sqlplus <user> @wfchitt <old_type> <new_type>
Enter password: <password>
Replace <old_type> with the current internal name of the item type, and replace
<new_type> with the new internal name of the item type.
Wfchluc.sql
Use wfchluc.sql to change the internal name of a lookup code and update all
Replace <lookup_type> with the lookup type of the lookup code you wish to update,
replace <old_luc> with the current internal name of the lookup code, and replace
<new_luc> with the new internal name of the lookup code.
Wfchlut.sql
Use wfchlut.sql to change the internal name of a lookup type and update all
references to the lookup type. See: Change the internal name of a workflow object, page
9-2.
Use the script as follows:
sqlplus <user> @wfchlut <old_lut> <new_lut>
Enter password: <password>
Replace <old_lut> with the current internal name of the lookup type, and replace
<new_lut> with the new internal name of the lookup type.
Wfchmsg.sql
Use wfchmsg.sql to change the internal name of a message and update all references
to the message. See: Change the internal name of a workflow object, page 9-2.
Use the script as follows:
sqlplus <user> @wfchmsg <msg_type><old_msg> <new_msg>
Enter password: <password>
Replace <msg_type> with the item type of the message you wish to update, replace
<old_msg> with the current internal name of the message, and replace <new_msg>
with the new internal name of the message.
Wfchmsga.sql
Use wfchmsga.sql to change the internal name of a message attribute. This script
does not update the message subject or message body references to the message
attribute, however. You must manually update the message attribute references. See:
Change the internal name of a workflow object, page 9-2.
Use the script as follows:
sqlplus <user> @wfchmsga <msg_type> <msg_name> <old_attr> <new_attr>
Enter password: <password>
Replace <msg_type> with the item type of the message attribute you wish to update,
replace <msg_name> with the internal name of the message that the message attribute
belongs to, replace <old_attr> with the current internal name of the message
Wfdirchk.sql
Use wfdirchk.sql to check for the following conditions in your directory service data
model:
• Invalid internal names that contain the characters '#', ':', or '/' in WF_USERS.
• Multiple names in WF_USERS or WF_ROLES linked to the same row in the original
repository.
• Invalid internal names in WF_ROLES that contain the characters '#' or '/' or have a
length greater than 30 characters.
• Missing user/role in WF_USER_ROLES. Every user must participate in its own role.
Wfdirchk.sql should return no rows to ensure that your directory service data model
is correct.
Use the script as follows:
sqlplus <user> @wfdirchk
Enter password: <password>
Wfevtenq.sql
Use wfevtenq.sql to enqueue an event message on a local queue using an override
agent. This script constructs an event message using the event name, event key, event
data, From Agent, and To Agent you specify. Then the event message is enqueued on
the queue associated with the override agent you specify, which can be different than
the From Agent listed inside the event message. If no override agent is specified, the
Note: This script can only enqueue an event message onto a queue for
an agent on the local system.
• <fromagent> - The From Agent that you want to list in the event message.
• <eventkey> - The event key that uniquely identifies the instance of the event.
Wfmlrdbg.sql
Use wfmlrdbg.sql to display debugging information for a notification that you can
use to check the status of the notification or investigate errors. This script creates an
output file named wfmlrdbg<nid>.html, where <nid> is the notification ID (NID).
Use the script as follows:
sqlplus <user> @wfmlrdbg <nid>
Enter password: <password>
Note: You can also obtain much of this information by running the
Mailer Diagnostic Test in Oracle Diagnostics Framework. See: Mailer
Diagnostic Test, page E-8.
Wfntfsh.sql
Use wfntfsh.sql to display status information about a particular notification, given
its notification ID.
Use the script as follows:
sqlplus <user> @wfntfsh <notification_id>
Enter password: <password>
Wfprot.sql
Use wfprot.sql to reset the protection level of all objects associated with a specified
item type.
Important: If you reset the protection level for all objects in an item
type, then none of those objects in the item type will be customizable by
users operating at an access level higher than the new protection level.
Replace <item_type> with the item type that you want to reset the protection level
for, and replace <protection_level> with the new protection level.
Wfrefchk.sql
Use wfrefchk.sql to check for invalid workflow data that is missing primary key
data for a foreign key.
Wfretry.sql
Use wfretry.sql to display a list of activities that have encountered an error for a
given process instance and then specify whether to skip, retry, or reset any one of those
errored activities.
Use the script as follows:
sqlplus <user> @wfretry <item_type><item_key>
Enter password: <password>
Provide an item type and item key to uniquely identify an item or process instance. The
script first returns the list of errored activities by label name. The script then prompts
you for the label name of an activity that you wish to skip, retry, or reset. If you choose
skip, then you must also specify the result that you want the skipped activity to have.
Note: This script calls the WF_ENGINE HandleError API, so you can
actually specify the label name of any activity associated with the
specified item type and item key to perform a rollback. See:
HandleError, Oracle Workflow API Reference.
Wfrmall.sql
Use wfrmall.sql to delete all data in all Oracle Workflow runtime and design time
tables.
Use the script as follows:
sqlplus <user> @wfrmall
Enter password: <password>
Warning: This script deletes ALL workflow definitions. Do not use this
script unless you are absolutely sure you want to remove all workflow
data from your runtime and design time tables.
After you run this script, you should also reload the workflow
definitions for the Standard, System: Mailer, and System: Error item
types stored in the files wfstd.wft, wfmail.wft, and wferror.wft,
respectively.
Wfrmita.sql
Use wfrmita.sql to delete all workflow data for a specified item type attribute. This
script prompts you for the item type and the name of the attribute to delete.
Alternatively, you can use Oracle Workflow Builder to delete an item type attribute
from a workflow definition stored in a file or a database.
Wfrmitms.sql
Use wfrmitms.sql to delete status information in Oracle Workflow runtime tables for
a particular item. This script prompts you to choose between deleting all data
associated with a specified item type and item key or deleting only data for the
completed activities of the specified item type and item key.
Use the script as follows:
sqlplus <user> @wfrmitms <item_type> <item_key>
Enter password: <password>
Wfrmitt.sql
Use wfrmitt.sql to delete all data in all Oracle Workflow design time and runtime
tables for a particular item type. This script prompts you for an item type from a list of
valid item types.
Use the script as follows:
sqlplus <user> @wfrmitt
Enter password: <password>
Warning: This script deletes ALL workflow data for the specified item
type.
Wfrmtype.sql
Use wfrmtype.sql to delete runtime data associated with a given item type. This
script prompts you for an item type to purge from a list of valid item types, then asks
you to choose between deleting all runtime data associated with the specified item type
or deleting only runtime data for the completed activities and items of the specified
item type.
Use the script as follows:
sqlplus <user> @wfrmtype
Enter password: <password>
Wfrun.sql
Use wfrun.sql to create and start a specified process.
Use the script as follows:
sqlplus <user> @wfrun <item_type> <item_key> <process_name>
Enter password: <password>
Wfstat.sql
Use wfstat.sql to display a developer status report for a specified item. The output is
132 characters per line.
Use the script as follows:
sqlplus <user> @wfstat <item_type> <item_key>
Enter password: <password>
Wfstatus.sql
Use wfstatus.sql to display an end user status report for a specified item. The
output is 132 characters per line.
Use the script as follows:
sqlplus <user> @wfstatus <item_type> <item_key>
Enter password: <password>
Wfstdchk.sql
Use wfstdchk.sql to check and report any problems found in the Oracle Workflow
data model. For example, this script will report any function activities that reference
invalid functions and scan the tables of each workflow process definition object to
verify that each row has a valid internal name and display name.
Use the script as follows:
sqlplus <user> @wfstdchk
Enter password: <password>
Wfvcrdlt.sql
Use wfvcrdlt.sql to delete end-dated vacation rules for a particular user all at once
instead of needing to delete the rules individually through the Vacation Rules page.
You can optionally specify an item type to delete only vacation rules for that user that
pertain to that item type. Additionally, you can optionally specify an end date in the
format DD/MM/YYYY to delete only vacation rules for that user whose effective period
ended before that date.
Use the script as follows:
sqlplus <user> @wfvcrdlt <user_name> [<item_type>] [<end_date>]
Enter password: <password>
Wfverchk.sql
Use wfverchk.sql if you suspect that problems arising in your workflow process are
due to multiple versions of an activity being active simultaneously. This script identifies
errors in versions of activities that cause multiple versions to appear to be active at
once.
Use the script as follows:
sqlplus <user> @wfverchk
Enter password: <password>
Wfverupd.sql
Use wfverupd.sql to correct problems arising in your workflow process that are due
to multiple versions of an activity being active simultaneously. This script identifies and
corrects errors in versions of activities that cause multiple versions to appear to be
active at once.
Use the script as follows:
sqlplus <user> @wfverupd
Enter password: <password>
This appendix lists the navigation paths to Oracle Workflow administrator Web pages
in the seeded Oracle Workflow responsibilities for Oracle E-Business Suite.
This appendix covers the following topics:
• Oracle Workflow Administrator Navigation Paths
This appendix lists features that you can add to Oracle Workflow administrator Web
pages through Oracle Application Framework Personalization.
This appendix covers the following topics:
• Oracle Workflow Administrator Personalizations
This appendix describes concepts and techniques that you can use to enhance
performance when running Oracle Workflow.
This appendix covers the following topics:
• Oracle Workflow Performance Concepts
See: Overview of the Workflow Engine, Oracle Workflow API Reference and Synchronous,
Asynchronous, and Forced Synchronous Processes, Oracle Workflow API Reference.
Item Attributes
Item attributes act as global variables that can be referenced or updated by any activity
within a workflow process. The number of item attributes directly affects the startup
time for work items, because the Workflow Engine by default creates runtime copies of
all item attributes when a new work item is created. For this reason, item attributes
should be kept to a minimum.
You can optionally enhance performance for a process by specifying that the Workflow
Engine should create runtime copies of item attributes only on demand. To do so,
define a special activity attribute named #ONDEMANDATTR for the top-level runnable
process activity. In this case, the Workflow Engine creates runtime copies of item
• Token replacement for messages. For messages where the number of lines may
vary, such as in repeating groups, do not create individual item attributes for each
line. Instead, use item and message attributes of type Document to combine the
lines together.
• Storing primary key values so that functions can look up all necessary values from
the database.
Item attributes should reference static values or values that are not in the database so
that there are no concerns about keeping the values synchronized. (Primary key values,
however, do not change.) Do not implement every column within a table as an item
attribute.
See: Item Type Attributes, Oracle Workflow Developer's Guide and To Define an Item
Type or Activity Attribute, Oracle Workflow Developer's Guide.
Item attribute types that can help you reduce the number of attributes you need include
the following:
• Document - The attribute value is an embedded or attached document, which
enables a complex structure to be rendered inline, or attached to notifications. You
can specify the following types of documents:
• PL/SQL document - A document representing data from the database as a
character string, generated from a PL/SQL procedure.
• Role - The attribute value is the internal name of a role. If a message attribute of
type role is included in a notification message, the attribute automatically resolves
Message Attributes
To enhance performance, message attributes should be kept to a minimum. For
messages where the number of lines may vary, such as in repeating groups, do not
create individual item and message attributes for each line (LINE_INFO1, LINE_INFO2,
etc.). Instead, use item and message attributes of type Document to combine the lines
together.
See: Attribute Types, Oracle Workflow Developer's Guide, Send and Respond Message
Attributes, Oracle Workflow Developer's Guide, and To Define a Message Attribute, Oracle
Workflow Developer's Guide.
Subprocesses
When you design a workflow process, you can group a collection of activities together
in a process activity which represents a subprocess within the main process. Using
subprocesses judiciously can help make workflow diagrams clearer and easier to read
and can simplify workflow monitoring and maintenance. However, subprocesses also
result in additional DML operations and additional state information stored in
Workflow tables. Consequently, you should avoid unnecessary use of subprocesses
when there is no functional benefit.
For example, the following two processes, Process 1 and Process 2, are functionally
identical, both performing a function called Function 1. However, they result in
different numbers of state rows being stored in Workflow tables.
Process 1 contains a Start activity, a Subprocess activity, and an End activity. The
subprocess contains a Start activity, the Function 1 activity, and an End activity. This
process stores 7 state rows in Workflow tables.
Process 2 simply contains a Start activity, the Function 1 activity, and an End activity.
This process stores only 4 state rows in Workflow tables.
Example Process 2
Because more rows are stored in Workflow tables, the kind of design shown in the
Process 1 diagram will result in slower workflow throughput and a need to purge
Workflow runtime tables more frequently than what should be necessary with the
Process 2 design.
Note: This guideline is not meant to imply that subprocesses should not
be used at all. Collapsing all subprocesses can make workflow
diagrams unreadable and difficult to maintain. This recommendation
merely highlights that unnecessary overuse of subprocesses can have a
negative performance impact.
See: Process Activity, Oracle Workflow Developer's Guide and To Create a Process
Activity, Oracle Workflow Developer's Guide.
• Partitioning
• Purging
• If you set an item type's Persistence to Temporary, you must also specify the
number of days of persistence ('n'). The status audit trail for each instance of a
Temporary item type is maintained for at least 'n' days of persistence after its
completion date. After the 'n' days of persistence, you can then use the WF_PURGE
APIs with the persistence type set to the default of TEMP, or the Purge Obsolete
Workflow Runtime Data concurrent program with the persistence type set to the
default of Temporary, to purge the item type's runtime status information. See:
WF_PURGE, Oracle Workflow API Reference.
Related Topics
WF_PURGE, Oracle Workflow API Reference
Persistence Type, Oracle Workflow Developer's Guide
This appendix lists the profile options that you can set to configure Oracle Workflow.
This appendix covers the following topics:
• Oracle Workflow Profile Options
• Local - User passwords are maintained only in Oracle Application Object Library.
Users must log in through the local Oracle E-Business Suite login page.
• Both - User passwords are maintained both in Oracle Directory Services and in
Oracle Application Object Library. Users can log in to Oracle E-Business Suite either
through single sign-on or through the local Oracle E-Business Suite login page. A
user's single sign-on password can be different than that user's Oracle Application
Object Library password.
Sign-On:Notification
This profile option lets you specify whether to display a tip message in the Oracle E-
Business Suite home page that informs the user how many open notifications are in his
or her worklist. The message also requests the user to view and respond to these
notifications. See: Displaying the Number of Open Notifications in the Oracle E-
Business Suite Home Page, page 2-169.
• Yes - The tip message listing the number of open notifications for the user appears
on the Oracle E-Business Suite home page.
• No - The tip message is disabled. This setting is the default value for this profile
option.
Note: The profile option value must end with a slash (/) in order to
form the final WSDL description URL correctly.
Users can view this profile option but cannot update it.
System administrators can view and update this profile option only at site level.
The internal name for this profile option is WF_BPEL_SERVER.
See: Setting the WF: Disable Reassign to Submitter Profile Option, page 2-166, To
Reassign a Notification to Another User, Oracle Workflow User's Guide, Vacation Rules,
Oracle Workflow User's Guide, and Defining Vacation Rules for Users, page 6-7.
• Yes - Notifications cannot be reassigned to the process owner who initiated the
workflow or the from role for the notification.
• No - The Respond button is hidden, and users must always respond to each
notification individually from the Notification Details page. This setting is the
default value for this profile option.
• Y - The quick action buttons appear in the My Worklist menu. This setting is the
default value for this profile option.
• No - The Notification Details pop-up window is not available, and users must
navigate to the Notification Details page to view the notification details. This setting
is the default value for this profile option.
The default value is 700*400. See: Enabling the Notification Details Pop-up Window,
page 2-168.
• Reassign - Provides users access to both the Delegate and Transfer reassign modes.
This setting is the default value for this profile option.
• Disabled - The "All" option does not appear in the list of available item types. Users
must specify the item type to which the vacation rule applies.
After changing the value of this profile option, you must stop and restart Oracle HTTP
Server for the change to take effect.
This appendix describes the diagnostic tests that workflow administrators can run to
check the setup of Oracle Workflow.
This appendix covers the following topics:
• Oracle Workflow Diagnostic Tests
Workflow Tests
The following tests are available in the Workflow Tests group.
• OAM creates new operating system processes for a service instance each time the
service instance is started. If a high number of operating system processes have
been created for a particular service instance in the last few minutes, there may be
an error that is causing that service instance to become continually deactivated and
then restarted by OAM. Use the service instance log to investigate any possible
errors. To view the log, navigate to the Service Components page in Oracle
Workflow Manager, select a service component belonging to the appropriate
service instance, and choose the View Log button. You can also choose the service
instance link in the Container column to review the current number of actual and
target processes in the Service Instances for Generic Service Component Container
page. See: Service Components, page 7-7.
• If any agent is assigned to an incorrect system or is disabled, use the Update Agent
page to update that agent definition. See: Agents, Oracle Workflow Developer's Guide.
• If any subscription has an incorrect subscribing system, has an out agent assigned
to an incorrect system, or is disabled, use the Update Event Subscriptions page to
update that subscription definition. See: Event Subscriptions, Oracle Workflow
Developer's Guide.
• Verify that the appsborg2.zip file contains the required JMS classes. Execute
the following command:
unzip -l $JAVA_TOP/../lib/appsborg2.zip | egrep -i
'javax/jms|oracle/jms' | wc -l
This command should return the count 186 if the required JMS classes are
present. If it returns 0 (zero), then you need to add the required classes into
appsborg2.zip. First verify that the $APPL_TOP/admin/adjborg2.txt
file contains entries for the required classes, jms.jar and aqapi.jar. Execute
the following command:
grep jar $APPL_TOP/admin/adjborg2.txt
Ensure that the output includes entries for jms.jar and aqapi.jar. For
example:
$IAS_ORACLE_HOME/rdbms/jlib/aqapi.jar
$IAS_ORACLE_HOME/j2ee/home/lib/jms.jar
• If dead subscribers are not being regularly removed from the WF_CONTROL
queue, ensure that a recurring concurrent request is scheduled in your Oracle E-
Business Suite instance for a concurrent program named Workflow Control Queue
Cleanup (FNDWFBES_CONTROL_QUEUE_CLEANUP). If you do not have this
request scheduled, perform the following steps:
• Submit a concurrent request for the Workflow Control Queue Cleanup program
(FNDWFBES_CONTROL_QUEUE_CLEANUP) for immediate execution. See:
Cleaning Up the Workflow Control Queue, page 2-199.
• Submit another request for the Workflow Control Queue Cleanup program to
run periodically, so that the WF_CONTROL queue will be cleaned of dead
subscribers regularly. The recommended interval for performing cleanup is
every six to twelve hours. See: Cleaning Up the Workflow Control Queue, page
2-199.
• After the first concurrent request has completed, restart the service instances for
Oracle Workflow. Navigate back to the Service Instances for Generic Service
Component Container page in Oracle Applications Manager and restart each
service instance. See: Service Components, page 7-7.
Note: You should not restart the service instances until the
initial cleanup performed by the first Workflow Control Queue
Cleanup request is finished.
• If the test could not successfully remove a dead subscriber from the WF_CONTROL
queue, the queue may need to be dropped and recreated. Contact Oracle Support
for instructions.
• If a queue is not enabled for enqueuing or dequeuing, you can stop the queue and
restart it with these operations enabled, using the DBMS_AQADM.Stop_Queue and
DBMS_AQADM.Start_Queue APIs. See: Managing Queues, Oracle Streams Advanced
Queuing User's Guide and Reference.
• If any queues or queue tables are invalid, contact Oracle Support for instructions.
Note: This test does not report whether a configured notification mailer
is currently running. You can use the Service Components page in
Oracle Workflow Manager to check the current status of your
notification mailer service components.
• Ensure that your IMAP server is accessible and able to accept connections, that the
inbound username defined for the notification mailer has a valid account on the
IMAP server, and that you can connect to the IMAP server from an email client
using the inbound username and password.
• Ensure that the inbox, processed folder, and discard folder defined for the
notification mailer exist within the inbound email account, and that these are three
separate folders.
• Ensure that the HTML agent defined for the notification mailer is accessible and
that the Web listener is processing requests.
• Ensure that all messages defined as message templates for the notification mailer
are loaded in your database, together with the item types to which the messages
belong.
• WF_JAVA_DEFERRED
• WF_ERROR
• WF_JAVA_ERROR
You can use this information to check the status of a particular event or to investigate
errors. Enter the event name and event key for the event that you want to review and
run the test. The Event Name and Event Key fields are case-sensitive. See: Setting Up
the Business Event System, page 2-186.
Note: You can also obtain this information through SQL*Plus using the
wfbesdbg.sql script. See: Wfbesdbg.sql, page 9-7.
Mailer Tests
The following test is available in the Mailer Tests group.
Note: You can also obtain this information through SQL*Plus using the
wfmlrdbg.sql script. See: Wfmlrdbg.sql, page 9-12.
Access Level
A numeric value ranging from 0 to 1000. Every workflow user operates at a specific
access level. The access level defines whether the user can modify certain workflow
data. You can only modify data that is protected at a level equal to or higher than your
access level.
Activity
A unit of work performed during a business process.
Activity Attribute
A parameter that has been externalized for a function activity that controls how the
function activity operates. You define an activity attribute by displaying the activity's
Attributes properties page in the Activities window. You assign a value to an activity
attribute by displaying the activity node's Attribute Values properties page in the
Process window.
Agent
A named point of communication within a system.
Agent Listener
A type of service component that processes event messages on inbound agents.
Attribute
See Activity Attribute, Item Type Attribute, or Message Attribute.
Background Engines
A supplemental Workflow Engine that processes deferred or timed out activities or
stuck processes.
Business Event
See Event.
Glossary-1
Cost
A relative value that you can assign to a function or notification activity to inform the
Workflow Engine how much processing is required to complete the activity. Assign a
higher cost to longer running, complex activities. The Workflow Engine can be set to
operate with a threshold cost. Any activity with a cost above the Workflow Engine
threshold cost gets set to 'DEFERRED' and is not processed. A background engine can be
set up to poll for and process deferred activities.
Concurrent Manager
An Oracle E-Business Suite component that manages the queuing of requests and the
operation of concurrent programs.
Concurrent Process
An instance of running a non-interactive, data-dependent function, simultaneously with
online operations. Each time you submit a request, a concurrent manager processes
your request, starts a concurrent process, and runs a concurrent program.
Concurrent Program
A concurrent program is an executable file that performs a specific task, such as posting
a journal entry or generating a report.
Concurrent Queue
A list of concurrent requests awaiting completion by a concurrent manager. Each
concurrent manager has a queue of requests waiting in line to be run. If your system
administrator sets up your Oracle E-Business Suite application to have simultaneous
queuing, your request can wait to run in more than one queue.
Directory Service
A mapping of Oracle Workflow users and roles to a site's directory repository.
Event
An occurrence in an internet or intranet application or program that might be
significant to other objects in a system or to external agents.
Event Activity
A business event modelled as an activity so that it can be included in a workflow
process.
Event Data
A set of additional details describing an event. The event data can be structured as an
XML document. Together, the event name, event key, and event data fully
communicate what occurred in the event.
Glossary-2
Event Key
A string that uniquely identifies an instance of an event. Together, the event name,
event key, and event data fully communicate what occurred in the event.
Event Message
A standard Workflow structure for communicating business events, defined by the
datatype WF_EVENT_T. The event message contains the event data as well as several
header properties, including the event name, event key, addressing attributes, and error
information.
Event Subscription
A registration indicating that a particular event is significant to a system and specifying
the processing to perform when the triggering event occurs. Subscription processing
can include calling custom code, sending the event message to a workflow process, or
sending the event message to an agent.
External Functions
Programs that are run outside of the Oracle Database.
Function
A PL/SQL stored procedure that can define business rules, perform automated tasks
within an application, or retrieve application information. The stored procedure accepts
standard arguments and returns a completion result.
Function Activity
An automated unit of work that is defined by a PL/SQL stored procedure.
Item
A specific process, document, or transaction that is managed by a workflow process.
Item Attribute
See Item Type Attribute.
Item Type
A grouping of all items of a particular category that share the same set of item
attributes. Item type is also used as a high level grouping for processes.
Glossary-3
Item Type Attribute
A feature associated with a particular item type, also known as an item attribute. An
item type attribute is defined as a variable whose value can be looked up and set by the
application that maintains the item. An item type attribute and its value are available to
all activities in a process.
Lookup Code
An internal name of a value defined in a lookup type.
Lookup Type
A predefined list of values. Each value in a lookup type has an internal and a display
name.
Message
The information that is sent by a notification activity. A message must be defined before
it can be associated with a notification activity. A message contains a subject, a priority,
a body, and possibly one or more message attributes.
Message Attribute
A variable that you define for a particular message to either provide information or
prompt for a response when the message is sent in a notification. You can use a
predefine item type attribute as a message attribute. Defined as a 'Send' source, a
message attribute gets replaced with a runtime value when the message is sent. Defined
as a 'Respond' source, a message attribute prompts a user for a response when the
message is sent.
Node
An instance of an activity in a process diagram as shown in the Process window.
Notification
An instance of a message delivered to a user.
Notification Activity
A unit of work that requires human intervention. A notification activity sends a
message to a user containing the information necessary to complete the work.
Notification Mailer
A type of service component that sends email notifications to users through a mail
application, and processes email responses.
Notification Worklist
A Web page that you can access to query and respond to workflow notifications.
Glossary-4
Performer
A user or role assigned to perform a human activity (notification). Notification activities
that are included in a process must be assigned to a performer.
Process
A set of activities that need to be performed to accomplish a business goal.
Process Activity
A process modelled as an activity so that it can be referenced by other processes.
Process Definition
A workflow process as defined in Oracle Workflow Builder, which can be saved as a
flat file or in a database.
Protection Level
A numeric value ranging from 0 to 1000 that represents who the data is protected from
for modification. When workflow data is defined, it can either be set to customizable
(1000), meaning anyone can modify it, or it can be assigned a protection level that is
equal to the access level of the user defining the data. In the latter case, only users
operating at an access level equal to or lower than the data's protection level can modify
the data.
Result Code
The internal name of a result value, as defined by the result type.
Result Type
The name of the lookup type that contains an activity's possible result values.
Result Value
The value returned by a completed activity.
Role
One or more users grouped by a common responsibility or position.
Service Component
An instance of a Java program which has been defined according to the Generic Service
Component Framework standards so that it can be managed through this framework.
Glossary-5
Subscription
See Event Subscription.
System
A logically isolated software environment such as a host machine or database instance.
Timeout
The amount of time during which a notification activity must be performed before the
Workflow Engine transitions to an error process or an alternate activity if one is
defined.
Transition
The relationship that defines the completion of one activity and the activation of
another activity within a process. In a process diagram, the arrow drawn between two
activities represents a transition.
Workflow Engine
The Oracle Workflow component that implements a workflow process definition. The
Workflow Engine manages the state of all activities for an item, automatically runs
functions and sends notifications, maintains a history of completed activities, and
detects error conditions and starts error processes. The Workflow Engine is
implemented in server PL/SQL and activated when a call to an engine API is made.
Glossary-6
Index
Index-1
Closing a group of notifications, 2-167 Electronic signatures
Concurrent program evidence store, 6-10
FNDWFPR, 9-3 Email Notification Preference, 2-23
FNDWFRET, 9-5 Email notifications, 1-4, 2-55
Concurrent programs and HTML attachments, 2-3
Synchronize Product License and Workflow character encoding, 2-160
BES License, 2-199 modifying mail templates, 2-106
Workflow Background Process, 2-49 requirements, 2-3
Workflow Control Queue Cleanup, 2-200 templates for, 2-66
Workflow Definitions Loader, 8-8 Engine thresholds, 2-54
Customization level Environment variables
Business Event System objects, 8-7 WF_ACCESS_LEVEL, 8-3, 8-7
workflow objects, 8-4 Errored activities
Custom logos retrying, 9-14
in Web pages, 2-185 Event Diagnostic Test, E-8
Event messages
D enqueuing, 9-11
Event Raise Test, E-8
Database links
Exception handling
creating, 2-187
inbound queues, 2-197
Deferred activities, 2-46
performance, C-6
Deferred processing F
for workflow processes, 2-46, C-6 Flexfields
Delegating notifications, 2-165 for Worklist, 6-15
Delete FND Framework External Agent profile option,
all workflow data, 9-14 2-60, 7-26, D-2
data for an item type, 9-15 FNDWFAASTATCC, 7-3
item type attributes, 9-14 FNDWFBES_CONTROL_QUEUE_CLEANUP, 2-
runtime data for an item type, 9-15, C-8 200
workflow status information, 9-15 FNDWFDSURV, 2-30
Delimiter for email response values, 2-62, 7-28 FNDWFLIC, 2-199
Denormalize Worklist Flexfields concurrent FNDWFMLRSTATCC, 7-3
program, 6-27 FNDWFPR, 9-3
Diagnostics, E-1 FNDWFRET, 9-5
Digital signatures FNDWFWITSTATCC, 7-3
Capicom.dll location, 2-21 Forced synchronous processes, C-1
loading certificates, 2-181 Foreign/primary key references, 9-13
Directory repository, 2-24
Directory services, 2-24, 2-26 G
checking the data model, 2-32, 9-11
Generic Service Component Framework, 2-55
Directory service views, 2-31
Global preferences, 2-16, 2-16
DISABLED preference, 2-77
Global Worklist button, 2-170
DLL location, 2-21
GSC Control Queue Test, E-4
Duplicate User Test, E-1
GSM Setup Test, E-2
Index-2
Workflow Definitions Loader, 8-8
H Local system, 2-19
Hardware requirements, 2-2
Home page M
administrator, 4-1 MAILATTH preference, 2-79
HTML_DELIMITER parameter, 2-62, 7-28 Mailer Component Parameter Test, E-7
HTML-formatted email with attachments, 2-83 Mailer Component Test, E-6
HTML-formatted email with no attachments, 2- Mailer Diagnostic Test, E-8
82 MAILHTM2 preference, 2-82
MAILHTML preference, 2-83
I MAILTEXT preference, 2-78
Message attributes
Icons, 2-186
performance, C-4
IMAP server, 2-57
Message templates
Internal names
for email notifications, 2-106
updating activity, 9-8
MIME support, 2-72
updating activity attributes, 9-9
Monitor
updating item attributes, 9-9
Administrator, 5-1
updating item types, 9-9
testing access, 5-36
updating lookup codes, 9-9
Monitoring
updating lookup types, 9-10
work items, 1-4
updating message attributes, 9-10
Move Messages from Exception to Normal
updating messages, 9-10
Queue of Workflow Agent concurrent program,
Invalid Email Address Warning message
2-98, 2-197
template, 2-158
Multilingual support, 9-7, 9-13
Item type attributes
performance, C-2
Item types N
persistence type, C-8 Navigation paths, A-1
System: Mailer, 2-106 NLS support
in a Web session, 2-44
J in email notifications, 2-46
in Oracle Workflow Builder, 2-44
Java agent listeners, 2-192, 7-78
Notification
JavaScript
status, 9-13
support in a Web browser, 2-3
Notification access keys, 2-86
Notification action source, 6-13
L
Notification Details pop-up window
Languages enabling, 2-168
enabling, 2-43 Notification IDs, 2-86
LDAP preferences, 2-18 Notification Mailer Override Address
Licensing, 2-198 Verification message template, 2-160
Listeners Notification mailers, 7-20
for inbound agents, 2-192 about, 2-55
running, 9-7 character encoding, 2-160
List of values of users, 2-172 diagnostic script, 9-12
Loader program handling errors, 2-93
Index-3
inbound processing, 2-68 2-134
MIME support, 2-72 Orig. Workflow Open Mail (Direct) message
notification preference, 2-75 template, 2-116
outbound processing, 2-65 Orig. Workflow Open Mail (More Information
resetting after cloning, 2-99 Request) message template, 2-148
response processing, 2-68 Orig. Workflow Open Mail (Outlook Express)
sending summary notifications, 2-62 message template, 2-120
setup, 2-57 Orig. Workflow Open Mail (Templated) message
testing URL access, 6-31 template, 2-111
Notification preferences, 2-75 Orig. Workflow Open Mail message template, 2-
Notification Preference Validation Test, E-2 124
Notification reassign modes, 2-165 OUTBOUND_THREAD_WAIT_TIMEOUT
Notifications parameter, 2-63, 7-29
administrator search, 6-1
character encoding, 2-160 P
via email, 2-55
Partitioning
Notification Search function, 2-162
for directory service tables, 2-28
Notification style, 2-75
Partitioning Workflow tables, 2-14, C-7
Notification style preferences, 2-19
Performance
Notification System, 2-55
Business Event System, 2-201
Notification templates
concepts, C-1
for email notifications, 2-106
deferred activities, C-6
Notification Web page, 1-4
item attributes, C-2
message attributes, C-4
O partitioning Workflow tables, C-7
OAuth 2.0, 2-64, 7-29 purging, C-7
Oracle Applications Manager, 1-4 subprocesses, C-4
Oracle Diagnostics Framework, E-1 synchronous and asynchronous workflows, C-
Oracle Directory Services, 2-18 1
Oracle E-Business Suite home page, 2-169 Persistence, C-8
Oracle Internet Directory, 2-18 Personal Worklist
Oracle Net Services, 2-2 embedding in a page, 6-30
Oracle Unified Directory, 2-18 PL/SQL, 1-3
Oracle Workflow PL/SQL agent listeners, 2-192, 7-70
implementation issues, 2-2 Plain text email with attachments, 2-79
system status, 7-3 Plain text email with no attachments, 2-78
Oracle Workflow Builder, 1-2 Portlets, 5-42
requirements, 2-2 Error Workflows, 5-42
Oracle Workflow home page Workflows, 5-43
administrator, 4-1 Profile options, D-1
Oracle Workflow Manager, 1-4, 7-1 Propagation
Orig. Workflow Canceled Mail message for outbound agents, 2-197
template, 2-131 Protection level, 8-3
Orig. Workflow Closed Mail message template, reset, 9-13
2-138 Protection level locking
Orig. Workflow Invalid Mail message template, Access protection, 8-1
Index-4
Purge Security
performance, C-7 classes of users, 3-1
runtime data, 9-3 configuring Oracle Workflow security options,
Purging 3-4
Oracle Workflow data, 7-96 for email notifications, 2-86
overview, 3-1
Q resources protected, 3-3
Self-Service Monitor
QUERY preference, 2-77
testing access, 5-36
Queue propagation, 7-121
Service components, 7-7
Queues
agent listeners, 2-193
setting up, 2-188
notification mailers, 2-55
Queue tables, 2-188
SET_WFNTF_AUTO_GEN_HEADER parameter,
2-63, 7-29
R
Signature Evidence Store, 6-10
RAC affinity, 2-9 Sign-On:Notification profile option, 2-169, D-2
Real Application Clusters, 2-9 SMTP server, 2-57
Reassigning notifications, 2-165 Software requirements, 2-2
to the submitter, 2-166 Source of notification actions, 6-13
Reassign modes, 2-165 Specialized workflow monitoring privileges, 5-19
Reassign notifications Specialized worklist views, 6-15
in Administrator Monitor, 5-8 Static function calls, 2-201
Requirements Statistics
hardware and software, 2-2 gathering for Oracle Workflow, 7-2
Resend Failed/Error Workflow Notifications Status Monitor
concurrent program, 2-97 Administrator, 5-1
Respond attributes, 2-109, 2-109, 2-110, 2-112, 2- guest access, 5-28
112, 2-112, 2-114, 2-114, 2-114, 2-117, 2-117, 2-117, specialized privileges, 5-19
2-119, 2-119, 2-119, 2-122, 2-122, 2-122, 2-132, 2- standard access, 5-24
135, 2-147, 2-149, 2-154 testing access, 5-36
Response processing Status report
by notification mailers, 2-68 developer, 9-16
Retry end user, 9-16
errored activities, 9-5 Stuck processes, 2-47
Role Subprocesses
administrator, 2-16 performance, C-4
Role hierarchies, 2-29 SUMHTML preference, 2-77
Role inheritance, 2-29 SUMMARY preference, 2-77
Routing Synchronizing user and role information, 2-29
notifications, 6-7 Synchronous processes, C-1
Rule Function Validation Test, E-2 System: Mailer item type, 2-106
Runtime data, C-6
T
S
TCP/IP drivers, 2-2
Search Timed out processes, 2-46, C-6
for notifications, 6-1 Transferring notifications, 2-165
Index-5
Translation, 2-43 WF_NOTIFICATION_IN queue, 2-188
WF_NOTIFICATION_OUT queue, 2-188
U WF_OUTBOUND_QUEUE, 2-47
WF_OUT queue, 2-188
User list of values, 2-172
WF_ROLES
User Notification Preference Update Report
view, 2-37
message template, 2-157
WF_USER_ROLE_ASSIGNMENTS_V
User preferences, 2-16
view, 2-40
notification style preference, 2-19
WF_USER_ROLES
view, 2-39
V
WF_USERS
Vacation rules view, 2-33
defining for users, 6-7 WF: BPEL Server profile option, 2-203, D-3
deleting, 9-16 WF: Disable Reassign to Submitter profile option,
Version, 9-17 2-166, D-3
of Oracle Workflow, 2-6 WF: Enable Bulk Notification Response profile
Version compatibility, 2-6 option, 2-167, D-4
WF: Enable Worklist Global Header profile
W option, 2-170, D-4
Web home page WF: Enable Worklist Global Header Quick
administrator, 4-1 Actions profile option, 2-170, D-5
Web services outbound components, 7-86 WF: GUEST Access to Notification profile option,
WF_ACCESS_LEVEL, 8-3, 8-7 D-5
WF_ALL_ROLES_VL WF: Notification Pop-up Enabled profile option,
view, 2-40 2-168, D-6
WF_ALL_USER_ROLE_ASSIGNMENTS WF: Notification Pop-up Window Size profile
view, 2-42 option, 2-168, D-6
WF_ALL_USER_ROLES WF: Notification Reassign Mode profile option,
view, 2-41 2-165, D-7
WF_CONTROL, 2-199 WF: Vacation Rules - Allow All profile option, 2-
WF_CONTROL queue, 2-188 171, D-7
WF_DEFERRED_QUEUE_M, 2-47 WF: Workflow Mailer Framework Web Agent
WF_DEFERRED queue, 2-188 profile option, D-8
WF_DIRECTORY_PARTITIONS, 2-28 Wfagtlst.sql, 9-7
WF_ERROR queue, 2-188 WFBES_MAX_CACHE_SIZE , 2-200
WF_EXTERNAL_ROLE, 2-60, 7-26 Wfbesdbg.sql, 9-7
WF_EXTERNAL_ROLE_NOEBS_ACCESS, 2-61, Wfbkgchk.sql, 9-8
7-26 Wfchact.sql, 9-8
WF_INBOUND_QUEUE, 2-47 Wfchacta.sql, 9-9
WF_IN queue, 2-188 Wfchita.sql, 9-9
WF_JMS_IN queue, 2-188 Wfchitt.sql, 9-9
WF_JMS_OUT queue, 2-188 Wfchluc.sql, 9-9
WF_LANGUAGES view, 2-43 Wfchlut.sql, 9-10
WF_LOCAL_ROLES, 2-25 Wfchmsg.sql, 9-10
WF_LOCAL_USER_ROLES, 2-25 Wfchmsga.sql, 9-10
WF_MAIL_SMTP_SIZE_LIMIT, 2-64, 7-29 Wfdirchk.sql, 9-11
Wfeitrac.sql, 2-12
Index-6
wfevquc2.sql, 2-191 loading, 1-3
wfevqued.sql, 2-191 transferring, 8-8
wfevrtry.sql, 2-204 Workflow Definitions Loader, 1-3, 8-8
Wfevtenq.sql, 9-11 concurrent program, 8-8
WFLOAD, 8-8 Workflow Designer
Wfmlpcln.sql, 2-99 Oracle Workflow Builder, 1-2
Wfmlrdbg.sql, 9-12 Workflow Directory Services Bulk Reset
wfnequ.sql, 2-95 DISABLED Notification Preference concurrent
WFNLADD.sql, 9-7 program, 2-96
WFNLENA.sql, 9-13 Workflow Directory Services User/Role
wfntffix.sql, 2-96 Validation concurrent program, 2-30
wfntfqup.sql, 2-95 Workflow directory service views, 2-31
wfntfrsp.sql, 2-204 Workflow Engine, 1-3
Wfntfsh.sql, 9-13 threshold cost, 2-54
wfntfsnd.sql, 2-96 Workflow Invalid Mail message template, 2-132
Wfpart.sql, 2-14 Workflow Invalid Open Mail (More Information
Wfprot.sql, 9-13 Request) message template, 2-153
Wfracprt.sql, 2-10 Workflow Mailer SMTP server size limit profile
Wfracvpd.sql, 2-11 option, 2-64, 7-29, D-8
Wfrefchk.sql, 9-13 Workflow Mailer Statistics Concurrent Program,
Wfretry.sql, 9-14 7-3
Wfrmall.sql, 9-14 Workflow Monitor
Wfrmita.sql, 9-14 Administrator, 5-1
Wfrmitms.sql, 9-15 testing access, 5-36
Wfrmitt.sql, 9-15 Workflow More Info Answered Mail message
Wfrmtype.sql, 9-15, C-8 template, 2-156
Wfrun.sql, 9-15 Workflow More Information Request (Outlook
Wfstat.sql, 9-16 Express) message template, 2-150
Wfstatus.sql, 9-16 Workflow Notification Mailer, 2-55
Wfstdchk.sql, 9-16 Workflow Objects Validity Test, E-6
Wfvcrdlt.sql, 9-16 Workflow Open Mail (Direct) message template,
Wfver.sql, 9-17 2-113
Wfverchk.sql, 9-17 Workflow Open Mail (More Information
Wfverupd.sql, 9-17 Request) message template, 2-146
Workflow administrator, 2-16 Workflow Open Mail (Outlook Express) message
Workflow Advanced Queue Rule Validation template, 2-118
Test, E-5 Workflow Open Mail (Templated) message
Workflow Agent Activity Statistics Concurrent template, 2-108
Program, 7-3 Workflow Open Mail message template, 2-123
Workflow Agents/AQ Status Test, E-6 Workflow processes
Workflow Canceled Mail message template, 2- creating and starting, 9-15
129 Workflow RAC affinity, 2-9, C-7
Workflow Closed Mail message template, 2-137 Workflow roles, 2-24
Workflow Configuration page, 2-16 Workflow Secure Mail Content message
Workflow control queue, 7-103 template, 2-145
Workflow data model, 9-16 Workflow Server
Workflow definitions requirements, 2-3
Index-7
Workflow Signature Required Mail message
template, 2-141
Workflow Signature Warning Mail message
template, 2-144
Workflow Summary Mail (HTML) message
template, 2-139
Workflow URL Attachment message template, 2-
128
Workflow users, 2-24
Workflow View From UI message template, 2-
125
Workflow View FYI From UI message template,
2-127
Workflow Warning Mail message template, 2-140
Workflow Web pages
customizing logo, 2-185
Workflow Work Items Statistics Concurrent
Program, 7-3
Workflow XML Loader, 8-11
Work items
active, 7-105
completed, 7-98
deferred, 7-108
errored, 7-114
suspended, 7-111
Worklist flexfields, 6-15
Worklist functions, 2-162
Worklist global button, 2-170
Worklist views, 6-15
X
XML Parser Installation Test, E-6
Index-8