Search Results get_fa_location

Overview

CSE_UTIL_PKG is a shared utility package in the Oracle E-Business Suite Applications (APPS) schema that supports the Enterprise Asset Management and Install Base (CSI) product family. It consolidates commonly repeated validation and lookup logic used by the Customer Service, Depot Repair, and Install Base modules, and its routines are declared AUTHID CURRENT_USER, so they execute with the privileges of the calling session and respect the caller's security context.

The package addresses three broad areas of business logic: item attribute validation (trackable, lot-controlled, serial-controlled, and depreciable status), accounting flexfield segment resolution, and reference-data lookups for organizations, locations, destination instances, and instance query records. Because the package exposes these repeatedly needed checks as callable subprograms, it reduces duplicated code across the many forms, concurrent programs, and public APIs that depend on it. The ETRM metadata indicates it is referenced by 28 other packages, confirming its role as a foundational dependency within the CSI and eAM layer.

Key Procedures and Functions

The package exposes 48 documented procedures and functions. The principal ones are:

• CHECK_ITEM_TRACKABLE — determines whether an inventory item is tracked at the instance level.
• CHECK_LOT_CONTROL and CHECK_SERIAL_CONTROL — return the lot and serial control attributes for an item within a specific organization.
• CHECK_DEPRECIABLE_SUBINV and CHECK_DEPRECIABLE — evaluate whether a subinventory or item is depreciable for asset purposes.
• GET_ASSET_CREATION_CODE — retrieves the asset creation code that governs how an instance generates fixed assets.
• GET_CONCAT_SEGMENTS — returns the concatenated accounting flexfield segment string for a supplied combination identifier, using the short name and flex code provided by the caller.
• GET_COMBINE_SEGMENTS — performs the complementary operation, deriving combination segments from concat segments.
• GET_DESTINATION_INSTANCE — resolves a destination instance record from an instance header table.
• GET_MASTER_ORGANIZATION — returns the master organization identifier associated with a given organization.
• GET_HZ_LOCATION and GET_FA_LOCATION — translate network location codes into Oracle Receivables (HZ) and Fixed Assets location identifiers.

Supporting subprograms include BUILD_ERROR_STRING, GET_STRING_VALUE, IS_EIB_INSTALLED, BYPASS_EVENT_QUEUE, GET_NEG_INV_CODE, GET_DEFAULT_STATUS_ID, INIT_INSTANCE_QUERY_REC, and INIT_INSTANCE_CREATE_REC. The GET_* routines converge on a three-out-parameter convention (x_concat_segments/x_combine_segments, x_Return_Status, x_Error_Message), enabling callers to branch on success and surface a standardized error string.

Tables Accessed

The package reads and writes through APPS synonyms. Install Base tables include CSI_ITEM_INSTANCES, CSI_ITEM_INSTANCES_H, CSI_TRANSACTIONS, CSI_TXN_TYPES, CSI_INSTANCE_STATUSES, CSI_II_RELATIONSHIPS, and CSI_A_LOCATIONS. Party and location data is drawn from HZ_LOCATIONS and HZ_PARTY_SITES, while inventory and costing context comes from MTL_MATERIAL_TRANSACTIONS. Concurrent manager and user context is obtained from FND_APPLICATION, FND_CONCURRENT_PROGRAMS, FND_CONCURRENT_REQUESTS, FND_EXECUTABLES, and FND_USER. These accesses support instance validation, status and transaction type resolution, location translation, and concurrent request tracking.

Usage Notes

CSE_UTIL_PKG is typically invoked from Install Base and eAM forms, from concurrent programs that process or validate instances, and from custom PL/SQL that must replicate standard attribute checks. The presence of IS_EIB_INSTALLED and BYPASS_EVENT_QUEUE indicates the package also gates behavior based on whether the Enterprise Install Base business event system is active. Because the routines are utilities rather than public APIs, callers are expected to declare and handle the return status and error message outputs, and to treat undocumented behavior as subject to change across patch levels. The GET_CONCAT_SEGMENTS procedure is the entry point most frequently referenced when resolving a combination identifier into its displayable concatenated segment value.