Marketing, Security, and Other Elements 16-7
Syntax QualifiedListItem …
cacheTable= CacheCatalog
RefPresentationCatalog … CacheCatalog
CacheConnPool RefConnectionPool …
CacheConnPool TargetColumn
RefPresentationColumn … TargetColumn
NodeColumn RefPresentationColumn …
NodeColumn DeleteSQL
CDATA[[…]] DeleteSQL
QualifiedListItem
Example QualifiedListItem name=Service Requests id=4018:280972 uid=2150831252
DescriptionDescription DeleteSQL
[CDATA[DELETE FROM M_C_GENERIC WHERE GUID = {guid}]] DeleteSQL
QualifiedListItem
16.1.5 Qualifying Key
The qualifying key element corresponds to the qualifying keys that are used in list catalog or segmentation catalog objects in the Marketing metadata. Qualifying keys
map qualified list items to presentation columns.
The qualifying key tag includes the following child elements:
The qualifying key tag does not include any attributes. PhysicalTable
References the physical table that stores the cached qualified list item.
The physical table is contained in a sub-element called RefPhysicalTable.
DeleteSQL Contains the physical SQL used to delete the cached results.
Table 16–7 Qualifying Key Child Elements
Element Name Description
RefSegCatalog References the segmentation catalog to which this qualifying
key belongs. RefListCatalog
References the list catalog to which this qualifying key belongs. RefPresentationColumn
References the presentation column for this qualifying key.
Table 16–6 Cont. Qualified List Item Child Elements
Element Name Description
16-8 Oracle Fusion Middleware Integrators Guide for Oracle Business Intelligence Enterprise Edition
Syntax QualifyingKey …
RefSegCatalog .. RefListCatalog ..
RefPresentatonColumn .. QualifyingKey
Example QualifyingKey name=Qualifying Key37 parentName=Orders
parentId=4018:280974 parentUid=2150831254
id=4020:281020 uid=2150831263
DescriptionDescription RefListCatalog uid=2150825512 id=4016:281114 qualifiedName=
quot;Marketing Contact Listquot; RefPresentationColumn uid=2150705283 id=4010:266234 qualifiedName=
quot;Marketing Contact Listquot;..quot;Orderquot;.quot;ROW_IDquot;
QualifyingKey
16.1.6 Sampling Table
The sampling table element corresponds to the sampling table object in the Marketing metadata. Sampling tables are created and managed as part of target level objects.
The sampling table tag includes the following attributes:
The sampling table tag includes the following child elements:
Syntax SamplingTable …
factor=5 RefPhysicalTable …
SamplingTable
Example SamplingTable name=M_10C_PERSON_D parentName=Contacts
parentId=4014:280966 parentUid=2150343035
id=4024:281051 uid=2150831204
factor=0.1
DescriptionDescription RefPhysicalTable uid=2253227 id=3001:86873 qualifiedName=quot;Oracle
Data Warehousequot;.quot;Catalogquot;.quot;dboquot;. quot;Dim_W_PARTY_PER_D_Contactquot;
SamplingTable
Table 16–8 Sampling Table Tag Attributes
Attribute Name Description
factor The sampling factor for example, 10.
Table 16–9 Sampling Table Child Elements
Element Name Description
RefPhysicalTable References the physical table being used as the sampling table.
Marketing, Security, and Other Elements 16-9
16.1.7 Seg Catalog
The seg catalog element corresponds to the segmentation catalog object in the Marketing metadata. Segmentation catalogs are Oracle BI subject areas that are
enabled for segmentation. Segmentation catalogs provides a set of dimensions and fact measures that can be used to create segment criteria.
The seg catalog tag includes the following child elements:
The seg catalog tag does not include any attributes.
Syntax SegCatalog …
RefPresentationCatalog … QualifyingKeys
RefQualifyingKey … QualifyingKeys
SegCatalog
Example SegCatalog name=Contacts_Customer Profile_segmentation
parentName=quot;Contactsquot; parentId=4014:280966
parentUid=2150343035 id=4026:281055
uid=2150343042
DescriptionDescription RefPresentationCatalog uid=2150319327 id=4004:275472 qualifiedName=
quot;Customer Profile_segmentationquot; QualifyingKeys
RefQualifyingKey uid=2150707126 id=4020:280992 qualifiedName= quot;Contactsquot;.quot;Qualifying Keyquot;
RefQualifyingKey uid=2150823314 id=4020:281033 qualifiedName= quot;Accountsquot;.quot;Qualifying Key21quot;
QualifyingKeys SegCatalog
16.2 Security Elements
Security elements are typically those elements that are related to Oracle Business Intelligence security features, such as those related to variables, authentication,
privileges, users, and application roles. Security elements include:
■
Section 16.2.1, Variable
■
Section 16.2.2, LDAP Server
■
Section 16.2.3, Init Block
■
Section 16.2.4, Custom Authenticator
Table 16–10 Seg Catalog Child Elements
Element Name Description
RefPresentationCatalog References the subject area for this segmentation catalog.
QualifyingKeys References the set of qualifying keys for this list catalog.
Each qualifying key is contained in a sub-element called RefQualifyingKey.
16-10 Oracle Fusion Middleware Integrators Guide for Oracle Business Intelligence Enterprise Edition
■
Section 16.2.5, Privilege Package
■
Section 16.2.6, Object Privilege
■
Section 16.2.7, Query Privilege
■
Section 16.2.8, User
■
Section 16.2.9, Group
■
Section 16.2.10, DB Sign-On
■
Section 16.2.11, FMW Security
16.2.1 Variable
The variable element corresponds to the variable object in the Physical layer of the repository.
The variable tag includes the following attributes:
The variable tag includes the following child elements:
Syntax Variable name= id= uid=
securityMask= isSessionVar=
Description Expr...Expr
Table 16–11 Variable Tag Attributes
Attribute Name Description
securityMask For session variables only. This attribute stores the value of the
following options:
■
Enable any user to set the value. When selected, lets
session variables be set after the initialization block has populated the value at user login by calling the ODBC
store procedure NQSSetSessionValue. For example, this option lets non-administrators set this variable for
sampling.
■
Security Sensitive. When selected, identifies the variable as
sensitive to security for virtual private databases VPDs. When filtering cache table matches, the Oracle BI Server
looks at the parent database of each column or table that is referenced in the logical request projection list. If the
physical database source is a VPD, the Oracle BI Server matches a list of security-sensitive variables to each
prospective cache hit. Cache hits would only occur on cache entries that included and matched all
security-sensitive variables.
isSessionVar If set to true, indicates that this variable is a session variable.
Session variables are created and assigned a value when each user logs on, unlike repository variables, which have static
values.
Table 16–12 Variable Child Elements
Element Name Description
Expr Contains the expression that forms the definition of this
variable.
