Search Results hz_credit_usage_rule_sets_tl




Overview

The HZ_CREDIT_USAGE_RULE_SETS_TL table is a core translation table within the Oracle E-Business Suite (EBS) Receivables (AR) module, specifically for versions 12.1.1 and 12.2.2. It stores the multilingual descriptions and names for sets of credit usage rules. These rule sets are logical groupings of business rules that govern how a customer's available credit is consumed and managed during the order-to-cash cycle. The table's primary role is to support the global deployment of EBS by enabling the display of user-facing rule set names and descriptions in the language of the user's session, a fundamental aspect of the application's NLS (National Language Support) architecture.

Key Information Stored

As a translation (TL) table, its structure follows the standard Oracle Applications pattern. The table holds language-specific textual data that corresponds to records in its base table. The most critical columns are the composite primary key and the translated text fields. The CREDIT_USAGE_RULE_SET_ID is the foreign key linking to the base table (HZ_CREDIT_USAGE_RULE_SETS_B), uniquely identifying the rule set. The LANGUAGE column holds the ISO code for the translation language (e.g., 'US' for American English). The SOURCE_LANG column typically indicates the original language of the record. The core content columns are NAME, which stores the translated name of the credit usage rule set, and DESCRIPTION, which holds the detailed explanation. These columns are populated via the standard EBS translation forms and are accessed by the application's NLS-aware views.

Common Use Cases and Queries

This table is primarily accessed indirectly through application forms and views that present credit management setups. Direct queries are most common for data validation, migration scripts, or custom reports requiring multilingual data. A typical use case is retrieving the translated name for a specific rule set ID in the current session language. For example, a report on credit rule assignments might use a query like:

SELECT t.name, t.description
FROM hz_credit_usage_rule_sets_tl t,
     hz_credit_usage_rule_sets_b b
WHERE t.credit_usage_rule_set_id = b.credit_usage_rule_set_id
AND t.language = USERENV('LANG')
AND b.enabled_flag = 'Y';


Another common pattern is verifying translation completeness by checking for rule sets missing an entry in a specific target language. Developers must always join to the base table (HZ_CREDIT_USAGE_RULE_SETS_B) for any functional filtering, as the TL table contains only descriptive text.

Related Objects

The table has a tightly defined relationship with its base table, as documented in the ETRM metadata. The primary foreign key dependency is:

  • Base Table (HZ_CREDIT_USAGE_RULE_SETS_B): This is the fundamental table storing the operational attributes of a credit usage rule set (e.g., enabled flag, start date). The HZ_CREDIT_USAGE_RULE_SETS_TL table references it via the column HZ_CREDIT_USAGE_RULE_SETS_TL.CREDIT_USAGE_RULE_SET_ID, which is a foreign key to HZ_CREDIT_USAGE_RULE_SETS_B. All transactional integrity is maintained against the base table.

In practice, application logic accesses translated data through NLS views, which perform the necessary join between the '_B' and '_TL' tables automatically based on the user's session language. Custom integrations or extensions that create or update credit usage rule sets must use the appropriate public Oracle Trading Community Architecture (TCA) or Receivables APIs to ensure both the base and translation records are maintained correctly.