Professional Documents
Culture Documents
Student Guide
14467GC10
Production 1.0
July 2000
M0-11868
Copyright Oracle Corporation, 2000. All rights reserved.
This documentation contains proprietary information of Oracle Corporation. It is provided under a license
agreement containing restrictions on use and disclosure and is also protected by copyright law. Reverse
engineering of the software is prohibited. If this documentation is delivered to a U.S. Government Agency of the
Department of Defense, then it is delivered with Restricted Rights and the following legend is applicable:
Restricted Rights Legend
Use, duplication or disclosure by the Government is subject to restrictions for commercial computer software
and shall be deemed to be Restricted Rights software under Federal law, as set forth in subparagraph (c)(1)(ii)
of DFARS 252.227-7013, Rights in Technical Data and Computer Software (October 1988).
This material or any portion of it may not be copied in any form or by any means without the express prior
written permission of the Education Products group of Oracle Corporation. Any other copying is a violation of
copyright law and may result in civil and/or criminal penalties.
If this documentation is delivered to a U.S. Government Agency not within the Department of Defense, then it is
delivered with Restricted Rights, as defined in FAR 52.227-14, Rights in Data-General, including Alternate III
(June 1987).
The information in this document is subject to change without notice. If you find any problems in the
documentation, please report them in writing to Worldwide Education Services, Oracle Corporation, 500 Oracle
Parkway, Box SB-6, Redwood Shores, CA 94065. Oracle Corporation does not warrant that this document is
error-free.
Oracle and all references to Oracle Products are trademarks or registered trademarks of Oracle Corporation.
All other products or company names are used for identification purposes only, and may be trademarks of their
respective owners.
Authors
Paula Baldock
Robin Seiden
Technical Contributors and Reviewers
Siu Chang
Kevin Hudson
Clara Jaeckel
Copyright Oracle Corporation, 2000. All rights reserved.
Oracle Workflow Table of Contents
i
Table of Contents
Oracle Workflow Release 2.5 Introduction.........................................................................1-1
Oracle Workflow Release 2.5..............................................................................................1-2
Objectives ............................................................................................................................1-3
Agenda.................................................................................................................................1-4
Overview .............................................................................................................................1-5
Why Workflow?.....................................................................................................................2-1
Why Workflow? ..................................................................................................................2-2
Objectives ............................................................................................................................2-3
All Businesses Must Become E-Businesses .......................................................................2-4
Oracle Workflow.................................................................................................................2-5
Workflow Driven Business Processes .................................................................................2-6
Example Workflow Processes .............................................................................................2-7
Designing Business Processes for Change...........................................................................2-8
Workflow is Essential..........................................................................................................2-9
Expense Report Processing..................................................................................................2-10
Common Expense Reports Questions..................................................................................2-11
Expense Report Processing..................................................................................................2-13
Expense Report Processing @ Oracle .................................................................................2-14
New Hire Processing ...........................................................................................................2-15
New Hire Process @ Oracle ................................................................................................2-16
Workflow Enabled e-business Suite ....................................................................................2-20
Workflow.............................................................................................................................2-22
Overview of Oracle Workflow..............................................................................................3-1
Overview of Oracle Workflow............................................................................................3-2
Objectives ............................................................................................................................3-3
Overview .............................................................................................................................3-4
Workflow Architecture........................................................................................................3-5
Oracle Workflow Features and Definitions .........................................................................3-6
Oracle Workflow Builder ....................................................................................................3-7
Workflow Process Definition ..............................................................................................3-8
Supported Process Constructs..............................................................................................3-9
Workflow Engine.................................................................................................................3-11
Workflow Definitions Loader..............................................................................................3-12
Notification System.............................................................................................................3-13
Notification Worklist Web Page..........................................................................................3-14
Notification Details Web Page ............................................................................................3-15
Email Notifications..............................................................................................................3-16
Email Notifications - Response Template ...........................................................................3-17
Directory Services ...............................................................................................................3-18
Oracle Workflow Monitor ...................................................................................................3-19
Demonstration......................................................................................................................3-22
Planning a Workflow Process...............................................................................................4-1
Planning a Workflow Process..............................................................................................4-2
Objectives ............................................................................................................................4-3
Process Components............................................................................................................4-4
Oracle Workflow Builder ....................................................................................................4-5
Oracle Workflow Builder (continued) .................................................................................4-6
Planning a Workflow Process..............................................................................................4-7
Planning a Workflow Process (continued) ..........................................................................4-8
Activities and Lookup Types...............................................................................................4-9
Copyright Oracle Corporation, 2000. All rights reserved.
Oracle Workflow Table of Contents
ii
Creating a New Process from Bottom Up............................................................................4-11
Creating a New Process from Top Down ............................................................................4-12
Demonstration......................................................................................................................4-13
Defining Item Types, Item Attributes, and Lookup Types ................................................5-1
Defining Item Types, Item Attributes, and Lookup Types ..................................................5-2
Objectives ............................................................................................................................5-3
Create a New Workflow Process Definition........................................................................5-4
Top-Down Design ...............................................................................................................5-5
Quick Start Wizard ..............................................................................................................5-6
Quick Start Wizard (Continued) ..........................................................................................5-7
Define an Item Type ............................................................................................................5-9
Item Type Selector/Callback Function ................................................................................5-10
Define Item Type Attributes................................................................................................5-11
Define Item Type Attributes (continued).............................................................................5-12
Form Attributes....................................................................................................................5-14
Document Attributes............................................................................................................5-15
URL Attributes ....................................................................................................................5-16
Activities and Lookup Types...............................................................................................5-17
Define Lookup Types ..........................................................................................................5-18
Define Lookup Codes ..........................................................................................................5-19
Defining a Notification Activity............................................................................................6-1
Defining a Notification Activity..........................................................................................6-2
Objectives ............................................................................................................................6-3
Workflow Terms..................................................................................................................6-4
Create a New Workflow Process Definition........................................................................6-5
Define a Message.................................................................................................................6-6
Define a Message (Continued) ............................................................................................6-7
Define a Message Attribute .................................................................................................6-8
Define a Respond Attribute .................................................................................................6-9
Respond Attributes in an E-mail Notification......................................................................6-10
Respond Attributes in the Notifications Web Page .............................................................6-11
Define a Notification Activity .............................................................................................6-12
Standard PL/SQL API for Calling Functions ......................................................................6-13
Execution Modes .................................................................................................................6-14
Standard Voting Activity.....................................................................................................6-16
Define Notification Activity Details....................................................................................6-17
Define a Dynamic Priority for a Notification ......................................................................6-18
Practice Les 6-1 Overview...................................................................................................6-19
Practice Les 6-1 Overview Continued .................................................................................6-20
Guided Practice Les 6-1: Planning a Notification Only Process .........................................6-21
Guided Practice Les 6-1: Using the Quick Start Wizard .....................................................6-22
Guided Practice Les 6-1: Designing a Process Top Down ..................................................6-23
Guided Practice Les 6-1: Creating Supporting Item Attributes ...........................................6-24
Guided Practice Les 6-1: Creating Supporting Messages....................................................6-25
Guided Practice Les 6-1: Creating Supporting Messages Continued ..................................6-26
Guided Practice Les 6-1: Setting Selected Node Properties ................................................6-27
Guided Practice Les 6-1: Saving Your Process ...................................................................6-28
Les 6-1 Summary.................................................................................................................6-29
Overview of the Workflow Directory Service .....................................................................7-1
Overview of the Workflow Directory Service.....................................................................7-2
Objectives ............................................................................................................................7-3
Terms...................................................................................................................................7-4
Directory Service Views......................................................................................................7-5
WF_USERS View...............................................................................................................7-6
WF_USERS View (continued) ............................................................................................7-7
Copyright Oracle Corporation, 2000. All rights reserved.
Oracle Workflow Table of Contents
iii
WF_ROLES View...............................................................................................................7-8
WF_ROLES View (continued)............................................................................................7-9
WF_USER_ROLES View...................................................................................................7-10
WF_USER_ROLES View (continued)................................................................................7-11
Oracle Workflow Local Tables............................................................................................7-12
Implementing Global User Preferences ...............................................................................7-13
User Preference Information................................................................................................7-14
Ad Hoc Users/Roles ............................................................................................................7-15
Directory Service for Oracle Applications...........................................................................7-16
Directory Services for Oracle Workflow Standalone Version.............................................7-17
Defining Function and Process Activities ............................................................................8-1
Defining Function and Process Activities............................................................................8-2
Objectives ............................................................................................................................8-3
Create a New Workflow Process Definition........................................................................8-4
Define a Function Activity ..................................................................................................8-5
Assigning a Cost to a Function Activity..............................................................................8-7
Standard PL/SQL API for Calling Functions ......................................................................8-8
Execution Modes .................................................................................................................8-9
Notification Activities Revisited .........................................................................................8-10
Execution Modes .................................................................................................................8-13
Post-Notification Function...................................................................................................8-15
Exception Handling .............................................................................................................8-16
Exception Handling Example ..............................................................................................8-17
Defining a Function Activity Attribute................................................................................8-18
Defining a Process Activity.................................................................................................8-19
Defining Activity Details.....................................................................................................8-20
Looping................................................................................................................................8-21
Self-Looping Transitions .....................................................................................................8-23
Default Error Process...........................................................................................................8-24
Error Handling.....................................................................................................................8-25
Error Handling (Continued).................................................................................................8-26
Practice Les 8-1 Overview...................................................................................................8-27
Practice Les 8-1 Overview Continued .................................................................................8-28
Guided Practice Les 8-1 Creating a Vacation Schedule Table ............................................8-29
Guided Practice Les 8-1 Creating a PL/SQL Procedure......................................................8-30
Guided Practice Les 8-1 RUN processing ...........................................................................8-31
Guided Practice Les 8-1 CANCEL processing....................................................................8-32
Guided Practice Les 8-1 Adding a Function Activity..........................................................8-33
Guided Practice Les 8-1 Adding a Function Activity Continued ........................................8-34
Les 8-1 Summary.................................................................................................................8-35
Practice Les 8-2 Overview Optional....................................................................................8-36
Practice Les 8-2 Overview Continued .................................................................................8-37
Guided Practice Les 8-2 Creating a PL/SQL Procedure.....................................................8-39
Guided Practice Les 8-2 RESPOND processing..................................................................8-40
Guided Practice Les 8-2 RESPOND processing continued.................................................8-41
Guided Practice Les 8-2 FORWARD processing...............................................................8-43
Guided Practice Les 8-2 FORWARD, RUN, TIMEOUT processing.................................8-44
Guided Practice Les 8-2 Adding a Post-Notification Function............................................8-45
Les 8-2 Summary.................................................................................................................8-46
Diagramming a Workflow Process.......................................................................................9-1
Diagramming a Workflow Process......................................................................................9-2
Objectives ............................................................................................................................9-3
Create a New Workflow Process Definition........................................................................9-4
Loading Roles......................................................................................................................9-5
Diagramming a Process .......................................................................................................9-6
Copyright Oracle Corporation, 2000. All rights reserved.
Oracle Workflow Table of Contents
iv
Quick Start Wizard ..............................................................................................................9-7
Diagramming a Process (continued)....................................................................................9-8
Show Label in Designer Menu Option ................................................................................9-9
Display Modes.....................................................................................................................9-10
Diagramming a Process (continued)....................................................................................9-11
Self-Looping Transitions .....................................................................................................9-13
<Any> Transitions...............................................................................................................9-14
Top Down Design................................................................................................................9-15
Validation Performed by the Verify Command...................................................................9-17
Validation Performed by the Verify Command (continued)................................................9-18
Editing a Transition .............................................................................................................9-19
Editing a Transition (continued) ..........................................................................................9-20
Customizing a Process Node ...............................................................................................9-21
Setting Activity Attribute Values.........................................................................................9-22
Deleting Item Attributes ......................................................................................................9-23
Standard Activities...............................................................................................................9-24
Saving the Process Definition..............................................................................................9-25
Reviewing the Process Definition........................................................................................9-26
Version Compatibility..........................................................................................................9-27
Display Name Conflicts.......................................................................................................9-28
Practice Les 9-1 Overview...................................................................................................9-29
Practice Les 9-1 Overview Continued .................................................................................9-30
Guided Practice Les 9-1 Adding a Timeout.........................................................................9-32
Guided Practice Les 9-1 Adding a Self-Timeout Transition................................................9-33
Guided Practice Les 9-1 Adding a Loop Counter Function Activity...................................9-34
Guided Practice Les 9-1 Adding a Loop Counter Function Activity Continued .................9-35
Guided Practice Les 9-1 Adding a Timeout transition to Loop Counter ............................9-36
Guided Practice Les 9-1 Adding a Timeout transition to Loop Counter Continued...........9-37
Guided Practice Les 9-1 Assigning a Process Result and Error Process ............................9-38
Guided Practice Les 9-1 Labeling End nodes with Result...................................................9-39
Les 9-1 Summary.................................................................................................................9-40
Overview of the Workflow Engine .......................................................................................10-1
Overview of the Workflow Engine......................................................................................10-2
Objectives ............................................................................................................................10-3
Overview of the Workflow Engine......................................................................................10-4
Overview of the Workflow Engine (continued) ..................................................................10-5
Workflow Engine Features ..................................................................................................10-6
Initiating a Workflow Process .............................................................................................10-7
Workflow Engine Processing ..............................................................................................10-8
Activity Statuses ..................................................................................................................10-9
Calling the Workflow Engine ..............................................................................................10-10
Oracle Workflow APIs ........................................................................................................10-11
Oracle Workflow APIs (continued) .....................................................................................10-12
Workflow Engine APIs........................................................................................................10-13
Background Engine .............................................................................................................10-18
Deferred Processing.............................................................................................................10-20
Timed Out Notification Activities .......................................................................................10-21
Error Processing...................................................................................................................10-22
Completing Workflow Notification Activities .....................................................................11-1
Completing Workflow Notification Activities ....................................................................11-2
Objectives ............................................................................................................................11-3
Oracle Workflow Home Page..............................................................................................11-4
Find Notifications Web Page...............................................................................................11-5
Notifications Worklist .........................................................................................................11-6
Notification Details..............................................................................................................11-8
Copyright Oracle Corporation, 2000. All rights reserved.
Oracle Workflow Table of Contents
v
Reassigning Notifications....................................................................................................11-9
Launching Oracle Application Forms..................................................................................11-11
E-Mail Notification..............................................................................................................11-12
E-Mail Notification (continued) ..........................................................................................11-14
E-Mail Summary of Notifications .......................................................................................11-15
Automatic Notification Processing......................................................................................11-16
Listing Notification Processing Rules .................................................................................11-17
Creating a New Notification Processing Rule .....................................................................11-18
Creating a New Notification Processing Rule (continued) ..................................................11-19
Monitoring Workflow Processes ..........................................................................................12-1
Monitoring Workflow Processes .........................................................................................12-2
Objectives ............................................................................................................................12-3
Workflow Monitor...............................................................................................................12-4
Process Title ........................................................................................................................12-5
Process Diagram Window ...................................................................................................12-6
Detail Tab Window..............................................................................................................12-7
Administration Buttons........................................................................................................12-8
Application-Controlled Access to the Workflow Monitor...................................................12-9
Application-Controlled Access to the Workflow Monitor (Continued) ..............................12-10
Direct Access to the Workflow Monitor..............................................................................12-11
Find Processes Web Page ....................................................................................................12-12
Reviewing the Process List..................................................................................................12-13
Reviewing the Notifications List .........................................................................................12-14
Filtering Activities in the Activities List .............................................................................12-16
Filtering Activities in the Activities List (continued) ..........................................................12-17
Child/Parent Instances .........................................................................................................12-18
Practice Les 12-1 Overview.................................................................................................12-19
Practice Les 12-1 Overview Continued ...............................................................................12-20
Guided Practice Les 12-1 Initiating a Work Item................................................................12-21
Guided Practice Les 12-1: Monitoring the Results..............................................................12-22
Guided Practice Les 12-1 Timing out Vacation Proposal notification ................................12-23
Guided Practice Les 12-1 Testing Schedule Vacation Function..........................................12-24
Guided Practice Les 12-1 Testing Schedule Vacation Function Continued ........................12-25
Guided Practice Les 12-1 Testing Post-Notification Function ............................................12-26
Guided Practice Les 12-1 Testing Post-Notification Function Continued...........................12-27
Les 12-1 Summary...............................................................................................................12-28
PL/SQL Documents ...............................................................................................................13-1
PL/SQL Documents.............................................................................................................13-2
Objectives ............................................................................................................................13-3
Integrating PL/SQL Documents in Workflow Processes.....................................................13-4
Defining Procedures to Generate a PL/SQL Document ......................................................13-5
Defining Procedures to Generate a PL/SQL Document (continued) ...................................13-7
PL/SQL Document Attachments .........................................................................................13-8
Practice Les 13-1 Overview.................................................................................................13-9
Guided Practice Les 13-1 Creating a PL/SQL Document Procedure ..................................13-10
Guided Practice Les 13-1 Using a PL/SQL Document Attribute ........................................13-13
Guided Practice Les 13-1 Setting a Document Attribute Value ..........................................13-16
Guided Practice Les 13-1 Testing a PL/SQL Document (HTML) ......................................13-17
Les 13-1 Summary...............................................................................................................13-18
Practice Les 13-2 Overview.................................................................................................13-19
Guided Practice Les 13-2 Creating a PL/SQL Procedure with Result.................................13-20
Guided Practice Les 13-2 RUN processing .........................................................................13-21
Guided Practice Les 13-2 CANCEL processing..................................................................13-22
Guided Practice Les 13-2 Adding a Function Activity........................................................13-23
Guided Practice Les 13-2 Adding a Function Activity Continued ......................................13-24
Copyright Oracle Corporation, 2000. All rights reserved.
Oracle Workflow Table of Contents
vi
Les 13-2 Summary...............................................................................................................13-25
Selector Functions..................................................................................................................14-1
Selector Functions ...............................................................................................................14-2
Objectives ............................................................................................................................14-3
Item Type Selector Function................................................................................................14-4
Standard API for the Selector/Callback Function................................................................14-5
Standard API for the Selector/Callback Function (continued).............................................14-6
Defining a Selector/Callback Function................................................................................14-7
Defining a Selector/Callback Function (continued).............................................................14-8
Calling a Selector/Callback Function ..................................................................................14-9
Practice Les 14-1 Overview.................................................................................................14-10
Guided Practice Les 14-1 Duplicating a Process.................................................................14-11
Guided Practice Les 14-1 Assigning a Selector Function....................................................14-12
Guided Practice Les 14-1 Creating a Selector Procedure ...................................................14-13
Guided Practice Les 14-1 RUN processing .........................................................................14-14
Guided Practice Les 14-1 Testing a Selector Function........................................................14-15
Guided Practice Les 14-1: Monitoring the Results..............................................................14-16
Les 14-1 Summary...............................................................................................................14-17
External System Integration.................................................................................................15-1
External System Integration.................................................................................................15-2
Objectives ............................................................................................................................15-3
Oracle Workflow Terms ......................................................................................................15-4
External Function Activity Support .....................................................................................15-5
Advanced Queues Processing..............................................................................................15-6
Advanced Queue Integration ...............................................................................................15-7
Block Activity......................................................................................................................15-14
CompleteActivity.................................................................................................................15-15
Forced Synchronous Processing...........................................................................................16-1
Forced Synchronous Processing ..........................................................................................16-2
Objectives ............................................................................................................................16-3
Forced Synchronous Processes............................................................................................16-4
Process Definition Restrictions............................................................................................16-5
Process Definition Restrictions (continued) ........................................................................16-6
Purge.......................................................................................................................................17-1
Purge....................................................................................................................................17-2
Objectives ............................................................................................................................17-3
Purging Obsolete Workflow Data........................................................................................17-4
Purging Obsolete Workflow Data in Oracle Applications...................................................17-5
Purging Obsolete Workflow Data in Oracle Applications (continued) ...............................17-6
Demonstration......................................................................................................................17-7
Document Management Integration....................................................................................18-1
Document Management Integration ....................................................................................18-2
Objectives ............................................................................................................................18-3
Document Management Integration ....................................................................................18-4
Document Management .......................................................................................................18-5
Defining Document Management Repositories...................................................................18-6
Document Management Integration in Notifications...........................................................18-7
Accessing a DM Document Sent by a Notification .............................................................18-8
Responding to a Notification with a DM Document ...........................................................18-9
Setting Up Oracle Workflow ................................................................................................19-1
Setting Up Oracle Workflow...............................................................................................19-2
Objectives ............................................................................................................................19-3
Required Set Up Steps .........................................................................................................19-4
Copyright Oracle Corporation, 2000. All rights reserved.
Oracle Workflow Table of Contents
vii
Step 1 Setting Global User Preferences ...............................................................................19-5
Step 2 Setting Up an Oracle Workflow Directory Service ..................................................19-6
Step 3 Verifying the WF_LANGUAGES View..................................................................19-7
Step 4 Setting the http_proxy Environment Variable ..........................................................19-8
Step 5 Setting the WF_RESOURCES Environment Variable.............................................19-9
Step 6 Setting Up Background Workflow Engines..............................................................19-10
Optional Setup Steps............................................................................................................19-11
Optional Step 1 Document Management Repositories .......................................................19-12
Optional Step 2 Notification Mailer ....................................................................................19-13
Optional Step 2 Notification Mailer Overview....................................................................19-14
Optional Step 2 continued Notification Mailer...................................................................19-15
Optional Step 2 continued Running the Notification Mailer ..............................................19-16
Optional Step 2 continued Notification Mailer Arguments ................................................19-18
Optional Step 3 Message Templates....................................................................................19-20
Optional Step 3 continued Message Templates ...................................................................19-21
Optional Step 4 Workflow Web Page Logo ........................................................................19-22
Optional Step 5 Custom Icons .............................................................................................19-23
Oracle Workflow Access Protection....................................................................................19-24
Access Levels ......................................................................................................................19-25
Setting Access Level............................................................................................................19-26
Setting Access, Protection, and Customization Levels........................................................19-27
Example of Access Protection .............................................................................................19-28
Workflow Definitions Loader..............................................................................................19-29
Transferring Workflow Definitions: Oracle Workflow Standalone....................................19-30
Transferring Workflow Definitions: Oracle Workflow embedded in Oracle Applications 19-32
Master/Detail Coordination Activities .................................................................................20-1
Master/Detail Coordination Activities.................................................................................20-2
Objectives ............................................................................................................................20-3
Master/Detail Coordination Activities.................................................................................20-4
Master/Detail Coordination Activities (continued)..............................................................20-5
Example of Master Process..................................................................................................20-6
Example of Detail Process...................................................................................................20-7
Extra Practices.......................................................................................................................21-1
Extra Practices .....................................................................................................................21-2
Extra Practice 1 Overview...................................................................................................21-3
Extra Practice 2 Overview...................................................................................................21-4
Extra Practice 3 Overview...................................................................................................21-5
Copyright Oracle Corporation, 2000. All rights reserved.
Oracle Workflow Table of Contents
ix
Preface
Profile
Before You Begin This Course
Before you begin this course, you should have the following qualifications:
Thorough knowledge of Oracle8 and/or Oracle 8i and Oracle WebDB,
Oracle Web Application Server, and/or Oracle Application Server
technology; and, if you plan to use Oracle Workflow with Oracle
Applications, a thorough knowledge of Oracle Applications
Working experience with PL/SQL
Prerequisites
Introduction to Oracle: SQL and PL/SQL
Overview of Oracle Workflow
How This Course Is Organized
Oracle Workflow is an instructor-led course featuring lecture and hands-on
exercises. Online demonstrations and written practice sessions reinforce the
concepts and skills introduced.
Copyright Oracle Corporation, 2000. All rights reserved.
Oracle Workflow Table of Contents
x
Related Publications
Oracle Publications
Title Part Number
Oracle Workflow Guide Release 2.5 A75397
Additional Publications
System release bulletins
Installation and users guides
read.me files
Oracle Applications Users Group (OAUG) articles
Oracle Magazine
Copyright Oracle Corporation, 2000. All rights reserved.
Oracle Workflow Table of Contents
xi
Typographic Conventions
Typographic Conventions in Text
Convention Element Example
Bold italic Glossary term (if
there is a glossary)
The algorithm inserts the new key.
Caps and
lowercase
Buttons,
check boxes,
triggers,
windows
Click the Executable button.
Select the Cant Delete Card check box.
Assign a When-Validate-Item trigger to the
ORD block.
Open the Master Schedule window.
Courier new,
case sensitive
(default is
lowercase)
Code output,
directory names,
filenames,
passwords,
pathnames,
URLs,
user input,
usernames
Code output: debug.set (I, 300);
Directory: bin (DOS), $FMHOME (UNIX)
Filename: Locate the init.ora file.
Password: User tiger as your password.
Pathname: Open c:\my_docs\projects
URL: Go to http://www.oracle.com
User input: Enter 300
Username: Log on as scott
Initial cap Graphics labels
(unless the term is a
proper noun)
Customer address (but Oracle Payables)
Italic Emphasized words
and phrases,
titles of books and
courses,
variables
Do not save changes to the database.
For further information, see Oracle7 Server
SQL Language Reference Manual.
Enter user_id@us.oracle.com,
where user_id is the name of the user.
Quotation
marks
Interface elements
with long names
that have only
initial caps;
lesson and chapter
titles in cross-
references
Select Include a reusable module component
and click Finish.
This subject is covered in Unit II, Lesson 3,
Working with Objects.
Uppercase SQL column
names, commands,
functions, schemas,
table names
Use the SELECT command to view
information stored in the LAST_NAME
column of the EMP table.
Copyright Oracle Corporation, 2000. All rights reserved.
Oracle Workflow Table of Contents
xii
Convention Element Example
Arrow Menu paths Select File> Save.
Brackets Key names Press [Enter].
Commas Key sequences Press and release keys one at a time:
[Alternate], [F], [D]
Plus signs Key combinations Press and hold these keys simultaneously:
[Ctrl]+[Alt]+[Del]
Typographic Conventions in Code
Convention Element Example
Caps and
lowercase
Oracle Forms
triggers
When-Validate-Item
Lowercase Column names,
table names
SELECT last_name
FROM s_emp;
Passwords DROP USER scott
IDENTIFIED BY tiger;
PL/SQL objects OG_ACTIVATE_LAYER
(OG_GET_LAYER
(prod_pie_layer))
Lowercase
italic
Syntax variables CREATE ROLE role
Uppercase SQL commands and
functions
SELECT userid
FROM emp;
Typographic Conventions in Navigation Paths
This course uses simplified navigation paths, such as the following example, to
direct you through Oracle Applications.
(N) Invoice > Entry > Invoice Batches Summary (M) Query > Find (B) Approve
This simplified path translates to the following:
1. (N) From the Navigator window, select Invoice > Entry > Invoice Batches
Summary.
2. (M) From the menu, select Query > Find.
3. (B) Click the Approve button.
Copyright Oracle Corporation, 2000. All rights reserved.
Oracle Workflow Table of Contents
xiii
Notations :
(N) = Navigator
(M) = Menu
(T) = Tab
(I) = Icon
(H) = Hyperlink
(B) = Button
Typographical Conventions in Help System Paths
This course uses a navigation path convention to represent actions you perform
to find pertinent information in the Oracle Applications Help System.
The following help navigation path, for example
(Help) General Ledger > Journals > Enter Journals
represents the following sequence of actions:
1. In the navigation frame of the help system window, expand the General
Ledger entry.
2. Under the General Ledger entry, expand Journals.
3. Under Journals, select Enter Journals.
4. Review the Enter Journals topic that appears in the document frame of the
help system window.
Copyright Oracle Corporation, 2000. All rights reserved.
Oracle Workflow Table of Contents
xiv
Copyright Oracle Corporation, 2000. All rights reserved.
Oracle Workflow Release 2.5 Introduction
Chapter 1 - Page 1
Oracle Workflow Release 2.5
Introduction
Chapter 1
Copyright Oracle Corporation, 2000. All rights reserved.
Oracle Workflow Release 2.5 Introduction
Chapter 1 - Page 2
Oracle Workflow Release 2.5
Copyright Oracle Corporation, 2000. All rights reserved.
Objectives
Objectives
After this course, you should be able to:
Explain why you would use Workflow
Design a workflow process using Oracle Workflow
Builder
Define your Oracle Workflow users and roles
View and respond to notification activities
Monitor and administer the status of a workflow
process
Write custom PL/SQL procedures that can be
executed as automated functions in a workflow
process
Set up Oracle Workflow for your site
After this course, you should be able to:
Explain why you would use Workflow
Design a workflow process using Oracle Workflow
Builder
Define your Oracle Workflow users and roles
View and respond to notification activities
Monitor and administer the status of a workflow
process
Write custom PL/SQL procedures that can be
executed as automated functions in a workflow
process
Set up Oracle Workflow for your site
Copyright Oracle Corporation, 2000. All rights reserved.
Oracle Workflow Release 2.5 Introduction
Chapter 1 - Page 4
Agenda
Copyright Oracle Corporation, 2000. All rights reserved.
Agenda
Agenda
Overview of Oracle Workflow
Planning and Creating a Workflow Process
Defining Function and Process Activities
Diagramming a Workflow Process
Advanced Features
Overview of Oracle Workflow
Planning and Creating a Workflow Process
Defining Function and Process Activities
Diagramming a Workflow Process
Advanced Features
Copyright Oracle Corporation, 2000. All rights reserved.
Oracle Workflow Release 2.5 Introduction
Chapter 1 - Page 5
Overview
Copyright Oracle Corporation, 2000. All rights reserved.
Overview
Overview
This course provides detailed information about
Oracle Workflow and its components so that you
can use its technology to workflow-enable any
application based on Oracle
This course provides detailed information about
Oracle Workflow and its components so that you
can use its technology to workflow-enable any
application based on Oracle
Copyright Oracle Corporation, 2000. All rights reserved.
Oracle Workflow Release 2.5 Introduction
Chapter 1 - Page 6
Copyright Oracle Corporation, 2000. All rights reserved.
Why Workflow?
Chapter 2 - Page 1
Why Workflow?
Chapter 2
Copyright Oracle Corporation, 2000. All rights reserved.
Why Workflow?
Chapter 2 - Page 2
Why Workflow?
Copyright Oracle Corporation, 2000. All rights reserved.
Why Workflow?
Why Workflow?
Copyright Oracle Corporation, 2000. All rights reserved.
Why Workflow?
Chapter 2 - Page 3
Objectives
Copyright Oracle Corporation, 2000. All rights reserved.
Objectives
Objectives
After this lesson, you should be able to:
Explain why you would use Workflow
Explain and describe Workflow processes
After this lesson, you should be able to:
Explain why you would use Workflow
Explain and describe Workflow processes
Copyright Oracle Corporation, 2000. All rights reserved.
Why Workflow?
Chapter 2 - Page 4
All Businesses Must Become E-Businesses
Copyright Oracle Corporation, 2000. All rights reserved.
All Businesses
Must Become E-Businesses
All Businesses
Must Become E-Businesses
Streamlined business processes plays a critical role
with the transformation to e-business
The wiring for
e-business
Oracle Workflow
Copyright Oracle Corporation, 2000. All rights reserved.
Why Workflow?
Chapter 2 - Page 5
Oracle Workflow
Copyright Oracle Corporation, 2000. All rights reserved.
Oracle Workflow
Oracle Workflow
Oracle Workflow automates and streamlines
business processes contained within and
between enterprises:
Add personalized trading partner rules
Validate self-service transactions
Achieve closed loop business intelligence
Approve standard business documents
Step through daily transaction flows
Oracle Workflow automates and streamlines
business processes contained within and
between enterprises:
Add personalized trading partner rules
Validate self-service transactions
Achieve closed loop business intelligence
Approve standard business documents
Step through daily transaction flows
The heart of e-business
Copyright Oracle Corporation, 2000. All rights reserved.
Why Workflow?
Chapter 2 - Page 6
Workflow Driven Business Processes
Copyright Oracle Corporation, 2000. All rights reserved.
Workflow is Essential
Workflow is Essential
Complete process representation
Crosses organizational, company boundaries
Build in management metrics, performance
goals
Adaptable workflow processes
Provides alternatives
Allow for refinement
Analyze time and costs of entire processes with
multidimensional analysis
Reducing costs and time
Complete process representation
Crosses organizational, company boundaries
Build in management metrics, performance
goals
Adaptable workflow processes
Provides alternatives
Allow for refinement
Analyze time and costs of entire processes with
multidimensional analysis
Reducing costs and time
Workflow enables continuous process improvement
Copyright Oracle Corporation, 2000. All rights reserved.
Why Workflow?
Chapter 2 - Page 10
Expense Report Processing
Copyright Oracle Corporation, 2000. All rights reserved.
Workflow enabled
Workflow Enabled e-business Suite
Workflow Enabled e-business Suite
Copyright Oracle Corporation, 2000. All rights reserved.
Why Workflow?
Chapter 2 - Page 21
Workflow Enabled e-business Suite
Copyright Oracle Corporation, 2000. All rights reserved.
Workflow
is much more
than approvals
Workflow
Workflow
Copyright Oracle Corporation, 2000. All rights reserved.
Overview of Oracle Workflow
Chapter 3 - Page 1
Overview of Oracle Workflow
Chapter 3
Copyright Oracle Corporation, 2000. All rights reserved.
Overview of Oracle Workflow
Chapter 3 - Page 2
Overview of Oracle Workflow
Copyright Oracle Corporation, 2000. All rights reserved.
Objectives
Objectives
After this lesson, you should be able to:
Understand the concept of a workflow process
Describe the architecture of Oracle Workflow
Describe Oracle Workflows features
After this lesson, you should be able to:
Understand the concept of a workflow process
Describe the architecture of Oracle Workflow
Describe Oracle Workflows features
Copyright Oracle Corporation, 2000. All rights reserved.
Overview of Oracle Workflow
Chapter 3 - Page 4
Overview
Copyright Oracle Corporation, 2000. All rights reserved.
Overview
Overview
Routes Information
Defines any rule
Delivers electronic notifications
Routes Information
Defines any rule
Delivers electronic notifications
Oracle Workflow accomplishes three important business requirements:
Routes Information
Routes information through Oracle Application.
These attachments include self-service Web page and Application forms.
Defines Any Rule
Oracle Workflow Builder lets you graphically define the business rules of
your process.
PL/SQL lets you express those rules as automated activities.
Delivers Electronic Notifications
Delivers electronic notifications to any Oracle Applications user.
Delivers electronic notifications to any e-mail or Internet user.
Copyright Oracle Corporation, 2000. All rights reserved.
Overview of Oracle Workflow
Chapter 3 - Page 5
Workflow Architecture
Copyright Oracle Corporation, 2000. All rights reserved.
Roles Users
Directory Services
Notification Services
Send
Respond
Forward
Cancel
Query
Oracle Workflow Enabled Application
Oracle Server
Engine
Execution
Definition
Administration
Monitoring
Query
Workflow
Builder
Workflow
Loader
Workflow
Definition
Files
Workflow
Development
Client
Oracle
Application
Server
or
WebDB
Notification
Mailer
Application
Server
Web
Notification
Worklist
Web
Process
Monitor
Web
Analysis
Tools
End-User
Client
Mail
Applications
Workflow Architecture
Workflow Architecture
Workflow Development Client
The development client is a PC running Windows95 or Windows NT. It is
a platform that will be used to create and modify the Oracle Workflow
definitions.
Oracle Server
The Oracle Server platform is the Oracle RDBMS. This hosts the business
application, integrated with Oracle Workflow.
Application Server
The Application Server is the environment outside of the RDBMS. This
includes ancillary services such as Oracle Web Application Server,
WebDB, and the Notification Mailer.
End-User Client
The End-User Client is the workstation or PC that the end user uses to
perform their daily tasks. This will include support for reviewing and
responding to notifications and using the Oracle Workflow Monitor.
Copyright Oracle Corporation, 2000. All rights reserved.
Overview of Oracle Workflow
Chapter 3 - Page 6
Oracle Workflow Features and Definitions
Copyright Oracle Corporation, 2000. All rights reserved.
Workflow Engine
Workflow Engine
Is embedded in the Oracle8i server
Uses the process definition created with Oracle
Workflow Builder to coordinate the routing of
activities for the process
Monitors the state of each activity in a workflow
process
Signals any changes in the workflow state to the
engine using calls to PL/SQL or Java APIs
Guarantees consistency between the application
and the workflow state because of Oracle8i
transactional integrity
Is embedded in the Oracle8i server
Uses the process definition created with Oracle
Workflow Builder to coordinate the routing of
activities for the process
Monitors the state of each activity in a workflow
process
Signals any changes in the workflow state to the
engine using calls to PL/SQL or Java APIs
Guarantees consistency between the application
and the workflow state because of Oracle8i
transactional integrity
Copyright Oracle Corporation, 2000. All rights reserved.
Overview of Oracle Workflow
Chapter 3 - Page 12
Workflow Definitions Loader
Copyright Oracle Corporation, 2000. All rights reserved.
Notification System
Notification System
e.g. UNIX Sendmail e.g. UNIX Sendmail
or MAPI compliant or MAPI compliant
Mail System Mail System
Application
Notification
Mailer
Oracle
Applications
Screens
Workflow
Worklist
Workflow
Engine
Notification
System
Directory
Services
Oracle 8 or higher
Notification System Features
Routes notifications to a role, which can be a single user or group of
users
Enables users to receive and respond to notifications using an e-mail
application or Web browser of choice
Allows users with access to the Internet to be included in a workflow
process
Access to Notification Worklist from Oracle Applications
Enables users to drill down to any URL or Oracle Applications screen to
respond to a notification from the Notification Worklist
Copyright Oracle Corporation, 2000. All rights reserved.
Overview of Oracle Workflow
Chapter 3 - Page 14
Notification Worklist Web Page
Notification Worklist Web Page
Notification Worklist Web Page
Notification Worklist
The Notification Worklist is a facility that provides a list of the open
notifications to a particular user. The Worklist is viewable through the
Oracle Workflow Web Agent or through Oracle Applications. You can
also configure the Notification Mailer to send an e-mail summarizing the
outstanding notifications. From the Worklist the user can view the
notifications as well as respond to those that require a response.
Viewing Notifications from a Web Page
Requires Oracle WebDB 2.0 or higher, Oracle Web Application
Server 3.0.1 or higher, or Oracle Application Server 4.0.7 or higher
Requires a Web browser that supports Frames and JavaScript
Note: Notification System has an Oracle Web Agent interface that
dynamically generates the list of notifications for a user.
Copyright Oracle Corporation, 2000. All rights reserved.
Overview of Oracle Workflow
Chapter 3 - Page 15
Notification Details Web Page
Copyright Oracle Corporation, 2000. All rights reserved.
Directory Services
Directory Services
WF_USERS
Contains information on the user names,
display names for the users, their notification
preference and their e-mail addresses
WF_USER_ROLES
Contains information on the association of the
users to the roles
WF_ROLES
Contains information on the roles of which
users can be members
WF_USERS
Contains information on the user names,
display names for the users, their notification
preference and their e-mail addresses
WF_USER_ROLES
Contains information on the association of the
users to the roles
WF_ROLES
Contains information on the roles of which
users can be members
Directory Services
The directory service for Oracle Workflow is implemented as a set of
views that are mapped across the user tables of the underlying application.
The above slide lists the three views.
Users can be associated with more than one role and a role may contain
more than one user. The Engine and Notification System utilize the
Directory Services to determine who should receive Notifications and in
what format. Notifications can be delivered to an individual user or to all
members of a particular role.
Copyright Oracle Corporation, 2000. All rights reserved.
Overview of Oracle Workflow
Chapter 3 - Page 19
Oracle Workflow Monitor
Copyright Oracle Corporation, 2000. All rights reserved.
Demonstration
Demonstration
Start a Workflow process
Follow a Workflow process through to completion
Make changes to a Workflow process
Start a Workflow process
Follow a Workflow process through to completion
Make changes to a Workflow process
Using Oracle Workflow we will demonstrate how to: Using Oracle Workflow we will demonstrate how to:
Copyright Oracle Corporation, 2000. All rights reserved.
Planning a Workflow Process
Chapter 4 - Page 1
Planning a Workflow Process
Chapter 4
Copyright Oracle Corporation, 2000. All rights reserved.
Planning a Workflow Process
Chapter 4 - Page 2
Planning a Workflow Process
Copyright Oracle Corporation, 2000. All rights reserved.
Objectives
Objectives
After this lesson, you should be able to:
Identify the components of a workflow process
Plan a workflow process
After this lesson, you should be able to:
Identify the components of a workflow process
Plan a workflow process
Copyright Oracle Corporation, 2000. All rights reserved.
Planning a Workflow Process
Chapter 4 - Page 4
Process Components
Copyright Oracle Corporation, 2000. All rights reserved.
Process Components
Process Components
Item Type
Process
Functions Notifications Subprocesses
...
...
...
Lookup
Types,
Attributes
Messages,
Lookup
Types,
Attributes
Functions,
Notifications,
Lookup
Types
...
Oracle Workflow Process Components
Item Type: A grouping of workflow components. All components of a
workflow process must be associated with a specific item type.
Item Type Attribute: Attributes of the item type that can be globally
referenced by any activity in a process.
Process Activity: The working diagram of a business process. Includes
function, notification, and process activities (that represent subprocesses)
and the transitions between these activities.
Function Activity: Automated unit of work defined as a PL/SQL stored
procedure.
Notification Activity: Activity that sends a message to a performer.
Message: The message may request the performer, the role receiving the
message, to do some work or may simply provide information.
Lookup Type: List of values that can be referenced by any component.
Copyright Oracle Corporation, 2000. All rights reserved.
Planning a Workflow Process
Chapter 4 - Page 5
Oracle Workflow Builder
Copyright Oracle Corporation, 2000. All rights reserved.
Demonstration
Demonstration
Samples of Oracle Applications R11i workflow
processes
Samples of Oracle Applications R11i workflow
processes
In Oracle Workflow we will show : In Oracle Workflow we will show :
Copyright Oracle Corporation, 2000. All rights reserved.
Planning a Workflow Process
Chapter 4 - Page 14
Copyright Oracle Corporation, 2000. All rights reserved.
Defining Item Types, Item Attributes, and Lookup Types
Chapter 5 - Page 1
Defining Item Types, Item
Attributes, and Lookup Types
Chapter 5
Copyright Oracle Corporation, 2000. All rights reserved.
Defining Item Types, Item Attributes, and Lookup Types
Chapter 5 - Page 2
Defining Item Types, Item Attributes, and Lookup Types
Copyright Oracle Corporation, 2000. All rights reserved.
Objectives
Objectives
After this lesson, you should be able to:
Create an item type
Create an item type selector/callback function
Create item type attributes
Create lookup types
After this lesson, you should be able to:
Create an item type
Create an item type selector/callback function
Create item type attributes
Create lookup types
Copyright Oracle Corporation, 2000. All rights reserved.
Defining Item Types, Item Attributes, and Lookup Types
Chapter 5 - Page 4
Create a New Workflow Process Definition
Copyright Oracle Corporation, 2000. All rights reserved.
Top-Down Design
Top-Down Design
Draw the process diagram first and then define the
underlying components.
Create new activities while drawing a process
diagram.
View activity and process activity property pages
from one dialogue.
Property page includes all tabs for base activity of
the node and the usage of the individual node.
Save a partially completed or errored process and
complete or correct later.
Draw the process diagram first and then define the
underlying components.
Create new activities while drawing a process
diagram.
View activity and process activity property pages
from one dialogue.
Property page includes all tabs for base activity of
the node and the usage of the individual node.
Save a partially completed or errored process and
complete or correct later.
Copyright Oracle Corporation, 2000. All rights reserved.
Defining Item Types, Item Attributes, and Lookup Types
Chapter 5 - Page 6
Quick Start Wizard
Copyright Oracle Corporation, 2000. All rights reserved.
Form Attributes
Form Attributes
Click on form icon to launch
Oracle Applications form
Form Type Attribute
The Notification Detail Web page supports form attributes. They appear in
a notification message as a form icon. When you open your notification
you can click on the attached form icon which drills down to the
referenced form.
Form Attribute Values
The value of a form parameter can be a text string enclosed in quotes ( )
or can be token substituted with another predefined item type attribute in
any of the following ways:
parameterN = &item_type_attribute
parameterN = Value &item_type_attribute, where
&item_type_attribute represents the rest of the value
Note: This attribute type is not relevant for the standalone version of
Oracle Workflow.
Copyright Oracle Corporation, 2000. All rights reserved.
Defining Item Types, Item Attributes, and Lookup Types
Chapter 5 - Page 15
Document Attributes
Copyright Oracle Corporation, 2000. All rights reserved.
Document Attributes
Document Attributes
PL/SQL document: a document representing data
from the database, generated from a PL/SQL
procedure.
Ideal for use when document content varies
For example, purchase orders with variable
number of lines or sales orders with variable
lines, discounts, and shipping addresses
DM document: a document managed by an
external document management system
PL/SQL document: a document representing data
from the database, generated from a PL/SQL
procedure.
Ideal for use when document content varies
For example, purchase orders with variable
number of lines or sales orders with variable
lines, discounts, and shipping addresses
DM document: a document managed by an
external document management system
You can specify the following types of documents in You can specify the following types of documents in
the default value field: the default value field:
Document Type Attributes
The Notification Detail Web page supports document attributes. They
appear in a notification message as an inline link or as an attachment icon.
When you open your notification you can click on a link or an attachment
icon to open the referenced document.
Document Attribute Values
The value of a document attribute can be a text string or can be token
substituted.
A PL/SQL document value is specified in the format:
PLSQL:<procedure>/<document identifier>
A DM document value is specified in the format:
DM:<document management node id>:<document identifier as
assigned by the DM system>
Copyright Oracle Corporation, 2000. All rights reserved.
Defining Item Types, Item Attributes, and Lookup Types
Chapter 5 - Page 16
URL Attributes
Copyright Oracle Corporation, 2000. All rights reserved.
URL Attributes
URL Attributes
URL Message Attribute Target
If the item attribute type you create is URL, specify a Frame Target. When
you reference this item attribute as the default value of a message attribute
in a message, the URL frame opens according to what you specified as the
frame target. The options are:
New Window: The URL loads in a new, unnamed browser
window.
Same Frame: The URL loads in the same frame as the element that
references the URL attribute.
Parent Frameset: The URL loads into the immediate FRAMESET
parent of the current frame. This value is equivalent to Same
Frame, if the current frame has no parent.
Full Window: The URL loads into the full, original window, thus
canceling all other frames. This value is equivalent to Same Frame,
if the current frame has no parent.
Copyright Oracle Corporation, 2000. All rights reserved.
Defining Item Types, Item Attributes, and Lookup Types
Chapter 5 - Page 17
Activities and Lookup Types
Copyright Oracle Corporation, 2000. All rights reserved.
Objectives
Objectives
After this lesson, you should be able to:
Define a message
Define a message attribute
Define a notification activity
After this lesson, you should be able to:
Define a message
Define a message attribute
Define a notification activity
Copyright Oracle Corporation, 2000. All rights reserved.
Defining a Notification Activity
Chapter 6 - Page 4
Workflow Terms
Copyright Oracle Corporation, 2000. All rights reserved.
Workflow Terms
Workflow Terms
Notification Activity
A task that requires human intervention. A
notification activity sends a message to a user
containing the information needed to complete
the work.
Notification Activity
A task that requires human intervention. A
notification activity sends a message to a user
containing the information needed to complete
the work.
Copyright Oracle Corporation, 2000. All rights reserved.
Defining a Notification Activity
Chapter 6 - Page 5
Create a New Workflow Process Definition
Copyright Oracle Corporation, 2000. All rights reserved.
Define a Message
Define a Message
Message Property Page
Messages must be associated with an item type and are created in the navigator
tree under the Messages branch of the item type. Select the item type, then
select New Message... from the Edit menu.
1. Enter an internal name, display name and description for the message.
2. Specify a priority for the message.
The priority entered here is specific to the message.
Recipients of this message can sort their notifications based on this priority.
Note: The 1 to 99 message priority scale of previous releases is now obsolete.
The notification priority values are: High, Normal and Low.
Body Property Page
Select the Body tab to display the Body property page.
1. Specify the message subject and body. The message body can be entered
using text or HTML formatting.
2. Optionally include message attributes in the subject or body.
Define a message attribute using the Message Attributes property page.
Specify the internal name of the message attribute and precede that internal
name with an & in the subject or body of the message.
Message attributes are token substituted with a runtime value when the
message is sent.
Copyright Oracle Corporation, 2000. All rights reserved.
Defining a Notification Activity
Chapter 6 - Page 7
Define a Message (Continued)
Copyright Oracle Corporation, 2000. All rights reserved.
Execution Modes
Execution Modes
Notification activity with a post-notification
function modes are:
RESPOND
FORWARD
TRANSFER
RUN
TIMEOUT
Notification activity with a post-notification
function modes are:
RESPOND
FORWARD
TRANSFER
RUN
TIMEOUT
Post-Notification Function Modes
RESPOND: The performer responded to the notification. The post-
notification function can interpret the result and perform post-
response processing. The function can reject the response with an
error.
FORWARD: The performer delegates the notification to another
user. The function can audit or reject the delegation request with an
error. This state corresponds to the Delegate Authority option in
the user interface.
TRANSFER: The performer transfers the notification to another
user. The function can audit or reject the transfer request with an
error.
RUN: Called after RESPOND, FORWARD, or TRANSFER
modes. The post-notification function in RUN mode can perform
additional processing associated with the notification event.
TIMEOUT: If a notification activity does not complete within a
certain period of time then Oracle Workflow marks that activity as
timed out and then cancels any notification associated with the
timed out activity. The Notification System sends a cancellation
message to the performer only if the cancelled notification was
expecting a response and the performer's notification preference is
to receive e-mail.
Copyright Oracle Corporation, 2000. All rights reserved.
Defining a Notification Activity
Chapter 6 - Page 15
Note: If the post-notification function in RESPOND, FORWARD or
TRANSFER mode returns ERROR:<errcode> as a result or raises an
exception, the Workflow Engine aborts the respond, forward, or transfer
operation.
Copyright Oracle Corporation, 2000. All rights reserved.
Defining a Notification Activity
Chapter 6 - Page 16
Standard Voting Activity
Copyright Oracle Corporation, 2000. All rights reserved.
Overview of the
Workflow Directory Service
Overview of the
Workflow Directory Service
Copyright Oracle Corporation, 2000. All rights reserved.
Overview of the Workflow Directory Service
Chapter 7 - Page 3
Objectives
Copyright Oracle Corporation, 2000. All rights reserved.
Objectives
Objectives
After this lesson, you should be able to:
Explain how Oracle Workflow receives information
about a role
Map Oracle Workflow to your directory repository
After this lesson, you should be able to:
Explain how Oracle Workflow receives information
about a role
Map Oracle Workflow to your directory repository
Copyright Oracle Corporation, 2000. All rights reserved.
Overview of the Workflow Directory Service
Chapter 7 - Page 4
Terms
Copyright Oracle Corporation, 2000. All rights reserved.
Terms
Terms
Role
Directory Repository
Role
Directory Repository
Workflow Definitions
Role: A grouping of one or more users who share a common responsibility
Directory Repository: A set of database tables that contain user information
Copyright Oracle Corporation, 2000. All rights reserved.
Overview of the Workflow Directory Service
Chapter 7 - Page 5
Directory Service Views
Copyright Oracle Corporation, 2000. All rights reserved.
WF_USERS View
WF_USERS View
Name: Internal name of a user
Display Name: Display name of a user
Description: Description of a user
Notification Preference: A value of MAILTEXT,
MAILATTH, MAILHTML, QUERY or SUMMARY to
indicate how user prefers to receive notifications
Language: NLS_LANGUAGE initialization
parameter that specifies the default language-
dependent behavior
Territory: NLS_TERRITORY initialization parameter
that specifies the default language-dependent date
and numeric formatting used
Name: Internal name of a user
Display Name: Display name of a user
Description: Description of a user
Notification Preference: A value of MAILTEXT,
MAILATTH, MAILHTML, QUERY or SUMMARY to
indicate how user prefers to receive notifications
Language: NLS_LANGUAGE initialization
parameter that specifies the default language-
dependent behavior
Territory: NLS_TERRITORY initialization parameter
that specifies the default language-dependent date
and numeric formatting used
Columns in WF_USERS contain the following Columns in WF_USERS contain the following
information: information:
Copyright Oracle Corporation, 2000. All rights reserved.
Overview of the Workflow Directory Service
Chapter 7 - Page 7
WF_USERS View (continued)
Copyright Oracle Corporation, 2000. All rights reserved.
WF_ROLES View
WF_ROLES View
Name
Display Name
Description
Notification Preference
Language
Name
Display Name
Description
Notification Preference
Language
Workflow roles can be roles, positions or Workflow roles can be roles, positions or
responsibilities referenced in a directory repository. responsibilities referenced in a directory repository.
The columns in WF_ROLES are similar to those in The columns in WF_ROLES are similar to those in
WF_USERS view: WF_USERS view:
Copyright Oracle Corporation, 2000. All rights reserved.
Overview of the Workflow Directory Service
Chapter 7 - Page 9
WF_ROLES View (continued)
Copyright Oracle Corporation, 2000. All rights reserved.
WF_USER_ROLES View
WF_USER_ROLES View
User_Name: Internal name of the user as listed in
WF_USERS view
User_Orig_System: Name assigned to the
directory repository that WF_USERS is based on
User_Orig_System_ID: Primary key that identifies
this user in the user directory repository
User_Name: Internal name of the user as listed in
WF_USERS view
User_Orig_System: Name assigned to the
directory repository that WF_USERS is based on
User_Orig_System_ID: Primary key that identifies
this user in the user directory repository
WF_USER_ROLES is an intersection of the users and WF_USER_ROLES is an intersection of the users and
roles in WF_USER and WF_ROLES. roles in WF_USER and WF_ROLES.
Copyright Oracle Corporation, 2000. All rights reserved.
Overview of the Workflow Directory Service
Chapter 7 - Page 11
WF_USER_ROLES View (continued)
Copyright Oracle Corporation, 2000. All rights reserved.
Ad Hoc Users/Roles
Ad Hoc Users/Roles
You can create and manage ad hoc users and
roles in a workflow process.
Use server PL/SQL APIs to dynamically create new
user and role definitions in the directory service.
The new APIs store the information in the
WF_LOCAL_* tables.
The WF_USERS and WF_ROLES views use the
EXPIRATION_DATE.
WF_LOCAL_USER_ROLES keeps track of the
originating system of the users and roles.
You can create and manage ad hoc users and
roles in a workflow process.
Use server PL/SQL APIs to dynamically create new
user and role definitions in the directory service.
The new APIs store the information in the
WF_LOCAL_* tables.
The WF_USERS and WF_ROLES views use the
EXPIRATION_DATE.
WF_LOCAL_USER_ROLES keeps track of the
originating system of the users and roles.
WF_DIRECTORY package APIs supporting ad hoc users/roles are:
CreateAdHocUser()
CreateAdHocRole()
AddUsersToAddHocRole()
GetRoleDisplayName()
SetAdHocUserStatus()
SetAdHocRoleStatus()
SetAdHocUserExpiration()
SetAdHocRoleExpiration()
SetAdHocUserAttr()
SetAdHocRoleAttr()
RemoveUsersFromAdHocRole()
Copyright Oracle Corporation, 2000. All rights reserved.
Overview of the Workflow Directory Service
Chapter 7 - Page 16
Directory Service for Oracle Applications
Copyright Oracle Corporation, 2000. All rights reserved.
Objectives
Objectives
After this lesson, you should be able to:
Define a function activity
Define an activity attribute
Apply the Workflow Engine APIs to your function
activities
Define a process activity
After this lesson, you should be able to:
Define a function activity
Define an activity attribute
Apply the Workflow Engine APIs to your function
activities
Define a process activity
Copyright Oracle Corporation, 2000. All rights reserved.
Defining Function and Process Activities
Chapter 8 - Page 4
Create a New Workflow Process Definition
Copyright Oracle Corporation, 2000. All rights reserved.
Execution Modes
Execution Modes
Function activity modes:
RUN
Activities that are executed for the first time
Follows CANCEL mode on a loop reset
CANCEL
Activities revisited as part of a loop reset
Activities that are part of a process that has
been canceled by a call to
WF_ENGINE.AbortProcess
Activities that are part of the process
stream being undone by a call to
WF_ENGINE.HandleError
Function activity modes:
RUN
Activities that are executed for the first time
Follows CANCEL mode on a loop reset
CANCEL
Activities revisited as part of a loop reset
Activities that are part of a process that has
been canceled by a call to
WF_ENGINE.AbortProcess
Activities that are part of the process
stream being undone by a call to
WF_ENGINE.HandleError
Copyright Oracle Corporation, 2000. All rights reserved.
Defining Function and Process Activities
Chapter 8 - Page 10
Notification Activities Revisited
Copyright Oracle Corporation, 2000. All rights reserved.
Execution Modes
Execution Modes
Notification activity with a post-notification
function modes are:
RESPOND
FORWARD
TRANSFER
RUN
TIMEOUT
Notification activity with a post-notification
function modes are:
RESPOND
FORWARD
TRANSFER
RUN
TIMEOUT
Post-Notification Function Modes
RESPOND: The performer responded to the notification. The post-
notification function can interpret the result and perform post-
response processing. The function can reject the response with an
error.
FORWARD: The performer delegates the notification to another
user. The function can audit or reject the delegation request with an
error. This state corresponds to the Delegate Authority option in
the user interface.
TRANSFER: The performer transfers the notification to another
user. The function can audit or reject the transfer request with an
error.
RUN: Called after RESPOND, FORWARD, or TRANSFER
modes. The post-notification function in RUN mode can perform
additional processing associated with the notification event.
TIMEOUT: If a notification activity does not complete within a
certain period of time then Oracle Workflow marks that activity as
timed out and then cancels any notification associated with the
timed out activity. The Notification System sends a cancellation
message to the performer only if the cancelled notification was
expecting a response and the performer's notification preference is
to receive e-mail.
Copyright Oracle Corporation, 2000. All rights reserved.
Defining Function and Process Activities
Chapter 8 - Page 14
Note: If the post-notification function in RESPOND, FORWARD or
TRANSFER mode returns ERROR:<errcode> as a result or raises an
exception, the Workflow Engine aborts the respond, forward, or transfer
operation.
Copyright Oracle Corporation, 2000. All rights reserved.
Defining Function and Process Activities
Chapter 8 - Page 15
Post-Notification Function
Copyright Oracle Corporation, 2000. All rights reserved.
Post-Notification Function
Post-Notification Function
Reference Global WF_ENGINE variables in PL/SQL
Global Context Information set:
WF_ENGINE.context_nid = notification_ID
WF_ENGINE.context_text = new recipient_role
available in TRANSFER or FORWARD mode
WF_ENGINE.context_text = responder
available in RESPOND mode
Reference Global WF_ENGINE variables in PL/SQL
Global Context Information set:
WF_ENGINE.context_nid = notification_ID
WF_ENGINE.context_text = new recipient_role
available in TRANSFER or FORWARD mode
WF_ENGINE.context_text = responder
available in RESPOND mode
Note: The value of responder varies depending on the notification
interface the recipient uses to respond. If the recipient responds using the
Notification Web page, responder is set to the role name of the responder.
If the recipient responds using e-mail, responder is set to
email:responder_email_address.
Copyright Oracle Corporation, 2000. All rights reserved.
Defining Function and Process Activities
Chapter 8 - Page 16
Exception Handling
Copyright Oracle Corporation, 2000. All rights reserved.
Exception Handling
Exception Handling
Use WF_CORE APIs to raise and catch errors in
your PL/SQL procedures
Engine sets function activity status ERROR if:
PL/SQL procedure raises an unhandled
exception
PL/SQL procedure returns a result beginning
with ERROR:
Use WF_CORE APIs to raise and catch errors in
your PL/SQL procedures
Engine sets function activity status ERROR if:
PL/SQL procedure raises an unhandled
exception
PL/SQL procedure returns a result beginning
with ERROR:
Debugging Function Activities Debugging Function Activities
Activities that Error
The following columns from the table
WF_ITEM_ACTIVITY_STATUSES, viewable from the Workflow
Monitor are set to reflect the error:
ERROR_NAME
ERROR_MESSAGE
ERROR_STACK
Copyright Oracle Corporation, 2000. All rights reserved.
Defining Function and Process Activities
Chapter 8 - Page 17
Exception Handling Example
Copyright Oracle Corporation, 2000. All rights reserved.
exception
when others then
WF_CORE.CONTEXT (<package name>,
<procedure name>, <itemtype>, <itemkey>,
to_char(<actid>), <funcmode>;
raise;
end <procedure name>
exception
when others then
WF_CORE.CONTEXT (<package name>,
<procedure name>, <itemtype>, <itemkey>,
to_char(<actid>), <funcmode>;
raise;
end <procedure name>
Exception Handling
WF_CORE.CONTEXT adds an entry to the error stack to provide context
information that helps locate the source of an error.
Use the exception handler example construct in your PL/SQL procedures to
facilitate debugging workflow function activities.
If a call to procedure name failed with an unhandled exception, the
column ERROR_STACK in WF_ITEM_ACTIVITY_STATUSES would
record the call to procedure name and its arguments.
Copyright Oracle Corporation, 2000. All rights reserved.
Defining Function and Process Activities
Chapter 8 - Page 18
Defining a Function Activity Attribute
Copyright Oracle Corporation, 2000. All rights reserved.
Looping
Looping
Looping occurs when the completion of an activity
causes a transition to another activity that has
already been completed.
The first activity detected as a revisited activity is
also called a loop point or pivot activity.
The Workflow Engine can handle a revisited
activity in one of three ways:
Ignore
Reset
Re-execute
Looping occurs when the completion of an activity
causes a transition to another activity that has
already been completed.
The first activity detected as a revisited activity is
also called a loop point or pivot activity.
The Workflow Engine can handle a revisited
activity in one of three ways:
Ignore
Reset
Re-execute
Handling a Revisited Activity
Ignore the activity and stop further processing of the thread, so in
effect, the activity can only run once.
Reset the loop to the loop point before re-executing by first
running logic to undo the activities within the loop.
Re-execute the loop point and all activities within the loop without
running any compensatory logic.
Copyright Oracle Corporation, 2000. All rights reserved.
Defining Function and Process Activities
Chapter 8 - Page 22
Looping
Copyright Oracle Corporation, 2000. All rights reserved.
Looping
Looping
Non-canceling Loop can improve performance by
preventing the rerun of functions in CANCEL
mode.
Non-canceling Loop can improve performance by
preventing the rerun of functions in CANCEL
mode.
Ignore: is for OR-type
operations where rest of
branch is ignored.
Reset: permits resetting
status by recalling
activities
in CANCEL-mode.
Loop: performs loop
without any reset.
Non-Canceling Loop
Looping occurs when the completion of an activity causes a transition to
another activity that has already been completed. The first activity that is
detected as a revisited activity is called a loop point or pivot activity.
Every activity has an On Revisit pop-up list field in its Oracle Workflow
Builder Details property page. The On Revisit pop-up list lets you specify
the behavior of the Workflow Engine when it revisits the activity in a
workflow process. It is an important flag to set for the pivot activity of a
loop. You can set the field to Ignore, Reset, or Loop. Setting On Revisit
to Loop for an activity is useful when you want to simply re-execute
activities in a loop without resetting the status of the activities in the loop.
Loop causes the Workflow Engine to re-execute the activity in RUN mode
without executing any CANCEL mode logic for the activity.
Copyright Oracle Corporation, 2000. All rights reserved.
Defining Function and Process Activities
Chapter 8 - Page 23
Self-Looping Transitions
Copyright Oracle Corporation, 2000. All rights reserved.
Self-Looping Transitions
Self-Looping Transitions
<Timeout>
Approve
Reject
Approve
Reject
<Timeout>
End (Approve)
End (Re je ct)
Notify
Requis ition
Approval
Re quire d
Reminder-Approval
Nee ded
Or
Or
Start
Activity loops
back to
itself
on Timeout
Self-Looping Transitions
You can draw a transition that loops back to its source activity without
creating additional activity nodes.
Copyright Oracle Corporation, 2000. All rights reserved.
Defining Function and Process Activities
Chapter 8 - Page 24
Default Error Process
Copyright Oracle Corporation, 2000. All rights reserved.
Error Handling
Error Handling
Notify System Administrator or a user of your
choice if an unexpected error occurs
Option to retry, abort or ignore from the
notification
Link to directly access administrator toolkit on the
monitor for more complex processing
Automatically terminates when error is no longer
active
Notify System Administrator or a user of your
choice if an unexpected error occurs
Option to retry, abort or ignore from the
notification
Link to directly access administrator toolkit on the
monitor for more complex processing
Automatically terminates when error is no longer
active
Error Item Type Support
You can add custom error processes to the System: Error item type or to
any other item type. However, you cannot edit the two predefined System:
Error error processes.
In addition, the default error process in the WFERROR item type includes
additional information in the notification that it sends to the workflow
administrator:
Monitor URL: Enables the administrator to navigate to the error
process.
A request to either retry or abort the process
Use the WF_ADMINISTRATOR item attribute in your item type to
specify to which role to send the error notification; the default is the
System Administrator role.
Copyright Oracle Corporation, 2000. All rights reserved.
Defining Function and Process Activities
Chapter 8 - Page 26
Error Handling (Continued)
Copyright Oracle Corporation, 2000. All rights reserved.
Objectives
Objectives
After this lesson you should be able to:
Diagram a workflow process
Incorporate standard activities in a process
Review the process definition for the item type
After this lesson you should be able to:
Diagram a workflow process
Incorporate standard activities in a process
Review the process definition for the item type
Copyright Oracle Corporation, 2000. All rights reserved.
Diagramming a Workflow Process
Chapter 9 - Page 4
Create a New Workflow Process Definition
Copyright Oracle Corporation, 2000. All rights reserved.
Loading Roles
Loading Roles
Loading Roles
If you wish to set the recipient of a notification to a constant value, you must
first load the roles stored in your Oracle Workflow directory service into Oracle
Workflow Builder. To load roles, use the following procedure:
1. Choose File>Open to connect to your database and open the item type
for which you are creating a process diagram.
2. Choose File>Load Roles from Database.
3. Specify search criteria in the Find Roles field of the Role selection
window and then choose Find.
4. Select the roles you want to load in the Query Results list, then choose
Add to add them to the Loaded Roles list.
5. Choose OK to load the roles and make them available to the objects in
your open item type.
Directory Service Display
Use the Directory Service branch in the navigator tree to see information about
the roles you load from the database.
List-of-Values for Role Attributes
You can select roles from the list of values which the directory service
populates. List-of-values is available wherever large lists are used.
Copyright Oracle Corporation, 2000. All rights reserved.
Diagramming a Workflow Process
Chapter 9 - Page 6
Diagramming a Process
Copyright Oracle Corporation, 2000. All rights reserved.
Diagramming a Process
Diagramming a Process
1. To begin drawing a process diagram, you must
display the process window. This can be done in
several ways:
a. Double-click on the process activity on the
navigator tree.
b. Select the process activity and press Ctrl + E.
c. Select the process activity and choose Process
Details from the Edit menu.
d. Use the Quick Start Wizard to create a process
activity and initial diagram with Start and End
nodes.
1. To begin drawing a process diagram, you must
display the process window. This can be done in
several ways:
a. Double-click on the process activity on the
navigator tree.
b. Select the process activity and press Ctrl + E.
c. Select the process activity and choose Process
Details from the Edit menu.
d. Use the Quick Start Wizard to create a process
activity and initial diagram with Start and End
nodes.
Each process diagram must have one or more Start
activities and one or more End activities.
Copyright Oracle Corporation, 2000. All rights reserved.
Diagramming a Workflow Process
Chapter 9 - Page 7
Quick Start Wizard
Copyright Oracle Corporation, 2000. All rights reserved.
Display Modes
Display Modes
Object Internal names
Standard icons
used for display
Display Modes
You can toggle between the following two display modes of the workflow
builder:
Presentation mode
Developer mode
In presentation mode, workflow builder shows the names for the activity
icons that you specify in their property page.
The developer mode assists you in developing large complex processes as
follows:
Providing visual distinctions between top-level processes and
subprocesses in the navigator tree
Setting the icons for each activity and object to the default icon of
its object type or subtype in both the navigator tree and the process
diagram window
Identifying each object in the navigator tree by its internal, or
developer, name
Identifying each activity in the process diagram window by its
activity label
Copyright Oracle Corporation, 2000. All rights reserved.
Diagramming a Workflow Process
Chapter 9 - Page 11
Diagramming a Process (continued)
Copyright Oracle Corporation, 2000. All rights reserved.
Self-Looping Transitions
Self-Looping Transitions
Activity loops
back to itself
on Timeout
Self-Looping Transitions
How to draw a self-loop transition
1. Select the activity node.
2. Hold down the right mouse button.
3. Drag the cursor away and back to the same activity node.
4. Release the right mouse button and select the transition label from the list
of results.
Note: The node Timeout property must be set to enable the <Timeout> option
in the transition list of results.
Copyright Oracle Corporation, 2000. All rights reserved.
Diagramming a Workflow Process
Chapter 9 - Page 14
<Any> Transitions
Copyright Oracle Corporation, 2000. All rights reserved.
<Any> Transitions
<Any> Transitions
No
Ye s
Approve
Reje ct
<Any>
Document
Approve d
Document
Re jecte d
End (Re ject)
End (Approve)
Review
Document
Start
Log Re view
Automatic parallel branching
with the
<Any> transition
<Any> Transition
The Workflow Engine follows an <Any> transition regardless of what
completion result the activity returns. This allows you to include a generic
activity in the process that the Workflow Engine executes in parallel with
the result-specific activity.
Copyright Oracle Corporation, 2000. All rights reserved.
Diagramming a Workflow Process
Chapter 9 - Page 15
Top Down Design
Copyright Oracle Corporation, 2000. All rights reserved.
Editing a Transition
Editing a Transition
1. Select the transition you want to edit.
2. Click on the right mouse button to edit the
transition
Delete transition: deletes the selected
transition
Locked: toggles between locking and
unlocking the transition from further edits
Hidden label: toggles between displaying and
hiding the transition label
Straighten: straightens the transition by
removing extra vertex points causing the bend
Results: allows changing of result label
already assigned
1. Select the transition you want to edit.
2. Click on the right mouse button to edit the
transition
Delete transition: deletes the selected
transition
Locked: toggles between locking and
unlocking the transition from further edits
Hidden label: toggles between displaying and
hiding the transition label
Straighten: straightens the transition by
removing extra vertex points causing the bend
Results: allows changing of result label
already assigned
Copyright Oracle Corporation, 2000. All rights reserved.
Diagramming a Workflow Process
Chapter 9 - Page 20
Editing a Transition (continued)
Copyright Oracle Corporation, 2000. All rights reserved.
Standard Activities
Standard Activities
Standard Activities
The standard item type includes function and notification activities that
can be included in process diagrams associated with the other item types.
For a full explanation of the above standard activities please see the
Oracle Workflow Guide (Release 2.5), chapter 6, Predefined Workflow
Activities.
Copyright Oracle Corporation, 2000. All rights reserved.
Diagramming a Workflow Process
Chapter 9 - Page 25
Saving the Process Definition
Copyright Oracle Corporation, 2000. All rights reserved.
Version Compatibility
Version Compatibility
All Oracle Workflow client modules automatically
verify that the module is compatible with the
version of the Oracle Workflow server that it is
operating against.
To determine which version of the Oracle
Workflow server is running, connect to the
Workflow server account using SQL/PLUS and
execute the script wfver.sql
All Oracle Workflow client modules automatically
verify that the module is compatible with the
version of the Oracle Workflow server that it is
operating against.
To determine which version of the Oracle
Workflow server is running, connect to the
Workflow server account using SQL/PLUS and
execute the script wfver.sql
Version Compatibility Check
You can check that the workflow builder is compatible with the version of
the workflow server against which it is operating.
Copyright Oracle Corporation, 2000. All rights reserved.
Diagramming a Workflow Process
Chapter 9 - Page 28
Display Name Conflicts
Copyright Oracle Corporation, 2000. All rights reserved.
Objectives
Objectives
After this lesson, you should be able to:
Give a general description of how the Workflow
Engine manages a process
Apply the Workflow Engine APIs to your function
activities
After this lesson, you should be able to:
Give a general description of how the Workflow
Engine manages a process
Apply the Workflow Engine APIs to your function
activities
Copyright Oracle Corporation, 2000. All rights reserved.
Overview of the Workflow Engine
Chapter 10 - Page 4
Overview of the Workflow Engine
Copyright Oracle Corporation, 2000. All rights reserved.
Activity Statuses
Activity Statuses
Once the Workflow Engine executes an activity, it
updates the state of the activity to one of the
following statuses:
Active
Complete
Waiting
Notified
Deferred
Error
Suspend
Once the Workflow Engine executes an activity, it
updates the state of the activity to one of the
following statuses:
Active
Complete
Waiting
Notified
Deferred
Error
Suspend
Activity Status Definitions
Active: Activity is currently being executed.
Complete: Activity executed successfully.
Waiting: Activity is waiting for dependencies to complete. An
example is the AND activity, where one of its incoming activity
transitions is complete but is still waiting for another required
incoming activity transition to complete before it can be marked as
complete.
Notified: Activity is waiting for a response from a notification or
for an external program to complete and call the Workflow Engine.
Deferred: Activity is deferred to a background engine for
execution.
Error: Activity has encountered an error during execution.
Suspend: Activity is suspended from further execution.
Copyright Oracle Corporation, 2000. All rights reserved.
Overview of the Workflow Engine
Chapter 10 - Page 10
Calling the Workflow Engine
Copyright Oracle Corporation, 2000. All rights reserved.
Background Engine
Background Engine
The Background Engine is a PL/SQL procedure.
The Background Engine checks for and executes
any deferred or timed out activities that satisfy the
arguments of the procedure at the time the
procedure is invoked.
The procedure ends once all matching activities
are executed.
If new activities are deferred or timed out after the
initiation of the current Background Engine
procedure, they will be processed when the next
Background Engine procedure is initiated.
The Background Engine is a PL/SQL procedure.
The Background Engine checks for and executes
any deferred or timed out activities that satisfy the
arguments of the procedure at the time the
procedure is invoked.
The procedure ends once all matching activities
are executed.
If new activities are deferred or timed out after the
initiation of the current Background Engine
procedure, they will be processed when the next
Background Engine procedure is initiated.
Resubmitting the Background Engine
For Oracle Workflow standalone, use one of the sample scripts
provided or create your own custom script to make the background
engine procedure loop indefinitely:
wfbkg.sql: Located in the Oracle Workflow admin/sql
subdirectory
wfbkgchk.sql: Located in the Oracle Workflow admin/sql
subdirectory
For Oracle Workflow embedded in Oracle Applications, use the
Workflow Background Process concurrent program to schedule the
background engine procedure to run repeatedly.
Copyright Oracle Corporation, 2000. All rights reserved.
Overview of the Workflow Engine
Chapter 10 - Page 19
Background Engine
Copyright Oracle Corporation, 2000. All rights reserved.
Background Engine
Background Engine
Background Engine API Background Engine API
WF_ENGINE.BACKGROUND(
itemtype in varchar2,
minthresholdin number default null,
maxthresholdin number default null,
process_deferred in boolean default TRUE,
process_timeout in boolean default TRUE);
Background Engine Parameters
You can set up as many background engines as needed, but if you set up
only one, then that background engine must handle both deferred and timed out
activities. That is, process_deferred and process_timeout must both
be TRUE.
Background Engine Definitions
itemtype: Optional item type to restrict this engine to activities associated
with that item type.
minthreshold: Optional minimum cost that an activity must have for this
background engine to execute it, in hundredths of a second.
maxthreshold: Optional maximum cost an activity can have for this
background engine to execute it, in hundredths of a second.
process_deferred: Set to TRUE to allow the engine to check for deferred
activities. Setting this parameter to FALSE restricts the engine to handling
only activities that have timed out.
process_timeout: Set this parameter to TRUE to allow the engine to check for
timed out activities. Setting the value to FALSE restricts the engine to
handling only deferred activities.
Copyright Oracle Corporation, 2000. All rights reserved.
Overview of the Workflow Engine
Chapter 10 - Page 20
Deferred Processing
Copyright Oracle Corporation, 2000. All rights reserved.
Deferred Processing
Deferred Processing
Set the Workflow Engine threshold cost to control
which activities get deferred.
The default threshold cost of the Workflow Engine
is set to 50.
The Workflow Engine threshold is an externalized
constant.
Add this command to a PL/SQL stored procedure
or execute this command in SQL*PLUS to change
the threshold: WF_ENGINE.THRESHOLD := n;
Set the Workflow Engine threshold cost to control
which activities get deferred.
The default threshold cost of the Workflow Engine
is set to 50.
The Workflow Engine threshold is an externalized
constant.
Add this command to a PL/SQL stored procedure
or execute this command in SQL*PLUS to change
the threshold: WF_ENGINE.THRESHOLD := n;
Note: A function activity is deferred to a background engine for
processing if its cost exceeds the threshold cost of the Workflow Engine.
Copyright Oracle Corporation, 2000. All rights reserved.
Overview of the Workflow Engine
Chapter 10 - Page 21
Timed Out Notification Activities
Copyright Oracle Corporation, 2000. All rights reserved.
Error Processing
Error Processing
If an activity error occurs the Workflow Engine:
Rolls back to the pre-activity savepoint.
Sets the activity to the ERROR status.
Attempts to run an Error Process.
If an activity error occurs the Workflow Engine:
Rolls back to the pre-activity savepoint.
Sets the activity to the ERROR status.
Attempts to run an Error Process.
Note: Workflow Engine attempts to locate an error process to run by
starting with the activity which caused the error, and then checking each
parent process activity until an associated error process is located.
Copyright Oracle Corporation, 2000. All rights reserved.
Completing Workflow Notification Activities
Chapter 11 - Page 1
Completing Workflow
Notification Activities
Chapter 11
Copyright Oracle Corporation, 2000. All rights reserved.
Completing Workflow Notification Activities
Chapter 11 - Page 2
Completing Workflow Notification Activities
Copyright Oracle Corporation, 2000. All rights reserved.
Objectives
Objectives
After this lesson, you should be able to:
Respond to notifications from the Notification Web
page
Respond to notifications using email
Access the Oracle Workflow home page
Define notification routing rules
After this lesson, you should be able to:
Respond to notifications from the Notification Web
page
Respond to notifications using email
Access the Oracle Workflow home page
Define notification routing rules
Copyright Oracle Corporation, 2000. All rights reserved.
Completing Workflow Notification Activities
Chapter 11 - Page 4
Oracle Workflow Home Page
Copyright Oracle Corporation, 2000. All rights reserved.
Notifications Worklist
Notifications Worklist
Viewing Notifications from a Web Page
Access the Notifications Worklist using one of the following
methods:
From the Oracle Workflow home page, whose URL is
<webagent>/ wfa_html.home choose the Worklist or Find
Notifications links
Using the URL <webagent>/wfa_html.worklist
From the Oracle Self-Service Web Applications home page
Present a summary of notifications:
Notifications Worklist either displays the notifications that
match your search criteria if you navigated from the Find
Notifications page, or lists all your open notifications if you
navigated directly to this page.
Sort the summary by priority, type, subject, sent date, due
date, or status.
Choose a notification from the list to display the details of the
notification on another page.
You can respond to or reassign a notification. Once you respond to
or reassign a notification, it no longer appears in your Worklist on
return to the Worklist page. If a notification does not require a
response, choose Close to remove it from your Worklist.
Copyright Oracle Corporation, 2000. All rights reserved.
Completing Workflow Notification Activities
Chapter 11 - Page 7
Use the Select checkbox to simultaneously close multiple
notifications that dont require a response or use the Select
checkbox to collectively reassign a group of notifications.
Copyright Oracle Corporation, 2000. All rights reserved.
Completing Workflow Notification Activities
Chapter 11 - Page 8
Notification Details
Copyright Oracle Corporation, 2000. All rights reserved.
Notification Details
Notification Details
Copyright Oracle Corporation, 2000. All rights reserved.
Completing Workflow Notification Activities
Chapter 11 - Page 9
Reassigning Notifications
Copyright Oracle Corporation, 2000. All rights reserved.
User
List-of-values
Delegate or
Transfer
reassign options
Reassigning Notifications
Reassigning Notifications
Multiple Reassign Modes
Use the following options to reassign notifications:
Delegate: Grant permission to someone else to act on a notification
on your behalf while you remain as the owner and performer of the
activity. This performs the same as the former Reassign command.
Transfer: Transfer responsibility to act on a notification to
someone else and transfer the ownership and performance of the
activity to them.
The following Oracle Workflow areas use these notification reassign values:
The Monitor Diagram web page
The Notifications web page
If you view your notifications in e-mail, you can use only the Forward function
which performs similar to the Delegate option.
The delegate function is WF_NOTIFICATION.Forward and the transfer
function is WF_NOTIFICATION.Transfer.
You can associate a post-notification function with a notification activity. The
Workflow Engine executes the post-notification function in response to an update
of the notification's state after the notification is delivered.
When you specify a post-notification function, the Workflow engine first sets the
context information to be used with the function using the following two global
engine variables:
Copyright Oracle Corporation, 2000. All rights reserved.
Completing Workflow Notification Activities
Chapter 11 - Page 10
WF_ENGINE.context_nid=notification_NID
WF_ENGINE.context_text=new recipient role, if the post-
notification function gets called in FORWARD or TRANSFER
mode. This variable is the new role to which the notification gets
forwarded/transferred.
Note:
WF_ENGINE.context_text=responder, if the post-notification function gets called
in RESPOND mode. The value of responder varies depending on the notification
interface the recipient uses to respond. If the recipient responds using the
Notification web page, responder is set to the role name of the responder. If the
recipient responds using E-mail, responder is set to email:responder email
address.
You may reference these global engine variables in your PL/SQL function.
Copyright Oracle Corporation, 2000. All rights reserved.
Completing Workflow Notification Activities
Chapter 11 - Page 11
Launching Oracle Application Forms
Copyright Oracle Corporation, 2000. All rights reserved.
E-Mail Notification
E-Mail Notification
<Place screenshot here>
<Place screenshot here> <Place screenshot here>
Automatic
generation
of
response
template
Viewing E-Mail Notifications
You can receive e-mail notifications if your notification preference
is set to Plan text mail, HTML mail, or Plain text mail with
attachments in the User Preferences web page and your workflow
administrator sets up the Notification Mailer to run.
E-Mail notification contains all the details of the notification,
including instructions on how to respond to the notification.
Include the original note with your response to ensure that
the notification identification and notification access key is
within your reply.
Plain text Template Response: use the template of
response prompts provided in the notification and enter
your response values between the double quotes following
each prompt.
Plain text Direct Response: the first lines of your reply are
interpreted as your notification response, where each line
represents a separate response value listed in the same
order as its corresponding response prompt. If a response
value requires more than one line, enclose the entire
response value in double quotes. If a response prompt
provides a default value, then a matching blank line for a
response accepts the default value.
Copyright Oracle Corporation, 2000. All rights reserved.
Completing Workflow Notification Activities
Chapter 11 - Page 13
Response values are interpreted literally, where upper case
values are distinct from lower case values.
Turn off automatic e-mail signatures when replying to
notifications.
If your mail applications support HTML attachments you
may respond to a notification using the attached HTML
Notification page.
Copyright Oracle Corporation, 2000. All rights reserved.
Completing Workflow Notification Activities
Chapter 11 - Page 14
E-Mail Notification (continued)
Copyright Oracle Corporation, 2000. All rights reserved.
Objectives
Objectives
After this lesson, you should be able to:
Check the progress of a workflow using the Java-
based Workflow Monitor
After this lesson, you should be able to:
Check the progress of a workflow using the Java-
based Workflow Monitor
Copyright Oracle Corporation, 2000. All rights reserved.
Monitoring Workflow Processes
Chapter 12 - Page 4
Workflow Monitor
Copyright Oracle Corporation, 2000. All rights reserved.
Workflow Monitor
Workflow Monitor
Workflow Monitor Features
The Workflow Monitor is a Java-based tool that lets you view and
administer the progress of a workflow process instance. The workflow
monitor features include:
A point-and-click interface.
A display for detailed status information for individual activities as
well as for the whole process.
An ability to run in USER mode or ADMIN mode, which provides
additional details and functionality pertinent only to a workflow
administrator.
User Interface Components
User Interface components include:
Process title
Process diagram window
Detail tab window
Administration buttons
Copyright Oracle Corporation, 2000. All rights reserved.
Monitoring Workflow Processes
Chapter 12 - Page 5
Process Title
Copyright Oracle Corporation, 2000. All rights reserved.
Process Title
Process Title
Process Title Features
The process title displays the process name, followed by the item type and
user key (or item key) that uniquely identifies the process instance. If you
drill down to a subprocess in the process diagram window, the process
title shows the name of the subprocess.
Copyright Oracle Corporation, 2000. All rights reserved.
Monitoring Workflow Processes
Chapter 12 - Page 6
Process Diagram Window
Copyright Oracle Corporation, 2000. All rights reserved.
Administration Buttons
Administration Buttons
Features of the Administration Buttons
The administration buttons appear only when you run the Workflow
Monitor in ADMIN mode. The buttons and their behavior are as follows:
Abort Process: Calls WF_ENGINE.AbortProcess to abort the
selected process and cancel any outstanding notifications. Prompts
for a result to assign to the aborted process.
Suspend Process: Calls WF_ENGINE.SuspendProcess to suspend
the selected process.
Resume Process: Calls WF_ENGINE.ResumeProcess to resume
the selected suspended process to normal execution status.
Reassign: Calls WF_ENGINE.AssignActivity to reassign the
selected notification activity to a different performer. Prompts for a
role name.
Expedite: Calls WF_ENGINE.HandleError to alter the state of an
errored activity, or to undo the selected activity and all other
activities following it to rollback part of the process. Prompts you
to select one of two values:
Skip, to skip the activity and assign it a specified result.
Retry, to reexecute the activity.
Attribute: Lets you change the value of an item attribute.
Copyright Oracle Corporation, 2000. All rights reserved.
Monitoring Workflow Processes
Chapter 12 - Page 9
Application-Controlled Access to the Workflow Monitor
Copyright Oracle Corporation, 2000. All rights reserved.
Child/Parent Instances
Child/Parent Instances
Link to Parent/Child Instances
If the selected process is a member of a parent/child process, a
parent/child hierarchy list appears on the left-hand side. The hierarchy list
shows links to corresponding parent and child instances of the current
process. The links invoke the Notifications List on the selected parent or
child instance.
Copyright Oracle Corporation, 2000. All rights reserved.
Monitoring Workflow Processes
Chapter 12 - Page 19
Practice Les 12-1 Overview
Copyright Oracle Corporation, 2000. All rights reserved.
PL/SQL Documents
PL/SQL Documents
Copyright Oracle Corporation, 2000. All rights reserved.
PL/SQL Documents
Chapter 13 - Page 3
Objectives
Copyright Oracle Corporation, 2000. All rights reserved.
Objectives
Objectives
After this lesson, you should be able to:
Integrate PL/SQL documents into a Workflow
process
Define a procedure to generate a PL/SQL
document
Attach PL/SQL documents
After this lesson, you should be able to:
Integrate PL/SQL documents into a Workflow
process
Define a procedure to generate a PL/SQL
document
Attach PL/SQL documents
Copyright Oracle Corporation, 2000. All rights reserved.
PL/SQL Documents
Chapter 13 - Page 4
Integrating PL/SQL Documents in Workflow Processes
Copyright Oracle Corporation, 2000. All rights reserved.
Selector Functions
Selector Functions
Copyright Oracle Corporation, 2000. All rights reserved.
Selector Functions
Chapter 14 - Page 3
Objectives
Copyright Oracle Corporation, 2000. All rights reserved.
Objectives
Objectives
After this lesson you should be able to:
Create a standard API for a selector/callback
function
Define a selector/callback function
Call a selector/callback function
After this lesson you should be able to:
Create a standard API for a selector/callback
function
Define a selector/callback function
Call a selector/callback function
Copyright Oracle Corporation, 2000. All rights reserved.
Selector Functions
Chapter 14 - Page 4
Item Type Selector Function
Copyright Oracle Corporation, 2000. All rights reserved.
Objectives
Objectives
After this lesson you should be able to:
Understand the options to incorporate external
system processing in a workflow process.
Describe the concept of Advanced Queues.
Describe how to pause and resume a workflow
process.
After this lesson you should be able to:
Understand the options to incorporate external
system processing in a workflow process.
Describe the concept of Advanced Queues.
Describe how to pause and resume a workflow
process.
Copyright Oracle Corporation, 2000. All rights reserved.
External System Integration
Chapter 15 - Page 4
Oracle Workflow Terms
Copyright Oracle Corporation, 2000. All rights reserved.
Function Function
Activity Activity
External Execution
Agent
Java
CORBA
OS command
Oracle8 Oracle8
Advanced Advanced
Queues Queues
External Function Activity Support
External Function Activity Support
External Function Activity Support
Oracle Workflow supports function activities that are external to the database,
facilitating integration with external products and legacy systems.
The workflow engine:
Leverages Oracle8 advanced queues to support the execution of external
function activities
Inserts messages into the outbound queue that external execution agents
can consume; the external execution agents must support Java, CORBA,
or OS command activities
Expects the external function to return information to the inbound queue
Advanced Queues is also being used to improve the throughput of the background
engine.
Copyright Oracle Corporation, 2000. All rights reserved.
External System Integration
Chapter 15 - Page 6
Advanced Queues Processing
Copyright Oracle Corporation, 2000. All rights reserved.
Block Activity
Block Activity
is a standard function activity alternative to
incorporating external system processing.
lets you pause a process until an external program
or manual step completes.
delays a process until a particular condition is met.
requires a program to issue a call to
WF_ENGINE.CompleteActivity to resume the
process at the Block activity.
is a standard function activity alternative to
incorporating external system processing.
lets you pause a process until an external program
or manual step completes.
delays a process until a particular condition is met.
requires a program to issue a call to
WF_ENGINE.CompleteActivity to resume the
process at the Block activity.
Copyright Oracle Corporation, 2000. All rights reserved.
External System Integration
Chapter 15 - Page 15
CompleteActivity
Copyright Oracle Corporation, 2000. All rights reserved.
CompleteActivity
CompleteActivity
Notifies the Workflow Engine that the specified
activity for an item has been completed.
Notifies the Workflow Engine that the specified
activity for an item has been completed.
procedure CompleteActivity
(itemtype in varchar2,
itemkey in varchar2,
activity in varchar2,
result_code in varchar2);
procedure CompleteActivity
(itemtype in varchar2,
itemkey in varchar2,
activity in varchar2,
result_code in varchar2);
WF_ENGINE.CompleteActivity API
Call WF_ENGINE.CompleteActivity to indicate an activity is completed. This
procedure requires that the activity currently has a status of 'Notified'. An optional
activity completion result can also be passed. (Result is not applicable for the
standard Block activity.) The result can determine which transition the process
takes next.
Provide the activity node's label name. If the activity node label name does not
uniquely identify the subprocess you can precede the label name with the internal
name of its parent process. For example,
<parent_process_internal_name>:<label_name>.
Copyright Oracle Corporation, 2000. All rights reserved.
External System Integration
Chapter 15 - Page 16
Copyright Oracle Corporation, 2000. All rights reserved.
Forced Synchronous Processing
Chapter 16 - Page 1
Forced Synchronous
Processing
Chapter 16
Copyright Oracle Corporation, 2000. All rights reserved.
Forced Synchronous Processing
Chapter 16 - Page 2
Forced Synchronous Processing
Copyright Oracle Corporation, 2000. All rights reserved.
Objectives
Objectives
After this lesson, you should be able to:
Describe forced synchronous processing.
Describe process definition restrictions.
After this lesson, you should be able to:
Describe forced synchronous processing.
Describe process definition restrictions.
Copyright Oracle Corporation, 2000. All rights reserved.
Forced Synchronous Processing
Chapter 16 - Page 4
Forced Synchronous Processes
Copyright Oracle Corporation, 2000. All rights reserved.
Purge
Purge
Copyright Oracle Corporation, 2000. All rights reserved.
Purge
Chapter 17 - Page 3
Objectives
Copyright Oracle Corporation, 2000. All rights reserved.
Objectives
Objectives
After this lesson you should be able to:
Purge obsolete Workflow runtime data
After this lesson you should be able to:
Purge obsolete Workflow runtime data
Object Purging
The persistence type of an item type controls when Oracle Workflow purges runtime
status information for instances of a workflow; the persistence values are:
Temporary: Item will be deleted in n days
Permanent: Item will be deleted only when forced
Copyright Oracle Corporation, 2000. All rights reserved.
Purge
Chapter 17 - Page 4
Purging Obsolete Workflow Data
Copyright Oracle Corporation, 2000. All rights reserved.
Demonstration
Demonstration
Run the WF_PURGE.Total API
Show the effects of purge
Run the WF_PURGE.Total API
Show the effects of purge
In Oracle Workflow we will demonstrate how to: In Oracle Workflow we will demonstrate how to:
Copyright Oracle Corporation, 2000. All rights reserved.
Purge
Chapter 17 - Page 8
Copyright Oracle Corporation, 2000. All rights reserved.
Document Management Integration
Chapter 18 - Page 1
Document Management
Integration
Chapter 18
Copyright Oracle Corporation, 2000. All rights reserved.
Document Management Integration
Chapter 18 - Page 2
Document Management Integration
Copyright Oracle Corporation, 2000. All rights reserved.
Objectives
Objectives
After this lesson you should be able to:
Describe how DM systems integrate with Oracle
Workflow.
After this lesson you should be able to:
Describe how DM systems integrate with Oracle
Workflow.
Copyright Oracle Corporation, 2000. All rights reserved.
Document Management Integration
Chapter 18 - Page 4
Document Management Integration
Copyright Oracle Corporation, 2000. All rights reserved.
Document Management
Document Management
Attached Document
Document can be
viewed online
Document Management Integration
The Notification Details web page displays document references as
defined by document-type attributes. This provides you direct access to a
specified document through the document management interface layer
using a browser session. This interface layer allows you to attach
documents to notification responses.
For users viewing e-mail notifications, the notification mailer fetches the
document contents and attaches them to the e-mail notification.
The following WF_ENGINE package APIs support document
management integration:
SetItemAttrDocument()
ItemStatus()
GetItemAttrDocument()
Before you can use document management integration, you need to define
a node for the document management system in the Document Nodes
page.
Copyright Oracle Corporation, 2000. All rights reserved.
Document Management Integration
Chapter 18 - Page 6
Defining Document Management Repositories
Copyright Oracle Corporation, 2000. All rights reserved.
Objectives
Objectives
After this lesson you should be able to:
Define the required setup steps of Oracle
Workflow.
Define the optional setup steps of Oracle
Workflow.
Understand the access protection feature of
Oracle Workflow.
Transfer workflow definitions between a database
and flat file.
After this lesson you should be able to:
Define the required setup steps of Oracle
Workflow.
Define the optional setup steps of Oracle
Workflow.
Understand the access protection feature of
Oracle Workflow.
Transfer workflow definitions between a database
and flat file.
Copyright Oracle Corporation, 2000. All rights reserved.
Setting Up Oracle Workflow
Chapter 19 - Page 4
Required Set Up Steps
Copyright Oracle Corporation, 2000. All rights reserved.
Step 1
Setting Global User Preferences
Step 1
Setting Global User Preferences
Use the Global Preferences web page to:
define the Workflow administrator role and
Workflow web agent.
set default user preference values for the
entire enterprise.
Entries in User Preferences web page override
those defaults set in the Global Preferences web
page.
Both web pages are accessible from the Oracle
Workflow Home page.
Global Preferences web page only available to the
Workflow administrator role.
Use the Global Preferences web page to:
define the Workflow administrator role and
Workflow web agent.
set default user preference values for the
entire enterprise.
Entries in User Preferences web page override
those defaults set in the Global Preferences web
page.
Both web pages are accessible from the Oracle
Workflow Home page.
Global Preferences web page only available to the
Workflow administrator role.
Note:
The Language, Territory, and Notification preference settings in the Global
Preferences and User Preferences web pages are valid only if your directory
service views map the Language, Territory, and Notification_Preference columns
to the Oracle Workflow preferences table.
Copyright Oracle Corporation, 2000. All rights reserved.
Setting Up Oracle Workflow
Chapter 19 - Page 6
Step 2 Setting Up an Oracle Workflow Directory Service
Copyright Oracle Corporation, 2000. All rights reserved.
Step 2
Setting Up an Oracle Workflow Directory
Service
Step 2
Setting Up an Oracle Workflow Directory
Service
offers flexibility in defining who the workflow
users and roles are.
references any directory repository for users and
roles information by creating views based on the
database tables making up that repository.
provides local tables that contain columns similar
to those defined in the views. These tables are
used to store users and roles not included in the
existing directory repository.
provides predefined Directory Service view
definition and verification scripts
offers flexibility in defining who the workflow
users and roles are.
references any directory repository for users and
roles information by creating views based on the
database tables making up that repository.
provides local tables that contain columns similar
to those defined in the views. These tables are
used to store users and roles not included in the
existing directory repository.
provides predefined Directory Service view
definition and verification scripts
Oracle Workflow :
Oracle Workflow Directory Service Views
WF_USERS
WF_ROLES
WF_USER_ROLES
Oracle Workflow Directory Service Local Tables
WF_LOCAL_USERS
WF_LOCAL_ROLES
WF_LOCAL_USER_ROLES
Oracle Workflow Directory Service Scripts
wfdirhrv.sql: maps users and roles over a unified Oracle Applications environment
wfdirouv.sql: maps users and roles onto the native users and roles defined in Oracle 8i
wfdircsv.sql: maps users and roles to the Oracle Workflow Local tables.
If you create your own or modify any of the predefined directory service view
definitions, run the script wfdirchk.sql to verify your directory service model.
Copyright Oracle Corporation, 2000. All rights reserved.
Setting Up Oracle Workflow
Chapter 19 - Page 7
Step 3 Verifying the WF_LANGUAGES View
Copyright Oracle Corporation, 2000. All rights reserved.
Step 3
Verifying the WF_LANGUAGES View
Step 3
Verifying the WF_LANGUAGES View
WF_LANGUAGES view is predefined in Oracle
Workflow Directory Services scripts.
Verify that the view definition identifies the
languages defined in your Oracle installation.
Customize the view definition if necessary.
WF_LANGUAGES allows for translation of field
values in the property pages of Oracle Workflow
Builder and workflow notifications.
WF_LANGUAGES view is predefined in Oracle
Workflow Directory Services scripts.
Verify that the view definition identifies the
languages defined in your Oracle installation.
Customize the view definition if necessary.
WF_LANGUAGES allows for translation of field
values in the property pages of Oracle Workflow
Builder and workflow notifications.
Mandatory Columns of the WF_LANGUAGES View
Code - the language code.
Display_Name - the display name of the language.
NLS_Language - the value of the Oracle NLS_LANGUAGE initialization parameter that
specifies the default language-dependent behavior of a session.
NLS_Territory - the value of the Oracle NLS_TERRITORY initialization parameter that
specifies the default territory-dependent date and numeric formatting of a session.
NLS_Codeset - the character set for the language.
Installed_Flag - flag to indicate if the language is installed and available for use.
Note:
A sample WF_LANGUAGES view is included in the script of each of the predefined
directory services that Oracle Workflow provides.
Copyright Oracle Corporation, 2000. All rights reserved.
Setting Up Oracle Workflow
Chapter 19 - Page 8
Step 4 Setting the http_proxy Environment Variable
Copyright Oracle Corporation, 2000. All rights reserved.
Step 4
Setting the http_proxy Environment
Variable
Step 4
Setting the http_proxy Environment
Variable
If you are planning to use the Notification Mailer,
set up the http_proxy variable to point to your
proxy server before starting the Oracle Workflow
Database or the Notification Mailer. Only required
if you plan to attach URL content that exists
outside your organization firewall.
For example, in UNIX, use the following command
to set the http_proxy variable:
setenv http_proxy http://www-proxy.
yourcompany.com:80/
If you are planning to use the Notification Mailer,
set up the http_proxy variable to point to your
proxy server before starting the Oracle Workflow
Database or the Notification Mailer. Only required
if you plan to attach URL content that exists
outside your organization firewall.
For example, in UNIX, use the following command
to set the http_proxy variable:
setenv http_proxy http://www-proxy.
yourcompany.com:80/
http_proxy Variable Use
The Notification Mailer can fetch the URL content of a URL attribute, if the attribute has
Attach Content checked in its Attribute property page. If the referenced URL is outside
your organizations firewall, the Notification Mailer must go through your organizations
proxy server to fetch the URL content.
Copyright Oracle Corporation, 2000. All rights reserved.
Setting Up Oracle Workflow
Chapter 19 - Page 9
Step 5 Setting the WF_RESOURCES Environment
Variable
Copyright Oracle Corporation, 2000. All rights reserved.
Step 5
Setting the WF_RESOURCES
Environment Variable
Step 5
Setting the WF_RESOURCES
Environment Variable
If you are using the standalone version of Oracle
Workflow and the Workflow server is installed on a
UNIX platform, set the WF_RESOURCES
environment variable.
This environment variable points to the language-
dependent Oracle Workflow resource file
wf<language>.res.
The resource file is generally found in the res
subdirectory of the Oracle Workflow server
directory structure.
If you are using the standalone version of Oracle
Workflow and the Workflow server is installed on a
UNIX platform, set the WF_RESOURCES
environment variable.
This environment variable points to the language-
dependent Oracle Workflow resource file
wf<language>.res.
The resource file is generally found in the res
subdirectory of the Oracle Workflow server
directory structure.
Copyright Oracle Corporation, 2000. All rights reserved.
Setting Up Oracle Workflow
Chapter 19 - Page 10
Step 6 Setting Up Background Workflow Engines
Copyright Oracle Corporation, 2000. All rights reserved.
Step 6
Setting Up Background Workflow
Engines
Step 6
Setting Up Background Workflow
Engines
Background engines are set up to handle costly
deferred activities allowing the Workflow Engine
to continue to the next available activity.
Background engines are also set up to handle
timed out notifications.
You can define and start up as many background
engines as you like.
A background engine runs until it completes all
eligible activities.
You should set the background engine up to run
periodically.
Background engines are set up to handle costly
deferred activities allowing the Workflow Engine
to continue to the next available activity.
Background engines are also set up to handle
timed out notifications.
You can define and start up as many background
engines as you like.
A background engine runs until it completes all
eligible activities.
You should set the background engine up to run
periodically.
To Start a Background Engine
If you are using the standalone version of Oracle Workflow, then use the
WF_ENGINE.BACKGROUND( ) API to start up a background engine. Sample scripts
that repeatedly run the background engine are provided with the standalone version of
Oracle Workflow.
If you are using the version of Oracle Workflow embedded in Oracle Applications, start a
background engine by submitting the Background Process concurrent program using the
Submit Requests form.
Note:
Make sure you have a least one background engine that can check for timed out activities
and one that can process deferred activities. At a minimum, you need to set up one
background engine that can handle both timed out and deferred activities.
Copyright Oracle Corporation, 2000. All rights reserved.
Setting Up Oracle Workflow
Chapter 19 - Page 11
Optional Setup Steps
Copyright Oracle Corporation, 2000. All rights reserved.
Optional Step 1
Document Management Repositories
Optional Step 1
Document Management Repositories
Oracle Workflow communicates with specific DM
systems through a web server agent interface. The
syntax for identifying the DM systems web server
is <protocol>://<server:port>/.
If you plan to use DM system integration, you must
register the DM system with Oracle Workflow by
using the Document Nodes web page to identify
the DM system as a document node.
Oracle Workflow uses the document node as the
gateway to a specific DM system and uses the
information defined in the node to construct the
URLs that display the DM system documents.
Oracle Workflow communicates with specific DM
systems through a web server agent interface. The
syntax for identifying the DM systems web server
is <protocol>://<server:port>/.
If you plan to use DM system integration, you must
register the DM system with Oracle Workflow by
using the Document Nodes web page to identify
the DM system as a document node.
Oracle Workflow uses the document node as the
gateway to a specific DM system and uses the
information defined in the node to construct the
URLs that display the DM system documents.
Copyright Oracle Corporation, 2000. All rights reserved.
Setting Up Oracle Workflow
Chapter 19 - Page 13
Optional Step 2 Notification Mailer
Copyright Oracle Corporation, 2000. All rights reserved.
Optional Step 2
Notification Mailer
Optional Step 2
Notification Mailer
Implement the Notification Mailer if users are to
receive notifications by e-mail as well as from the
Notifications Worklist web page.
The Notification Mailer is a program that performs
email send and response processing for the
Oracle Workflow Notification System.
The Notification Mailer also processes responses
by interpreting the text of messages mailed to its
response account and calling the appropriate
Notification API to complete the notification.
Once set up, the Notification Mailer continually
polls for messages to send and checks for
responses to process.
Implement the Notification Mailer if users are to
receive notifications by e-mail as well as from the
Notifications Worklist web page.
The Notification Mailer is a program that performs
email send and response processing for the
Oracle Workflow Notification System.
The Notification Mailer also processes responses
by interpreting the text of messages mailed to its
response account and calling the appropriate
Notification API to complete the notification.
Once set up, the Notification Mailer continually
polls for messages to send and checks for
responses to process.
Full MIME Support
Oracle Workflow fully supports Multi-purpose Internet Mail Extensions (MIME)
encoded messages. This means that the Notification Mailer can exchange messages with
workflow users containing languages with different character sets and multimedia
encoded content.
Notification Preferences
Oracle Workflow allows you to determine how you view notifications by setting a
notification preference in the User Preferences web page.
There are five types of notification preferences:
MAILTEXTplain text mail: The notification message appears as plain text
with no attachments.
MAILHTMLHTML mail: The notification message appears as HTML-
formatted text with at least one other attachment that is a link to the notification
in the Notifications Web page.
MAILATTHplain text mail with HTML attachments: The notification message
appears as plain text with at least two other attachments. One being an HTML-
formatted version of the message, the other being the link to the notification in
the Notifications Web page.
SUMMARYplain text summary mail: The message is a plain text summary of
all open notifications.
QUERYdo not send me mail: The Notification Mailer does not send you email
notifications.
Copyright Oracle Corporation, 2000. All rights reserved.
Setting Up Oracle Workflow
Chapter 19 - Page 14
Optional Step 2 Notification Mailer Overview
Copyright Oracle Corporation, 2000. All rights reserved.
Optional Step 2
Notification Mailer Overview
Optional Step 2
Notification Mailer Overview
Notifications
Oracle server
Advanced Queues
Oracle
Internet
Messaging
SMTP
MAPI
Oracle Workflow
Notification Mailer
HTML
Plain text
Various
Mail
Applications
Netscape
Lotus Notes
MS Exchange
Unix Sendmail
Others
Notification Mailer Features
The Notification Mailer sends e-mail and processes responses for the Oracle Workflow
Notifications System. The Notification Mailer:
Polls the database for messages to send.
Resolves the e-mail address of the recipient role, which itself can be a mail distribution
list.
Switches its database session to be the preferred language of the role and territory
setting.
Selects information from the database as defined by the attributes of the message.
Generates the message using a message template.
Sends the message via UNIX Sendmail, Oracle Internet Messaging, or a MAPI-
compliant mail application.
Processes responses returned and calls the appropriate Notification API to complete the
notification activity.
Notification Mailer remains running unless a database failure occurs or the PL/SQL
package state changes for the session.
Note:
For the standalone version of Oracle Workflow, create and run a perpetual shell script
that restarts the Notification Mailer, should it shutdown. Example: UNIX shell script
wfmail.csh located in the Oracle Workflow server bin subdirectory.
Copyright Oracle Corporation, 2000. All rights reserved.
Setting Up Oracle Workflow
Chapter 19 - Page 15
Optional Step 2 continued Notification Mailer
Copyright Oracle Corporation, 2000. All rights reserved.
Optional Step 3
Message Templates
Optional Step 3
Message Templates
Messages sent by the Notification Mailer are
composed using one of six templates defined in the
System: Mailer item type. This item type is defined in
the wfmail.wft workflow definition file.
Copy wfmail.wft and store in your source
controlled file system.
Open your file copy of the System: Mailer item
type in your Workflow Builder.
Select one of the message templates.
Display the property sheet for the message.
Edit the Subject or Body of the message.
Messages sent by the Notification Mailer are
composed using one of six templates defined in the
System: Mailer item type. This item type is defined in
the wfmail.wft workflow definition file.
Copy wfmail.wft and store in your source
controlled file system.
Open your file copy of the System: Mailer item
type in your Workflow Builder.
Select one of the message templates.
Display the property sheet for the message.
Edit the Subject or Body of the message.
Mail Templates
Open Mail: For notifications that require a response.
Open FYI Mail: For notifications that do not require a response.
Canceled Mail: Informs recipient that a notification is cancelled.
Invalid Mail: Informs recipient that the response to the notification is invalid.
Closed Mail: Informs recipient that a previously sent notification is now closed.
Summary Mail: For notification summaries.
Warning Mail: Informs recipient of unsolicited mail that he/she sent
Copyright Oracle Corporation, 2000. All rights reserved.
Setting Up Oracle Workflow
Chapter 19 - Page 21
Optional Step 3 continued Message Templates
Copyright Oracle Corporation, 2000. All rights reserved.
Optional Step 4
Workflow Web Page Logo
Optional Step 4
Workflow Web Page Logo
Once the web server is installed and set up, you
can customize the company logo that appears on
Oracle Workflows web pages.
Create your company logo file in gif format and
save as filename WFLOGO.gif.
Move WFLOGO.gif to the physical directory
associated with your web servers /OA_MEDIA/
virtual directory.
Once the web server is installed and set up, you
can customize the company logo that appears on
Oracle Workflows web pages.
Create your company logo file in gif format and
save as filename WFLOGO.gif.
Move WFLOGO.gif to the physical directory
associated with your web servers /OA_MEDIA/
virtual directory.
Copyright Oracle Corporation, 2000. All rights reserved.
Setting Up Oracle Workflow
Chapter 19 - Page 23
Optional Step 5 Custom Icons
Copyright Oracle Corporation, 2000. All rights reserved.
Optional Step 5
Custom Icons
Optional Step 5
Custom Icons
Oracle Workflow provides a variety of icons that
you can use with your activities and processes.
You can add additional icon files as long as they
are of the appropriate format.
Create custom icon files and convert to gif files.
Oracle Workflow Builder looks for Windows icon
files (.ico) in the Icon subdirectory of the Oracle
Workflow area on your PC.
Oracle Workflow Monitor and web pages look for
gif files (.gif) in
/OA_MEDIA/oracle/apps/fnd/wf/icons
where /OA_MEDIA/ is a virtual directory mapping
defined in your web server.
Oracle Workflow provides a variety of icons that
you can use with your activities and processes.
You can add additional icon files as long as they
are of the appropriate format.
Create custom icon files and convert to gif files.
Oracle Workflow Builder looks for Windows icon
files (.ico) in the Icon subdirectory of the Oracle
Workflow area on your PC.
Oracle Workflow Monitor and web pages look for
gif files (.gif) in
/OA_MEDIA/oracle/apps/fnd/wf/icons
where /OA_MEDIA/ is a virtual directory mapping
defined in your web server.
Adding Custom Icons to Oracle Workflow
Convert the icon files (.ico) to gif format (.gif)
Copy the .gif files to a directory where Workflow Monitor can access them:
/OA_JAVA/oracle/apps/fnd/wf/icons
Note: /OA_JAVA/ is a virtual directory mapping defined in your Web server when
Oracle Workflow is installed.
Copyright Oracle Corporation, 2000. All rights reserved.
Setting Up Oracle Workflow
Chapter 19 - Page 24
Oracle Workflow Access Protection
Copyright Oracle Corporation, 2000. All rights reserved.
Access Levels
Access Levels
Each user of Oracle Workflow Builder operates the
system at a certain access level.
The access levels are defined as follows:
0-9reserved for Oracle Workflow
10-19reserved for Oracle Application Object
Library
20-99reserved for Oracle Applications
100-999reserved for customer organizations
1000Public
Each user of Oracle Workflow Builder operates the
system at a certain access level.
The access levels are defined as follows:
0-9reserved for Oracle Workflow
10-19reserved for Oracle Application Object
Library
20-99reserved for Oracle Applications
100-999reserved for customer organizations
1000Public
Protection Level
If you protect an object from customization, you effectively assign the object a protection
level equal to your current access level.
Objects protected against customizations are considered seed data.
Only users operating at an access level equal or lower than the protection level of
the object can modify the object.
Users operating at an access level greater than the protection level of the object
will see a small lock on the icon for the object in the navigator tree indicating that
the object is read-only.
Customization Level
If you set an object to be customizable, its protection level is set to 1000.
The customization level of an object is set to the access level of the initial user
who customizes the object.
A customized object is locked from further modification except from users with
access levels equal to the customization level of the object.
The customization level is relevant only with respect to unprotected workflow
objects.
If an object is protected at a certain level, it shouldnt be modified at all except
by an access level equal to or less than the protected level of the object.
Copyright Oracle Corporation, 2000. All rights reserved.
Setting Up Oracle Workflow
Chapter 19 - Page 26
Setting Access Level
Copyright Oracle Corporation, 2000. All rights reserved.
Objectives
Objectives
After this lesson you should be able to:
Describe the concept of Master/Detail coordination
activities.
After this lesson you should be able to:
Describe the concept of Master/Detail coordination
activities.
Copyright Oracle Corporation, 2000. All rights reserved.
Master/Detail Coordination Activities
Chapter 20 - Page 4
Master/Detail Coordination Activities
Copyright Oracle Corporation, 2000. All rights reserved.
Extra Practices
Extra Practices
Copyright Oracle Corporation, 2000. All rights reserved.
Extra Practices
Chapter 21 - Page 3
Extra Practice 1 Overview
Copyright Oracle Corporation, 2000. All rights reserved.