Search Results bsc_aw_bsc_metadata
Overview
The APPS.BSC_AW_BSC_METADATA package body is a core metadata engine within the Oracle EBS Balanced Scorecard (BSC) module, specifically belonging to the Analytic Workspace (AW) integration layer. Its primary business function is to resolve, assemble, and expose the structural metadata that describes KPIs, dimensions, dimension sets, calendars, and data sources used by the Balanced Scorecard analytics engine. Essentially, this package translates the logical BSC configuration stored in the E-Business Suite repository into a form that can be consumed by the analytic workspace and reporting layers. It is classified as an OTHER API, meaning it is intended primarily for internal module use rather than as a public integration API. The package is VALID in the APPS schema and is heavily reused: the ETRM metadata confirms that APPS.BSC_AW_BSC_METADATA is not referenced by any database object directly in the dependency graph shown, but it is referenced by seven other packages and depends on a wide set of BSC components.
Key Procedures and Functions
The package exposes 39 documented procedures and functions. Among the most significant are:
- GET_ALL_PARENT_CHILD and GET_PARENT_CHILDREN — retrieve hierarchical parent/child relationships, enabling roll-up and drill-down navigation of dimension members.
- GET_ALL_DISTINCT_LEVELS — returns the distinct levels defined across dimensions, used to build level-aware metadata.
- SET_DIM_RECURSIVE — establishes recursive handling of a dimension, supporting self-referencing hierarchies.
- GET_DIMS_FOR_KPIS and GET_KPI_FOR_DIM — resolve the many-to-many mapping between KPIs and dimensions.
- GET_KPI_FOR_CALENDAR and GET_KPI_PROPERTIES — return KPI assignments to calendars and the defining attributes of each KPI.
- GET_KPI_DIM_SETS, GET_DIM_SET_DIMS, GET_DIM_SET_MEASURES, GET_DIM_SET_DATA_SOURCE — resolve dimension set composition, its measures, and its associated data source.
- GET_S_VIEWS and GET_BASE_TABLE_DATA_SOURCE — identify source views and base tables that feed the analytic workspace.
- IS_TARGET_AT_HIGHER_LEVEL, GET_TARGET_DIM_LEVELS, and GET_DIM_LEVEL_PROPERTIES — govern target handling and level-level properties.
- CHECK_DIM_ZERO_CODE — validates dimension zero-code conditions.
- CREATE_REC_DATA_SOURCE and CREATE_DATA_SOURCE — construct the data source definitions consumed downstream.
Tables Accessed
The ETRM metadata lists the referenced objects as DBMS_SQL, PLITBLM, STANDARD, and the BSC internal packages BSC_AW_ADAPTER_DIM, BSC_AW_ADAPTER_KPI, BSC_AW_BSC_METADATA (self-reference), BSC_AW_CALENDAR, BSC_AW_UTILITY, and BSC_METADATA. These are accessed via APPS synonyms rather than as physical tables. DBMS_SQL and PLITBLM are Oracle-supplied packages used for dynamic SQL execution and index-by-table (PL/SQL table) operations respectively. The BSC_METADATA package is the principal source of logical BSC definitions, while the adapter and calendar packages supply KPI, dimension, and calendar metadata. The package therefore reads metadata rather than writing transactional business data, and no direct base-table DML is documented.
Usage Notes
BSC_AW_BSC_METADATA is invoked internally by the Balanced Scorecard analytics and AW build processes. Because it is an OTHER-class API and is referenced by seven other packages, it is typically called indirectly—for example, when a user configures KPIs or dimension sets in the BSC administrator forms, or when a concurrent program refreshes the analytic workspace. Custom code should call it only with caution, since its procedures are not published integration interfaces and their behavior is tightly coupled to the BSC metadata model. The dynamic SQL reliance via DBMS_SQL means privileges on the underlying objects must be granted to the APPS schema, and the package is valid and supported on Oracle EBS 12.1.1 and 12.2.2.
-
PACKAGE BODY: APPS.BSC_AW_BSC_METADATA
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:BSC_AW_BSC_METADATA, status:VALID,
-
PACKAGE: APPS.BSC_AW_ADAPTER_DIM
12.1.1
owner:APPS, object_type:PACKAGE, object_name:BSC_AW_ADAPTER_DIM, status:VALID,
-
PACKAGE: APPS.BSC_AW_BSC_METADATA
12.1.1
owner:APPS, object_type:PACKAGE, object_name:BSC_AW_BSC_METADATA, status:VALID,
-
PACKAGE: APPS.BSC_AW_ADAPTER_KPI
12.1.1
owner:APPS, object_type:PACKAGE, object_name:BSC_AW_ADAPTER_KPI, status:VALID,
-
PACKAGE: APPS.BSC_AW_CALENDAR
12.1.1
owner:APPS, object_type:PACKAGE, object_name:BSC_AW_CALENDAR, status:VALID,
-
PACKAGE: APPS.BSC_METADATA
12.1.1
owner:APPS, object_type:PACKAGE, object_name:BSC_METADATA, status:VALID,
-
PACKAGE BODY: APPS.BSC_AW_ADAPTER
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:BSC_AW_ADAPTER, status:VALID,
-
PACKAGE BODY: APPS.BSC_AW_ADAPTER_DIM
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:BSC_AW_ADAPTER_DIM, status:VALID,
-
PACKAGE BODY: APPS.BSC_AW_ADAPTER_KPI
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:BSC_AW_ADAPTER_KPI, status:VALID,
-
PACKAGE: APPS.BSC_AW_BSC_METADATA
12.1.1
-
PACKAGE BODY: APPS.BSC_AW_CALENDAR
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:BSC_AW_CALENDAR, status:VALID,
-
PACKAGE BODY: APPS.BSC_AW_LOAD_KPI
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:BSC_AW_LOAD_KPI, status:VALID,
-
PACKAGE BODY: APPS.BSC_AW_READ
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:BSC_AW_READ, status:VALID,
-
PACKAGE BODY: APPS.BSC_AW_UTILITY
12.1.1
owner:APPS, object_type:PACKAGE BODY, object_name:BSC_AW_UTILITY, status:VALID,
-
12.1.1 DBA Data
12.1.1
-
PACKAGE: APPS.BSC_AW_UTILITY
12.1.1
owner:APPS, object_type:PACKAGE, object_name:BSC_AW_UTILITY, status:VALID,
-
12.1.1 DBA Data
12.1.1
-
APPS.BSC_AW_BSC_METADATA dependencies on BSC_AW_BSC_METADATA
12.1.1
-
APPS.BSC_AW_UTILITY dependencies on BSC_AW_BSC_METADATA
12.1.1
-
APPS.BSC_AW_LOAD_KPI dependencies on BSC_AW_BSC_METADATA
12.1.1
-
APPS.BSC_AW_ADAPTER_DIM dependencies on BSC_AW_BSC_METADATA
12.1.1
-
APPS.BSC_AW_CALENDAR dependencies on BSC_AW_BSC_METADATA
12.1.1
-
APPS.BSC_AW_ADAPTER_KPI dependencies on BSC_AW_BSC_METADATA
12.1.1
-
APPS.BSC_AW_READ dependencies on BSC_AW_BSC_METADATA
12.1.1
-
APPS.BSC_AW_ADAPTER dependencies on BSC_AW_BSC_METADATA
12.1.1
-
PACKAGE BODY: APPS.BSC_AW_BSC_METADATA
12.1.1
-
SYNONYM: PUBLIC.DBMS_SQL
12.1.1
owner:PUBLIC, object_type:SYNONYM, object_name:DBMS_SQL, status:VALID,
-
APPS.BSC_AW_BSC_METADATA dependencies on BSC_METADATA
12.1.1
-
APPS.BSC_AW_BSC_METADATA dependencies on DBMS_SQL
12.1.1
-
SYNONYM: PUBLIC.PLITBLM
12.1.1
owner:PUBLIC, object_type:SYNONYM, object_name:PLITBLM, status:VALID,
-
PACKAGE BODY: APPS.BSC_AW_ADAPTER_KPI
12.1.1
-
12.1.1 DBA Data
12.1.1
-
12.1.1 DBA Data
12.1.1
-
PACKAGE: SYS.STANDARD
12.1.1
owner:SYS, object_type:PACKAGE, object_name:STANDARD, status:VALID,