Search Results pqh_cbr_engine
Overview
PQH_CBR_ENGINE is an Oracle Application Object Library (APPS) schema PL/SQL package that implements the Criteria-Based Rules (CBR) evaluation engine for Oracle Human Resources and Oracle Payroll. Its role is to apply configurable business rules — sets of attribute-defined conditions — against HR and budgeting data, and to determine whether a given condition is satisfied. In practice the package supports the rule-driven logic used by budget pools, budget versions, and position/budget reallocation processes, where the outcome of one or more rules governs how funds are allocated, reallocated, or validated during transactional processing.
Within Oracle EBS, Criteria-Based Rules allow organizations to express eligibility, allocation, and validation logic declaratively rather than through hard-coded customizations. PQH_CBR_ENGINE is the runtime component that reads the rule definitions stored in the PQH_RULES, PQH_RULE_SETS, and PQH_RULE_ATTRIBUTES tables, resolves attribute values against the transactional context, and returns a pass/fail result. The package is classified as OTHER rather than a published open interface, meaning it is an internal engine consumed by other application modules rather than a supported external API.
Key Procedures and Functions
The ETRM documentation lists thirteen documented procedures and functions. Grouped by purpose:
- POPULATE_GLOBALS — initialises package-level global variables and session context used by subsequent rule evaluation calls.
- POPULATE_ATTR_MATX — builds the in-memory attribute matrix that maps rule attributes to their resolved values for the transaction under evaluation.
- GET_TRANSACTION_VALUE — retrieves a specific attribute or transaction value required during rule matching.
- CHECK_ATTRIBUTE_RESULT — evaluates a single attribute condition and returns whether the condition is met.
- APPLY_RULES and APPLY_DEFINED_RULES and APPLY_BUSINESS_RULES — orchestrate the execution of a rule set, driving the condition checks and returning the aggregate outcome.
- APPLY_CBR_REALLOC — applies criteria-based rules specifically to the budget reallocation process.
- VALID_RULE_CONDITIONS, VALID_PROCESS_RULES — perform validation of rule definitions and processing eligibility before evaluation proceeds.
- CHECK_RULE_EXISTENCE — determines whether any applicable rules exist for the supplied context, allowing calling code to skip unnecessary processing.
- CHECK_ORG_VALID_RULE and GET_ORG_STRUCTURE_VERSION_ID — resolve organisational context, identifying the applicable organisation structure version against which rules are evaluated.
Parameter lists are not documented in the metadata and are intentionally omitted here.
Tables Accessed
PQH_CBR_ENGINE reads and writes the following tables via APPS synonyms. Rule configuration is sourced from PQH_RULES, PQH_RULE_SETS, PQH_RULE_ATTRIBUTES, and PQH_ATTRIBUTES. Budget context is drawn from PQH_BUDGETS, PQH_BUDGET_POOLS, PQH_BUDGET_PERIODS, PQH_BUDGET_VERSIONS, and PQH_BDGT_POOL_REALLOCTIONS. Organisational structure resolution uses PER_ORG_STRUCTURE_ELEMENTS, PER_ORG_STRUCTURE_VERSIONS, and PER_SHARED_TYPES, while PER_TIME_PERIODS supplies date-period information and HR_ALL_POSITIONS_F supplies position data. FND_NEW_MESSAGES is used for Oracle Application Framework message handling, enabling the engine to raise or retrieve user-facing error messages. The package is referenced by PQH_BDGT_REALLOC_UTILITY and by itself recursively.
Usage Notes
PQH_CBR_ENGINE is an internal engine rather than a directly callable public interface. It is invoked indirectly through Oracle HR/Payroll budget and position allocation processes, most notably by PQH_BDGT_REALLOC_UTILITY, and its CBR evaluation logic is typically triggered from the budget reallocation concurrent program and related forms. Because the package name appears in the ETRM dependency documentation, it is sometimes diagnosed during troubleshooting of budget reallocation or rules-based allocation errors. Custom code should not call results-dependent internals directly, as signatures are not assured across patch levels; any extension should instead rely on standard budget or rule APIs. The VALID status in 12.1.1 and 12.2.2 indicates the package is compiled and current in both releases.
-
PACKAGE: APPS.PQH_CBR_ENGINE
12.2.2
owner:APPS, object_type:PACKAGE, object_name:PQH_CBR_ENGINE, status:VALID,
-
PACKAGE: APPS.PQH_CBR_ENGINE
12.1.1
owner:APPS, object_type:PACKAGE, object_name:PQH_CBR_ENGINE, status:VALID,
-
SYNONYM: APPS.PQH_RULE_ATTRIBUTES
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PQH_RULE_ATTRIBUTES, status:VALID,
-
PACKAGE BODY: APPS.PQH_CBR_ENGINE
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:PQH_CBR_ENGINE, status:VALID,
-
SYNONYM: APPS.PQH_RULE_SETS
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PQH_RULE_SETS, status:VALID,
-
SYNONYM: APPS.PQH_RULE_SETS
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PQH_RULE_SETS, status:VALID,
-
SYNONYM: APPS.PQH_BUDGET_POOLS
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PQH_BUDGET_POOLS, status:VALID,
-
SYNONYM: APPS.PQH_RULE_ATTRIBUTES
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PQH_RULE_ATTRIBUTES, status:VALID,
-
SYNONYM: APPS.PQH_BUDGET_POOLS
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PQH_BUDGET_POOLS, status:VALID,
-
PACKAGE BODY: APPS.PQH_CBR_ENGINE
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:PQH_CBR_ENGINE, status:VALID,
-
SYNONYM: APPS.PQH_ATTRIBUTES
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PQH_ATTRIBUTES, status:VALID,
-
SYNONYM: APPS.PQH_ATTRIBUTES
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PQH_ATTRIBUTES, status:VALID,
-
PACKAGE: APPS.PQH_BDGT_REALLOC_LOG_PKG
12.2.2
owner:APPS, object_type:PACKAGE, object_name:PQH_BDGT_REALLOC_LOG_PKG, status:VALID,
-
SYNONYM: APPS.PQH_RULES
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PQH_RULES, status:VALID,
-
PACKAGE: APPS.PQH_BUDGET
12.2.2
owner:APPS, object_type:PACKAGE, object_name:PQH_BUDGET, status:VALID,
-
PACKAGE: APPS.PQH_BDGT_REALLOC_UTILITY
12.1.1
owner:APPS, object_type:PACKAGE, object_name:PQH_BDGT_REALLOC_UTILITY, status:VALID,
-
PACKAGE: APPS.PQH_BUDGET
12.1.1
owner:APPS, object_type:PACKAGE, object_name:PQH_BUDGET, status:VALID,
-
PACKAGE: APPS.PQH_BDGT_REALLOC_UTILITY
12.2.2
owner:APPS, object_type:PACKAGE, object_name:PQH_BDGT_REALLOC_UTILITY, status:VALID,
-
SYNONYM: APPS.PQH_RULES
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PQH_RULES, status:VALID,
-
PACKAGE: APPS.PQH_BDGT_REALLOC_LOG_PKG
12.1.1
owner:APPS, object_type:PACKAGE, object_name:PQH_BDGT_REALLOC_LOG_PKG, status:VALID,
-
PACKAGE: APPS.PQH_MGMT_RPT_PKG
12.1.1
owner:APPS, object_type:PACKAGE, object_name:PQH_MGMT_RPT_PKG, status:VALID,
-
PACKAGE: APPS.PQH_REFRESH_DATA
12.2.2
owner:APPS, object_type:PACKAGE, object_name:PQH_REFRESH_DATA, status:VALID,
-
SYNONYM: APPS.PQH_BDGT_POOL_REALLOCTIONS
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PQH_BDGT_POOL_REALLOCTIONS, status:VALID,
-
PACKAGE: APPS.PQH_MGMT_RPT_PKG
12.2.2
owner:APPS, object_type:PACKAGE, object_name:PQH_MGMT_RPT_PKG, status:VALID,
-
PACKAGE: APPS.PQH_REFRESH_DATA
12.1.1
owner:APPS, object_type:PACKAGE, object_name:PQH_REFRESH_DATA, status:VALID,
-
PACKAGE BODY: APPS.PQH_BDGT_REALLOC_UTILITY
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:PQH_BDGT_REALLOC_UTILITY, status:VALID,
-
PACKAGE BODY: APPS.PQH_BDGT_REALLOC_UTILITY
12.2.2
owner:APPS, object_type:PACKAGE BODY, object_name:PQH_BDGT_REALLOC_UTILITY, status:VALID,
-
SYNONYM: APPS.PQH_BDGT_POOL_REALLOCTIONS
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PQH_BDGT_POOL_REALLOCTIONS, status:VALID,
-
SYNONYM: APPS.PQH_BUDGET_PERIODS
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PQH_BUDGET_PERIODS, status:VALID,
-
SYNONYM: APPS.PQH_BUDGET_PERIODS
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PQH_BUDGET_PERIODS, status:VALID,
-
SYNONYM: APPS.PQH_TXN_CATEGORY_ATTRIBUTES
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PQH_TXN_CATEGORY_ATTRIBUTES, status:VALID,
-
SYNONYM: APPS.PQH_TXN_CATEGORY_ATTRIBUTES
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PQH_TXN_CATEGORY_ATTRIBUTES, status:VALID,
-
PACKAGE: APPS.PQH_CBR_ENGINE
12.1.1
-
PACKAGE: APPS.PQH_CBR_ENGINE
12.2.2
-
PACKAGE: APPS.DT_FNDATE
12.2.2
owner:APPS, object_type:PACKAGE, object_name:DT_FNDATE, status:VALID,
-
PACKAGE: APPS.DT_FNDATE
12.1.1
owner:APPS, object_type:PACKAGE, object_name:DT_FNDATE, status:VALID,
-
SYNONYM: APPS.PQH_BUDGET_VERSIONS
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PQH_BUDGET_VERSIONS, status:VALID,
-
SYNONYM: APPS.PQH_BUDGETS
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PQH_BUDGETS, status:VALID,
-
SYNONYM: APPS.PQH_BUDGETS
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PQH_BUDGETS, status:VALID,
-
SYNONYM: APPS.PQH_TABLE_ROUTE
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PQH_TABLE_ROUTE, status:VALID,
-
SYNONYM: APPS.PQH_TABLE_ROUTE
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PQH_TABLE_ROUTE, status:VALID,
-
SYNONYM: APPS.PQH_BUDGET_VERSIONS
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PQH_BUDGET_VERSIONS, status:VALID,
-
SYNONYM: APPS.PER_SHARED_TYPES
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PER_SHARED_TYPES, status:VALID,
-
SYNONYM: APPS.PQH_TRANSACTION_CATEGORIES
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PQH_TRANSACTION_CATEGORIES, status:VALID,
-
SYNONYM: APPS.PER_SHARED_TYPES
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PER_SHARED_TYPES, status:VALID,
-
SYNONYM: APPS.PQH_TRANSACTION_CATEGORIES
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PQH_TRANSACTION_CATEGORIES, status:VALID,
-
SYNONYM: APPS.PER_ORG_STRUCTURE_VERSIONS
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PER_ORG_STRUCTURE_VERSIONS, status:VALID,
-
SYNONYM: APPS.PER_ORG_STRUCTURE_VERSIONS
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PER_ORG_STRUCTURE_VERSIONS, status:VALID,
-
SYNONYM: APPS.PER_ORG_STRUCTURE_ELEMENTS
12.1.1
owner:APPS, object_type:SYNONYM, object_name:PER_ORG_STRUCTURE_ELEMENTS, status:VALID,
-
SYNONYM: APPS.PER_ORG_STRUCTURE_ELEMENTS
12.2.2
owner:APPS, object_type:SYNONYM, object_name:PER_ORG_STRUCTURE_ELEMENTS, status:VALID,