Search Results jtf_tty_geo_terr_values




Overview

The JTF_TTY_GEO_TERR_VALUES table is a core data structure within the Oracle E-Business Suite (EBS) CRM Foundation module (JTF). It functions as the detailed assignment table for geography-based territory definitions. In the context of Oracle Territory Management, a territory is a logical grouping used to segment customers, partners, or resources for sales, service, and marketing operations. This table specifically stores the individual geographic criteria, such as postal codes, that constitute a defined geography territory. Its role is to link high-level territory definitions with the granular geographic data stored within the EBS geography hierarchy, enabling precise territory assignment and rule evaluation.

Key Information Stored

The table's primary function is to map territory definitions to specific geographic entities. Its key columns, as indicated by the provided metadata, are the primary and foreign keys that enforce this relationship. The GEO_TERR_VALUE_ID column serves as the unique primary key identifier for each assignment record. The GEO_TERRITORY_ID column is a foreign key that links to the JTF_TTY_GEO_TERR table, identifying the parent geography territory definition. The GEO_ID column is a foreign key that links to the JTF_TTY_GEOGRAPHIES table, specifying the exact geographic element (e.g., a specific postal code, city, or state) included in the territory. The table's description emphasizes its use for storing "geography territory values like postal code assignment," confirming its purpose of holding the atomic components of a geographic territory rule.

Common Use Cases and Queries

The primary use case is determining territory membership for a given address or location. During transaction processing, such as order entry or service request creation, the system can query this table to identify which territories encompass a customer's postal code. Common reporting and administrative queries include listing all geographic components for a specific territory or identifying which territories contain a particular geographic ID. A sample SQL pattern to retrieve all postal codes assigned to a territory would involve joining to the geography tables:

  • SELECT g.GEOGRAPHY_NAME FROM JTF_TTY_GEO_TERR_VALUES v, JTF_TTY_GEOGRAPHIES g WHERE v.GEO_ID = g.GEOGRAPHY_ID AND v.GEO_TERRITORY_ID = :terr_id;

Data maintenance typically occurs through the Oracle Territory Manager user interface or associated APIs, not via direct DML, to maintain business rule integrity.

Related Objects

As defined by its foreign key constraints, JTF_TTY_GEO_TERR_VALUES has direct dependencies on two critical tables. The JTF_TTY_GEO_TERR table stores the master definition of the geography territory, including its name, type, and effective dates. The JTF_TTY_GEOGRAPHIES table is the master repository for all geographic data within EBS, organized in a hierarchical model. This table is also intrinsically related to the broader territory engine and objects such as JTF_TERR_RSC_EXTNS and JTF_TERR_USERS_ALL, which assign resources to the territories defined using these geographic values. Queries for territory resolution often join through this table to connect resources, territory definitions, and geographic data.