Search Results amw_utility_pvt
Overview
AMW_UTILITY_PVT is the private utility package body for the Oracle E-Business Suite Audit Management (AMW) module, part of the Governance, Risk, and Compliance (GRC) product family. In EBS 12.1.1 and 12.2.2, the AMW schema family supports internal audit planning, audit project execution, risk and control assessment, and opinion tracking. AMW_UTILITY_PVT centralizes the low-level helper logic that the public AMW APIs depend on, which is why it is classified as a PVT (private) API package — it is not intended as a public integration surface, but rather as the shared internal toolbox for the module.
The package has a status of VALID in the APPS schema and is instantiated as a PACKAGE BODY. ETRM documentation records 51 documented procedures and functions, and the package is referenced by 42 other database objects. Notably, AMW_UTILITY_PVT is not referenced by any database object upward — it is a leaf consumer of AMW, FND, WF, ENG, and XDO infrastructure, not a provider to them.
Key Procedures and Functions
The 51 documented routines fall into four functional clusters.
- Data validation and integrity: CHECK_FK_EXISTS verifies foreign key referential integrity before a dependent record is created; CHECK_LOOKUP_EXISTS validates that a value exists in the relevant lookup; CHECK_UNIQUENESS enforces single-occurrence constraints; IS_Y_OR_N indicates the boolean-style "Y"/"N" convention used throughout AMW tables; FIND_HIERARCHY_LEVEL resolves the position of an entity within an AMW hierarchy.
- Messaging, logging, and diagnostics: DEBUG_MESSAGE, ERROR_MESSAGE, and DISPLAY_MESSAGES manage the runtime message stack via FND_MSG_PUB and FND_LOG. SEND_WF_STANDALONE_MESSAGE dispatches an Oracle Workflow notification outside of a running workflow process. GET_MESSAGE_TEXT retrieves the text of a stored message.
- Lookup and descriptive retrieval: GET_LOOKUP_MEANING returns the meaning for a lookup code; GET_LOB_MEANING resolves Line of Business; GET_PROCESS_NAME, GET_RISK_NAME, GET_CONTROL_NAME, and GET_ORGANIZATION_NAME return display names for the corresponding AMW entities; GET_EMPLOYEE_NAME resolves an employee's name for display.
- Process and opinion utilities: WAIT_FOR_REQ polls or blocks on a concurrent request; GET_PROC_ORG_OPINION_STATUS and GET_PROC_ORG_OPINION_DATE return the audit opinion status and date for a process/organization pair. These support the opinion engine that AMW uses to summarize audit results.
Parameter lists are intentionally omitted here; the routines are described by purpose only.
Tables Accessed
The package reads and writes a broad set of AMW base and view objects through APPS synonyms. Key base tables include AMW_AUDIT_PROJECTS (audit project headers), AMW_CONTROL_ASSOCIATIONS (linkages between controls and other entities), AMW_EXCEPTIONS_B and AMW_EXCEPTIONS_TL (exception headers and translated text), AMW_EXCEPTIONS_REASONS (exception rationale), AMW_EXECUTION_SCOPE (scope definitions for audit execution), AMW_LATEST_HIERARCHIES (current hierarchy snapshots), AMW_OBJECTIVE_ASSOCIATIONS (objective linkages), AMW_OBJECT_OPINION_TYPES (opinion type mapping), AMW_OPINION_TYPES_B (opinion type definitions), AMW_PARAMETERS (module configuration), AMW_PROCESS (process headers), AMW_PROCESS_LOCKS (concurrency control on processes), AMW_PROCESS_NAMES_TL (translated process names), and AMW_PROCESS_ORGANIZATION (process-to-organization mapping).
It also joins a large set of AMW views — including AMW_AUDIT_UNITS_V, AMW_CONTROLS_ALL_VL, AMW_EMPLOYEES_CURRENT_V, AMW_OPINIONS_V, AMW_PROCESS_OBJECTIVES_VL, AMW_PROCESS_VL, AMW_RISKS_ALL_VL, and AMW_PROC_HIERARCHY_DENORM — reflecting its role as a cross-cutting utility layer. FND infrastructure objects (FND_MESSAGE, FND_MSG_PUB, FND_LOG, FND_PROFILE, FND_REQUEST, FND_CONCURRENT, FND_LOOKUP_VALUES, FND_FLEX_VALUES) supply messaging, concurrency, profile, and flexfield services. Workflow (WF_NOTIFICATION, WF_ACTIVITIES, WF_DIRECTORY), engineering change (ENG_ENGINEERING_CHANGES, ENG_CHANGE_SUBJECTS), and XDO_TEMPLATES_B are also referenced.
Usage Notes
AMW_UTILITY_PVT is invoked indirectly by the public AMW APIs and by the Audit Management OAF pages and concurrent programs that call those APIs. It is not exposed to end users and should not be called directly from custom code, because its signatures are not part of the supported public interface and may change between point releases. Customizations that require AMW validation, messaging, or lookup resolution should instead call the corresponding public AMW package procedures. The presence of FND_LOG and FND_MSG_PUB references means AMW_UTILITY_PVT participates in standard EBS logging and message-stack handling, so its DEBUG_MESSAGE and ERROR_MESSAGE routines will honor the current FND_LOG level and FND profile settings. Because the package is not referenced by any database object, it can be recompiled at any time without invalidating dependents, but changes to its body are still subject to Oracle's standard patching and licensing terms.
-
PACKAGE BODY: APPS.AMW_UTILITY_PVT
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:AMW_UTILITY_PVT, status:VALID,
-
PACKAGE: APPS.AMW_UTILITY_PVT
12.1.1
owner:APPS, object_type:PACKAGE, object_name:AMW_UTILITY_PVT, status:VALID,
-
SYNONYM: APPS.AMW_EXCEPTIONS_TL
12.1.1
owner:APPS, object_type:SYNONYM, object_name:AMW_EXCEPTIONS_TL, status:VALID,
-
SYNONYM: APPS.AMW_EXCEPTIONS_REASONS
12.1.1
owner:APPS, object_type:SYNONYM, object_name:AMW_EXCEPTIONS_REASONS, status:VALID,
-
SYNONYM: APPS.ENG_CHANGE_SUBJECTS
12.1.1
owner:APPS, object_type:SYNONYM, object_name:ENG_CHANGE_SUBJECTS, status:VALID,
-
PACKAGE BODY: APPS.AMW_CREATE_LINES_PKG
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:AMW_CREATE_LINES_PKG, status:VALID,
-
SYNONYM: APPS.AMW_PROCESS_LOCKS
12.1.1
owner:APPS, object_type:SYNONYM, object_name:AMW_PROCESS_LOCKS, status:VALID,
-
SYNONYM: APPS.AMW_PARAMETERS
12.1.1
owner:APPS, object_type:SYNONYM, object_name:AMW_PARAMETERS, status:VALID,
-
SYNONYM: APPS.AMW_EXCEPTIONS_B
12.1.1
owner:APPS, object_type:SYNONYM, object_name:AMW_EXCEPTIONS_B, status:VALID,
-
PACKAGE BODY: APPS.AMW_EVALUATIONS_PKG
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:AMW_EVALUATIONS_PKG, status:VALID,
-
SYNONYM: APPS.AMW_AUDIT_PROJECTS
12.1.1
owner:APPS, object_type:SYNONYM, object_name:AMW_AUDIT_PROJECTS, status:VALID,
-
SYNONYM: APPS.AMW_PROCESS_NAMES_TL
12.1.1
owner:APPS, object_type:SYNONYM, object_name:AMW_PROCESS_NAMES_TL, status:VALID,
-
SYNONYM: APPS.AMW_PROC_HIERARCHY_DENORM
12.1.1
owner:APPS, object_type:SYNONYM, object_name:AMW_PROC_HIERARCHY_DENORM, status:VALID,
-
SYNONYM: APPS.AMW_PROCESS_ORGANIZATION
12.1.1
owner:APPS, object_type:SYNONYM, object_name:AMW_PROCESS_ORGANIZATION, status:VALID,
-
PACKAGE BODY: APPS.AMW_ATTACHMENT_PVT
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:AMW_ATTACHMENT_PVT, status:VALID,
-
PACKAGE: APPS.AMW_RISK_PVT
12.1.1
owner:APPS, object_type:PACKAGE, object_name:AMW_RISK_PVT, status:VALID,
-
PACKAGE BODY: APPS.AMW_RL_HIERARCHY_PKG
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:AMW_RL_HIERARCHY_PKG, status:VALID,
-
SYNONYM: APPS.AMW_OBJECT_OPINION_TYPES
12.1.1
owner:APPS, object_type:SYNONYM, object_name:AMW_OBJECT_OPINION_TYPES, status:VALID,
-
PACKAGE BODY: APPS.AMW_PROCESS_PVT
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:AMW_PROCESS_PVT, status:VALID,
-
PACKAGE BODY: APPS.AMW_AP_APPROVAL_PVT
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:AMW_AP_APPROVAL_PVT, status:VALID,
-
PACKAGE BODY: APPS.AMW_RISK_PVT
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:AMW_RISK_PVT, status:VALID,
-
SYNONYM: APPS.AMW_OPINION_TYPES_B
12.1.1
owner:APPS, object_type:SYNONYM, object_name:AMW_OPINION_TYPES_B, status:VALID,
-
SYNONYM: APPS.AMW_LATEST_HIERARCHIES
12.1.1
owner:APPS, object_type:SYNONYM, object_name:AMW_LATEST_HIERARCHIES, status:VALID,
-
PACKAGE: APPS.AMW_AUDIT_PROCEDURES_PVT
12.1.1
owner:APPS, object_type:PACKAGE, object_name:AMW_AUDIT_PROCEDURES_PVT, status:VALID,
-
PACKAGE BODY: APPS.AMW_RISK_TYPE_PVT
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:AMW_RISK_TYPE_PVT, status:VALID,
-
PACKAGE BODY: APPS.AMW_ASSOC_POST_TXN
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:AMW_ASSOC_POST_TXN, status:VALID,
-
PACKAGE BODY: APPS.AMW_LOAD_CONSTRAINT_DATA
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:AMW_LOAD_CONSTRAINT_DATA, status:VALID,
-
PACKAGE BODY: APPS.AMW_PROC_APPROVAL_PKG
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:AMW_PROC_APPROVAL_PKG, status:VALID,
-
PACKAGE BODY: APPS.AMW_CONTROL_PVT
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:AMW_CONTROL_PVT, status:VALID,
-
PACKAGE BODY: APPS.AMW_EXCEPTIONS_PKG
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:AMW_EXCEPTIONS_PKG, status:VALID,
-
SYNONYM: APPS.AMW_OBJECTIVE_ASSOCIATIONS
12.1.1
owner:APPS, object_type:SYNONYM, object_name:AMW_OBJECTIVE_ASSOCIATIONS, status:VALID,
-
PACKAGE BODY: APPS.AMW_PROCESS_OBJECTIVES_B_PKG
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:AMW_PROCESS_OBJECTIVES_B_PKG, status:VALID,
-
SYNONYM: APPS.AMW_PROCESS
12.1.1
owner:APPS, object_type:SYNONYM, object_name:AMW_PROCESS, status:VALID,
-
PACKAGE BODY: APPS.AMW_RISK_APPROVAL_PVT
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:AMW_RISK_APPROVAL_PVT, status:VALID,
-
PACKAGE BODY: APPS.AMW_PARAMETERS_PVT_PKG
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:AMW_PARAMETERS_PVT_PKG, status:VALID,
-
PACKAGE BODY: APPS.AMW_CTRL_APPROVAL_PVT
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:AMW_CTRL_APPROVAL_PVT, status:VALID,
-
PACKAGE BODY: APPS.AMW_LOAD_KEY_ACC_DATA
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:AMW_LOAD_KEY_ACC_DATA, status:VALID,
-
PACKAGE BODY: APPS.AMW_CONTROLS_PAGE_PKG
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:AMW_CONTROLS_PAGE_PKG, status:VALID,
-
PACKAGE BODY: APPS.AMW_PROC_ORG_HIERARCHY_PVT
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:AMW_PROC_ORG_HIERARCHY_PVT, status:VALID,
-
PACKAGE BODY: APPS.AMW_LOAD_RCM_ORG_DATA
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:AMW_LOAD_RCM_ORG_DATA, status:VALID,
-
SYNONYM: APPS.XDO_TEMPLATES_B
12.1.1
owner:APPS, object_type:SYNONYM, object_name:XDO_TEMPLATES_B, status:VALID,
-
PACKAGE BODY: APPS.AMW_LOAD_CTRL_DATA
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:AMW_LOAD_CTRL_DATA, status:VALID,
-
PACKAGE BODY: APPS.AMW_AUDIT_PROCEDURES_PVT
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:AMW_AUDIT_PROCEDURES_PVT, status:VALID,
-
PACKAGE BODY: APPS.AMW_PROC_ORG_APPROVAL_PKG
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:AMW_PROC_ORG_APPROVAL_PKG, status:VALID,
-
PACKAGE BODY: APPS.AMW_GEN_APPROVAL_PVT
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:AMW_GEN_APPROVAL_PVT, status:VALID,
-
SYNONYM: APPS.WF_ACTIVITIES_TL
12.1.1
owner:APPS, object_type:SYNONYM, object_name:WF_ACTIVITIES_TL, status:VALID,
-
PACKAGE BODY: APPS.AMW_LOAD_AP_DATA
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:AMW_LOAD_AP_DATA, status:VALID,
-
PACKAGE BODY: APPS.AMW_LOAD_AUDIT_PROCEDURE_DATA
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:AMW_LOAD_AUDIT_PROCEDURE_DATA, status:VALID,
-
VIEW: APPS.AMW_PROCESS_ORG_HIERARCHY_V
12.1.1
owner:APPS, object_type:VIEW, fnd_design_data:AMW.AMW_PROCESS_ORG_HIERARCHY_V, object_name:AMW_PROCESS_ORG_HIERARCHY_V, status:VALID,
-
SYNONYM: APPS.AMW_EXECUTION_SCOPE
12.1.1
owner:APPS, object_type:SYNONYM, object_name:AMW_EXECUTION_SCOPE, status:VALID,