Oracle Apps - Workflow

1056
Oracle r Workflow Guide RELEASE 2.6.2 VOLUME 1 October 2001

Transcript of Oracle Apps - Workflow

Oracler Workflow GuideRELEASE 2.6.2 VOLUME 1

October 2001

Oracle Workflow Guide Volume 1, Release 2.6.2 The part number for this volume is A9527601 . To reorder this book, please use the set part number, A9526501 . Copyright E 1996, 2001, Oracle Corporation. All rights reserved.

Primary Authors: Siu Chang, Clara Jaeckel Major Contributors: George Buzsaki, John Cordes, Mark Craig, Kevin Hudson, George Kellner, David Lam, Jin Liu, Kenneth Ma, Steve Mayze, Tim Roveda, Robin Seiden, Sheryl Sheh, Susan StrattonThe Programs (which include both the software and documentation) contain proprietary information of Oracle Corporation; they are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright, patent and other intellectual and industrial property laws. Reverse engineering, disassembly or decompilation of the Programs, except to the extent required to obtain interoperability with other independently created software or as specified by law, is prohibited. The information contained in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. Oracle Corporation does not warrant that this document is errorfree. Except as may be expressly permitted in your license agreement for these Programs, no part of these Programs may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Oracle Corporation. If the Programs are delivered to the US Government or anyone licensing or using the Programs on behalf of the US Government, the following notice is applicable: RESTRICTED RIGHTS NOTICE Programs delivered subject to the DOD FAR Supplement are commercial computer software and use, duplication and disclosure of the Programs including documentation, shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement. Otherwise, Programs delivered subject to the Federal Acquisition Regulations are restricted computer software and use, duplication and disclosure of the Programs shall be subject to the restrictions in FAR 52.22719, Commercial Computer Software Restricted Rights (June, 1987). Oracle Corporation, 500 Oracle Parkway, Redwood City, CA 94065. The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently dangerous applications. It shall be licensees responsibility to take all appropriate failsafe, back up, redundancy and other measures to ensure the safe use of such applications if the Programs are used for such purposes, and Oracle disclaims liability for any damages caused by such use of the Programs. Oracle is a registered trademark, and Oracle8, Oracle8i, Oracle9i, Oracle Financials, OracleMetaLink, PL/SQL, and SQL*Plus are trademarks or registered trademarks of Oracle Corporation. Other names may be trademarks of their respective owners.

Contents

VOLUME 1Volume 1 . . . . . . . . . . . . . . . . . . . . . . . . . .

i

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Audience for This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . How To Use This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Documentation Accessibility . . . . . . . . . . . . . . . . . . . . . . . . . . . Other Information Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Online Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Users Guides . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Guides Related to All Products . . . . . . . . . . . . . . . . . . . . . . . . . User Guides Related to This Product . . . . . . . . . . . . . . . . . . . . Installation and System Administration . . . . . . . . . . . . . . . . . Other Implementation Documentation . . . . . . . . . . . . . . . . . . Training and Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Do Not Use Database Tools to Modify Oracle Applications Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . About Oracle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Your Feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

xix xx xx xxi xxii xxii xxiii xxiii xxiv xxv xxvi xxviii xxix xxix xxx

Chapter 1

Overview of Oracle Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . Introduction to Oracle Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . Major Features and Definitions . . . . . . . . . . . . . . . . . . . . . . . . . Workflow Processes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

11 12 13 16

Contents

iii

Chapter 2

Setting Up Oracle Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Oracle Workflow Hardware and Software Requirements . . . . . . Overview of Setting Up . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Overview of Required Set Up Steps for the Standalone Version of Oracle Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . Overview of Required Set Up Steps for the Version of Oracle Workflow Embedded in Oracle Applications . . . . . . Optional Setup Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Other Workflow Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Identifying the Version of Your Oracle Workflow Server . . . Setup Flowchart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setup Checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setup Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Overview of Oracle Workflow Access Protection . . . . . . . . . . . . . Setting Up a Default Access Level . . . . . . . . . . . . . . . . . . . . . . Using the Workflow Definitions Loader . . . . . . . . . . . . . . . . . . . . . Using the Workflow XML Loader . . . . . . . . . . . . . . . . . . . . . . . . . .

21 22 25 25 26 26 27 28 29 2 10 2 11 2 94 2 98 2 100 2 105

Chapter 3

Defining a Workflow Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Overview of Oracle Workflow Builder . . . . . . . . . . . . . . . . . . . . . . The Navigator Tree Structure . . . . . . . . . . . . . . . . . . . . . . . . . . Viewing the Navigator Tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . Creating Process Definitions in Oracle Workflow Builder . . . . . . Opening and Saving Item Types . . . . . . . . . . . . . . . . . . . . . . . . Quick Start Wizard Overview . . . . . . . . . . . . . . . . . . . . . . . . . . Using Oracle Workflow Builder with Different Server Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Item Type Definition Web Page . . . . . . . . . . . . . . . . . . . . . . . . . . . .

31 32 33 34 37 3 12 3 18 3 21 3 24

Chapter 4

Defining Workflow Process Components . . . . . . . . . . . . . . . . . . Workflow Process Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . Item Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Allowing Access to an Object . . . . . . . . . . . . . . . . . . . . . . . . . . Lookup Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Voting Activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Deleting Objects in Oracle Workflow Builder . . . . . . . . . . . . . . . . Modifying Objects in Oracle Workflow Builder . . . . . . . . . . . . . . Workflow Objects That Support Versioning . . . . . . . . . . . . . .

41 42 42 4 17 4 19 4 23 4 42 4 60 4 67 4 68 4 69

iv Oracle Workflow Guide

Workflow Objects That Do Not Support Versioning . . . . . . . 4 70

Chapter 5

Defining a Workflow Process Diagram . . . . . . . . . . . . . . . . . . . . Process Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Modifying Fonts in Oracle Workflow Builder . . . . . . . . . . . . Creating a Shortcut Icon for a Workflow Process . . . . . . . . . . Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

51 52 5 21 5 22 5 24

Chapter 6

Predefined Workflow Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . Standard Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . And/Or Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Comparison Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Compare Execution Time Activity . . . . . . . . . . . . . . . . . . . . . . Wait Activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Block Activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Defer Thread Activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Launch Process Activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Noop Activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Loop Counter Activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Start Activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . End Activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Role Resolution Activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Notify Activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Vote Yes/No Activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Master/Detail Coordination Activities . . . . . . . . . . . . . . . . . . Wait for Flow Activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Continue Flow Activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Assign Activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Get Monitor URL Activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Get Event Property Activity . . . . . . . . . . . . . . . . . . . . . . . . . . . Set Event Property Activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . Compare Event Property Activity . . . . . . . . . . . . . . . . . . . . . . XML Get Tag Value Activity . . . . . . . . . . . . . . . . . . . . . . . . . . . XML Compare Tag Value Activities . . . . . . . . . . . . . . . . . . . . . XML Transform Activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Concurrent Manager Standard Activities . . . . . . . . . . . . . . . . . . . . Execute Concurrent Program Activity . . . . . . . . . . . . . . . . . . . Submit Concurrent Program Activity . . . . . . . . . . . . . . . . . . . Wait for Concurrent Program Activity . . . . . . . . . . . . . . . . . . . Default Error Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

61 62 62 63 63 64 65 66 66 67 67 68 68 69 69 6 10 6 11 6 12 6 12 6 14 6 14 6 15 6 15 6 16 6 18 6 19 6 20 6 22 6 22 6 23 6 24 6 26

Contents

v

System: Error Item Type and Item Attributes . . . . . . . . . . . . . Default Error Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Retryonly Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Default Event Error Process . . . . . . . . . . . . . . . . . . . . . . . . . . . .

6 27 6 28 6 32 6 34

Chapter 7

Defining Procedures and Functions for Oracle Workflow . . . . Defining Procedures and Functions for Oracle Workflow . . . . . . Standard API for PL/SQL Procedures Called by Function Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Standard API for Java Procedures Called by Function Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Standard API for an Item Type Selector or Callback Function . . Standard APIs for PL/SQL and PL/SQL CLOB Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PL/SQL Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PL/SQL CLOB Documents . . . . . . . . . . . . . . . . . . . . . . . . . . Standard API for an Event Data Generate Function . . . . . . . . . . . Standard APIs for a Queue Handler . . . . . . . . . . . . . . . . . . . . . . . . Enqueue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Dequeue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Standard API for an Event Subscription Rule Function . . . . . . . .

71 72 73 78 7 13 7 17 7 17 7 19 7 21 7 23 7 23 7 24 7 25

Chapter 8

Oracle Workflow APIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Oracle Workflow Procedures and Functions . . . . . . . . . . . . . . . . . Overview of the Workflow Engine . . . . . . . . . . . . . . . . . . . . . . . . . Oracle Workflow Java Interface . . . . . . . . . . . . . . . . . . . . . . . . Additional Workflow Engine Features . . . . . . . . . . . . . . . . . . Workflow Engine APIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CreateProcess . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SetItemUserKey . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GetItemUserKey . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GetActivityLabel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SetItemOwner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . StartProcess . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . LaunchProcess . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SuspendProcess . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ResumeProcess . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . AbortProcess . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CreateForkProcess . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . StartForkProcess . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

81 82 83 84 87 8 18 8 20 8 22 8 23 8 24 8 25 8 27 8 29 8 31 8 33 8 35 8 37 8 39

vi Oracle Workflow Guide

Background . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . AddItemAttribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . AddItemAttributeArray . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SetItemAttribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SetItemAttrDocument . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SetItemAttributeArray . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . getItemTypes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GetItemAttribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GetItemAttrDocument . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GetItemAttrClob . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . getItemAttributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GetItemAttrInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GetActivityAttrInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GetActivityAttribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GetActivityAttrClob . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . BeginActivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CompleteActivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CompleteActivityInternalName . . . . . . . . . . . . . . . . . . . . . . . . AssignActivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . HandleError . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SetItemParent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ItemStatus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . getProcessStatus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Workflow Function APIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . loadItemAttributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . loadActivityAttributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . getActivityAttr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . getItemAttr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . setItemAttrValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . execute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Workflow Attribute APIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . WFAttribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . getName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . getValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . getType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . getFormat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . getValueType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . toString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . compareTo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Workflow Core APIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

8 40 8 42 8 45 8 47 8 50 8 52 8 55 8 56 8 58 8 59 8 60 8 61 8 62 8 63 8 65 8 66 8 68 8 71 8 73 8 74 8 76 8 78 8 79 8 80 8 81 8 82 8 83 8 84 8 86 8 87 8 88 8 89 8 91 8 92 8 93 8 94 8 95 8 96 8 97 8 98 8 99 8 100

Contents

vii

CLEAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GET_ERROR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . TOKEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . RAISE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CONTEXT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . TRANSLATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Workflow Purge APIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Notifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Total . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . TotalPERM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . AdHocDirectory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Purge Obsolete Workflow Runtime Data Concurrent Program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Workflow Directory Service APIs . . . . . . . . . . . . . . . . . . . . . . . . . . GetRoleUsers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GetUserRoles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GetRoleInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GetRoleInfo2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . IsPerformer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . UserActive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GetUserName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GetRoleName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GetRoleDisplayName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SetAdHocUserStatus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SetAdHocRoleStatus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CreateAdHocUser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CreateAdHocRole . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . AddUsersToAdHocRole . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SetAdHocUserExpiration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SetAdHocRoleExpiration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SetAdHocUserAttr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SetAdHocRoleAttr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . RemoveUsersFromAdHocRole . . . . . . . . . . . . . . . . . . . . . . . . . Workflow Preferences API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . get_pref . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Workflow Monitor APIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GetAccessKey . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GetDiagramURL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GetEnvelopeURL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GetAdvancedEnvelopeURL . . . . . . . . . . . . . . . . . . . . . . . . . . .

8 101 8 102 8 103 8 104 8 107 8 109 8 110 8 112 8 113 8 114 8 115 8 116 8 117 8 118 8 120 8 121 8 122 8 123 8 124 8 125 8 126 8 127 8 128 8 129 8 130 8 131 8 132 8 134 8 136 8 137 8 138 8 139 8 140 8 141 8 142 8 142 8 143 8 144 8 145 8 147 8 149

viii Oracle Workflow Guide

Oracle Workflow Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . WF_ITEM_ACTIVITY_STATUSES_V . . . . . . . . . . . . . . . . . . . WF_NOTIFICATION_ATTR_RESP_V . . . . . . . . . . . . . . . . . . . WF_RUNNABLE_PROCESSES_V . . . . . . . . . . . . . . . . . . . . . . WF_ITEMS_V . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Workflow Queue APIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . EnqueueInbound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DequeueOutbound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DequeueEventDetail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PurgeEvent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PurgeItemType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ProcessInboundQueue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GetMessageHandle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DequeueException . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DeferredQueue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . InboundQueue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OutboundQueue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ClearMsgStack . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CreateMsg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . WriteMsg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SetMsgAttr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SetMsgResult . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Document Management APIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . get_launch_document_url . . . . . . . . . . . . . . . . . . . . . . . . . . . . . get_launch_attach_url . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . get_open_dm_display_window . . . . . . . . . . . . . . . . . . . . . . . . get_open_dm_attach_window . . . . . . . . . . . . . . . . . . . . . . . . . set_document_id_html . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Overview of the Oracle Workflow Notification System . . . . . . . . Notification Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Notification APIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Send . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Custom Callback Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SendGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Forward . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Transfer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Cancel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CancelGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Respond . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Responder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . VoteCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

8 151 8 151 8 153 8 154 8 155 8 156 8 159 8 161 8 164 8 166 8 167 8 168 8 169 8 170 8 171 8 172 8 173 8 174 8 175 8 176 8 177 8 178 8 179 8 180 8 181 8 182 8 183 8 184 8 186 8 186 8 191 8 193 8 194 8 197 8 199 8 201 8 203 8 204 8 205 8 206 8 207

Contents

ix

OpenNotificationsExist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Close . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . AddAttr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SetAttribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GetAttrInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GetInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GetText . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GetShortText . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GetAttribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GetAttrDoc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GetSubject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GetBody . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GetShortBody . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . TestContext . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . AccessCheck . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . WorkCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . getNotifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . getNotificationAttributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . WriteToClob . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Overview of the Oracle Workflow Business Event System . . . . . Business Event System Datatypes . . . . . . . . . . . . . . . . . . . . . . . . . . Agent Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . getName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . getSystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . setName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . setSystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Parameter Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . getName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . getValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . setName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . setValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Parameter List Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Event Message Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Initialize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . getPriority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . getSendDate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . getReceiveDate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . getCorrelationID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . getParameterList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . getEventName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . getEventKey . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . getEventData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

8 208 8 209 8 210 8 211 8 213 8 214 8 215 8 216 8 217 8 219 8 220 8 221 8 222 8 223 8 224 8 225 8 226 8 227 8 228 8 229 8 230 8 231 8 231 8 231 8 232 8 232 8 233 8 233 8 233 8 234 8 234 8 235 8 236 8 239 8 239 8 239 8 240 8 240 8 240 8 240 8 241 8 241

x Oracle Workflow Guide

getFromAgent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . getToAgent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . getErrorSubscription . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . getErrorMessage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . getErrorStack . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . setPriority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . setSendDate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . setReceiveDate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . setCorrelationID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . setParameterList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . setEventName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . setEventKey . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . setEventData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . setFromAgent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . setToAgent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . setErrorSubscription . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . setErrorMessage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . setErrorStack . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . AddParameterToList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GetValueForParameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Example for Using Abstract Datatypes . . . . . . . . . . . . . . . . . . Mapping Between WF_EVENT_T and OMBAQ_TEXT_MSG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Event APIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Raise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Send . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . NewAgent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Enqueue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Listen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Workflow Agent Listener Concurrent Program . . . . . . . . . . . SetErrorInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SetDispatchMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . AddParameterToList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . AddParameterToListPos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GetValueForParameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GetValueForParameterPos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Event Subscription Rule Function APIs . . . . . . . . . . . . . . . . . . . . . Default_Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

8 241 8 241 8 241 8 242 8 242 8 242 8 242 8 243 8 243 8 243 8 244 8 244 8 244 8 245 8 245 8 245 8 245 8 246 8 246 8 247 8 247 8 247 8 249 8 251 8 254 8 255 8 259 8 261 8 262 8 263 8 264 8 265 8 266 8 267 8 268 8 269 8 270 8 271 8 272 8 274 8 276

Contents

xi

Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Warning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Success . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Workflow_Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Error_Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SetParametersIntoParameterList . . . . . . . . . . . . . . . . . . . . . . . . Event Function APIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SubscriptionParameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . AddCorrelation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Generate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Receive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Business Event System Replication APIs . . . . . . . . . . . . . . . . . . . . WF_EVENTS Document Type Definition . . . . . . . . . . . . . . . . WF_EVENTS_PKG.Generate . . . . . . . . . . . . . . . . . . . . . . . . . . WF_EVENTS_PKG.Receive . . . . . . . . . . . . . . . . . . . . . . . . . . . . WF_EVENT_GROUPS Document Type Definition . . . . . . . . WF_EVENT_GROUPS_PKG.Generate . . . . . . . . . . . . . . . . . . WF_EVENT_GROUPS_PKG.Receive . . . . . . . . . . . . . . . . . . . WF_SYSTEMS Document Type Definition . . . . . . . . . . . . . . . WF_SYSTEMS_PKG.Generate . . . . . . . . . . . . . . . . . . . . . . . . . . WF_SYSTEMS_PKG.Receive . . . . . . . . . . . . . . . . . . . . . . . . . . . WF_AGENTS Document Type Definition . . . . . . . . . . . . . . . . WF_AGENTS_PKG.Generate . . . . . . . . . . . . . . . . . . . . . . . . . . WF_AGENTS_PKG.Receive . . . . . . . . . . . . . . . . . . . . . . . . . . . WF_EVENT_SUBSCRIPTIONS Document Type Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . WF_EVENT_SUBSCRIPTIONS_PKG.Generate . . . . . . . . . . . WF_EVENT_SUBSCRIPTIONS_PKG.Receive . . . . . . . . . . . . Index

8 277 8 278 8 279 8 280 8 281 8 282 8 283 8 284 8 286 8 287 8 289 8 291 8 293 8 295 8 296 8 297 8 298 8 299 8 300 8 301 8 302 8 303 8 304 8 305 8 306 8 307 8 308 8 309

VOLUME 2Volume 2 . . . . . . . . . . . . . . . . . . . . . . . . . .

i

Chapter 9

Oracle Workflow Home Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 1 Accessing the Oracle Workflow Home Page . . . . . . . . . . . . . . . . . 9 2 Setting User Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 5

xii Oracle Workflow Guide

Chapter 10

Viewing Notifications and Processing Responses . . . . . . . . . . . Overview of Notification Handling . . . . . . . . . . . . . . . . . . . . . . . . . Reviewing Notifications via Electronic Mail . . . . . . . . . . . . . . Viewing Notifications from a Web Browser . . . . . . . . . . . . . . Reviewing a Summary of Your Notifications via Electronic Mail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Defining Rules for Automatic Notification Processing . . . . . Document Management Integration in Notifications . . . . . . . . . .

10 1 10 2 10 2 10 13 10 25 10 26 10 33

Chapter 11

Monitoring Workflow Processes . . . . . . . . . . . . . . . . . . . . . . . . . . Overview of Workflow Monitoring . . . . . . . . . . . . . . . . . . . . . . . . . Workflow Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Workflow Monitor Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

11 1 11 2 11 2 11 7

Chapter 12

Testing a Workflow Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 1 Testing Workflow Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 2

Chapter 13

Managing Business Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Managing Business Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Event Subscriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setting Up Message Propagation . . . . . . . . . . . . . . . . . . . . . . . Raising Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Signing Up Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Synchronizing Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Reviewing Local Queues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Workflow Agent Ping/Acknowledge . . . . . . . . . . . . . . . . . . . . . . . The Workflow Agent Ping/Acknowledge Item Type . . . . . . Summary of the Master Ping Process . . . . . . . . . . . . . . . . . . . . Master Ping Process Activities . . . . . . . . . . . . . . . . . . . . . . . . . Summary of the Detail Ping Process . . . . . . . . . . . . . . . . . . . . Detail Ping Process Activities . . . . . . . . . . . . . . . . . . . . . . . . . .

13 1 13 2 13 4 13 17 13 22 13 33 13 51 13 62 13 64 13 67 13 69 13 73 13 74 13 75 13 76 13 77 13 78

Chapter 14

Predefined Workflow Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Predefined Workflow Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Event Definition Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Event Group Definition Events . . . . . . . . . . . . . . . . . . . . . . . . .

14 1 14 2 14 2 14 3

Contents

xiii

System Definition Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Agent Definition Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Event Subscription Definition Events . . . . . . . . . . . . . . . . . . . Synchronize Event Systems Event . . . . . . . . . . . . . . . . . . . . . . Seed Event Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ping Agent Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . System Signup Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Any Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Unexpected Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Workflow Send Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . The Workflow Send Protocol Item Type . . . . . . . . . . . . . . . . . Summary of the Workflow Event Protocol Process . . . . . . . . Workflow Event Protocol Process Activities . . . . . . . . . . . . . . Workflow Send Protocol Events . . . . . . . . . . . . . . . . . . . . . . . .

14 4 14 4 14 5 14 5 14 6 14 8 14 9 14 10 14 12 14 16 14 17 14 19 14 20 14 23

Chapter 15

Demonstration Workflow Processes . . . . . . . . . . . . . . . . . . . . . . . Sample Workflow Processes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Displaying the Process Diagram of a Sample Workflow . . . . Requisition Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installing the Requisition Data Model . . . . . . . . . . . . . . . . . . . Initiating the Requisition Workflow . . . . . . . . . . . . . . . . . . . . . The Requisition Item Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Summary of the Requisition Approval Process . . . . . . . . . . . Requisition Process Activities . . . . . . . . . . . . . . . . . . . . . . . . . . Summary of the Notify Approver Subprocess . . . . . . . . . . . . Notify Approver Subprocess Activities . . . . . . . . . . . . . . . . . . Sample StartProcess Function . . . . . . . . . . . . . . . . . . . . . . . . . . Example Function Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . Example: Select Approver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Example: Verify Authority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Example Notification Activity . . . . . . . . . . . . . . . . . . . . . . . . . . Example: Notify Requisition Approval Required . . . . . . . . . Product Survey Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installing the Product Survey Data Model . . . . . . . . . . . . . . . Initiating the Product Survey Workflow . . . . . . . . . . . . . . . . . The Product Survey Item Type . . . . . . . . . . . . . . . . . . . . . . . . . Summary of the Survey Single Process . . . . . . . . . . . . . . . . . Survey Single Process Activities . . . . . . . . . . . . . . . . . . . . . . Summary of the Survey Master/Detail Process . . . . . . . . . Survey Master/Detail Process Activities . . . . . . . . . . . . . . . Summary of the Detail Survey Process . . . . . . . . . . . . . . . . . .

15 1 15 2 15 3 15 5 15 6 15 8 15 12 15 13 15 15 15 19 15 21 15 23 15 26 15 26 15 29 15 31 15 31 15 34 15 35 15 36 15 38 15 39 15 41 15 42 15 44 15 46

xiv Oracle Workflow Guide

Detail Survey Process Activities . . . . . . . . . . . . . . . . . . . . . . . . Document Review Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . The Document Management Item Type . . . . . . . . . . . . . . . . . . Summary of the Document Review Process . . . . . . . . . . . . . . Document Review Process Activities . . . . . . . . . . . . . . . . . . . . Error Check Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . The Periodic Alert Item Type . . . . . . . . . . . . . . . . . . . . . . . . . . . Summary of the Error Check Process . . . . . . . . . . . . . . . . . . . . Error Check Process Activities . . . . . . . . . . . . . . . . . . . . . . . . . Summary of the User Defined Alert Action Process . . . . . . . User Defined Alert Action Process Activities . . . . . . . . . . . . . Event System Demonstration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installing the Event System Demonstration Data Model . . . Initiating the Event System Demonstration Workflow . . . . . The Event System Demonstration Item Type . . . . . . . . . . . . . Summary of the Buyer: Top Level PO Process . . . . . . . . . . . . Buyer: Top Level PO Process Activities . . . . . . . . . . . . . . . . . . Summary of the Buyer: Send PO to Supplier Subprocess . . . Buyer: Send PO to Supplier Subprocess Activities . . . . . . . . Summary of the Buyer: Receive Supplier PO Acknowledgement Subprocess . . . . . . . . . . . . . . . . . . . . . . . . . Buyer: Receive Supplier PO Acknowledgement Subprocess Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Summary of the Buyer: Advanced Shipment Notice Subprocess . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Buyer: Advanced Shipment Notice Subprocess Activities . . Summary of the Buyer: Receive Supplier Invoicing Subprocess . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Buyer: Receive Supplier Invoicing Subprocess Activities . . . Summary of the Supplier: Top Level Order Process . . . . . . . Supplier: Top Level Order Process Activities . . . . . . . . . . . . . Summary of the Supplier: Get Order Details Subprocess . . . Supplier: Get Order Details Subprocess Activities . . . . . . . . . Summary of the Supplier: Credit Check Subprocess . . . . . . . Supplier: Credit Check Subprocess Activities . . . . . . . . . . . . . Summary of the Supplier: Stock Check Subprocess . . . . . . . . Supplier: Stock Check Subprocess Activities . . . . . . . . . . . . . Summary of the Supplier: Advanced Shipment Notice Subprocess . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Supplier: Advanced Shipment Notice Subprocess Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Summary of the Supplier: Send Supplier Invoice Subprocess . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

15 47 15 49 15 49 15 50 15 52 15 54 15 54 15 56 15 57 15 60 15 61 15 63 15 64 15 66 15 71 15 73 15 75 15 78 15 78 15 80 15 81 15 83 15 84 15 85 15 86 15 87 15 88 15 91 15 92 15 94 15 95 15 96 15 97 15 98 15 99 15 100

Contents

xv

Supplier: Send Supplier Invoice Subprocess Activities . . . . . B2B Purchase Order Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B2B Purchase Order Acknowledgement Event . . . . . . . . . . . B2B Advanced Shipment Notice Event . . . . . . . . . . . . . . . . . . B2B Invoice Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

15 101 15 102 15 105 15 106 15 107

Chapter 16

Workflow Administration Scripts . . . . . . . . . . . . . . . . . . . . . . . . . Miscellaneous SQL Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FNDWFLST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FNDWFPR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . WFNLADD.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wfagtlst.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wfbkg.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wfbkgchk.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wfchact.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wfchacta.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wfchita.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wfchitt.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wfchluc.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wfchlut.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wfchmsg.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wfchmsga.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wfdirchk.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wfevtenq.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wfjvstop.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wfmqupd.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wfnlena.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wfntfsh.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wfprot.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wfqclean.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wfrefchk.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wfretry.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wfrmall.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wfrmita.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wfrmitms.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wfrmitt.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wfrmtype.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wfrun.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wfstat.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wfstatus.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wfstdchk.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

16 1 16 2 16 4 16 4 16 5 16 5 16 6 16 6 16 7 16 7 16 7 16 8 16 8 16 8 16 9 16 9 16 10 16 10 16 11 16 12 16 12 16 12 16 12 16 13 16 13 16 13 16 14 16 14 16 15 16 15 16 15 16 15 16 16 16 16 16 16

xvi Oracle Workflow Guide

Wfver.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 16 Wfverchk.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 17 Wfverupd.sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 17

Appendix A

Oracle Workflow Builder Menus and Toolbars . . . . . . . . . . . . . A 1 Oracle Workflow Builder Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . A 2 Oracle Workflow Builder Toolbars . . . . . . . . . . . . . . . . . . . . . . . . . A 7

Appendix B

Oracle Applications Embedded Workflows . . . . . . . . . . . . . . . . Predefined Workflows Embedded in Oracle Applications and Oracle SelfService Web Applications . . . . . . . . . . . . . . . . . . . Oracle Workflow Business Event System Integration in Oracle Applications and Oracle SelfService Web Applications . . . . . . . Oracle Support Policy for Predefined Workflows, Events, and Subscriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Customization Guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Resolving Customization Issues . . . . . . . . . . . . . . . . . . . . . . . . What Is NOT Supported . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . What Is Supported . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Glossary Index

B1 B2 B 17 B 19 B 19 B 20 B 20 B 20

Contents

xvii

xviii Oracle Workflow Guide

Preface

Preface

xix

Audience for This GuideWelcome to the Oracle Workflow Guide. This guide assumes you have a working knowledge of the following: The principles and customary practices of your business area. Oracle Workflow If you have never used Oracle Workflow, Oracle suggests you attend one or more of the Oracle Workflow training classes available through Oracle University. See Other Information Sources for more information about Oracle Applications product information. The Oracle Workflow Guide also assumes you have a basic understanding of operating system concepts and familiarity with Oracle database server, PL/SQL, and Oracle9i Application Server technology. If you have not yet been introduced to any of these systems, Oracle suggests you attend one or more of the training classes available through Oracle University.

How To Use This GuideThis guide contains the information you need to understand and use Oracle Workflow. Chapter 1 provides an overview of Oracle Workflow. Chapter 2 describes how to implement Oracle Workflow for your site. Chapter 3 describes how to begin defining a workflow process. Chapter 4 describes how to define the components necessary to build a workflow process. Chapter 5 describes how to draw and define a workflow process diagram. Chapter 6 describes the standard activities provided with Oracle Workflow. Chapter 7 describes the standard APIs for the PL/SQL and Java functions that can be called by Oracle Workflow. Chapter 8 provides detailed information about Oracle Workflows APIs.

xx

Oracle Workflow Guide

Chapter 9 describes the Oracle Workflow home page, where users and administrators can centrally access all the webbased features of Oracle Workflow. Chapter 10 discusses how a user can view and act on a workflow notification. Chapter 11 describes how to use the Workflow Monitor to administer or view the status of a workflow process. Chapter 12 describes how to launch a workflow process for testing purposes. Chapter 13 describes how to manage business events. Chapter 14 describes the standard events provided with Oracle Workflow. Chapter 15 describes the demonstration workflow processes included with Oracle Workflow. Chapter 16 describes the miscellaneous administrative SQL scripts included with Oracle Workflow. Appendix A describes the Oracle Workflow Builder menus and toolbar. Appendix B lists the predefined workflow processes that are included with the Oracle Applicationsembedded version of Oracle Workflow, as well as Oracle Applications features that leverage the Business Event System. This appendix also includes the Oracle Workflow support policy. At the end of this guide, we include a glossary of Oracle Workflow terms.

Documentation AccessibilityOur goal is to make Oracle products, services, and supporting documentation accessible, with good usability, to the disabled community. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Standards will continue to evolve over time, and Oracle Corporation is actively engaged with other marketleading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For additional information, visit the Oracle Accessibility Program Web site at http://www.oracle.com/accessibility/.

Preface

xxi

Accessibility of Code Examples in Documentation JAWS, a Windows screen reader, may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, JAWS may not always read a line of text that consists solely of a bracket or brace. Accessibility of Links to External Web Sites in Documentation This documentation may contain links to Web sites of other companies or organizations that Oracle Corporation does not own or control. Oracle Corporation neither evaluates nor makes any representations regarding the accessibility of these Web sites.

Other Information SourcesYou can choose from many sources of information, including online documentation, training, and support services, to increase your knowledge and understanding of Oracle Workflow. If this guide refers you to other Oracle Applications documentation, use only the Release 11i versions of those guides.

Online DocumentationIf you are using the version of Oracle Workflow embedded in Oracle Applications, note that all Oracle Applications documentation is available online (HTML or PDF). Online Help The new features section in the HTML help describes new features in 11i. This information is updated for each new release of Oracle Workflow. The new features section also includes information about any features that were not yet available when this guide was printed. For example, if your administrator has installed software from a minipack or an upgrade, this document describes the new features. Online help patches are available on MetaLink. 11i Features Matrix This document lists new features available by patch and identifies any associated new documentation. The new features matrix document is available on MetaLink.

xxii

Oracle Workflow Guide

Readme File Refer to the readme file for patches that you have installed to learn about new documentation or documentation patches that you can download. Portions of this guide are also available online in Windows Help format. The Windows Help is available from the Oracle Workflow Builder Help menu. If you are using the standalone version of Oracle Workflow, note that this guide is available online in HTML format, and portions of the guide are available in Windows Help format as well. The Windows Help is available from the Oracle Workflow Builder Help menu. The HTML documentation is available from a URL provided by your system administrator or from the help icon in the Oracle Workflow web pages.

Related Users GuidesOracle Workflow is used by other Oracle Applications products to provide embedded workflows. Therefore, if you are using the version of Oracle Workflow embedded in Oracle Applications, you may want to refer to other users guides when you set up and use Oracle Workflow to learn more about the embedded workflows. You can read the guides online by choosing Library from the expandable menu on your HTML help window, by reading from the Oracle Applications Document Library CD included in your media pack, or by using a Web browser with a URL that your system administrator provides. If you require printed guides, you can purchase them from the Oracle Store at http://oraclestore.oracle.com.

Guides Related to All ProductsOracle Applications Users Guide This guide explains how to enter data, query, run reports, and navigate using the graphical user interface (GUI) available with this release of Oracle Workflow (and any other Oracle Applications products). This guide also includes information on setting user profiles, as well as running and reviewing reports and concurrent processes. You can access this users guide online by choosing Getting Started with Oracle Applications from any Oracle Applications help file.

Preface

xxiii

User Guides Related to This ProductOracle General Ledger User Guide This guide provides information about journal entry, budgeting, and multicompany accounting and consolidation. Oracle Purchasing Users Guide This guide provides information about entering and managing purchase orders and requisitions. Implementing Oracle SelfService Human Resources (SSHR) This guide provides information about setting up the selfservice human resources management functions for managers and employees. Managers and employees can then use an intranet and Web browser to have easy and intuitive access to personal and career management functionality Oracle Payables User Guide This guide provides information about entering and managing suppliers, invoices, and payments. Oracle Projects User Guide This guide provides information about entering and managing projects, budgets, expenditures, costing, and billing. Oracle Receivables User Guide This guide provides information about entering and managing customers, receipts, collections, and transactions. Oracle Business Intelligence System Implementation Guide This guide provides information about implementing Oracle Business Intelligence (BIS) in your environment. BIS 11i User Guide Online Help This guide is provided as online help only from the BIS application and includes information about intelligence reports, Discoverer workbooks, and the Performance Management Framework.

xxiv

Oracle Workflow Guide

Oracle Financials Open Interface Reference This guide is a compilation of all open interface descriptions in all Oracle Financial Applications users guides. Oracle XML Gateway Users Guide This guide explains how to implement the production and consumption of valid, wellformed XML messages between Oracle Applications and trading partners.

Installation and System AdministrationOracle Applications Concepts This guide provides an introduction to the concepts, features, technology stack, architecture, and terminology for Oracle Applications Release 11i. It provides a useful first book to read before an installation of Oracle Applications. This guide also introduces the concepts behind Applicationswide features such as Business Intelligence (BIS), languages and character sets, and SelfService Web Applications. Installing Oracle Applications This guide provides instructions for managing the installation of Oracle Applications products. In Release 11i, much of the installation process is handled using Oracle Rapid Install, which minimizes the time to install Oracle Applications, the Oracle8 technology stack, and the Oracle8i Server technology stack by automating many of the required steps. This guide contains instructions for using Oracle Rapid Install and lists the tasks you need to perform to finish your installation. You should use this guide in conjunction with individual product users guides and implementation guides. Upgrading Oracle Applications Refer to this guide if you are upgrading your Oracle Applications Release 10.7 or Release 11.0 products to Release 11i. This guide describes the upgrade process and lists database and productspecific upgrade tasks. You must be either at Release 10.7 (NCA, SmartClient, or character mode) or Release 11.0, to upgrade to Release 11i. You cannot upgrade to Release 11i directly from releases prior to 10.7.

Preface

xxv

Maintaining Oracle Applications Use this guide to help you run the various AD utilities, such as AutoUpgrade, AutoPatch, AD Administration, AD Controller, AD Relink, License Manager, and others. It contains howto steps, screenshots, and other information that you need to run the AD utilities. This guide also provides information on maintaining the Oracle applications file system and database. Oracle Applications System Administrators Guide This guide provides planning and reference information for the Oracle Applications System Administrator. It contains information on how to define security, customize menus and online help, and manage concurrent processing. Oracle Alert Users Guide This guide explains how to define periodic and event alerts to monitor the status of your Oracle Applications data. Oracle Applications Developers Guide This guide contains the coding standards followed by the Oracle Applications development staff. It describes the Oracle Application Object Library components needed to implement the Oracle Applications user interface described in the Oracle Applications User Interface Standards for FormsBased Products. It also provides information to help you build your custom Oracle Forms Developer 6i forms so that they integrate with Oracle Applications.

Other Implementation DocumentationOracle Applications Product Update Notes Use this guide as a reference for upgrading an installation of Oracle Applications. It provides a history of the changes to individual Oracle Applications products between Release 11.0 and Release 11i. It includes new features, enhancements, and changes made to database objects, profile options, and seed data for this interval. Multiple Reporting Currencies in Oracle Applications If you use the Multiple Reporting Currencies feature to record transactions in more than one currency, use this manual before

xxvi

Oracle Workflow Guide

implementing Oracle Workflow. This manual details additional steps and setup considerations for implementing Oracle Workflow with this feature. Multiple Organizations in Oracle Applications This guide describes how to set up and use Oracle Workflow with Oracle Applications Multiple Organization support feature, so you can define and support different organization structures when running a single installation of Oracle Workflow. Oracle Applications Flexfields Guide This guide provides flexfields planning, setup and reference information for the Oracle Workflow implementation team, as well as for users responsible for the ongoing maintenance of Oracle Applications product data. This manual also provides information on creating custom reports on flexfields data. Oracle eTechnical Reference Manuals Each eTechnical Reference Manual (eTRM) contains database diagrams and a detailed description of database tables, forms, reports, and programs for a specific Oracle Applications product. This information helps you convert data from your existing applications, integrate Oracle Applications data with nonOracle applications, and write custom reports for Oracle Applications products. Oracle eTRM is available on MetaLink. Oracle Applications User Interface Standards for FormsBased Products This guide contains the user interface (UI) standards followed by the Oracle Applications development staff. It describes the UI for the Oracle Applications products and how to apply this UI to the design of an application built by using Oracle Forms. Oracle Manufacturing APIs and Open Interfaces Manual This manual contains uptodate information about integrating with other Oracle Manufacturing applications and with your other systems. This documentation includes APIs and open interfaces found in Oracle Manufacturing.

Preface

xxvii

Oracle Order Management Suite APIs and Open Interfaces Manual This manual contains uptodate information about integrating with other Oracle Manufacturing applications and with your other systems. This documentation includes APIs and open interfaces found in Oracle Order Management Suite. Oracle Applications Message Reference Manual This manual describes all Oracle Applications messages. This manual is available in HTML format on the documentation CDROM for Release 11i.

Training and SupportTraining Oracle offers a complete set of training courses to help you and your staff master Oracle Workflow and reach full productivity quickly. These courses are organized into functional learning paths, so you take only those courses appropriate to your job or area of responsibility. You have a choice of educational environments. You can attend courses offered by Oracle University at any one of our many Education Centers, you can arrange for our trainers to teach at your facility, or you can use Oracle Learning Network (OLN), Oracle Universitys online education utility. In addition, Oracle training professionals can tailor standard courses or develop custom courses to meet your needs. For example, you may want to use your organization structure, terminology, and data as examples in a customized training session delivered at your own facility. Support From onsite support to central support, our team of experienced professionals provides the help and information you need to keep Oracle Workflow working for you. This team includes your Technical Representative and Account Manager, and Oracles large staff of consultants and support specialists with expertise in your business area, managing an Oracle database server, and your hardware and software environment.

xxviii

Oracle Workflow Guide

Do Not Use Database Tools to Modify Oracle Applications DataOracle STRONGLY RECOMMENDS that you never use SQL*Plus, Oracle Data Browser, database triggers, or any other tool to modify Oracle Applications data unless otherwise instructed. Oracle provides powerful tools you can use to create, store, change, retrieve, and maintain information in an Oracle database. But if you use Oracle tools such as SQL*Plus to modify Oracle Applications data, you risk destroying the integrity of your data and you lose the ability to audit changes to your data. Because Oracle Applications tables are interrelated, any change you make using Oracle Applications can update many tables at once. But when you modify Oracle Applications data using anything other than Oracle Applications, you may change a row in one table without making corresponding changes in related tables. If your tables get out of synchronization with each other, you risk retrieving erroneous information and you risk unpredictable results throughout Oracle Applications. When you use Oracle Applications to modify your data, Oracle Applications automatically checks that your changes are valid. Oracle Applications also keeps track of who changes information. If you enter information into database tables using database tools, you may store invalid information. You also lose the ability to track who has changed your information because SQL*Plus and other database tools do not keep a record of changes.

About OracleOracle Corporation develops and markets an integrated line of software products for database management, applications development, decision support, and office automation, as well as Oracle Applications, an integrated suite of more than 160 software modules for financial management, supply chain management, manufacturing, project systems, human resources, and customer relationship management. Oracle products are available for mainframes, minicomputers, personal computers, network computers and personal digital assistants, allowing organizations to integrate different computers, different operating systems, different networks, and even different database management systems, into a single, unified computing and information resource.

Preface

xxix

Oracle is the worlds leading supplier of software for information management, and the worlds second largest software company. Oracle offers its database, tools, and applications products, along with related consulting, education, and support services, in over 145 countries around the world.

Your FeedbackThank you for using Oracle Workflow and this guide. Oracle values your comments and feedback. At the end of this guide is a Readers Comment Form you can use to explain what you like or dislike about Oracle Workflow or this guide. Mail your comments to the following address or call us directly at (650) 5067000. Oracle Applications Documentation Manager Oracle Corporation 500 Oracle Parkway Redwood Shores, CA 94065 U.S.A. Or, send electronic mail to [email protected].

xxx

Oracle Workflow Guide

CHAPTER

1

Overview of Oracle Workflowhis chapter introduces you to the concept of a workflow process and to the major features of Oracle Workflow. These features include: Oracle Workflow Builder, a graphical tool that lets you create business process definitions. The Workflow Engine, which implements process definitions at runtime. The Notifications System, which sends notifications to and processes responses from users in a workflow. Workflow Monitor, which allows you to track your workflow process using a web browser. The Business Event System, which communicates business events between systems.

T

Overview of Oracle Workflow

11

Introduction to Oracle WorkflowBusiness processes today involve getting many types of information to multiple people according to rules that are constantly changing. Oracle Workflow lets you automate and continuously improve business processes, routing information of any type according to business rules you can easily change to people both inside and outside your enterprise. See: Major Features and Definitions: page 1 3. Routing Information With so much information available, and in so many different forms, how do you get the right information to the right people? Oracle Workflow lets you provide each person with all the information they need to take action. Oracle Workflow can route supporting information to each decision maker in a business process. Defining and Modifying Business Rules Oracle Workflow lets you define and continuously improve your business processes using a draganddrop process designer. Unlike workflow systems that simply route documents from one user to another with some approval steps, Oracle Workflow lets you model sophisticated business processes. You can define processes that loop, branch into parallel flows and then rendezvous, decompose into subflows, and more. Because Oracle Workflow can decide which path to take based on the result of a stored procedure, you can use the full power of PL/SQL, the language of the Oracle database server, to express any business rule that affects a workflow process. See: Workflow Processes: page 1 6. Delivering Electronic Notifications Oracle Workflow extends the reach of business process automation throughout the enterprise and beyond to include any email or Internet user. Oracle Workflow lets people receive notifications of items awaiting their attention via email, and act based on their email responses. You can even view your list of things to do, including necessary supporting information, and take action using a standard Web browser.

12

Oracle Workflow Guide

Integrating Systems Oracle Workflow lets you set up subscriptions to business events which can launch workflows or enable messages to be propagated from one system to another when business events occur. You can communicate events among systems within your own enterprise and with external systems as well. In this way, you can implement pointtopoint messaging integration or use Oracle Workflow as a messaging hub for more complex system integration scenarios. You can model business processes that include complex routing and processing rules to handle events powerfully and flexibly.

Major Features and DefinitionsOracle Workflow Builder Oracle Workflow Builder lets you create, view, or modify a business process with simple drag and drop operations. Using the Workflow Builder, you can create and modify all workflow objects, including activities, item types, and messages. See: Workflow Processes: page 1 6. At any time you can add, remove, or change workflow activities, or set up new prerequisite relationships among activities. You can easily work with a summarylevel model of your workflow, expanding activities within the workflow as needed to greater levels of detail. And, you can operate Oracle Workflow Builder from a desktop PC or from a disconnected laptop PC. Workflow Engine The Workflow Engine embedded in the Oracle database server monitors workflow states and coordinates the routing of activities for a process. Changes in workflow state, such as the completion of workflow activities, are signaled to the engine via a PL/SQL API or a Java API. Based on flexiblydefined workflow rules, the engine determines which activities are eligible to run, and then runs them. The Workflow Engine supports sophisticated workflow rules, including looping, branching, parallel flows, and subflows. Business Event System The Business Event System is an application service that uses the Oracle Advanced Queuing (AQ) infrastructure to communicate business events

Overview of Oracle Workflow

13

between systems. The Business Event System consists of the Event Manager, which lets you register subscriptions to significant events, and event activities, which let you model business events within workflow processes. When a local event occurs, the subscribing code is executed in the same transaction as the code that raised the event. Subscription processing can include executing custom code on the event information, sending event information to a workflow process, and sending event information to other queues or systems. Workflow Definitions Loader The Workflow Definitions Loader is a utility program that moves workflow definitions between database and corresponding flat file representations. You can use it to move workflow definitions from a development to a production database, or to apply upgrades to existing definitions. In addition to being a standalone server program, the Workflow Definitions Loader is also integrated into Oracle Workflow Builder, allowing you to open and save workflow definitions in both a database and file. Complete Programmatic Extensibility Oracle Workflow lets you include your own PL/SQL procedures or external functions as activities in your workflows. Without modifying your application code, you can have your own program run whenever the Workflow Engine detects that your programs prerequisites are satisfied. Electronic Notifications Oracle Workflow lets you include users in your workflows to handle activities that cannot be automated, such as approvals for requisitions or sales orders. Electronic notifications are routed to a role, which can be an individual user or a group of users. Any user associated with that role can act on the notification. Each notification includes a message that contains all the information a user needs to make a decision. The information may be embedded in the message body or attached as a separate document. Oracle Workflow interprets each notification activity response to decide how to move on to the next workflow activity.

14

Oracle Workflow Guide

Electronic Mail Integration Electronic mail (email) users can receive notifications of outstanding work items and can respond to those notifications using their email application of choice. An email notification can include an attachment that provides another means of responding to the notification. InternetEnabled Workflow Any user with access to a standard Web browser can be included in a workflow. Web users can access a Notification Web page to see their outstanding work items, then navigate to additional pages to see more details or provide a response. Monitoring and Administration Workflow administrators and users can view the progress of a work item in a workflow process by connecting to the Workflow Monitor using a standard Web browser that supports Java. The Workflow Monitor displays an annotated view of the process diagram for a particular instance of a workflow process, so that users can get a graphical depiction of their work item status. The Workflow Monitor also displays a separate status summary for the work item, the process, and each activity in the process. If you are using the version of Oracle Workflow embedded in Oracle Applications and you have implemented Oracle Applications Manager, you can also use the Oracle Workflow Manager component of Oracle Applications Manager as an additional administration tool for Oracle Workflow. Oracle Applications Manager is a tool that provides administrative and diagnostic capabilities for concurrent processing, Oracle Workflow, and other functionality in Oracle Applications. For more information, please refer to the Oracle Applications Manager online help.

Overview of Oracle Workflow

15

Workflow ProcessesOracle Workflow manages business processes according to rules that you define. The rules, which we call a workflow process definition, include the activities that occur in the process and the relationship between those activities. An activity in a process definition can be an automated function defined by a PL/SQL stored procedure or an external function, a notification to a user or role that may optionally request a response, a business event, or a subflow that itself is made up of a more granular set of activities. A workflow process is initiated when an application calls a set of Oracle Workflow Engine APIs. The Workflow Engine takes over by driving the relevant work item defined by the application, through a specific workflow process definition. According to the workflow process definition, the Workflow Engine performs automated steps and invokes appropriate agents when external processing is required. The following diagram depicts a simplified workflow process definition that routes a requisition to a manager or set of managers for approval.

16

Oracle Workflow Guide

We refer to the whole drawing as a process or process diagram. The icons represent activities, and the arrows represent the transitions between the activities. In the above example, new items are created for the process when a user creates and submits a requisition in the appropriate application. This process contains several workflow activities implemented as PL/SQL stored procedures, including: Select Approverto select, according to your business rules, who should approve the requisition. Verify Authorityto verify that a selected approver has the spending authority to approve the requisition.

Overview of Oracle Workflow

17

18

Oracle Workflow Guide

CHAPTER

2

Setting Up Oracle Workflowhis chapter describes the requirements for Oracle Workflow and provides the steps necessary to set up Oracle Workflow at your site.

T

Setting Up Oracle Workflow

21

Oracle Workflow Hardware and Software RequirementsThe components of Oracle Workflow require the following hardware and software configurations: Oracle Workflow Builder is installed using Oracle Universal Installer and requires the installation of Oracle Net Services (version 8.1.6 or higher for Oracle8i, or version 9.0.1 or higher for Oracle9i) and Required Support Files (version 8.1.6 or higher for Oracle8i, or version 9.0.1 or higher for Oracle9i). You should install Oracle Workflow Builder on an IBM, Compaq or 100% compatible personal computer with the following: A 486 processor or better Clock speed of 66 Mhz or greater (90 Mhz or greater is recommended) Network card SVGA color monitor Modem configured with dialin access for use by Oracle Worldwide Customer Support. At least one PC at your site should be configured with a modem. Remote access and control software to be used by Customer Support for dialin access through a modem to your PC. The preferred software is Symantecs Norton pcANYWHERE, or Microcoms Carbon Copy. Without some form of remote access and control software, Oracle Worldwide Customer Support will not be able to dial in to your site to diagnose problems, nor will they be able to supply patches directly to your client PC. Warning: Please follow the necessary security precautions against viruses and unauthorized access when installing any software that allows remote access. Dual speed, ISO 9660 format CDROM available as a logical drive Microsoft Windows 95, Windows 98, Windows 2000, or Windows NT 4.0 or higher At least 60 Mb of available disk space to install Oracle Workflow Builder, Oracle Net Services, and Required Support Files. At least 32 Mb of memory, 64 Mb recommended

22

Oracle Workflow Guide

Attention: Oracle Net Services require and only support the use of Microsofts TCP/IP drivers. Oracle8i Enterprise or Standard Edition database version 8.1.6 or higher, or Oracle9i Enterprise or Standard Edition database version 9.0.1 or higher, along with the Oracle Objects and JServer Options, installed on a supported server machine At least 40 Mb of available disk space for Oracle Workflow Server once it is installed in your Oracle Home At least 128 Mb of memory, 256 Mb recommended Oracle Net Services version 8.1.6 or higher for Oracle8i, or version 9.0.1 or higher for Oracle9i SQL*Plus version 8.1 or higher for Oracle8i, or version 9.0.1 or higher for Oracle9i If you are installing Oracle Workflow Server on Microsoft Windows NT, the following additional hardware and software configurations are required: ISO 9660 format CDROM available as a logical drive Microsoft Windows NT 4.0 or higher

The Oracle Workflow Server requires the following:

Attention: While the version of Oracle Workflow offered to Oracle8i Standard Edition customers is exactly the same as the version offered to Oracle8i Enterprise Edition customers, it is important to note that Oracle Workflow leverages Oracle8i functionality. Consequently, using an Oracle8i Standard Edition database limits some of the features available for use by the Oracle Workflow Business Event System. For example: You cannot create any additional queues in Oracle8i Standard Edition beyond the default queues provided by Oracle Workflow. If you require additional queues, you should choose Oracle8i Enterprise Edition. Oracle Advanced Queuing propagation in Oracle8i Standard Edition does not support propagating messages outside the local database. If you require messages to be propagated to other systems, you should choose Oracle8i Enterprise Edition.

Setting Up Oracle Workflow

23

In Oracle9i, however, these restrictions no longer apply. Exactly the same functionality is available with Oracle Workflow in an Oracle9i Standard Edition database as in an Oracle9i Enterprise Edition database. The email notifications component contains a program that can send mail through UNIX Sendmail or a Windows NT MAPIcompliant mail application. Oracle Workflow can also send mail to other email applications as long as you install the appropriate UNIX gateway product to communicate with your email application of choice. To send and respond to email notifications with HTML attachments, your email application should support HTML attachments and you should have a Web browser application that supports JavaScript and Frames to view the attachment. The Web notifications, Workflow Monitor, and Event Manager components require Oracle HTTP Server and mod_plsql to be installed on a server machine. The Oracle HTTP Server and mod_plsql components are included with Oracle8i Database version 8.1.7 or higher and with Oracle9i Database version 9.0.1 or higher, as well as with Oracle9i Application Server version 1.0.1 or higher. To view notifications you need a Web browser application that supports JavaScript and Frames. To view the Workflow Monitor you need a Web browser that supports Java Development Kit (JDK), Version 1.1.8 or higher and Abstract Windowing Toolkit (AWT), such as Netscape Communicator version 4.76 or a higher version of 4.7x, or Microsoft Internet Explorer version 5.0x or 5.5. To run external Java function activities and to use the Workflow XML Loader, you must have Java Runtime Environment (JRE) version 1.1.8, or a higher 1.1.x version, installed. To extract the HTML help for the standalone version of Oracle Workflow, you need an unzip utility.

24

Oracle Workflow Guide

Overview of Setting UpAfter you install Oracle Workflow, you implement it for your site by setting up the preferences and components appropriate for your enterprise.

Overview of Required Set Up Steps for the Standalone Version of Oracle Workflow1. Set up the default Oracle Workflow user preferences for your entire enterprise using the Global Preferences web page. The Global Preferences web page also lets you define your workflow