Search Results ib_interface




Overview

The APPS.OKS_OMIB_INT_EXTNS_PUB package is a public extension hook within Oracle Service Contracts (OKS) in Oracle E-Business Suite 12.1.1 and 12.2.2. Its role is to provide a supported customization point for injecting custom business logic before and after contract operations that are triggered by Oracle Installed Base (IB) instance transactions. The package name reflects its function: an OM/IB integration extension point (OMIB = Order Management / Installed Base) exposed as a public API (_PUB). The header comment (revision 120.1, dated 2005/06/28) indicates the object has remained stable across releases, with the same interface carried forward into 12.2.2.

In practice, this package lets implementers extend the standard contract lifecycle without modifying Oracle seeded code. The seeded integration programs call these extension procedures, allowing site-specific validation, data enrichment, or deferred processing triggered by IB instance operations such as contract line replacement.

Key Procedures and Functions

Two documented procedures make up the package interface:

  • PRE_INTEGRATION — Invoked before a contract operation is performed as a result of an IB instance operation. It enables custom logic to run before the standard contract processing. According to the header comment, it is called from oks_ibint_pub.ib_interface (for "Replace"/RPL transaction types, where p_order_line_id is passed as NULL and p_transaction_type is "RPL"), from oks_ocint_pub.oc_interface (where the new order line ID is passed and p_transaction_type is NULL), and from oks_ocint_pub.order_reprocess (where the order line ID is passed and p_transaction_type is NULL). The procedure returns an x_process_status value; the caller executes existing code only when it returns 'C'. Any other value defers the existing code. The x_return_status must be Success for existing code and post-integration to proceed.
  • POST_INTEGRATION — Invoked after a contract operation resulting from an IB instance operation. It allows custom logic to execute after standard contract processing completes. Per the header, it is called from oks_ibint_pub.ib_interface for "Replace" (RPL) transaction types, where p_order_line_id is passed as NULL.

Tables Accessed

The ETRM 12.2.2 metadata documents no direct table references for this package via APPS synonyms. This is consistent with its design as an extension shell: the seeded procedures provide entry points and status contracts, while any table access occurs in customer-written replacement code or downstream standard logic invoked by the caller. Implementers who override or supply the custom logic are responsible for any direct DML against Service Contracts and Installed Base tables. The metadata notes the package is referenced by two other packages, confirming its role as a called dependency rather than a data-access layer.

Usage Notes

This package is typically invoked indirectly. It is called by seeded Service Contracts integration packages (oks_ibint_pub, oks_ocint_pub) during IB instance operations, not directly from forms or concurrent programs. In Oracle EBS 12.1.1 and 12.2.2, customizations are applied by wrapping or extending the standard behavior through these hooks rather than editing seeded code, preserving upgradeability.

The key contract to honor is the status protocol: x_process_status must return 'C' and x_return_status must return Success to allow the existing contract operation and post-integration processing to continue. Returning any other process status defers the existing logic, which can be used to suppress standard processing deliberately. Because the procedure signature includes standard API messaging parameters (message list, count, and data), custom logic should populate these consistently. Implementers frequently search for "ib_interface" in this context to locate the calling integration point, reinforcing that this package is the designated extension mechanism around oks_ibint_pub.ib_interface.