Search Results ams_gen_approval_pvt
Overview
APPS.AMS_GEN_APPROVAL_PVT is a private (PVT) PL/SQL package within the Oracle E-Business Suite Marketing (AMS) application, responsible for orchestrating the generic approval workflow used across Oracle Marketing and Trade Management objects. It provides the procedural backbone that determines whether a given business object — such as a campaign, event, fund, claim, or budget — requires approval routing, and it manages the full lifecycle of that approval: initiating the workflow, resolving approvers according to seeded rules, presenting approval notifications, and updating the underlying object status upon approval, rejection, or abort.
The package is declared with AUTHID CURRENT_USER, indicating that it executes with the privileges of the invoking session rather than the defining schema, which is significant because much of its work is driven through Oracle Workflow callbacks. The package is tightly coupled to the AMS_APPROVAL_PVT workflow item type and is invoked directly from workflow function activities, most notably AMS_GET_APPROVER_DETAILS. It is referenced by sixteen other packages, confirming its role as a shared, low-level utility rather than a standalone entry point.
Key Procedures and Functions
The package exposes twenty-six documented procedures and functions. The most prominent are grouped as follows:
- CHECK_PROCESS_TYPE — the workflow-callable wrapper that evaluates whether a line or object requires further approval, returning a result such as
COMPLETE:YorCOMPLETE:Nto direct the workflow branch. - STARTPROCESS — initiates the approval flow for an object (identified by approval object type, object ID, and object version number) transitioning it from an original user status to a new user status.
- SET_ACTIVITY_DETAILS, SET_APPROVER_DETAILS, SET_FURTHER_APPROVALS — populate workflow activity attributes and resolve the set of approvers and any subsequent approval steps.
- GET_APPROVAL_DETAILS, GET_API_NAME — retrieve approval configuration and the relevant underlying API name for the object being processed.
- PREPARE_DOC, UPDATE_STATUS, APPROVED_UPDATE_STATUS, REJECT_UPDATE_STATUS, REVERT_STATUS — prepare the document and apply the correct status transitions for approved, rejected, or reverted outcomes.
- ABORTPROCESS — terminates an in-flight approval flow.
- Notification procedures — NTF_APPROVAL, NTF_APPROVAL_REMINDER, NTF_FORWARD_FYI, NTF_APPROVED_FYI, NTF_REJECTED_FYI, and NTF_REQUESTOR_OF_ERROR deliver the workflow messages associated with each approval event.
- DYNTST — a dynamic testing utility.
Tables Accessed
The package reads and writes a well-defined set of AMS, OZF, and JTF tables through APPS synonyms:
- AMS_APPROVAL_DETAILS, AMS_APPROVERS, AMS_OBJECT_RULES_B, AMS_ACT_BUDGETS — approval configuration, approver assignment, object-level approval rules, and activity budgets.
- OZF_CLAIMS_ALL, OZF_CLAIM_LINES_ALL, OZF_FUNDS_ALL_B — Trade Management claim, claim line, and fund records whose approval status is being managed.
- FND_USER, JTF_RS_ROLES_B, JTF_RS_ROLE_RELATIONS — user, role, and role-hierarchy resolution used to determine valid approvers.
Usage Notes
This is an internal (PVT) package and should not be called directly from custom code; Oracle does not guarantee its signature across patches. It is invoked primarily by the Oracle Workflow engine as function activities within the AMS_APPROVAL_PVT item type, where it governs branching logic and notification generation. Because it is referenced by sixteen other packages, changes to its behavior propagate broadly across Marketing and Trade Management approval flows. When troubleshooting check_line_further_approval, verify the workflow activity definition, the item type, and the AMS_OBJECT_RULES_B configuration, since the Resultout value returned to the workflow depends on those seeded records.
-
PACKAGE: APPS.AMS_GEN_APPROVAL_PVT
12.1.1
owner:APPS, object_type:PACKAGE, object_name:AMS_GEN_APPROVAL_PVT, status:VALID,
-
PACKAGE BODY: APPS.AMS_GEN_APPROVAL_PVT
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:AMS_GEN_APPROVAL_PVT, status:VALID,
-
PACKAGE: APPS.AMS_GEN_APPROVAL_PVT
12.2.2
owner:APPS, object_type:PACKAGE, object_name:AMS_GEN_APPROVAL_PVT, status:VALID,
-
PACKAGE BODY: APPS.AMS_GEN_APPROVAL_PVT
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:AMS_GEN_APPROVAL_PVT, status:VALID,
-
SYNONYM: APPS.AMS_OBJECT_RULES_B
12.2.2
owner:APPS, object_type:SYNONYM, object_name:AMS_OBJECT_RULES_B, status:VALID,
-
PACKAGE: APPS.AMS_APPR_HIST_PVT
12.1.1
owner:APPS, object_type:PACKAGE, object_name:AMS_APPR_HIST_PVT, status:VALID,
-
PACKAGE BODY: APPS.OZF_PRICELIST_APPROVAL_PVT
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:OZF_PRICELIST_APPROVAL_PVT, status:VALID,
-
PACKAGE BODY: APPS.OZF_FUND_APPROVAL_PVT
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:OZF_FUND_APPROVAL_PVT, status:VALID,
-
SYNONYM: APPS.AMS_ACT_BUDGETS
12.2.2
owner:APPS, object_type:SYNONYM, object_name:AMS_ACT_BUDGETS, status:VALID,
-
SYNONYM: APPS.AMS_OBJECT_RULES_B
12.1.1
owner:APPS, object_type:SYNONYM, object_name:AMS_OBJECT_RULES_B, status:VALID,
-
SYNONYM: APPS.AMS_ACT_BUDGETS
12.1.1
owner:APPS, object_type:SYNONYM, object_name:AMS_ACT_BUDGETS, status:VALID,
-
PACKAGE: APPS.AMS_APPR_HIST_PVT
12.2.2
owner:APPS, object_type:PACKAGE, object_name:AMS_APPR_HIST_PVT, status:VALID,
-
PACKAGE BODY: APPS.OZF_FUND_REQUEST_APR_PVT
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:OZF_FUND_REQUEST_APR_PVT, status:VALID,
-
PACKAGE BODY: APPS.OZF_PRICELIST_PVT
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:OZF_PRICELIST_PVT, status:VALID,
-
PACKAGE BODY: APPS.OZF_CLAIM_APPROVAL_PVT
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:OZF_CLAIM_APPROVAL_PVT, status:VALID,
-
SYNONYM: APPS.AMS_APPROVAL_DETAILS
12.1.1
owner:APPS, object_type:SYNONYM, object_name:AMS_APPROVAL_DETAILS, status:VALID,
-
SYNONYM: APPS.AMS_APPROVERS
12.2.2
owner:APPS, object_type:SYNONYM, object_name:AMS_APPROVERS, status:VALID,
-
PACKAGE BODY: APPS.AMS_GENERIC_NTFY_PVT
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:AMS_GENERIC_NTFY_PVT, status:VALID,
-
SYNONYM: APPS.AMS_APPROVERS
12.1.1
owner:APPS, object_type:SYNONYM, object_name:AMS_APPROVERS, status:VALID,
-
SYNONYM: APPS.AMS_APPROVAL_DETAILS
12.2.2
owner:APPS, object_type:SYNONYM, object_name:AMS_APPROVAL_DETAILS, status:VALID,
-
PACKAGE: APPS.AMS_OBJECTATTRIBUTE_PVT
12.2.2
owner:APPS, object_type:PACKAGE, object_name:AMS_OBJECTATTRIBUTE_PVT, status:VALID,
-
PACKAGE: APPS.AMS_OBJECTATTRIBUTE_PVT
12.1.1
owner:APPS, object_type:PACKAGE, object_name:AMS_OBJECTATTRIBUTE_PVT, status:VALID,
-
PACKAGE BODY: APPS.AMS_GENERIC_NTFY_PVT
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:AMS_GENERIC_NTFY_PVT, status:VALID,
-
PACKAGE BODY: APPS.OZF_PRICELIST_APPROVAL_PVT
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:OZF_PRICELIST_APPROVAL_PVT, status:VALID,
-
PACKAGE BODY: APPS.OZF_OFFERADJ_APPROVAL_PVT
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:OZF_OFFERADJ_APPROVAL_PVT, status:VALID,
-
PACKAGE BODY: APPS.OZF_FUNDS_PVT
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:OZF_FUNDS_PVT, status:VALID,
-
PACKAGE BODY: APPS.OZF_FUNDS_PVT
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:OZF_FUNDS_PVT, status:VALID,
-
PACKAGE BODY: APPS.OZF_FUND_APPROVAL_PVT
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:OZF_FUND_APPROVAL_PVT, status:VALID,
-
PACKAGE BODY: APPS.OZF_OFFERADJ_APPROVAL_PVT
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:OZF_OFFERADJ_APPROVAL_PVT, status:VALID,
-
PACKAGE BODY: APPS.OZF_OFFER_ADJUSTMENT_PVT
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:OZF_OFFER_ADJUSTMENT_PVT, status:VALID,
-
PACKAGE BODY: APPS.OZF_OFFER_ADJUSTMENT_PVT
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:OZF_OFFER_ADJUSTMENT_PVT, status:VALID,
-
PACKAGE BODY: APPS.OZF_FUND_REQUEST_APR_PVT
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:OZF_FUND_REQUEST_APR_PVT, status:VALID,
-
SYNONYM: APPS.OZF_CLAIM_LINES_ALL
12.1.1
owner:APPS, object_type:SYNONYM, object_name:OZF_CLAIM_LINES_ALL, status:VALID,
-
PACKAGE BODY: APPS.OZF_PRICELIST_PVT
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:OZF_PRICELIST_PVT, status:VALID,
-
PACKAGE BODY: APPS.OZF_CLAIM_APPROVAL_PVT
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:OZF_CLAIM_APPROVAL_PVT, status:VALID,
-
PACKAGE BODY: APPS.PV_PARTNER_PROGRAM_PVT
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:PV_PARTNER_PROGRAM_PVT, status:VALID,
-
PACKAGE BODY: APPS.OZF_MASS_SETTLEMENT_PVT
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:OZF_MASS_SETTLEMENT_PVT, status:VALID,
-
SYNONYM: APPS.OZF_CLAIM_LINES_ALL
12.2.2
owner:APPS, object_type:SYNONYM, object_name:OZF_CLAIM_LINES_ALL, status:VALID,
-
PACKAGE BODY: APPS.OZF_OFFER_BACKDATE_PVT
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:OZF_OFFER_BACKDATE_PVT, status:VALID,
-
PACKAGE BODY: APPS.OZF_OFFER_BACKDATE_PVT
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:OZF_OFFER_BACKDATE_PVT, status:VALID,
-
PACKAGE BODY: APPS.OZF_CLAIM_SETTLEMENT_PVT
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:OZF_CLAIM_SETTLEMENT_PVT, status:VALID,
-
PACKAGE BODY: APPS.OZF_ACTBUDGETS_PVT
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:OZF_ACTBUDGETS_PVT, status:VALID,
-
PACKAGE BODY: APPS.OZF_ACTBUDGETS_PVT
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:OZF_ACTBUDGETS_PVT, status:VALID,
-
PACKAGE BODY: APPS.OZF_MASS_SETTLEMENT_PVT
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:OZF_MASS_SETTLEMENT_PVT, status:VALID,
-
PACKAGE BODY: APPS.OZF_CLAIM_SETTLEMENT_PVT
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:OZF_CLAIM_SETTLEMENT_PVT, status:VALID,
-
SYNONYM: APPS.OZF_FUNDS_ALL_B
12.1.1
owner:APPS, object_type:SYNONYM, object_name:OZF_FUNDS_ALL_B, status:VALID,
-
SYNONYM: APPS.OZF_CLAIMS_ALL
12.1.1
owner:APPS, object_type:SYNONYM, object_name:OZF_CLAIMS_ALL, status:VALID,
-
PACKAGE BODY: APPS.AMS_APPROVAL_PVT
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:AMS_APPROVAL_PVT, status:VALID,
-
PACKAGE BODY: APPS.PV_PRGM_APPROVAL_PVT
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:PV_PRGM_APPROVAL_PVT, status:VALID,
-
PACKAGE BODY: APPS.AMS_APPROVAL_PVT
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:AMS_APPROVAL_PVT, status:VALID,