AME Setups

This Post is going to describe how to use AME for Requisition approvals. Purchase requisition and Purchase orders can be approved using AME. AME Stands for Approval Management Engine.

We are going to perform the setup steps one by one and see a demo test case. We are going to perform this case on R12.1.3

Setup Steps

1) AME Profile Options
2) Assign AME Roles and Responsibilities
3) Grant Transaction Type Access to User
4) Create New Transaction Types
5) Approval Process Setup
6) Enable AME for Requisition Approval


Step 2) Assign AME Roles and Responsibilities

Navigate to User Management Responsibility > Users

Query for the User. In our case its Apps_User

Click on Update and then Assign Roles

Now Query for "Approvals%" and select "Approval Management Administrator" and "Approval Management Business Analyst"

Click Select

Put some justification and click apply. A message will be displayed "You have successfully updated the information "


Step 3) Grant Transaction Type Access to User

Next step is to Grant Transaction Type Access to User.

Navigate to Functional Administrator >Security > Grants> Create Grants

Fill In below Information in the next form

Name = Apps_User Grants
Grantee Type = Specific User
Grantee = Apps_User
Object = AME Transaction Types

Click On next

Data Context Type = All Rows
Click Next

Set = AME Calling Applications

Click Next and review and clicking on Finish will display "Grant '' has been created successfully."

Step 4) Create new Transaction Type

You can use existing transaction type also or can create your own. Lets Create a new Transaction type.

Navigate to Approval Management Administrator (This Responsibility will be available now because it was assigned in step 2) and Click On "Create Transaction Type"

Enter Information as shown below or create your own Transaction type

Click Next, Select Line Item from Drop Down and Click "Go"

Change the Order Number to 2

Post below in the query. I copied it from earlier Requisition approval transaction type.

select prd.distribution_id from po_req_distributions_all prd, 
po_requisition_lines_all prl
where prl.requisition_header_id = po_ame_setup_pvt.get_new_req_header_id(:transactionId) 
and prl.requisition_line_id = prd.requisition_line_id  
and nvl(prl.cancel_flag, 'N') = 'N' 
and nvl(prl.modified_by_agent_flag, 'N') = 'N' 
order by prd.distribution_id 

Click on Validate, a message will be displayed "The query is valid" and now click on "Apply".

Click on Next and enter the details as shown in below screenshot.

Click on Validate Button after entering each value. Below are the value. I copy pasted from seeded transaction type defined

ALLOW_DELETING_RULE_GENERATED_APPROVERS=
select decode(PO_AME_SETUP_PVT.is_system_approver_mandatory(:transactionId), 
'N', 'true', 'false') 
from dual 

ALLOW_REQUESTOR_APPROVAL=
select decode (PO_AME_SETUP_PVT.can_preparer_approve(:transactionId),
'Y', 'true', 'false') 
from dual

WORKFLOW_ITEM_KEY=
select wf_item_key  from   po_requisition_headers_all where  requisition_header_id = po_ame_setup_pvt.get_new_req_header_id(:transactionId)


WORKFLOW_ITEM_TYPE=
select wf_item_type from   po_requisition_headers_all where  requisition_header_id = po_ame_setup_pvt.get_new_req_header_id(:transactionId)

Now Click On next and Finish Button. A confirmation message will be displayed as "Transaction type Mandeep Purchase Requisition Approval has been created successfully."

Step 5) Approval Process Setup

Next is to define Attributes, Conditions, Actions Types, Approval Group, Rules etc

Navigate to Approval Management Business Analyst > Business Analyst Dashboard

In Approval Process Setup, Query for Transaction Type as "Mandeep Purchase Requisition Approval".

Attributes:

Next Click on Attributes. Click On "Use Existing Attributes"

Now select the attributes as shown below and click Go

Select REQUISTION_TOTAL and Click On Continue

Select Usage Type as Dynamic and Copy below sql there

SELECT nvl(SUM(decode(order_type_lookup_code, 'RATE', amount, 'FIXED PRICE', amount, quantity * unit_price)), 0), po_ame_setup_pvt.get_function_currency(max(requisition_header_id)), po_ame_setup_pvt.get_rate_type(max(requisition_header_id)) from po_requisition_lines_all where requisition_header_id = po_ame_setup_pvt.get_new_req_header_id(:transactionId) and nvl(cancel_flag, 'N') = 'N' and nvl(modified_by_agent_flag, 'N') = 'N' 

Click on Validate and then Finish will display a message "Attribute REQUISITION_TOTAL has been created successfully."

Similarly do same for Item category. Click on Use Existing Attributes. Select Attributes as shown below

Select Item Category and click Continue

Select Usage Type as Dynamic and Copy below sql there

select mck.concatenated_segments from mtl_categories_b_kfv mck, po_requisition_lines_all prl, po_req_distributions_all prd where mck.category_id = prl.category_id and prl.requisition_line_id = prd.requisition_line_id and prl.requisition_header_id = po_ame_setup_pvt.get_new_req_header_id(:transactionId) order by prd.distribution_id


Also Add Below Attributes for selecting action types

TRANSACTION_REQUESTOR_PERSON_ID(Required for Supervisory level Action Type)

select nvl(PREPARER_ID, 0) from po_requisition_headers_all where REQUISITION_HEADER_ID = po_ame_setup_pvt.get_new_req_header_id(:transactionId)

And Now add

ALLOW_EMPTY_APPROVAL_GROUPS(Required for approval-group chain of authority Action Type)

Conditions:

Next is to specify Conditions. Click on Setups> Conditions > then click on Create

Condition for Item Category

Condition for Requisition Total

Action Types

Now click on action types and select use existing actions

Select below value and click Continue

• Supervisory level
• Approval-Group Chain of authority

and click on Finish "The selected action types have been added successfully."

Approver Groups

Now click on Approver Groups and click on Create Button.

Enter Name, description , Order number, Voting Method. and add approvers

Click Apply. Similarly create other approver groups.

Give order number

AME Rule Setups

Now ;lets use condition and approver groups to create rules. Click on Rule

Click on Create.

Enter Rule details like Name, End date will automatically come and you can change it also. Click Next and Add Conditions.

Select Conditions which is created earlier or use from exiting conditions. Click Continue. You can add more conditions here and then click next and add actions

Click Next and Review

Click on Finish "Rule Supervisior has been created successfully".

Similarly create rule for Item Category Condition

Click Finish "Rule Item Category has been created successfully."

Step 6) Enable AME for Requisition Approval

Next step is to enable AME for requisition approval.

Navigate to Purchasing super user>Setup>Purchasing>Document Type and search for Purchase requisition

Add "Mandeep_Purchase_REQ" in Approval Transaction Type and save

This complete our AME setups.

References:
http://mandeeporacle.blogspot.com/2014/05/ame-setups.html