Search Results oks_ent_util_pvt




Overview

The APPS.OKS_ENT_UTIL_PVT package body is a private utility package within the Oracle E-Business Suite Service Contracts (OKS) and Enterprise Contracts (OKC) module family. Its designation as a PVT package indicates that it is intended for internal use by other API packages within the same product, rather than for direct invocation by external custom code or concurrent programs. The package serves as a central extraction and retrieval utility that resolves entitlement attributes, contract terms, pricing constructs, and party relationships from the underlying service contract data model. It abstracts the complexity of joining contract headers, lines, line styles, party roles, and governance records into a set of reusable accessor functions shared across the OKS entitlement engine.

Key Procedures and Functions

The package exposes twenty-seven documented procedures and functions, each designed to retrieve a specific entitlement or contract attribute. These can be grouped by functional domain:

Tables Accessed

The package reads from the core Service Contracts and Enterprise Contracts base tables, primarily through APPS synonyms. The principal contract tables are OKC_K_HEADERS_B, OKC_K_LINES_B, and OKC_K_ITEMS, which store header, line, and item level contract data; OKC_K_PARTY_ROLES_B supplies party role assignments, and OKC_LINE_STYLES_B provides line style definitions that govern contract behavior. The OKS-specific tables OKS_K_HEADERS_B and OKS_K_LINES_B supply service contract extensions. OKC_GOVERNANCES holds governance records that bind contract structures. Installed base context is drawn from CSI_ITEM_INSTANCES. Lookup values are resolved through FND_LOOKUPS, and date arithmetic relies on OKC_TIME_UTIL_PUB. Several read-only views — including OKS_COV_TYPES_V, OKX_CUSTOMER_ACCOUNTS_V, OKX_CUSTOMER_PRODUCTS_V, OKX_CUST_SITE_USES_V, OKX_PARTIES_V, OKX_PARTY_SITES_V, OKX_SYSTEMS_V, and OKX_SYSTEM_ITEMS_V — supply customer, party, system, and customer product hierarchies.

Usage Notes

As a private package, OKS_ENT_UTIL_PVT is not intended for direct invocation by external interfaces, concurrent programs, or form personalizations. It is invoked indirectly through public entitlement and service contract APIs, and it is documented as being referenced by five other packages within the OKS module. The package itself is not referenced by any database object outside this internal dependency chain. Because its status is VALID and it does not appear as an entry point, developers extending entitlement logic should call the public OKS/OKC APIs rather than this utility directly. Custom code that bypasses the public layer and invokes these accessors directly risks breakage during patching or upgrade, since the private interface is not guaranteed to remain stable across releases such as 12.1.1 and 12.2.2.