Search Results ams_metric_formulas_pk




Overview

The AMS_METRIC_FORMULAS table is a core data repository within the Oracle E-Business Suite (EBS) Marketing (AMS) module. It serves as the central definitional store for metric formulas, which are the computational rules used to derive key performance indicators (KPIs) and other measurable values in marketing campaigns, lead management, and performance analysis. In the context of EBS 12.1.1 and 12.2.2, this table enables the configuration and storage of complex business logic, allowing marketing managers to define how metrics are calculated from underlying transactional data. Its role is critical for the flexible and accurate measurement of marketing effectiveness, feeding into dashboards, reports, and analytical summaries.

Key Information Stored

The table's primary purpose is to define the relationship between a calculated metric and its source components. Based on the provided metadata, the key structural elements include:

  • METRIC_FORMULA_ID: The unique primary key identifier (PK: AMS_METRIC_FORMULAS_PK) for each formula definition.
  • METRIC_ID: A foreign key column linking to the AMS_METRICS_ALL_B table. This identifies the specific metric being calculated by the formula.
  • SOURCE_ID: A foreign key column with dual references. It can link to either the AMS_CATEGORIES_B table or again to the AMS_METRICS_ALL_B table. This indicates that a formula's source component can be a predefined category (for dimensional breakdowns) or another base metric (for derived calculations), illustrating the potential for nested or composite metric formulas.

While specific formula expression columns are not detailed in the excerpt, the table logically contains attributes to store the actual formula logic (e.g., arithmetic operators, functions) and metadata such as active status and creation information.

Common Use Cases and Queries

This table is primarily accessed for system configuration and analytical reporting. A common administrative use case is querying all formulas associated with a specific high-level marketing metric to audit or modify calculation logic. For example:

SELECT mf.metric_formula_id, m.metric_name, mf.source_id
FROM ams_metric_formulas mf,
     ams_metrics_all_b m
WHERE mf.metric_id = m.metric_id
AND m.metric_name = 'Campaign ROI';

For reporting and data validation, developers may write queries to join AMS_METRIC_FORMULAS with transactional tables (like AMS_ACTIVITIES or AMS_LEADS) to reconcile calculated metric values with their source data. Another critical use case is during the creation of custom marketing dashboards, where understanding the formula definition is necessary to correctly aggregate and present metric data.

Related Objects

The AMS_METRIC_FORMULAS table is integral to the metric definition framework within AMS. Its primary relationships, as documented, are:

  • AMS_METRICS_ALL_B: This is the central metrics master table. AMS_METRIC_FORMULAS has a foreign key relationship to it via the METRIC_ID column (defining the target metric) and potentially via the SOURCE_ID column (if the source is another metric).
  • AMS_CATEGORIES_B: The table for category definitions. The foreign key from SOURCE_ID allows metric formulas to incorporate categorical dimensions, enabling calculations segmented by regions, product lines, or other classified attributes.

This table is also foundational for various AMS module views and public APIs that expose metric calculations for integration and reporting purposes, ensuring that all downstream consumers utilize a consistent, centrally managed formula definition.