Workflow Troubleshooting in R12

Workflow Troubleshooting in R12

Karen Brownfield

GoldPartner

Copyright © 2014 Infosemantics, Inc. All Rights Reserved . Any other commercial product names herein are trademark, registered trademarks or service marks of their respective owners.

2

About the Speaker

■ Oracle Ace■ Oracle Certified Specialist (EBS and Fusion)■ Over 20 years E-Business Suite support■ OAUG Board 1994-2009, 2014-2015, former President■ Member ATG Customer Advisory Board■ Co-Chair Oracle EBS User Management SIG■ Over 100 presentations worldwide■ Co-author multiple books on E-Business Suite

3 GoldPartner


About Infosemantics

■ Established in 2001

■ SBA 8(a) Small Business disadvantaged company

■ GSA Schedule contract GS-35F-0680V

■ Texas State HUB vendor

■ For more information, go to our web site at www.Infosemantics.com■ R12.1.3, R12.2, OBIEE public

vision instances■ Posted presentations on

functional and technical topics

GoldPartner


4

Agenda

■ Introduction■ Workflow Dashboard ■ Workflows and Events■ Setups and Prepare for Cleanup■ Access Health of Active Workflows■ Solve and Remediate Errored Workflows and Events■ Cleanup

■ Special Cases■ References■ Q&A

GoldPartner


5

Introduction

GoldPartner


6

The Problem

■ SYSADMIN has hundreds of emails■ Workflow Analyzer evaluated my environment as RED■ I closed a bunch of WFERRORs, but the errored

workflows are still there■ WFERROR subject starts out “Local Event Error” –

where did the event go? ■ Is WFERROR the only error handling workflow?■ Is there any special help for Order Management?■ Where do I start? What do I do? Is there any way to

manage this better than one workflow/email at a time?

GoldPartner


7

Audience?

■ Role ?■ DBA■ SYSADMIN■ Workflow Administrator■ Functional SuperUser

■ Release ?■ 11.5.10■ 12.0.x■ 12.1.x■ 12.2.x

GoldPartner


8

Workflow Dashboard

GoldPartner


9

Workflow Dashboard

■ Mailer Not Required, Purge can be run manually, all other should be green checks

GoldPartner


10

SetupsPrepare for Cleanup

GoldPartner


11

Non-Optional Setups (prevent trouble)

■ Start Listeners■ Set “Server Timezone” profile option■ Either add email to SYSADMIN user or set preference

for SYSADMIN to “Do not send me mail”■ If not using mailer, set global preference to “Do not

send me mail”

■ For mailer on cloned instances■ If stopped, set global preference■ If not stopped, MUST use different email account than

production if inbound responses permitted■ Perform all required setups for each workflow in use

GoldPartner


12

Non-Optional Setups (prevent trouble)

■ If running Projects, setup PASYSADMIN as a user■ Must have Workflow Administrator responsibility■ Setup Worklist Access to this user same as SYSADMIN

GoldPartner


13

Highly Recommended Setups

■ Download Workflow Analyzer■ Set up to run as concurrent program ■ See MOS notes 1369938.1 and 1425053.1

■ Set Workflow Administrator to responsibility■ Update Config.sys parameters ■ Add Personal Worklist to this responsibility■ If not using System Administrator▸ Add “Application Super User Role” to role hierarchy▸ Ensure ‘Workflow Administrator’ report group assigned▸ Ensure responsibility can run reports

■ Add following programs to responsibility report group▸ (R12.2.n) Workflow Directory Services Bulk Reset DISABLED

Notification Preference

GoldPartner


14

Highly Recommended Setups

■ Grant Worklist Access to SYSADMIN’s emails to all administrators■ Use Functional Administrator and create grant

■ Create Worklist Flexfields■ Create Custom views for WFERROR, POERROR,

HRSSA, OMERROR, xxERROR notifications■ See Workflow Analyzer for active xxERROR workflows in

your environment■ Enable Export button in Personal Worklist■ Set “WF: Enable Bulk Notification Response” profile

option to “Yes” for workflow administrators

GoldPartner


15

Prepare for Cleanup

■ Patch current■ 12.1.3▸ Run Patch Wizard ■ 17774755 – EBS 12.1.3+ RPC1■ 9817770 – Post R12.ATG.PF.B.DELTA.3 Consolidated Patch■ 19329720 – Latest Recommended Patch Collection for OWF

12.1.3+▸ See list from Workflow Analyzer

■ 12.2.3 / 12.2.4▸ See MOS note 1583092.1■ AD/TXK Delta 5 ■ Apply at same time (12.2.n AD/TXK MUST be at same delta)

GoldPartner


16

Patch Current from Workflow Analyzer – 12.1.3

GoldPartner


17

Patch Current from Workflow Analyzer – 12.1.3

GoldPartner


18

Prepare for Cleanup■ Run Purge for Temp and Perm■ Reduce “noise”

■ Purge Orphaned Notifications from WFERROR■ Wf_purge.Notifications (‘WFERROR’,’<date>’,TRUE,1)▸ Date is used to compare to closed date for orphaned notifications

■ Run Workflow Statistics programs■ Workflow Mailer Statistics Concurrent Program■ Workflow Agent Activity Statistics Concurrent Program■ Workflow Work Items Statistics Concurrent Program

■ Run Gather Schema Statistics at 30% for APPLSYS■ Unclick “Send e-mails for canceled notifications” if running

Notification Mailer and SYSADMIN is setup to receive emails (step 4 of Mailer setup)

GoldPartner


19

Process

■ Assess Health■ Was has errored? How many?▸ Don’t forget errored events

■ Triage■ Most Recent■ Most Numerous

■ Stop the Bleeding!!■ Take action on errored workflows■ Clean up associated WFERRORs

■ Take action on errored events■ Clean up associated WFERRORS

GoldPartner


20

Access Health

GoldPartner


21

How Many Notifications Awaiting Action

■ If notification or xxERROR workflow closed, this may give false picture

GoldPartner


22

What? How many? Where? When?

■ Workflow Analyzer – tells What, How many■ Count is of distinct workflows

■ OAM Workflow pages – tells What, How many, Where■ Tells When by specific workflow, but not sorted so earliest

/ most recent hard to determine■ Provides link to Status monitor■ Workflow may be errored in multiple points, so count may

not match Workflow Analyzer■ SQL summary – tells What, How many, Where, Earliest

/ most recent■ Workflow may be errored in multiple points, so count may

not match Workflow Analyzer

GoldPartner


23

SQL Summary (my script)

GoldPartner


24

Errored Events (my script)

■ WFERROR not linked to workflow, so previous methods not applicable

■ SQL to get counts and errored event, then use notifications to SYSADMIN to diagnose and remediate

GoldPartner


25

Workflow Analyzer

■ Ideally there should be at least one WFERROR (and message to SYSADMIN) for each errored workflow

GoldPartner


26

OAM Workflow Pages

■ Click “Work Items” link at bottom of page, then select the view “Errored Work Items”

To see which activity errored, click workflow,

then View Details

To see which activity errored, click a workflow,

then View Details

GoldPartner


27

OAM Workflow Pages

■ Each activity in error and count■ Next drilldown will show specific workflows

GoldPartner


28

OAM Workflow Pages

■ Not sorted by Date or Key■ Links to manage or view Status Diagram

GoldPartner


29

What About #STUCK?

GoldPartner


30

What About #STUCK?

■ Stuck will show in error counts also

GoldPartner


31

Not Every Message is an Errored Workflow

■ This type “error” will have to be addressed (usually) one workflow at a time

GoldPartner


32

Not Every Message is an Errored Workflow

GoldPartner


33

Diagnostics

■ MOS note 1083807.1 – 12.1.3+ catalog

GoldPartner


34

Diagnostics

■ Use <CTRL>F to search for tests in other sections

GoldPartner


35

Diagnostics

■ Need Application Diagnostics responsibility■ MOS note 753979.1▸ Must use User Management and assign at least one of

following roles■ Application End User■ Application Super User■ Diagnostics Super User

▸ Many responsibilities (PO Super User, System Administrator, Order Management Super User) have had Diagnostics Super User role attached to the responsibility

▸ For further information, see OAUG paper database “Maximize Efficiency of Oracle E-Business Suite Release 11i/12 through Diagnostics” by Susan Behn

GoldPartner


36

TriageStop the Bleeding!

GoldPartner


37

Where to start

■ Start with workflow or event that has errored most recently and if multiple ones, one that has errored most often■ If Most Recent Begin Date in past, then indicates error

fixed▸ Still need to clean up workflow that errored and associated

WFERROR

GoldPartner


38

Use Personal Worklist Views

■ Note multiple workflows have same error■ In this case, inform DBA immediately

GoldPartner


39

Other Common Worklist Views

GoldPartner


40

Export to Spreadsheet

GoldPartner


41

What if xxERROR is missing?

■ For non-event errors

GoldPartner


42

What if count of event errors is really large?

■ Note: If WFERROR is missing, there is no other source

GoldPartner


43

Use OAM Drilldown

■ Effective when associated WFERRORs are closed

GoldPartner


44

Take Action

GoldPartner


45

Will Retry Work?

■ Retry is a good answer if:■ Errors are recent■ Issue that caused error did not require changes to

workflow definition▸ Exception: Messages, PL/SQL are not versioned

■ Error doesn’t make sense (retry one to see if anomaly)■ PO Approval – Document Manager error

■ How to Retry■ Notifications or status monitor – one at a time■ Bulk Response from Notifications■ OAM Retry All■ “Retry Errored Workflow Activities” concurrent program

GoldPartner


46

Bulk Respond from Notification

■ Select Notifications, click Respond■ Must all belong to same Type, Same Message Name

Message Name Different

Different Error

GoldPartner


47

Bulk Response From Notifications■ Select Response (Retry), Click Go

■ Response for WFERROR for events is:■ Abort■ Raise Event with Event Key■ Raise Event with Event Key and Event Data■ Raise with Event Key Event Data and Parameters■ (and standard) Reassign, More Information Please

GoldPartner


48

OAM Retry All

■ “Retry All” acts on all, not just ones showing on screen■ Retry happens “while you wait”, not deferred

GoldPartner


49

Retry Errored Workflow Activities

■ Useful when want to only restart recent errors (specify Errored On or After (DD-MON-RRRR))

Change to 1

GoldPartner


50

Selectively Abort

■ Do you really want old POs, Requisitions, Expense Reports, ….. to restart?■ Aborting workflow does not remove data from application

tables■ What does the event do? Is there an alternative

process that will perform the same action■ Example: all events with user in the name do not have to

be re-raised, run “Workflow Directory Services User/Role Validation”

■ All error reporting workflows that are still open although parent workflow is now closed■ Purge will close WFERROR, but not OMERROR,

POERROR, HRSSA, etc.

GoldPartner


51

Selectively Abort Non-Error Reporting Items

■ How many exist?■ Use Status Monitor or OAM to abort if number is small■ Otherwise adjust following (from MOS note 804622.1)

■ If Error Item Type is WFERROR, it will be closed and purged when parent workflow is purged

GoldPartner


52

Selectively Abort Errored Event

GoldPartner


53

Error Reporting Workflows

GoldPartner


54

Error Reporting Workflows (MOS 804622.1)

■ Change to create list of errored workflows

Use OAM to Abort All

GoldPartner


55

It’s a Repetitive Process

GoldPartner


56

Repeat Preparation

■ Run Purge for Temp and Perm■ Reduce “noise”

■ Run Workflow Statistics programs■ Workflow Mailer Statistics Concurrent Program■ Workflow Agent Activity Statistics Concurrent Program■ Workflow Work Items Statistics Concurrent Program

■ Run Gather Schema Statistics at 30% for APPLSYS■ Rerun Workflow Analyzer

GoldPartner


57

Monitor Need to Reorganize

% is actually > 100

GoldPartner


58

Special Cases

GoldPartner


59

User Notification Preference Update Report

■ FYI notification issued when someone’s notification preference is set to DISABLED due to bad or missing email■ No workflow behind this, so can’t use Worklist Flexfields■ Can customize message in workflow “System: Mailer”

and add person to Subject

GoldPartner


60


■ MOS note 1326359.1■ Fix Email Address▸ If user linked to employee, must add to employee■ To see email in user record, relink user to employee

▸ If recipient a supplier/customer, use supplier/customer forms

■ Fix User Notification Preference 12.1.3▸ If recipient is a user, user can use Preferences link▸ SQL

GoldPartner


61


■ MOS note 1326359.1■ Fix User Notification Preference 12.2.n▸ If recipient is a user, user can use Preferences link▸ Run “Workflow Directory Services Bulk Reset DISABLED

Notification Preference”

■ Resend Notifications

GoldPartner


62

Users Missing Responsibilities / Can’t Log In

■ R12.1.3 and R12.2.n use complex set of events to synchronize all tables

■ Synchronize WF LOCAL Tables obsolete in 12.2.2 (MOS note 1547670.1)■ 12.1.3 – still needed for PER_ROLE, POS, PQH_ROLE

■ Workflow Directory Services User/Role Validation

GoldPartner


63

If Using Resource Manager

■ MOS notes 1293524.1 and 462988.1

GoldPartner


64

ONT, PO, HCM, (and soon to come) INV, AP

■ Workflow Analyzer contains special sections for issues specific to select products■ Section has detailed analysis of product specific

workflows■ References to MOS notes

GoldPartner


65

References

GoldPartner


66

References and More Information

■ MOS notes■ 1320509.1 – E-Business Suite 11i/R12: Oracle Workflow

(WF) Product Information Center (PIC)■ 453137.1 – Oracle Workflow Best Practices Release 12

and Release 11i■ Workflow Book■ Pdf copy from lulu.com

■ Workflow Documentation■ My Oracle Support feeds■ Settings, Hot Topics E-Mail

■ OAUG Conference Database■ Now “googling” will yield links to papers

GoldPartner


67

[email protected]

Thank you!!

Workflow Troubleshooting in R12

Documents

Transcript of Workflow Troubleshooting in R12