Search Results validate_attribute_change

Overview

PA_PROJECT_UTILS2 is a server-side PL/SQL utility package owned by the APPS schema in Oracle E-Business Suite. In the ETRM 12.2.2 documentation it is classified as an OTHER API, meaning it is not a public, formally supported integration interface but rather an internal utility library that supports a wide range of Projects (PA) module functionality. Its role is to centralize common validation and lookup logic used repeatedly across project maintenance, project status processing, resource management, purging, and assignment handling. The package is marked VALID and holds both a package specification and package body.

The package's central purpose is to provide reusable validation and retrieval routines for project records. Rather than duplicating project-level checks in each consuming package, the Projects module delegates these operations to PA_PROJECT_UTILS2, which enforces consistent behavior for project attribute changes, project number/ID resolution, and business group derivation. A secondary, workflow-related function supports abort processing.

Key Procedures and Functions

• VALIDATE_ATTRIBUTE_CHANGE — Validates whether a requested change to a project attribute is permitted. It is the package's primary business-rule enforcement routine, used to prevent modifications that violate project configuration or status constraints.
• GET_PROJECT_BUSINESS_GROUP — Retrieves the business group associated with a project. Business group is a critical multi-organization construct in EBS, and this function supplies the correct operating unit/business group context for downstream processing.
• CHECK_PROJECT_NUMBER_OR_ID — Resolves or verifies a project using either its project number or its internal project ID. This supports callers that must accept either identifier and confirm its existence or validity.
• ABORTWORKFLOW — Handles abort logic for the workflow process associated with project processing, allowing a workflow instance to be terminated when project operations cannot proceed.

Tables Accessed

The package reads and writes a focused set of Projects and HR tables, accessed through APPS synonyms:

• PA_PROJECTS_ALL — The master project table; used for project attribute and identifier validation and to derive project context.
• HR_ORGANIZATION_INFORMATION — Supplies organization-level attributes needed to determine business group information.
• PA_PROJECT_TYPES_ALL and PA_PROJECT_TYPES — Provide project type definitions used when validating attribute changes against type configuration.
• PA_PROJECT_STATUSES and PA_OBJ_STATUS_CHANGES — Support status-related validation and tracking of project status transitions.
• PA_CI_COMMENTS — Stores comments associated with project changes or status events.
• PA_IMPLEMENTATIONS_ALL — Provides installation/implementation context used by the validation logic.
• PA_WF_PROCESSES — Holds workflow process information used by the abort-workflow routine.

Usage Notes

PA_PROJECT_UTILS2 is an internal utility package and is not intended as a supported public API. It is invoked by numerous Projects packages, including PA_PROJECT_PUB, PA_PROJECT_PVT, PA_PROJECTS_MAINT_PVT, PA_ASSIGNMENTS_PUB, PA_ASSIGNMENT_UTILS, PA_RES_MANAGEMENT_AMG_PUB, PA_PROJECT_STUS_UTILS, PA_PROJ_TEMPLATE_SETUP_PVT, PA_MU_BATCHES_V_PKG, and the PA_PURGE family of packages (including PA_PURGE_VALIDATE, PA_PURGE_COSTING, PA_PURGE_BILLING, PA_PURGE_ICIP, and PA_PURGE_PJR_TXNS). These consumer packages are in turn called from project maintenance forms, concurrent programs, and workflow-driven processes.

Because the package is listed as referenced by 24 other packages, it sits near the core of the Projects dependency graph. Customizations should call the supported public APIs (such as PA_PROJECT_PUB) rather than invoking PA_PROJECT_UTILS2 directly, since its procedures and signatures are not guaranteed to remain stable across patches or releases. It is best treated as a functional dependency to be documented and monitoring during upgrades rather than a customization target.