Search Results per_ri_configuration_api




Overview
Explore in AI Chat

Overview

The APPS.PER_RI_CONFIGURATION_API package is a public Oracle E-Business Suite API that belongs to the Oracle Human Resources (HR) family of configuration utilities. Its purpose is to provide a controlled, programmatic interface for creating, maintaining, and removing Recruitment and Intelligence (RI) configuration records within the HR schema. In Oracle EBS 12.1.1 and 12.2.2, configuration data governs how recruitment-related features, lookups, and setup entities are organized and made available to the end user. Rather than allowing direct DML against the underlying configuration tables, Oracle exposes this API so that the required validation logic, translation handling, and business-rule enforcement are applied consistently. The package is classified as an API in the ETRM registry, carries a status of VALID, and is owned by the APPS schema. It is a component of the broader Recruitment configuration framework, sitting alongside companion objects such as PER_RI_CONFIGURATION_SWI, PER_RI_CONFIG_IMPORT_PKG, PER_RI_CONFIG_UTILITIES, and PER_RI_MNG_CFG_PKG, all of which reference this API for their configuration manipulation needs.

Key Procedures and Functions

The ETRM documentation identifies three documented procedures within this package. Parameter lists are intentionally not enumerated here, as the authoritative signature should always be verified against the deployed package specification.

  • CREATE_CONFIGURATION — Inserts a new recruitment/intelligence configuration record. Invoking this procedure ensures the new configuration is validated and registered through the approved HR API path rather than by direct insert.
  • UPDATE_CONFIGURATION — Modifies an existing configuration record. This procedure applies the same validation and translation maintenance logic as creation, keeping the configuration consistent after changes.
  • DELETE_CONFIGURATION — Removes a configuration record. It is expected to enforce referential and dependency checks before deletion, preserving data integrity across the configuration framework.

Each procedure is a wrapper that encapsulates the underlying HR business rules and shields callers from the internal structure of the configuration tables.

Tables Accessed

The documented table references, exposed to the package through APPS synonyms, are:

  • PER_RI_CONFIGURATIONS_TL — The translation (TL) table holding the language-specific, user-facing configuration text. This is the primary target for create, update, and delete operations performed by the API.
  • HR_LOCATIONS_ALL — The base locations table, read by the API to validate and associate location information relevant to configuration records.
  • HR_LOCATIONS_ALL_TL — The translated locations table, read to resolve location descriptions in the user's session language.

By combining the base and translated location tables with the configuration translation table, the API maintains both relational integrity and multilingual consistency.

Usage Notes

This package is normally invoked indirectly. It is referenced by four other packages within the RI framework, which act as higher-level orchestrators for configuration import, management, and utility processing. Consequently, the most common invocation path is through those wrapper packages or through the Recruitment configuration screens in the Oracle HR forms, rather than through direct calls. Custom code, interfaces, or concurrent programs that must manipulate recruitment configuration data should invoke this API instead of issuing direct DML, so that validation and translation handling remain intact. As a rule, developers should confirm the exact parameter signatures in the deployed environment prior to use, since the ETRM metadata documents only the procedure names and not their full argument lists.