Search Results pnp_util_func
Overview
PNP_UTIL_FUNC is a utility package body in the APPS schema that supports Oracle Property Manager (PNP), the EBS module used to administer real estate leases, properties, locations, space assignments, and related payment obligations. The package encapsulates a broad set of reusable calculations and lookups that are required by Property Manager forms, concurrent programs, and dependent PL/SQL packages. Its status is VALID in both the 12.1.1 and 12.2.2 releases, and the ETRM metadata classifies its API type as OTHER, reflecting that it is an internal helper package rather than a formally published public API.
The package is not referenced by any database object, but it is referenced by approximately 51 other packages. This asymmetrical dependency profile confirms that PNP_UTIL_FUNC functions as a shared service layer: consumers such as PN_SPACE_ASSIGN_CUST_PKG and PN_SPACE_ASSIGN_EMP_PKG call into it for validation, date derivation, and occupancy computations. It also depends internally on PNP_DEBUG_PKG and PN_MO_CACHE_UTILS, indicating that it participates in debug tracing and cache management within the Property Manager codebase.
Key Procedures and Functions
The documented interface exposes 122 procedures and functions. The following are representative of the principal functional groupings.
- Lease termination validation: VALIDATE_LEASE_TERMINATE_DATE and MIN_LEASE_TERMINATE_DATE constrain the earliest permissible termination date for a lease, supporting data integrity when lease records are amended or terminated.
- Item end-date handling: ITEM_END_DATE and FETCH_ITEM_END_DATES resolve the effective end date of payment items and related lease items, which drives billing and accrual processing.
- Payment aggregation: GET_TOTAL_PAYMENT_ITEM_AMT and GET_TOTAL_PAYMENT_TERM_AMT compute total amounts across payment items and payment terms respectively.
- Term existence check: NORM_TRM_EXSTS determines whether a normalized payment term exists for a given context.
- Address construction: GET_CONCATENATED_ADDRESS builds a formatted address string from the underlying location and address components.
- Space and occupancy metrics: GET_VACANT_AREA, GET_VACANT_AREA_PERCENT, GET_LOAD_FACTOR, GET_UTILIZED_CAPACITY, GET_VACANCY, GET_OCCUPANCY_PERCENT, GET_TOTAL_LEASED_AREA, and GET_AREA_UTILIZED provide the quantitative measures used in property and space reporting.
- Hierarchy retrieval: GET_FLOORS and GET_OFFICES return floor and office hierarchies associated with a property.
- Status and reference lookups: GET_LEASE_STATUS returns the current lease status; PN_DISTINCT_ZIP_CODE derives distinct postal codes from location data.
Tables Accessed
The package reads and writes Property Manager base tables through APPS synonyms. Lease and tenancy data is drawn from PN_LEASES_ALL, PN_LEASE_CHANGES_ALL, and PN_TENANCIES_ALL. Financial schedules and terms are sourced from PN_PAYMENT_ITEMS_ALL, PN_PAYMENT_SCHEDULES_ALL, PN_PAYMENT_TERMS_ALL, PN_TERM_TEMPLATES_ALL, PN_VAR_ABATEMENTS_ALL, PN_VAR_RENTS_ALL, and PN_VAR_RENT_INV_ALL. Property and space structures are represented by PN_PROPERTIES_ALL, PN_LOCATIONS, PN_LOCATIONS_ALL, PN_LOCATIONS_S, PN_LOCATION_PARKS, PN_SPACE_ASSIGN_CUST_ALL, and PN_SPACE_ASSIGN_EMP_ALL. Addresses are resolved through PN_ADDRESSES_ALL, and currency context through PN_CURRENCIES.
Cross-module lookups depend on Oracle Payables (AP_TERMS, AP_DISTRIBUTION_SETS, AP_DISTRIBUTION_SETS_ALL), Receivables (RA_CUST_TRX_TYPES, RA_RULES, RA_SALESREPS, RA_TERMS), Projects (PA_PROJECTS_ALL, PA_TASKS, PA_ORGANIZATIONS_EXPEND_V, PA_TASKS_EXPEND_V), General Ledger (GL_PERIODS, GL_PERIOD_STATUSES, GL_SETS_OF_BOOKS, GL_CURRENCY_API), and Human Resources (PER_ALL_ASSIGNMENTS_F, PER_ALL_PEOPLE_F, PER_JOBS, PER_PERSON_TYPES_TL, PER_PHONES, HR_ORGANIZATION_UNITS, HR_LOOKUPS). FND_API, FND_FLEX_APIS, FND_MESSAGE, FND_GLOBAL, FND_LOOKUPS, and FND_TERRITORIES_VL supply application framework services. Dynamic SQL is executed via DBMS_SQL against DUAL and STANDARD.
Usage Notes
PNP_UTIL_FUNC is typically invoked indirectly. Property Manager forms call the dependent space assignment and lease packages, which in turn call PNP_UTIL_FUNC for validation and computation. Concurrent programs that generate lease abstracts, occupancy reports, or billing schedules rely on the same inner functions. Because the package is referenced by 51 other packages but is itself unreferenced, customizations should treat it as an internal implementation detail; direct invocation is possible from custom PL/SQL but is not supported by Oracle. Developers extending Property Manager should prefer the higher-level callers and should be aware that the package performs cross-module lookups into AP, AR, GL, PA, and HR, so performance is sensitive to the setup of those modules.
-
SYNONYM: APPS.PN_CURRENCIES
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PN_CURRENCIES, status:VALID,
-
SYNONYM: APPS.PN_SPACE_ASSIGN_CUST_ALL
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PN_SPACE_ASSIGN_CUST_ALL, status:VALID,
-
SYNONYM: APPS.PN_CURRENCIES
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PN_CURRENCIES, status:VALID,
-
SYNONYM: APPS.PN_LOCATION_PARKS
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PN_LOCATION_PARKS, status:VALID,
-
SYNONYM: APPS.PN_LOCATION_PARKS
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PN_LOCATION_PARKS, status:VALID,
-
SYNONYM: APPS.PN_SPACE_ASSIGN_EMP_ALL
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PN_SPACE_ASSIGN_EMP_ALL, status:VALID,
-
SYNONYM: APPS.PN_LOCATIONS
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PN_LOCATIONS, status:VALID,
-
SYNONYM: APPS.PN_SPACE_ASSIGN_CUST_ALL
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PN_SPACE_ASSIGN_CUST_ALL, status:VALID,
-
SYNONYM: APPS.PN_SPACE_ASSIGN_EMP_ALL
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PN_SPACE_ASSIGN_EMP_ALL, status:VALID,
-
PACKAGE BODY: APPS.PNP_UTIL_FUNC
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:PNP_UTIL_FUNC, status:VALID,
-
SYNONYM: APPS.PN_LOCATIONS
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PN_LOCATIONS, status:VALID,
-
SYNONYM: APPS.PER_PERSON_TYPES_TL
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PER_PERSON_TYPES_TL, status:VALID,
-
SYNONYM: APPS.PER_PERSON_TYPES_TL
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PER_PERSON_TYPES_TL, status:VALID,
-
SYNONYM: APPS.PN_LOCATIONS_ALL
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PN_LOCATIONS_ALL, status:VALID,
-
PACKAGE BODY: APPS.PNP_UTIL_FUNC
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:PNP_UTIL_FUNC, status:VALID,
-
PACKAGE: APPS.PNP_UTIL_FUNC
12.1.1
owner:APPS, object_type:PACKAGE, object_name:PNP_UTIL_FUNC, status:VALID,
-
SYNONYM: APPS.PN_SPACE_ASSIGN_EMP_S
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PN_SPACE_ASSIGN_EMP_S, status:VALID,
-
SYNONYM: APPS.PN_LOCATIONS_S
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PN_LOCATIONS_S, status:VALID,
-
SYNONYM: APPS.PN_PAYMENT_TERMS_ALL
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PN_PAYMENT_TERMS_ALL, status:VALID,
-
SYNONYM: APPS.AP_DISTRIBUTION_SETS_ALL
12.2.2
owner:APPS, object_type:SYNONYM, object_name:AP_DISTRIBUTION_SETS_ALL, status:VALID,
-
SYNONYM: APPS.PN_SPACE_ASSIGN_CUST
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PN_SPACE_ASSIGN_CUST, status:VALID,
-
PACKAGE BODY: APPS.PN_LOC_STATUS_CHANGE_PKG
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:PN_LOC_STATUS_CHANGE_PKG, status:VALID,
-
SYNONYM: APPS.PN_VAR_ABATEMENTS_ALL
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PN_VAR_ABATEMENTS_ALL, status:VALID,
-
PACKAGE BODY: APPS.PNRX_SP_UTIL_BY_LOC
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:PNRX_SP_UTIL_BY_LOC, status:VALID,
-
PACKAGE BODY: APPS.PNRX_SP_UTIL_BY_LEASE
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:PNRX_SP_UTIL_BY_LEASE, status:VALID,
-
SYNONYM: APPS.AP_DISTRIBUTION_SETS_ALL
12.1.1
owner:APPS, object_type:SYNONYM, object_name:AP_DISTRIBUTION_SETS_ALL, status:VALID,
-
SYNONYM: APPS.PN_PAYMENT_TERMS_ALL
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PN_PAYMENT_TERMS_ALL, status:VALID,
-
PACKAGE: APPS.PNP_UTIL_FUNC
12.2.2
owner:APPS, object_type:PACKAGE, object_name:PNP_UTIL_FUNC, status:VALID,
-
SYNONYM: APPS.PN_REC_ARCL_DTLLN_ALL
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PN_REC_ARCL_DTLLN_ALL, status:VALID,
-
PACKAGE BODY: APPS.PN_OPTIONS_PKG
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:PN_OPTIONS_PKG, status:VALID,
-
SYNONYM: APPS.PN_LOCATIONS_S
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PN_LOCATIONS_S, status:VALID,
-
SYNONYM: APPS.AP_DISTRIBUTION_SETS
12.2.2
owner:APPS, object_type:SYNONYM, object_name:AP_DISTRIBUTION_SETS, status:VALID,
-
SYNONYM: APPS.PN_ADDRESSES_ALL
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PN_ADDRESSES_ALL, status:VALID,
-
PACKAGE BODY: APPS.PNRX_MILESTONES
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:PNRX_MILESTONES, status:VALID,
-
PACKAGE BODY: APPS.PN_INSURANCE_REQUIREMENTS_PKG
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:PN_INSURANCE_REQUIREMENTS_PKG, status:VALID,
-
PACKAGE BODY: APPS.PN_SPACE_ALLOCATIONS_PKG
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:PN_SPACE_ALLOCATIONS_PKG, status:VALID,
-
PACKAGE BODY: APPS.PN_LEASE_DETAILS_PKG
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:PN_LEASE_DETAILS_PKG, status:VALID,
-
SYNONYM: APPS.PN_VAR_ABATEMENTS_ALL
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PN_VAR_ABATEMENTS_ALL, status:VALID,
-
PACKAGE BODY: APPS.PNRX_LEASE_OPTIONS
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:PNRX_LEASE_OPTIONS, status:VALID,
-
PACKAGE BODY: APPS.PN_CC_SYNC_PKG
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:PN_CC_SYNC_PKG, status:VALID,
-
PACKAGE BODY: APPS.PNRX_SP_ASSIGN_BY_LEASE
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:PNRX_SP_ASSIGN_BY_LEASE, status:VALID,
-
PACKAGE BODY: APPS.PNRX_SP_ASSIGN_BY_LOC
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:PNRX_SP_ASSIGN_BY_LOC, status:VALID,
-
SYNONYM: APPS.PN_PROPERTIES
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PN_PROPERTIES, status:VALID,
-
SYNONYM: APPS.PN_PROPERTIES
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PN_PROPERTIES, status:VALID,
-
SYNONYM: APPS.PN_SPACE_ASSIGN_EMP
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PN_SPACE_ASSIGN_EMP, status:VALID,
-
PACKAGE BODY: APPS.PNT_PAYMENT_SCHEDULES_PKG
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:PNT_PAYMENT_SCHEDULES_PKG, status:VALID,
-
SYNONYM: APPS.PN_LOCATIONS_ALL
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PN_LOCATIONS_ALL, status:VALID,
-
PACKAGE: APPS.PN_SPACE_ASSIGN_EMP_PKG
12.1.1
owner:APPS, object_type:PACKAGE, object_name:PN_SPACE_ASSIGN_EMP_PKG, status:VALID,
-
PACKAGE BODY: APPS.PN_LOC_STATUS_CHANGE_PKG
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:PN_LOC_STATUS_CHANGE_PKG, status:VALID,
-
PACKAGE BODY: APPS.PN_EXP_TO_CAD_ITF
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:PN_EXP_TO_CAD_ITF, status:VALID,