Search Results is_asgmt_in_open_status

Overview

PA_ASSIGNMENT_UTILS is a server-side PL/SQL utility package owned by APPS that supports the Oracle Projects staffing and assignment subsystem in Oracle E-Business Suite 12.1.1 and 12.2.2. Its primary business function is to centralize validation, status determination, and attribute derivation logic for project assignments — the records that associate a resource (typically an employee or contingent worker) with a project role over a defined period. The package is part of the Project Resource Management layer and is classified under ETRM as an OTHER API rather than a public, supported interface.

The package operates largely against the assignment entity represented by PA_PROJECT_ASSIGNMENTS and its resource-level counterpart PA_RESOURCE_ASSIGNMENTS. It also interacts with team template structures, project status definitions, and competency data. Because it encapsulates rules that govern how an assignment may be created, staffed, cancelled, or transitioned between provisional and confirmed states, it is a foundational dependency for many other Project Resource Management packages; ETRM records that it is referenced by 21 other packages. The package header declares a set of global PL/SQL variables used as transient state holders across calls, including team template identifiers and name tokens, provisional and confirmed hour accumulators, and paired person/project/effective-date variables for assignments with and without a name.

Key Procedures and Functions

The package exposes 33 documented procedures and functions. Among the most notable:

• CHECK_STATUS_IS_IN_USE — Determines whether a given project status code is referenced by any assignment or assignment schedule, returning an in-use flag plus a return status and error message code. This guards against deleting or changing statuses that remain actively referenced.
• CHECK_STF_PRIORITYNAME_OR_CODE — The object associated with the user's search term. It validates a staffing priority against the accepted priority name or code during assignment processing, ensuring that only valid priority values are accepted for a resource assignment before the record is saved.
• VALIDATE_ASGMT_COMPETENCY — Validates competency values associated with a given assignment, taking a project identifier and assignment identifier and confirming that the competency data is consistent with the assignment definition.
• GET_DEF_ASGMT_STATUSES — Retrieves the default assignment statuses that apply when an assignment is created.
• GET_PROJECT_ID — Resolves the project identifier for a given assignment context.
• IS_CONFIRMED_STATUS / IS_PROVISIONAL_STATUS — Boolean-style predicates that classify an assignment status as confirmed or provisional.
• IS_ASGMT_FILLED / IS_ASGMT_IN_OPEN_STATUS / IS_OPEN_ASGMT_CANCELLED / IS_STAFFED_ASGMT_CANCELLED — State-evaluation predicates that test whether an assignment is filled, open, or in a cancelled condition for open versus staffed assignments.
• CHECK_INPUT_SYSTEM_STATUS / CHECK_PROJ_ASSIGNMENTS_EXIST / CHECK_ASSIGNMENT_NUMBER_OR_ID — Input and existence validators for system status values, for the presence of project assignments, and for resolving an assignment by number or identifier.
• IS_ASGMT_ALLOW_STUS_CTL_CHECK — Tests whether assignment status-control checks are permitted for the current assignment.
• GET_PERSON_ASGMT / GET_ASSIGNMENT_MEASURES — Retrieve a person's assignment and the calculated measures attached to an assignment.
• GET_ROLE_ACTIVITY_TEXT / GET_ROLE_ACTIVITY_DATE — Return descriptive text and dates describing role activity for an assignment.
• ADD_MESSAGE — Publishes a message, typically through the FND message stack, so that callers can surface validation failures to the user.

Tables Accessed

The package reads and writes a documented set of tables through APPS synonyms. Core assignment tables include PA_PROJECT_ASSIGNMENTS and PA_RESOURCE_ASSIGNMENTS, with supporting resource data drawn from PA_RESOURCES_DENORM. Project context is obtained from PA_PROJECTS_ALL and PA_PROJECT_PARTIES. Status validation relies on PA_PROJECT_STATUSES and PA_PROJECT_STATUS_CONTROLS. Team template information comes from PA_TEAM_TEMPLATES. Competency validation uses PER_COMPETENCES. Financial planning and forecasting dependencies include PA_FIN_PLAN_TYPES_B, PA_FORECAST_ITEMS, PA_PROJ_FP_OPTIONS and PA_FIN_PLAN_TYPES_B. PA_RESOURCE_TXN_ATTRIBUTES supplies additional resource transaction attributes, and PA_IMPLEMENTATIONS supports installation-level configuration checks. Message output is handled through FND_NEW_MESSAGES.

Usage Notes

PA_ASSIGNMENT_UTILS is invoked indirectly rather than as a standalone public API. It is called by Oracle Project Resource Management forms, by the assignment and staffing concurrent programs, and by the 21 dependent packages reported in ETRM. Custom code that needs to test assignment status, validate staffing priority values, or confirm assignment existence should call the relevant procedure or function rather than reimplementing the rules. Because the package is classified as OTHER and its header carries a version older than the current release, extensions should be limited to read-only validation calls; any replacement of the logic would need to preserve the assignment status-control and cancellation semantics that the Project Resource Management application depends upon.