Lease approval workflow_white_paper

1. 1
ORACLE APPLICATIONS
WHITE PAPER
Lease Approval Workflow
Prepared by
Author: Vaishali Karanth –Property Manager Support
Updated by:
Creation Date: 01-May-2014
Last Updated:
Control Number: 1
Version:
Copyright (C) 1995 Oracle Corporation
All Rights Reserved
Product Design and Architecture

2. 2
Contents
1. Introduction ........................................................................................................................................4
2. Scope ....................................................................................................................................................4
3. Pre-requisites.......................................................................................................................................4
4. Features ...............................................................................................................................................4
5. Setup ....................................................................................................................................................5
a. HRMS...............................................................................................................................................5
b. Workflow.........................................................................................................................................5
c. Oracle Approvals Management (AME)......................................................................................5
d. System administrator.....................................................................................................................5
e. Property Manager ..........................................................................................................................5
5.1. HRMS.............................................................................................................................................5
5.2. Workflow.....................................................................................................................................7
5.2.1. Setup Approval Workflow ...............................................................................................7
5.2.2. Confirm Business Event is enabled ................................................................................8
5.2.3. Confirm Business Event is is setup and linked to Workflow ......................................9
5.2.4. Setup Business Event Subscription details.....................................................................9
5.3. Oracle Approvals Management (AME)................................................................................14
5.3.1. Attribute ............................................................................................................................15
5.3.2. Actions / Action types .....................................................................................................25
5.3.3. Conditions.........................................................................................................................27
5.3.4. Approver Groups.............................................................................................................31
5.4. System Administrator .............................................................................................................32
5.4.1. Create the users and assign them the following responsibilities: .............................32

3. 3
5.4.2. Setup Profile Option ........................................................................................................34
5.4.3. Run the Concurrent Workflow Background Process..................................................36
5.5. Property Manager ....................................................................................................................36
6. Technical Aspects................................................................................................................................42
6.1. Tables involved in Lease Approval Process.........................................................................42
6.2. Trouble Shooting.........................................................................................................................43
6.2.1. Collecting the output of the AME Set-up Utility Report............................................43
6.2.2. Running a Real Transaction Test in AME.....................................................................45
6.2.3. Collecting the AME Exceptions log for a transaction .................................................47
7. Reference ...........................................................................................................................................48

4. 4
1. Introduction
In today’s world, business conglomerates and MNC’s process huge number of leases.
Approving all the leases manually by the appropriate authority is a painful process.
Property manager Lease Approval Workflow process automates the approval process.
Lease approval workflow process enables you to automate the approval process. It helps
in customizing and setting approval methodology based on Approval Hierarchy
2. Scope
This document is intended for an audience who are familiar with the basic setup /
knowledge of Oracle Approval Management and workflow administration.
Scope of this white paper is to explain the Setup details involved in Oracle Property
Manager, Oracle Approval Management and Workflow for the lease approval work
flow to work. In addition to that it also has details of a full Cycle explaining the usage
of lease Approval.
This paper will not cover general AME details and Workflow details Trouble shooting of
Lease approval Workflow
3. Pre-requisites
The basic requirements to enable the Lease Approval Workflow is
 Oracle Property Manager Patch set Level 12.1.3
 Setup the Profile Option for PN:Lease Approval Workflow to Yes at the Site,
Application, Responsibility or User levels.
4. Features
The approval can be submitted through:
 Leases and Documents > Main Lease > Enter Leases and document
 Create a new lease or Query an existing lease which is in Draft status.
 Change the Approval Status to Submitted for Approval
The approval can be done through
E-mail
Workflow notification

5. 5
5. Setup
The setup for Lease Approval Workflow, it involves below modules
a. HRMS
b. Workflow
c. Oracle Approvals Management (AME)
d. System administrator
e. Property Manager
5.1. HRMS
The lease approval workflow uses the employee details and employee supervisor
details defined in the HRMS module to determine the approval hierarchy.
With regards to setup part, in HRMS first we you need to create employees and
assign supervisors.
In our test case, we are going to create the following employees and their
supervisors:
Employee Job Job Approval
Authority (From Job
form)
Stock, Ms. Pat MGR500.Manager 2
Brown, Ms. Casey EX100.Executive 3
Tucker, Mr. William EX100.Executive 4

6. 6

7. 7
5.2. Workflow
For Lease approval work flow to work, the setup that needs to be done in workflow are
 Setup Approval Workflow
 Confirm Business Event is is enabled
 Confirm Business Event is is setup and linked to Workflow
 Setup Business Event Subscription details
5.2.1. Setup Approval Workflow
To check whether seeded property manager Approval workflow is already
available in your application, navigate to

8. 8
Responsibility: Workflow Administrator Web Application
N: Administrator Workflow > Developer Studio
Confirm Workflow Type is setup
Developer Studio (T)
Workflow Type: PN: Lease Approval Workflow
Type Internal Name: PNAPPRWF
5.2.2. Confirm Business Event is enabled
A business event is an occurrence in an internet or intranet application or
program that might be significant to other objects in a system or to external
agents. For instance, the creation of a purchase order is an example of a business
event in a purchasing application. You can define your significant events in the
Event Manager.
Oracle Workflow provides several predefined events for significant occurrences
within the Business Event System. The seeded business event available for Lease
approval work flow is ‘oracle.apps.pn.lease.leasestatus’.
The navigation to check whether the seeded Lease approval workflow is enabled
or not is
Business Event (T)
Name: oracle.apps.pn.lease.leasestatus
Status: Enabled

9. 9
5.2.3. Confirm Business Event is is setup and linked to Workflow
Business Events (T)
Events (ST)
Name: oracle.apps.pn.lease.leasestatus
Click on Subscription
Action: Launch Workflow
Function: wf_rule.default_rule
Workflow: PNAPPRWF/PNPROC
Click Update (I)
5.2.4. Setup Business Event Subscription details
An event subscription is a registration indicating that a particular event is
significant to a particular system and specifying the processing to perform when
the triggering event occurs.
Whenever an event is raised locally or received from an external source, the
Event Manager searches for and executes any eligible subscriptions. To be
eligible, a subscription must meet the following requirements:

10. 10
 The subscriber must be the local system.
 The triggering event must be the event that was raised or received, an
event group that includes that event, or the Any event.
 Both the subscription and its triggering event must be marked as active
by having a status of Enabled.
 The source type of the subscription must match the source of the event,
either local or external.
5.2.4.1 Create or Update an Event Subscription:
1. Navigate to the Create Event Subscription page or to the Update Event
Subscriptions page. The Create Event Subscription page and the Update Event
Subscriptions page are identical, except that the fields in the Update Event
Subscriptions page are populated with previously defined information for the
selected subscription.
2. In the Subscriber region, select the system where the subscription executes.

11. 11
3. In the Triggering Event region, specify the event source to which the
subscription applies in the Source Type field.
 Local - The subscription applies only to events raised on the subscribing
system.
 External - The subscription applies only to events received by an inbound
agent on the subscribing system.
 Error - The subscription applies to only to errored events dequeued from
the WF_ERROR queue or WF_JAVA_ERROR queue.
4. Select the event that triggers the subscription in the Event Filter field. You can
specify an individual event or an event group.
5. Optionally select a source agent to which the subscription applies. If you
specify source agent, then the subscription is executed only when the triggering
event is received from that agent. In most cases, the Source Agent field is left
blank.
6. In the Execution Condition region, enter a phase number for the subscription to
specify the order in which subscriptions triggered by the same event are
executed. The phase number also controls whether a subscription is executed
immediately or is deferred, unless processing for the event is deferred by another
method.
7. Select Enabled or Disabled as the subscription status. If you disable a
subscription,it still remains in the Event Manager for reference, but it can no
longer be executed when events occur.
8. In the Rule Data field, specify the event information required by the subscription.

12. 12
 Key - The subscription requires only the event key.
 Message - The subscription requires the complete event data.
9. In the Action Type region, select the subscription processing you want to perform
when the triggering event occurs. For lease approval work flow to work we need to set
this option to Launch Workflow i.e Send the event message to launch or continue a
workflow process.
10. Specify the error handling to perform if Oracle Workflow encounters an error while
processing this subscription.
 Stop and Rollback - The Event Manager halts all subscription processing for
the event and rolls back any subscriptions already executed for the event.
 Skip to Next - The Event Manager rolls back only this subscription and then
continues processing the next subscription for the event according to the
subscription phase order.
11. Choose the Next button to define the details of the subscription action, depending on
the action type you selected.

13. 13
12. In the Action Region ,Select the workflow item type and process name for the
workflow process to which you want to send the event. This needs to be setup only if
you selected Launch Workflow as the action type.
13. Select Normal, High, or Low as the priority for the subscription. Oracle Workflow
uses the priority to help determine the order in which deferred subscriptions are
processed. The default priority is Normal.
14. You can optionally select an additional option to control how the subscription is
executed.For more information on the details of Additional Options refer Workflow
Developer guide Page 8-40

14. 14
15. In the Documentation region, in Owner Tag field enter the application short name of
the program or application that owns the subscription. In Owner Name field enter the
application name associated with that application short name.
5.3. Oracle Approvals Management (AME)
The purpose of Oracle Approvals Management (AME) is to define approval rules that
determine the approval processes for Oracle applications.
The first step which we need to do in AME for lease approval work is check whether
‘PN approval workflow’ Transaction Type is setup. The Navigation to check the
transaction type is
Responsibility: Approvals Management Business Management
N: Business Management Dashboard
Confirm Transaction Type is setup
Transaction Types (ST)
Name: PN approval workflow

15. 15
The second step would be to create a rule for Transaction Type ‘ PN approval
workflow’. In our test case, we will see how to create a Rule in AME for : PN
approval workflow.
To create a rule in Approval Management, we need to create the following and
then attach to the rule:
 Attribute
 Actions / Action types
 Conditions
 Approver Groups
5.3.1. Attribute
An attribute is a business variable that has exactly one value for a given transaction.
Examples are Invoice Amount, An item's category, A person's salary etc., An attribute
has the following properties:
Name- An attribute name is a string that represents a decision variable
Item Classes-An attribute item class determines what class of items has a value for the
attribute.
Data Types-An attribute type indicates the data type of the attribute's values.
Usage Type- There are two kinds of attribute use:
 Static - A static attribute use assigns a constant value to an attribute, for a
given transaction type.
 Dynamic- A dynamic attribute use assigns an SQL query to an attribute, for
a given transaction type.
Navigation to define Attribute is
Responsibility: Approvals Management Business Management
N: Business Management Dashboard
Transaction Types (ST) Name: PN approval workflow
Click Setup (I)
CreateAttribute

16. 16
In addition to defining the above attribution, for lease approval workflow to work, we
need to is check whether the below Attributes are setup for the Transaction Type: PN
approval workflow.
Navigation for the same is
Responsibility: Approvals Management Business Management
N: Business Management Dashboard
Transaction Types (ST)
Name: PN approval workflow
Click Setup (I) Attribute

17. 17
The attributes that needs to be setup are
5.3.1.1. ALLOW_REQUESTOR_APPROVAL
This is a boolean attribute. It determines whether AME enables a requestor to
approve their own transaction, if they have sufficient signing authority. When
this attribute is true, and a requestor has sufficient authority, the relevant action
type makes the requestor the only approver in their chain of authority, and
assigns the requestor the initial approval status. When the attribute is false, the
relevant action type does not include the requestor in the chain of authority.
Instead, the action type includes in the chain of authority at least one of the
requestor's superiors.

18. 18
5.3.1.2. AT_LEAST_ONE_RULE_MUST_APPLY
This is a boolean attribute determining whether AME raises an exception when
no rules apply to a transaction at run time.
5.3.1.3. EFFECTIVE_RULE_DATE
When AME begins to process a transaction, this date determines which rules are
active for a given transaction. AME then evaluates each active rule's conditions
to see whether the rule actually applies to the transaction.
For most transaction types, the system date (sysdate) is the appropriate
EFFECTIVE_RULE_DATE value. To use this value, provide
EFFECTIVE_RULE_DATE a static use with no value.

19. 19
5.3.1.4. EVALUATE_PRIORITIES_PER_ITEM
This is a boolean attribute. It determines whether AME evaluates the
applicable rules' use priorities per item. Per-item evaluation is relevant for
relative rule-priority modes. When the attribute is true, AME evaluates the
rules' use priorities that apply to each item as a group. When the attribute is
false, it evaluates the use priorities of all the rules applying to the transaction
together.
5.3.1.5. INCLUDE_ALL_JOB_LEVEL_APPROVERS
This attribute determines if all approvers with the same job level should be
included when building the chain of authority for the action types that
depend on Job Level.

20. 20
5.3.1.6.JOB_LEVEL_NON_DEFAULT_STARTING_POINT_PERSON_ID
If this attribute is not null, the approver it identifies will be used as the starting
point for action types that depend on Job Level. Its value will override the setting
for TRANSACTION_REQUESTOR_PERSON_ID
5.3.1.7. REJECTION_RESPONSE
This is a string attribute. It determines how AME responds when an approver
rejects an item. The attribute has three allowed values:
 ContinueAllOtherItems: When REJECTION_RESPONSE has this value,
AME continues the approval processes of all items other than the
item(s)that were rejected.
 ContinueOtherSubItems : When REJECTION_RESPONSE has this value,
AME continues the approval processes of all subordinate-level items
other than the item(s) that were rejected, but stops the approval process
of the header and the rejected item(s).
 StopAllItems: When REJECTION_RESPONSE has this value, AME stops
the approval processes of all of the transaction's items, including the
header.
For Leave approval workflow we will set this attribute value as
‘StopAllItems’

21. 21
5.3.1.8. REPEAT_SUBSTITUTIONS
This is a boolean attribute with a default value of false, in order to
make it backward compatible. AME uses this attribute to process the
substitution rules a second time at the end of the processing cycle. This
is done to apply the Substitution rules on adhoc insertions and
surrogate approvers. The attribute's value can be set or reset
dynamically for any transaction. For example, if you would like the
substitution rules to run again only for a certain set of transactions, this
attribute value can be set dynamically to true or false.

22. 22
5.3.1.9. TOP_SUPERVISOR_PERSON_ID
This attribute should be assigned to the person ID of the employee at the top
of the hierarchy (typically the CEO of a corporation). This is used in Action
Types that climb the supervisor hierarchy and is needed to determine if AME
has reached the top of the hierarchy as opposed to reaching a gap in the
hierarchy setup.
5.3.1.10. TRANSACTION_REQUESTOR_PERSON_ID
This attribute should be assigned to the ID of person requesting the
transaction. Several of the defined Action Types will use this as the starting
point for traversing the hierarchy.

23. 23
5.3.1.11. USE_RESTRICTIVE_ITEM_EVALUATION
This is a boolean attribute. It indicates whether AME requires a single
subordinate-level item to satisfy all conditions on attributes belonging to the
subordinate item class, in a given rule, for the rule to apply. If the attribute is
true, then a rule containing conditions on a subordinate-level item class'
attributes only applies if one of the transaction's items in that class satisfies all
of the rule's conditions on attributes of that item class. If the attribute is false,
then different items may satisfy different conditions on the subordinate item
class' attributes.
5.3.1.12. USE_WORKFLOW
This is a boolean attribute. It indicates whether AME should log the
transaction type's exceptions to the Workflow exception stack. Ordinarily this
attribute must have a static use.

24. 24
5.3.1.13. WORKFLOW_ITEM_KEY
This is a string attribute. It is a transaction's item key in the integrating
application's workflow. The item key is typically also the AME transaction
ID, and in this case, the attribute's dynamic use can select : transactionId from
dual. AME uses this attribute's value when it logs exceptions in Workflow's
exception stack.
5.3.1.14. WORKFLOW_ITEM_TYPE
This is the item type of the integrating application's workflow. AME uses this
attribute's value when it logs exceptions to Workflow's exception stack.

25. 25
5.3.2. Actions / Action types
An action is an instruction to AME to modify a transaction's approval process in the
manner you specify. An action type is a collection of actions having similar functionality.
For example, actions in the absolute-job-level action type all require approvals up to a
certain job level in the HR supervisory hierarchy. The main differences among the actions
are the job level they require.
Navigation to assign action type to the Transaction Type ‘ PN approval workflow’ is
Responsibility: Approvals Management Business Management
N: Business Management Dashboard
Transaction Types (ST)
Name: PN approval workflow
Click Setup (I)
Action Types
Click on use existing Action type and select below two action types only
 Absolute job level- The absolute-job-level action type generates a chain of authority by
ascending the HR supervisory hierarchy starting at a given approver and continuing
until an approver with a sufficient job level is found.
First Approver
By default, the first approver (starting point) in an absolute-job-level chain is the
supervisor of the person identified by the required number attribute
TRANSACTION_REQUESTOR_PERSON_ID.

26. 26
Final Approver
The absolute-job-level action type's ascent up the supervisory hierarchy stops
when it
reaches one or more approvers having a sufficient job level. A job level is a value
in the
authority_level column of the Oracle HRMS table per_jobs.
 Final-Approver-Only - The final-approver-only action type is also a variant of the
absolute-job-level action type. Instead of requiring approval from every person in an
ascent up the supervisory hierarchy, this action type only includes the final approver.
Click on Continue and then Save

27. 27
5.3.3. Conditions
The if part of an approval rule consists of zero or more conditions. A condition is a
statement that is either true or false, for a given transaction. For the rule to apply to a
transaction, all of its conditions must be true for the transaction.
There are two types of conditions:
 Regular conditions- An ordinary condition associates an attribute with a set of allowed
values or range. Such a condition is true when the attribute has one of the allowed
values.
 List-modifiers- A list-modification condition checks for the presence of a given target
approver at a specific set of allowed locations in the default approver list. When the
target approver is present in an allowed location, we say that the default approver list
satisfies the condition.

28. 28
The navigation to define the condition is
Responsibility: Approvals Management Business Management
N: Business Management Dashboard
Transaction Types (ST)
Name: PN approval workflow
Click Setup (I)
Conditions
Click on Create button
In the attribute field PNAPPRWF from the list of values.
Set expression option to TRUE
Apply and save
Once the condition is defined, Confirm List Modifier details for the Transaction
Type: PN approval workflow

29. 29
5.3.3.1. Creating Rules
Creating rules and rule usages is the main step in the AME implementation
process. Rarely will an organization’s business rules match any rules that are
seeded with a transaction type. Instead, you must translate the business rules you
documented into AME rules yourself.
Rule associate one or more conditions with an approval in an if then statement.
Before you can create rules, you must create conditions for the rules to use. You
may need to create (or have a system administrator create) some custom
attributes like how we created PNAPPRWF and/or approvals. You may also need
to create some approval groups. Thus, while creating rules is your ultimate goal,
it is also the last thing you do when you set up AME.
Navigation to create Rules is
Responsibility: Approvals Management Business Management
N: Business Management Dashboard
Transaction Types (ST)
Name: PN approval workflow
Click Rules (I)
Click on the ‘Create’ tab
Give the name of the Rule in the Name.

30. 30
Select the rule type to ‘List Creation’
Give appropriate Start and End date for the rule and then press continue button
Click on Add condition button and select the condition PNAPPRWF is true and
press continue button
Select the appropriate Action Types (in our case chains of authority based on
absolute job level action type is selected) and Select appropriate Action (in our
example we have selected Require approvals up to at least level 2) and then press
continue.
Finally recheck the complete Rule setup and save

31. 31
5.3.4. Approver Groups
The forth and the final step in AME for lease approval management is setting up
Approver Groups.
An approver group can either be an ordered set of one or more approvers
(persons and/or user accounts) or it can be a list, which is dynamically generated
at rule evaluation time. A typical pre- or post-approval rule adds an approver
group's members (in order) to a transaction's approver list. Typically approver
groups represent functional approvers outside a transaction's chain of authority,
such as human-resource
management and internal legal counsel, that must approve a transaction before
or after management has done so.
To create an approver group:
Use the Create New Approver Group page.
 Click the Approver Groups tab to display the Approver Groups page. If
you are navigating from the Business Dashboard, then select the required
transaction type in the Approval Process Setup available in the Business
Dashboard and click the Approver Groups link.
 Click Create to open the Create New Approver Group page.
 Enter the group's name and description.
 Enter the order number to determine how the approver groups in the
same sub-list are ordered.
 Select the voting method to determine the order in which AME notifies
the group's members and how the group makes approval decisions.
 Select the group's use type to determine the group's membership list. If
you select the dynamic use type, then enter an SQL query and click
Validate to ensure the query is well formed. If you select the static use

32. 32
type, then you must enter members for the static approver group in the
Group Members region.
 Click Apply to add the approver group to your transaction type
5.4. System Administrator
In System Administrator Responsibility, we need to
5.4.1. Create the users and assign them the following responsibilities:
Employee User login Responsibilities (minimum
responsibilities to be assigned)
Stock, Ms. Pat Operations/welcome Property Manager, Approval
Management
(OAM), Workflow
Brown, Ms. Casey Cbrown/welcome Property Manager, Approval
Management
(OAM), Workflow
Following are the screenshots of the above

33. 33

34. 34
5.4.2. Setup Profile Option
Responsibility: System Administrator
N: Profile > System
Find System Profile Options: PN Approval Workflow

35. 35
Set the profile to Yes

36. 36
5.4.3. Run the Concurrent Workflow Background Process
Responsibility: System Administrator
N: Requests > Run
Run This Request… form
Name Workflow Background Process
Item Type: PN Lease Approval Workflow
5.5. Property Manager
The Final steps in this simulation is to create a lease in property manager module
and then submit the same for approval.
Responsibility: Property Manager vision operations
Logged in as OPERATIONS (Stock, Ms. Pat)
N: Leases and Documents Main Lease
Enter Leases and Documents
Click on new button and create a Lease

37. 37
Once the Lease is created, change the lease status from Draft to Submitted

38. 38
Then system will ask for a confirmation message.

39. 39
Click on Save now Option. Now the lease is submitted for Approval.
To see the notification, login with Cbrown user (Stock, Ms. Pat’ s supervisor). In
Cbrown’ s work list we see a Notification for the lease approval
Click on Notification and Approve the Same.

40. 40
Now when we login with Operations (Stock, Ms. Pat’s) login, in the work list we will see
a Notification that lease is approved
Also in the Lease work bench, the lease status is changed from Submitted to Final

41. 41
We can also see that schedule and Items program is automatically getting fired by the system
once the lease is approved.
Also we can see the schedule lines generated in Authorize Payments Window

42. 42
6. Technical Aspects
6.1. Tables involved in Lease Approval Process
Workflow Tables. Usage
WF_EVENTS,
WF_EVENT_SUBSCRIPTIONS
Consists complete list of events and events
subscriptions along with licensing details
WF_DEFERRED Stores details of the events that requires to be
submitted to workflow
WF_ERROR If the ‘Workflow Agent Listener’errors, then a
record is logged in this table
WF_ITEM_TYPES_TL Consists complete list of workflow item types
WF_ITEM_ATTRIBUTES_TL Consists attributes defined for a workflow item
type
WF_ACTIVITIES_TL,
WF_PROCESS_ACTIVITIES
Consists activities defined for a
workflow item type
WF_ITEMS Consists item type and item key. One record exists
for every Lease submitted for approval
WF_ITEM_ATTRIBUTE_VALUES Consists attribute values used during approval
workflow

43. 43
WF_ITEM_ACTIVITY_STATUSES Consists item key activity status
WF_NOTIFICATIONS Consists notification details
WF_USERS, WF_ROLES,
WF_USER_ROLES
Used to identify the notification
users notification preferences
AME tables Usage
AME_TRANSACTION_TYPES_V Consists AME transaction types lists
AME_ATTRIBUTES,
AME_CONDITIONS,
AME_ACTIONS,
AME_ACTION_TYPES,
AME_APPROVAL_GROUPS
Consists details of AME attributes,
conditions and approval lists
AME_RULES,
AME_CONDITION_USAGES,
AME_ATTRIBUTE_USAGES,
AME_RULE_USAGES,
AME_ACTION_TYPE_USAGES
Consists rules and usage of attributes, conditions
and approval list in the rules
AME_TRANS_APPROVAL_HISTORY Stores transaction id of the approval process and
the person id who approved the transactions
HRMS tables Usage
PER_ALL_PEOPLE_F Stores the employee details
PER_ALL_ASSIGNMENTs_F Stores details of the employee assignment /
supervisor
PER_JOBS Stores the Approval Authority details
6.2. Trouble Shooting
The three basic troubleshooting steps covered in this document will be:
I: Collecting the output of the AME Set-up Utility Report
- HRMS Approvals Management (AME) Reporting Utility Support Tool (Doc ID 287255.1)
II: Running a Real Transaction Test in AME
III: Collecting the AME Exceptions log for a transaction
6.2.1. Collecting the output of the AME Set-up Utility Report
This reporting utility script will allow a snapshot to be taken of the AME set-up for a specified
transaction type (ie Setup Report for the transaction Type). It will report on the following

44. 44
 AME Setup Data for a Transaction Type
 Invalid Approvers in the setup
 Invalid AME Objects
 AME Patch Level
 AME Key Files Versions
The output of this utility script is an HTML document.
See HRMS Approvals Management (AME) Reporting Utility Support Tool (Doc ID 287255.1)
Steps to generate the Setup Report
There are 2 steps involved in generating the setup report. The first step we need to identify the
AME’s internal application id for the transaction type in question. The second step is the actually
running the script which generates the setup report.
Step 1 : Identify the AME Internal ID for the Transaction Type.
You may use the script below to obtain the ID
Select application_id
from ame_calling_apps
where application_name = ‘PN approval workflow'
and sysdate between start_date and nvl(end_date, sysdate);
Note: Please note that the AME Internal ID (Application ID) is usually a negative integer.
Make a note of the AME Internal ID. The AME internal id for PN approval workflow is
-726
Step 2 : Running the script
Run the following SQL from SQLPLUS under ‘apps’ account.
Select decode(to_char(nvl(fnd_profile.value('AME_INSTALLATION_LEVEL')
,'Pre-AME.B')),'Pre-11.5.10','Pre-11.5.10','Post-11.5.10') From Dual;
If the value returned by step is ‘Pre-11.5.10', then run the ‘getPre11510AMESetup.sql’
If the value returned by step is ‘Post-11.5.10', then run the ‘getPost11510AMESetup.sql’
The ‘getPre11510AMESetup.sql’ and ‘getPost11510AMESetup.sql’can be downloaded from Doc
ID 287255.1
The utility script should be run in an SQLPLUS session using ‘apps’ account. The AME-internalID
identified in Step 1 should be applied as a parameter to the script as specified below.

45. 45
Note: Setup report can also be retrieved from Approvals Management Administrator
responsibility
Click Admin Dashboard,
Setup Report on far right of page,
Click Setup Report, Enter Transaction Type = PN approval workflow,
Click GO
6.2.2. Running a Real Transaction Test in AME
Run a Real Transaction Test for lease number.
Access Approvals Management Business Analyst responsibility
Note- can also select Transaction Type = PN approval workflow (on right side of page), and then
access test
Business Analyst Dashboard, For Transaction Type = PN approval workflow , click Test, This is the
AME Test Workbench

46. 46
Click Run Real Transaction Test (1) and enter Transaction ID = Lease number
- Results display
- click ‘Run Test Case (2)’ button and observe output
Click 'View Approval Process Stages (1)'
- results display

47. 47
6.2.3. Collecting the AME Exceptions log for a transaction
Use Approvals Management Administrator responsibility, Admin Dashboard

48. 48
Note, Exception Log in Quick Links (on upper right side of page), click Exception Log
Enter Transaction Type = PN approval workflow and Transaction ID = Lease number
Click GO
7. Reference
Oracle® Approvals Management Implementation Guide
Oracle® Workflow Developer's Guide