13-12 Oracle Fusion Middleware Integrators Guide for Oracle Business Intelligence Enterprise Edition
Example LogicalKey name=RegKey
parentName=quot;Paintquot;.quot;MarketDimquot;.quot;Regionquot; parentId=2025:121
id=2008:183 uid=139
isPrimary=true isForDrillDown=true
Description Columns
RefLogicalColumn id=2006:75 qualifiedName=quot;Paintquot;. quot;Marketsquot;.quot;Regionquot;
Columns LogicalKey
13.9 Logical Table Source
The logical table source element corresponds to the logical table source object in the Business Model and Mapping layer. See also the column mapping element, described
in Section 13.9.1, Column Mapping.
The logical table source tag includes the following attributes:
The logical table source tag includes the following child elements:
Table 13–17 Logical Table Source Attributes
Attribute Name Description
isDistinct This attribute is used if the values for the logical table source are
unique. In the Administration Tool, this option is called Select distinct values
in the Content tab of the Logical Table Source dialog.
isDimOnly If set to true, indicates that this source is the preferred logical
table source for dimension-only queries. Dimension-only queries retrieve results from the dimension table without
joining with the fact table, unlike normal queries, which always have at least one fact column in the query.
In the Administration Tool, this option is called Dimension Browse
in the General tab of the Logical Table Source dialog. isSysGen
If set to true, indicates that an internal utility such as the Aggregate Persistence Wizard has generated this logical table
source. canCombine
If set to true, indicates that this logical table source can be combined with other logical table sources to provide a full set of
results. In the Administration Tool, this option is called This source should be combined with other sources at this level
in the Content tab of the Logical Table Source dialog.
isActive If set to true, indicates that this logical table source is active. In
the Administration Tool, this attribute corresponds with the Disabled
option in the General tab of the Logical Table Source dialog.
priorityGroup Indicates the priority group number of this logical table source.
Logical table source priority group numbers are assigned to indicate which logical table source should be used for queries
for which there is more than one logical table source that can satisfy the requested set of columns.
Logical Elements 13-13
Table 13–18 Logical Table Source Child Elements
Element Name Description
Link References the set of physical tables to which the logical table
source is mapped. These links are references to the physical joins that already exist. In the Administration Tool, this element
corresponds with the Map to these tables section in the General tab of the Logical Table Source dialog.
Each link child element contains two sub-elements, StartNode and Joins:
■
The StartNode sub-element references the physical table identified by this link. It can contain the RefCubeTable,
RefPhysicalTable, RefAWDimension, or RefAWCube sub-element, depending on your data source type.
■
The Joins sub-element defines the joins for this link. It contains different sub-elements, depending on the type of
join. For example: RefCubeTable, RefPhysicalTable, RefAWCube, or
RefAWDimension RefPhysicalForeignKey or RefComplexJoin
DrivingTable, which contains a sub-element RefPhysicalTable
The Joins sub-element has two attributes: type Inner, LeftOuter, RightOuter, FullOuter, or
FullOuterStitch and cardinality ONE TO ONE, ZERO OR ONE TO ONE, ONE TO ZERO OR ONE, ZERO
OR ONE TO ZERO OR ONE, ONE TO MANY, ZERO OR ONE TO MANY, ZERO OR ONE TO MANY, MANY TO ONE,
MANY TO ZERO OR ONE, or MANY TO MANY.
See the syntax for the logical table source element to see the complete hierarchy for the link child element.
WhereClause If a WHERE clause filter has been defined, contains the WHERE
clause expression that limits the number of rows the source uses in the resultant table. The expression is contained in a
sub-element called Expr.
In the Administration Tool, this option is called Use this WHERE clause filter to limit rows returned exclude the
WHERE in the Content tab of the Logical Table Source dialog.
GroupBy Contains the expression that defines whether the aggregation is
grouped by logical level or by column. The expression is contained in a sub-element called Expr.
In the Administration Tool, this option is called Aggregation content, group by
in the Content tab of the Logical Table Source dialog.
FragmentContent Contains the expression that defines how the source is
fragmented. The expression is contained in a sub-element called Expr.
This child element is used in conjunction with the canCombine attribute. In the Administration Tool, this option is called
Fragmentation content
in the Content tab of the Logical Table Source dialog.
ClosureTable References the parent-child table, if any.
The parent-child table is contained in a sub-element called RefPhysicalTable.
13-14 Oracle Fusion Middleware Integrators Guide for Oracle Business Intelligence Enterprise Edition
Syntax LogicalTableSource …
isDistinct= isDimOlny=
isSysGen= canCombine=
isActive= priorityGroup=
Description Link
StartNode RefPhysicalTable …
StartNode Joins
Join type= cardinality= RefPhysicalTable …
RefPhysicalTable … RefPhysicalForeignKey …
Join Joins
Link WhereClause
Expr...Expr WhereClause
GroupBy Expr
GroupBy FragmentContent
Expr FragmentContent
ClosureTable RefTable …
ClosureTable LogicalTableSource
Example LogicalTableSource name=WEEK, UPC, CITY
parentName=quot;Paintquot;.quot;Sales Factsquot; parentId=2035:21
id=2037:368 uid=324
isActive=true
Description Link
StartNode RefPhysicalTable id=3001:550 qualifiedName=quot;Paintquot;...quot;
Factquot; StartNode
Joins Join type=Inner cardinality=MANY TO ONE
RefPhysicalTable id=3001:550 qualifiedName=quot;Paintquot;... quot;Factquot;
RefPhysicalTable id=3001:560 qualifiedName=quot;Paintquot;quot;... quot;Marketquot;
RefPhysicalForeignKey id=3006:621 qualifiedName=quot;Paintquot;... quot;Factquot;.quot;fact_FKey1quot;
Join Join type=Inner cardinality=MANY TO ONE
RefPhysicalTable id=3001:550 qualifiedName=quot;Paintquot;...
Logical Elements 13-15
quot;Factquot; RefPhysicalTable id=3001:587 qualifiedName=quot;Paintquot;...
quot;Periodquot; RefPhysicalForeignKey id=3006:625 qualifiedName=quot;Paintquot;...
quot;Factquot;.quot;fact_FKey2quot;
Join Join type=Inner cardinality=MANY TO ONE
RefPhysicalTable id=3001:550 qualifiedName=quot;Paintquot;... quot;Factquot;
RefPhysicalTable id=3001:601 qualifiedName=quot;Paintquot;... quot;Productquot;
RefPhysicalForeignKey id=3006:626 qualifiedName=quot;Paintquot;... quot;Factquot;.quot;fact_FKey3quot;
Join Joins
Link Link
StartNode RefPhysicalTable id=3001:601 qualifiedName=quot;Paintquot;...
quot;Productquot; StartNode
Joins Join type=Inner cardinality=ONE TO MANY
RefPhysicalTable id=3001:601 qualifiedName=quot;Paintquot;... quot;Productquot;
RefPhysicalTable id=3001:550 qualifiedName=quot;Paintquot;... quot;Factquot;
RefPhysicalForeignKey id=3006:626 qualifiedName=quot;Paintquot;... quot;Factquot;.quot;fact_FKey3quot;
Join Joins
Link WhereClause
Expr [CDATA[ Paint...Market.LevelX = MARKET AND Paint.
..Product.LevelX = UPC AND Paint...Period.LevelX = WEEK]]
Expr WhereClause
GroupBy Expr
GroupBy FragmentContent
Expr FragmentContent
LogicalTableSource
13.9.1 Column Mapping
The column mapping element does not correspond to any metadata repository object. It is only used in conjunction with the logical table source element. The column
mapping element appears on its own in the XML schema .xsd file, rather than as part of the logical table source element, so that the column mapping details are easier to
read and update.
The column mapping tag includes the following child elements:
