Search Results cs_kb_elements_pkg




Overview

CS_KB_ELEMENTS_PKG is a PL/SQL package owned by the APPS schema in Oracle E-Business Suite. It is an internal data-access and maintenance package associated with the Oracle Knowledge Base component of the Service (CS) module. The Knowledge Base stores reusable diagnostic and solution content — solution elements, resolution text, and associated metadata — that service agents consult while resolving customer incidents and service requests.

The package encapsulates the standard Oracle Forms-style table maintenance pattern (insert, lock, update, delete) plus multi-language and bulk-loading utilities for the Knowledge Base elements entity. Because it exposes row-level DML and translation handling for the CS_KB_ELEMENTS base and translated tables, it functions as the persistence layer beneath the Knowledge Base maintenance forms and concurrent programs rather than as a business-rule API intended for direct customer integration. In the ETRM metadata classification it is registered as an OTHER-type API, and it is documented as VALID at both the 12.1.1 and 12.2.2 release levels.

Key Procedures and Functions

The ETRM documentation records eight documented procedures and functions for this package. Parameter lists are not published in the metadata and must be derived from the package specification in the database.

  • INSERT_ROW — Creates a new Knowledge Base element record in the base table, assigning the element identifier and populating the descriptive columns from the form or caller-supplied values.
  • LOCK_ROW — Obtains a row-level lock on an existing element so that concurrent maintenance sessions cannot modify the same record simultaneously. This is the standard Oracle Forms on-lock semantics.
  • UPDATE_ROW — Applies changes to the non-translatable columns of an existing element record.
  • DELETE_ROW — Removes an element record, together with its dependent translated rows, from the Knowledge Base.
  • ADD_LANGUAGE — Inserts a new language row into the translated table for an existing element, seeding the translated columns so the element is available to users of that language.
  • TRANSLATE_ROW — Writes translated text values into the translation table for a specific element and language combination.
  • LOAD_ROW — Bulk-loads or inserts an element row from a seed or migration data set, typically used for data movement rather than interactive entry.
  • UPDATE_CLOBS — Manages large object (CLOB) columns on the element record, handling the long-text solution content that exceeds standard varchar limits.

Tables Accessed

The package references four objects through APPS synonyms:

  • CS_KB_ELEMENTS_B — the base (non-translatable) table holding one row per Knowledge Base element, keyed by element identifier and language-independent attributes.
  • CS_KB_ELEMENTS_TL — the translated table holding language-specific text such as element names and descriptions, with one row per element per installed language.
  • FND_LANGUAGES — the Oracle Applications language registry, consulted to validate and enumerate available languages for the translation procedures.
  • DBMS_LOB — the Oracle-supplied LOB package, used by UPDATE_CLOBS for chunked read and write of CLOB content.

Usage Notes

CS_KB_ELEMENTS_PKG is referenced by CS_KB_ELEMENTS_AUDIT_PKG, which wraps it to capture audit trail information, and it is documented as being referenced by one other package. This dependency pattern indicates the package is invoked indirectly through the Knowledge Base maintenance forms and seeding or upgrade routines rather than called directly from customization code.

Because the procedures implement raw table maintenance without enforced business validation, direct invocation from custom code is not recommended. Any custom maintenance of Knowledge Base elements should go through the supported forms or through the audit wrapper so that audit columns and translation rows remain consistent. When migrating or seeding Knowledge Base content between environments, LOAD_ROW and UPDATE_CLOBS provide the supported path for moving element definitions and their long-text solution bodies.