Oracle® Fusion Middleware Oracle Business Intelligence Enterprise Editionインテグレーターズ・ガイド 11g リリース1(11.1.1) B63033-01 |
|
前 |
次 |
この章では、Oracle Marketing Segmentationオブジェクト、セキュリティ・オブジェクト、および他のカテゴリに含まれないその他のオブジェクトのXML API要素について説明します。
この章は、次の項で構成されています。
マーケティング要素とは、主に、Oracle Marketing Segmentation製品の機能に関連する要素です。Oracle Marketing Segmentationに関連する機能とオプションの詳細は、Oracle Marketing Segmentationアプリケーションの管理者向けドキュメントを参照してください。
マーケティング要素には次のものがあります。
カタログ・リンク要素は、マーケティング・メタデータの同ディメンションのリンク・オブジェクトに対応しています。同ディメンションのリンクでは、2つのファクト表で共有されているディメンションに沿ったナビゲーションによって、ターゲット・レベルIDを含むファクトが、ターゲット・レベルIDを含まないファクトにリンクされます。
カタログ・リンク・タグには次の子要素があります。
表16-1 カタログ・リンクの子要素
要素名 | 説明 |
---|---|
From |
ディメンションのリンク元であるサブジェクト・エリアの主キーを表すプレゼンテーション列を参照します。 主キー列は |
To |
ディメンション・リンクが指すサブジェクト・エリアの主キーを表すプレゼンテーション列を参照します。 主キー列は |
カタログ・リンク・タグには属性はありません。
構文
<CatalogLink …> <From> <RefPresentationColumn …/> </From> <To> <RefPresentationColumn …/> </To> </CatalogLink>
例
<CatalogLink name="Customer Profile->Campaign Contacts" id="4012:280960" uid="2150823331"> <Description> <![CDATA[Used by both Contact and Account Target Levels to filter with "Offered Product_segmentation" catalog.]]> </Description> <To> <RefPresentationColumn uid="2150707139" id="4010:223709" qualifiedName= ""Campaign Contacts_segmentation".."- Contact Profile". "ROW_ID""/> </To> </CatalogLink>
ターゲット・レベル要素は、マーケティング・メタデータのターゲット・レベル・オブジェクトに対応しています。ターゲット・レベルとは、マーケティング担当者が重視するエンティティ(一般に、個人、企業、家族などの顧客タイプ)です。
ターゲット・レベル・タグには次の属性があります。
表16-2 ターゲット・レベル・タグの属性
属性名 | 説明 |
---|---|
hasDispName |
このターゲット・レベルがカスタムの表示名を持っているかどうかを示します。 |
dispName |
カスタム表示名の値(このターゲット・レベルにカスタム表示名が存在する場合)。 |
hasDispDescription |
このターゲット・レベルがカスタムの説明を持っているかどうかを示します。 |
dispDescription |
カスタム説明の値(このターゲット・レベルにカスタム説明が存在する場合)。 |
ターゲット・レベル・タグには次の子要素があります。
表16-3 ターゲット・レベルの子要素
要素名 | 説明 |
---|---|
PrimaryQLI |
このターゲット・レベルのプライマリ修飾リスト項目を参照します。 修飾リスト項目は |
PrimaryPresCatalog |
このターゲット・レベルのプライマリ・セグメンテーション・カタログを参照します。 セグメンテーション・カタログは |
SamplingTables |
このターゲット・レベルのサンプリング表として使用する物理表を参照します。 各物理表は |
Catalogs |
このターゲット・レベルのセグメンテーション・カタログ・セットを参照します。 各セグメンテーション・カタログは |
PresentationCatalog |
保存された結果セット(保存済結果カタログ)のサブジェクト・エリアを参照します。 保存済結果カタログは |
TargetColumn |
ターゲットIDプレゼンテーション列を参照します。 ターゲットID列は |
NodeColumn |
GUIDプレゼンテーション列を参照します。 GUID列は |
PhysicalTable |
このターゲット・レベルの結果セットを格納する物理表を参照します。 物理表は |
ConnectionPool |
このターゲット・レベルがマップされている接続プールを参照します。 接続プールはRefConnectionPoolというサブ要素に含まれます。 |
HeaderSQL |
保存済結果ヘッダーの挿入を実行する物理SQLを格納します。ユーザーによる結果セットの保存時に使用されます。 |
DelHeaderSQL |
保存済結果セット・ヘッダーの削除を実行する物理SQLを格納します。ユーザーによる保存済結果セットのパージ時に使用されます。 |
DelDataSQL |
保存済結果データ・セットの削除を実行する物理SQLを格納します。ユーザーによる保存済結果セットのパージ時に使用されます。 |
構文
<TargetLevel … hasDispName="" dispName="" hasDispDescription="" dispDescription="" > <PrimaryQLI> <RefQualifiedListItem …/> </PrimaryQLI> <PrimaryPresCatalog> <RefPresentationCatalog…/> </PrimaryPresCatalog> <SamplingTables> <RefPhysicalTable …/> </SamplingTables> <Catalogs> <RefSegCatalog ../> <RefSegCatalog ../> </Catalogs> <PresentationCatalog> <RefPresentationCatalog…/> </PresentationCatalog> <TargetColumn> <RefPresentationColumn…/> </TargetColumn> <NodeColumn> <RefPresentationColumn…/> </NodeColumn> <PhysicalTable> <RefPhysicalTable…/> </PhysicalTable> <ConnectionPool> <RefConnectionPool…/> </ConnectionPool> <HeaderSQL…/> <DelHeaderSQL…/> <DelDataSQL…/> </TargetLevel>
例
<TargetLevel name="Contacts" id="4014:280966" uid="2150343035" hasDispName="false" hasDispDescription="false"> <Description></Description> <PrimaryQLI> <RefQualifiedListItem uid="2150343036" id="4018:280973" qualifiedName= ""Contacts""/> </PrimaryQLI> <PrimaryPresCatalog> <RefPresentationCatalog uid="2150319327" id="4004:275472" qualifiedName= ""Customer Profile_segmentation""/> </PrimaryPresCatalog> <SamplingTables> <RefSamplingTable uid="2150831204" id="4024:281051" qualifiedName= ""Contacts"."M_10C_PERSON_D""/> </SamplingTables> <Catalogs> <RefSegCatalog uid="2150343042" id="4026:281055" qualifiedName= ""Contacts"."Contacts_Customer Profile_segmentation""/> <RefSegCatalog uid="2150343043" id="4026:281056" qualifiedName= ""Contacts"."Contacts_Orders_segmentation""/> <RefSegCatalog uid="2150343044" id="4026:281057" qualifiedName= ""Contacts"."Contacts_Assets_segmentation""/> <RefSegCatalog uid="2150343041" id="4026:281058" qualifiedName= ""Contacts"."Contacts_Activities_segmentation""/> </Catalogs> <TargetColumn> <RefPresentationColumn uid="2150343373" id="4010:226666" qualifiedName= ""Marketing Segmentation Cache and Saved Results".."- Contact Results Data"."Person ID""/> </TargetColumn> <NodeColumn> <RefPresentationColumn uid="2150343375" id="4010:226665" qualifiedName= ""Marketing Segmentation Cache and Saved Results".."- Contact Results Data"."GUID""/> </NodeColumn> <PhysicalTable> <RefPhysicalTable uid="2150343168" id="3001:99531" qualifiedName= ""Oracle Data Warehouse"."Catalog"."dbo". "M_SR_CONTACT""/> </PhysicalTable> <HeaderSQL> <![CDATA[INSERT INTO M_SR_HEADER (GUID, SEGMENT_PATH, SR_CUSTOM_LABEL, PRIORITY, NODE_PATH, NODE_LABEL, TARGET_LEVEL, CREATED_BY, "COUNT", DATE_ TIME, SR_PATH, CONNECTION_POOL) VALUES ('@{guid}', '@{segmentPath}', '@{srCustomLabel}', @{priority}, '@{nodePath}', '@{nodeLabel}', '@{targetLevel}','@{createdBy}', @{count},'@{createdTime}', '@{srPath}', '@{connectionPool}')]]> </HeaderSQL> <DelHeaderSQL> <![CDATA[DELETE FROM M_SR_HEADER WHERE GUID IN (@{guids})]]> </DelHeaderSQL> <DelDataSQL> <![CDATA[DELETE FROM M_SR_CONTACT WHERE GUID IN (@{guids})]]> </DelDataSQL> </TargetLevel>
リスト・カタログ要素はマーケティング・メタデータのリスト・カタログ・オブジェクトに対応しています。リスト・カタログとは、ターゲット・レベルでのデータ・リストの生成に使用されるオブジェクトです。
リスト・カタログ・タグには次の子要素があります。
表16-4 リスト・カタログの子要素
要素名 | 説明 |
---|---|
RefPresentationCatalog |
このカタログのサブジェクト・エリアを参照します。サブジェクト・エリア名がリスト・カタログの名前として使用されます。 |
QualifyingKeys |
このリスト・カタログの修飾キーのセットを参照します。 各修飾キーは |
リスト・カタログ・タグには属性はありません。
構文
<ListCatalog …> <RefPresentationCatalog …/> <QualifyingKeys> <RefQualifyingKey …/> <RefQualifyingKey …/> </QualifyingKeys> </ListCatalog>
例
<ListCatalog name="Marketing Contact List" id="4016:281114" uid="2150825512"> <Description></Description> <RefPresentationCatalog uid="2150704699" id="4004:275681" qualifiedName= ""Marketing Contact List""/> <QualifyingKeys> <RefQualifyingKey uid="2150831265" id="4020:280989" qualifiedName= ""Service Requests"."Qualifying Key#36""/> <RefQualifyingKey uid="2150831263" id="4020:281020" qualifiedName= ""Orders"."Qualifying Key#37""/> </QualifyingKeys> </ListCatalog>
修飾リスト項目要素はマーケティング・メタデータの修飾リスト項目オブジェクトに対応しています。修飾リスト項目とは、セグメント基準に基づいて評価されるエンティティであり、特定の項目に関連する情報をリスト・ファイルにエクスポートする目的で使用されます。
修飾リスト項目タグには次の属性があります。
修飾リスト項目タグには次の子要素があります。
表16-6 修飾リスト項目の子要素
要素名 | 説明 |
---|---|
CacheCatalog |
この修飾リスト項目のキャッシュのサブジェクト・エリアを参照します。 サブジェクト・エリアは |
CacheConnPool |
キャッシュ表の接続プールを参照します。 接続プールは |
TargetColumn |
ターゲットIDプレゼンテーション列を参照します。 ターゲットID列は |
NodeColumn |
GUIDプレゼンテーション列を参照します。 GUID列は |
PhysicalTable |
キャッシュされた完全修飾リスト項目を格納する物理表を参照します。 物理表は |
DeleteSQL |
キャッシュされた結果の削除に使用する物理SQLを格納します。 |
構文
<QualifiedListItem … cacheTable=""> <CacheCatalog> <RefPresentationCatalog …/> </CacheCatalog> <CacheConnPool> <RefConnectionPool …/> </CacheConnPool> <TargetColumn> <RefPresentationColumn …/> </TargetColumn> <NodeColumn> <RefPresentationColumn …/> </NodeColumn> <DeleteSQL> <!CDATA[[…]]> </DeleteSQL> </QualifiedListItem>
例
<QualifiedListItem name="Service Requests" id="4018:280972" uid="2150831252"> <Description></Description> <DeleteSQL> <![CDATA[DELETE FROM M_C_GENERIC WHERE GUID = '@{guid}']]> </DeleteSQL> </QualifiedListItem>
修飾キー要素は、マーケティング・メタデータのリスト・カタログ・オブジェクトまたはセグメンテーション・カタログ・オブジェクトで使用される修飾キーに対応しています。修飾キーによって、修飾リスト項目がプレゼンテーション列にマップされます。
修飾キー・タグには次の子要素があります。
表16-7 修飾キーの子要素
要素名 | 説明 |
---|---|
RefSegCatalog |
この修飾キーが属するセグメンテーション・カタログを参照します。 |
RefListCatalog |
この修飾キーが属するリスト・カタログを参照します。 |
RefPresentationColumn |
この修飾キーのプレゼンテーション列を参照します。 |
この修飾キー・タグには属性はありません。
構文
<QualifyingKey …> <RefSegCatalog ../> <RefListCatalog ../> <RefPresentatonColumn ../> </QualifyingKey>
例
<QualifyingKey name="Qualifying Key#37" parentName=""Orders"" parentId="4018:280974" parentUid="2150831254" id="4020:281020" uid="2150831263"> <Description></Description> <RefListCatalog uid="2150825512" id="4016:281114" qualifiedName= ""Marketing Contact List""/> <RefPresentationColumn uid="2150705283" id="4010:266234" qualifiedName= ""Marketing Contact List".."Order"."ROW_ID""/> </QualifyingKey>
サンプリング表要素はマーケティング・メタデータのサンプリング表オブジェクトに対応しています。サンプリング表はターゲット・レベル・オブジェクトの一部として作成および管理されます。
サンプリング表タグには次の属性があります。
サンプリング表タグには次の子要素があります。
構文
<SamplingTable … factor="5%"> <RefPhysicalTable …/> </SamplingTable>
例
<SamplingTable name="M_10C_PERSON_D" parentName=""Contacts"" parentId="4014:280966" parentUid="2150343035" id="4024:281051" uid="2150831204" factor="0.1"> <Description></Description> <RefPhysicalTable uid="2253227" id="3001:86873" qualifiedName=""Oracle Data Warehouse"."Catalog"."dbo". "Dim_W_PARTY_PER_D_Contact""/> </SamplingTable
セグ・カタログ要素はマーケティング・メタデータのセグメンテーション・カタログ・オブジェクトに対応しています。セグメンテーション・カタログは、セグメンテーションに対して有効なOracle BIサブジェクト・エリアです。セグメンテーション・カタログは、セグメント基準の作成に使用できるディメンションとファクト・メジャーのセットを提供します。
セグ・カタログ・タグには次の子要素があります。
表16-10 セグ・カタログの子要素
要素名 | 説明 |
---|---|
RefPresentationCatalog |
このセグメンテーション・カタログのサブジェクト・エリアを参照します。 |
QualifyingKeys |
このリスト・カタログの修飾キーのセットを参照します。 各修飾キーは |
セグ・カタログ・タグには属性はありません。
構文
<SegCatalog …> <RefPresentationCatalog …/> <QualifyingKeys> <RefQualifyingKey …/> </QualifyingKeys> </SegCatalog>
例
<SegCatalog name="Contacts_Customer Profile_segmentation" parentName=""Contacts"" parentId="4014:280966" parentUid="2150343035" id="4026:281055" uid="2150343042"> <Description></Description> <RefPresentationCatalog uid="2150319327" id="4004:275472" qualifiedName= ""Customer Profile_segmentation""/> <QualifyingKeys> <RefQualifyingKey uid="2150707126" id="4020:280992" qualifiedName= ""Contacts"."Qualifying Key""/> <RefQualifyingKey uid="2150823314" id="4020:281033" qualifiedName= ""Accounts"."Qualifying Key#21""/> </QualifyingKeys> </SegCatalog>
セキュリティ要素とは、主に、Oracle Business Intelligenceのセキュリティ機能に関連する要素であり、たとえば変数、認証、権限、ユーザー、アプリケーション・ロールなどに関連する要素を指します。セキュリティ要素には次のものがあります。
変数要素は、リポジトリの物理レイヤー内の変数オブジェクトに対応しています。
変数タグには次の属性があります。
表16-11 変数タグの属性
属性名 | 説明 |
---|---|
securityMask |
セッション変数にのみ使用されます。この属性は次のオプションの値を格納します。
|
isSessionVar |
trueに設定されている場合は、この変数がセッション変数であることを示します。リポジトリ変数の値が静的であるのに対し、セッション変数は、各ユーザーのログオン時に作成され、値が代入されます。 |
変数タグには次の子要素があります。
構文
<Variable name="" id="" uid="" securityMask="" isSessionVar="" > <Description /> <Expr>...</Expr> </Variable>
例
<Variable name="Current Month" id="3031:16" uid="17"> <Description /> <Expr> <![CDATA[ CURRENT_DATE ]]> </Expr> </Variable>
LDAPサーバー要素は、管理ツールの「Identity Manager」ダイアログにあるLDAPサーバー・オブジェクトに対応しています。
LDAPサーバー・タグには次の属性があります。
表16-13 LDAPサーバー・タグの属性
属性名 | 説明 |
---|---|
hostName |
LDAPサーバーのホスト名。 |
port |
LDAPサーバーのポート番号(389など)。 |
baseDN |
認証検索の開始点を識別するベース識別名(DN)。 |
bindDN |
LDAPサーバーへのバインドに必要なオプションのDN。 |
userNameAttrType |
ユーザーID、RDN(相対識別名)、sAMAccountName(ADSIの場合)などの、ユーザーを一意に識別する値。 |
domainID |
LDAPオブジェクトの担当範囲のドメインを一意に識別するドメイン識別子。これはLDAPオブジェクトが複数存在する場合に特に役立ちます。 |
password |
バインドDNに関連付けられたユーザー・パスワード。 |
timeout |
管理ツールによるインポート試行またはOracle BIサーバーによるユーザーの認証試行がタイムアウトになるまでの時間。 |
cacheExpiry |
LDAPキャッシュ内の、ログオンしたユーザーの認証キャッシュ・エントリをリフレッシュする間隔。 このオプションは、管理ツールの「オプション」ダイアログの「リポジトリ」タブにある「キャッシュ・リフレッシュ間隔」に対応しています。 |
isADSI |
trueに設定されている場合は、Active Directory LDAPサーバーであることを示します。 |
useSSL |
trueに設定されている場合は、LDAPサーバーへの接続にSecure Sockets Layer(SSL)を使用することを示します。 |
keyFile |
クライアント証明書と認証局(CA)証明書を格納するキー・ファイルの名前。useSSLがtrueに設定されている場合は必須です。 このオプションは、管理ツールの「オプション」ダイアログの「リポジトリ」タブにある「キー・ファイル名」に対応しています。 |
version |
LDAPサーバーのLDAPバージョン番号2または3のいずれか。デフォルトは3です。 |
cacheEntries |
Oracle BIサーバーの起動時に事前割当てされる認証キャッシュの最大エントリ数。ユーザー数がこの制限を超えると、キャッシュ・エントリはLRUアルゴリズムを使用して置換されます。この値が0の場合は、認証キャッシュは無効になります。 このオプションは、管理ツールの「オプション」ダイアログの「リポジトリ」タブにある「キャッシュ・エントリ数」に対応しています。 |
LDAPサーバー・タグには子要素はありません。
構文
<LDAPServer … hostName="" port="" baseDN="" bindDN="" userNameAttrType="" domainID="" password="" timeout="" cacheExpiry="" entities="" isADSI="" useSSL="" keyFile="" version="" cacheEntries="" > </LDAPServer>
例
<LDAPServer name="ldap" id="3035:3119" uid="5032" hostName="sdacns05" port="389" version="3" baseDN="name1" bindDN="name2" userNameAttrType="sAMAccountName" domainID="as" password="D7EDED84BC624A917F5B462A4DCA05CDCE256EEEEEDC97D5A3D4B868D64238CA" timeout="60" cacheExpiry="86400" cacheEntries="1000" isADSI="true" useSSL="true"> <Description></Description> </LDAPServer>
初期化ブロック要素は、物理レイヤーの初期化ブロック・オブジェクトに対応しています。初期化ブロックはリポジトリの動的変数、システム・セッション変数および非システム・セッション変数の初期化に使用されます。
初期化ブロック・タグには次の属性があります。
表16-14 初期化ブロック・タグの属性
属性名 | 説明 |
---|---|
isSessionVar |
trueに設定されている場合は、この初期化ブロックがセッション初期化ブロックであることを示します。セッション初期化ブロックはセッション変数とともに使用されます。 デフォルト値はfalseです。 |
refreshPeriod |
この初期化ブロックのリフレッシュ間隔(秒数)。リポジトリ初期化ブロックに対してのみ使用されます。 デフォルト値は0です。 |
baseTime |
この初期化ブロックの開始日時。リポジトリ初期化ブロックに対してのみ使用されます。 デフォルト値は |
isRowWiseInit |
trueに設定されている場合は、行単位の初期化が有効化されていることを示します。行単位の初期化では、セッションの開始時にセッション変数を動的に作成して値を設定できます。セッション初期化ブロックに対してのみ使用されます。 デフォルト値はfalseです。 |
isRowWiseCacheEnabled |
trueに設定されている場合は、「キャッシュの使用」オプションが有効化されていることを示します。このオプションを指定すると、Oracle BIサーバーは問合せの結果をメイン・メモリー・キャッシュに格納します。このオプションは、行単位の初期化が有効化されている場合にのみ使用できます。 デフォルト値trueです。 |
isSuccRequired |
管理ツールでこの初期化ブロックに対して「認証のために必要」オプションが選択されていることを示します。 このオプションが選択されている場合、ユーザーがログインするためには、この初期化ブロックの実行に成功する必要があります。つまり、初期化ブロックの実行に失敗すると、ユーザーはOracle BI EEへのアクセスを拒否されます。実行の失敗は、初期化ブロックで誤った資格証明が定義されているか、またはデフォルトの初期化文字列にエラーがある場合に発生することがあります。 デフォルト値はfalseです。 |
isEnabled |
trueに設定されている場合は、この初期化ブロックが有効であることを示します。セッション初期化ブロックに対してのみ使用されます。 デフォルト値trueです。 |
初期化ブロック・タグには次の子要素があります。
表16-15 初期化ブロックの子要素
要素名 | 説明 |
---|---|
RefConnectionPool |
この初期化ブロックの接続プールを参照します。 この要素は、この初期化ブロックのデータ・ソース・タイプがデータベースまたはXMLの場合にのみ使用されます。 |
DBMap |
データベース固有の文字列の値を格納します。次に示すように、 <Item name=""> <Value /> </Item> |
Predecessors |
この初期化ブロックの前に初期化する初期化ブロックがある場合は、その初期化ブロックを参照します。 各初期化ブロックは |
Variables |
この初期化ブロックに関連付けられた変数を参照します。 各変数は |
InitString |
変数に移入する必要があるSQL初期化文字列。 この要素は、この初期化ブロックのデータ・ソース・タイプがデータベースまたはXMLの場合にのみ使用されます。 |
LDAPServers |
この初期化ブロックに関連付けられたLDAPサーバーを参照します。 各LDAPサーバーは この要素は、この初期化ブロックのデータ・ソース・タイプがLDAPの場合にのみ使用されます。 |
構文
<InitBlock name="" id="" uid="" isSessionVar="" refreshPeriod="" baseTime="" isRowWiseInit="" isRowWiseCacheEnabled="" isSuccRequired="" isEnabled=""> <Description /> <RefConnectionPool …/> <DBMap> <Item name=""> <Value …/> </Item> </DBMap> <Predecessors> <RefInitBlock …/> </Predecessors> <Variables> <RefVariable …/> <RefVariable …/> </Variables> <InitString …/> <LDAPServers> <RefLDAPServer …/> <RefLDAPServer …/> </LDAPServers> <InitBlock>
例
<InitBlock name="Test Block" id="3033:3052" uid="2147485020" isSessionVar="true" isRowWiseCacheEnabled="false"> <Description></Description> <RefConnectionPool id="3029:3045" qualifiedName=""SQLDB_NorthwindCodedRec". "NorthwindCodedRec Connections""/> <DBMap> <Item name="DefaultMulDB"> <Value><![CDATA[SELECT region, country, 'SQLDB', 'North', 'wind', 'Customers' FROM employees WHERE employeeid = 1]]></Value> </Item> </DBMap> <Variables> <RefVariable id="3031:160" qualifiedName=""Test Block". "REGION""/> <RefVariable id="3031:161" qualifiedName=""Test Block". "COUNTRY""/> <RefVariable id="3031:169" qualifiedName=""Test Block". "SQLDB""/> <RefVariable id="3031:170" qualifiedName=""Test Block". "North""/> <RefVariable id="3031:171" qualifiedName=""Test Block". "wind""/> <RefVariable id="3031:173" qualifiedName=""Test Block". "CustomersSamplingTable""/> </Variables> <InitString><![CDATA[SELECT region, country, 'SQLDB', 'North', 'wind', 'Customers' FROM employees WHERE employeeid = 1]]></InitString> </InitBlock>
カスタム認証要素は、管理ツールの「Identity Manager」ダイアログにあるカスタム認証システム・オブジェクトに対応しています。
カスタム認証システム・タグには次の属性があります。
表16-16 カスタム認証システム・タグの属性
属性名 | 説明 |
---|---|
cacheExpiry |
このカスタム認証システムで、ログオンしたユーザーの認証キャッシュ・エントリをリフレッシュする間隔。 |
path |
プラグインdllのパスと名前。 |
configParam |
このカスタム認証システムの、構成用に明示的に公開されているパラメータをリストします。 |
hiddenParam |
このカスタム認証システムの暗号化されているパラメータ(パスワードなど)をリストします。 |
cacheEntries |
Oracle BIサーバーの起動時に事前割当てされる、このカスタム認証システムの認証キャッシュの最大エントリ数。ユーザー数がこの制限を超えると、キャッシュ・エントリはLRUアルゴリズムを使用して置換されます。この値が0の場合は、認証キャッシュは無効になります。 |
カスタム認証システム要素には子要素はありません。
構文
<CustomAuthenticator name="" id="" uid="" cacheExpiry="" path="" configParam="" hiddenParam="" cacheEntries="" > </CustomAuthenticator>
例
<CustomAuthenticator name="Authenticator" id="3047:1210" uid="1148510121" cacheExpiry ="1000" path="authenticate.dll" > <Description></Description> </CustomAuthenticator>
権限パッケージ要素は他の権限のコンテナです。これは、リポジトリ・メタデータ内の特定のユーザーまたはアプリケーション・ロール・オブジェクトに適用される権限セットに対応しています。権限パッケージ要素は、管理ツールの「ユーザー/アプリケーション・ロール権限」ダイアログの「オブジェクト権限」タブ、「問合せ制限」タブおよび「データ・フィルタ」タブに表示される情報を格納します。
権限パッケージは複数のユーザーまたはアプリケーション・ロールと関連付けることができるので、権限パッケージの総数はユーザー・ロールおよびアプリケーション・ロールの総数と一致しない場合があります。
権限パッケージ・タブには次の子要素があります。
表16-17 権限パッケージの子要素
要素名 | 説明 |
---|---|
QueryPrivileges |
この権限パッケージに属する問合せ権限および対応するデータベースを参照します。 問合せ権限とデータベースの各ペアは 各
|
Filters |
オブジェクト名とフィルタ式のマッピングによって、この権限パッケージに属するデータ・フィルタを参照します。 オブジェクト名とフィルタ式の各ペアは 各
|
ObjectPrivileges |
この権限パッケージに属するオブジェクト権限を参照します。 各オブジェクト権限は |
権限パッケージ・タグには属性はありません。スキーマでnone
、 read
、write
、readwrite
、delete
、grant
およびall
の属性をリストしていますが、これらの属性は使用されません。これらの権限は子要素定義の一部として公開されます。
構文
<PrivilegePackage …> <QueryPrivileges> <Mapping> <RefDatabase …/> <RefQueryPrivilege …/> </Mapping> </QueryPrivileges> <RefTypePrivilege ../> <Filters> <Mapping status=""> <RefObject …/> <Expr …/> </Mapping> </Filters> <ObjectPrivileges> <RefObjectPrivilege …/> </ObjectPrivileges> </PrivilegePackage>
例
<PrivilegePackage name="PrivPack_4209:16704985826474" id="4209:469" uid="425"> <Description /> <Filters> <Mapping status="enable"> <RefObject id="4008:459" qualifiedName=""Paint".. "Markets"" /> <Expr> <![CDATA[ "Paint"."Markets"."Region" = 'Eastern Region' ]]> </Expr> </Mapping> <Mapping status="enable"> <RefObject id="4008:462" qualifiedName=""Paint".."Sales Measures"" /> <Expr> <![CDATA[ "Paint"."Markets"."Region" = 'Eastern Region' ]]> </Expr> </Mapping> <Mapping status="enable"> <RefObject id="4008:463" qualifiedName=""Paint".."Share Measures"" /> <Expr> <![CDATA[ "Paint"."Markets"."Region" = 'Eastern Region' ]]> </Expr> </Mapping> <Mapping status="enable"> <RefObject id="4008:464" qualifiedName=""Paint".."Forecast Measures"" /> <Expr> <![CDATA[ "Paint"."Markets"."Region" = 'Eastern Region' ]]> </Expr> </Mapping> <Mapping status="enable"> <RefObject id="4008:465" qualifiedName=""Paint Exec" .."Measures"" /> <Expr> <![CDATA[ "Paint"."Markets"."Region" = 'Eastern Region' ]]> </Expr> </Mapping> <Mapping status="enable"> <RefObject id="4008:466" qualifiedName=""Paint Exec".. "Markets"" /> <Expr> <![CDATA[ "Paint"."Markets"."Region" = 'Eastern Region' ]]> </Expr> </Mapping> </Filters> <ObjectPrivileges /> </PrivilegePackage>
オブジェクト権限要素は、論理列やプレゼンテーション列などのメタデータ・オブジェクトに適用できるオブジェクト権限のセットに対応しています。オブジェクト権限は、管理ツールのプレゼンテーション・レイヤーか、または「ユーザー/アプリケーション・ロール権限」ダイアログの「オブジェクト権限」タブで設定できます。
オブジェクト権限タグには次の属性があります。
表16-18 オブジェクト権限タグの属性
属性名 | 説明 |
---|---|
type |
オブジェクトに適用される権限のタイプを格納します。有効な値は次のとおりです。
この権限には、 |
オブジェクト権限タグには次の子要素があります。
構文
<ObjectPrivilege … privilege=""> <Objects> <RefObject…/> <RefObject…/> </Objects> </ObjectPrivilege>
例
<ObjectPrivilege name="ObjPriv_1500:10072891258596599" id="1500:1007289" uid="2162635189" type="read"> <Description></Description> <Objects> <RefObject id="4004:275554" uid="2156776977" qualifiedName=""Sales - CRM Sales Activity""/> <RefObject id="4004:275556" uid="2156689246" qualifiedName=""Sales - CRM Pipeline""/> <RefObject id="4004:275636" uid="2156689916" qualifiedName=""Sales - CRM Forecasting""/> <RefObject id="4004:275663" uid="2156776077" qualifiedName=""Sales - CRM Customer Overview""/> <RefObject id="4004:275728" uid="2160717431" qualifiedName=""Sales - CRM Quota Management""/> </Objects> </ObjectPrivilege
問合せ権限要素は、ユーザーまたはアプリケーションのロールに適用できる問合せ権限のセットに対応しています。問合せ権限は、管理ツールの「ユーザー/アプリケーション・ロール権限」ダイアログにある「問合せ制限」タブで設定できます。
問合せ権限タグには次の属性があります。
表16-20 問合せ権限タグの属性
属性名 | 説明 |
---|---|
maxExecTime |
データベースで実行可能なクエリーの最大分数。 |
maxExecTimePrivilege |
クエリーの最大実行時間制限のステータスを指定します。有効な値は次のとおりです。
|
maxRows |
ユーザーがデータベースから取得する最大行数。 |
maxRowsPrivilege |
最大行数制限のステータスを指定します。有効な値は次のとおりです。
|
populatePrivilege |
データベースに対する移入権限を付与するか、否認するかを指定します。移入ストアド・プロシージャは、基準ブロックのキャッシュ時に、キャッシュ/保存済結果セットの値をデータベースに書き込みます。有効な値は次のとおりです。
|
execPhysicalPrivilege |
直接データベース・リクエストがデフォルトで実行可能かどうかを指定します。有効な値は次のとおりです。
|
問合せ権限タグには次の子要素があります。
表16-21 問合せ権限の子要素
要素名 | 説明 |
---|---|
ExecTimeTable |
データベースへのアクセスが特定の期間に制限されている場合に、期間とアクセスの許可または拒否をリストします。 各期間は |
構文
<QueryPrivilege … maxExecTime="" maxExecTimePrivilege="" maxRows="" maxRowsPrivilege="" populatePrivilege="" execPhysicalPrivilege=""> <ExecTimeTable> <Item allow="true" startTime="" endTime=""/> <Item allow="true" startTime="" endTime=""/> </ExecTimeTable> </QueryPrivilege>
例
<QueryPrivilege name="QueryPriv_4204:8253601255133864" id="4204:825360" uid="2162247182" maxExecTime="600" maxRows="100000"> <Description></Description> </QueryPrivilege
ユーザー要素はリポジトリのユーザー・オブジェクトに対応しています。これらのオブジェクトは外部で管理されるユーザー・オブジェクトのメタデータ・リポジトリのコピーまたはバージョンを表します。
ユーザー・タグには次の属性があります。
表16-22 ユーザー・タグの属性
属性名 | 説明 |
---|---|
fullName |
このユーザーのフルネーム。 |
password |
この属性は使用されていません。 |
periodicity |
この属性は使用されていません。 |
loggingLevel |
このユーザーのロギング・レベル。 |
logStatisticsStatus |
この属性は使用されていません。 |
noExpiry |
この属性は使用されていません。 |
ユーザー・タグには次の子要素があります。
表16-23 ユーザーの子要素
要素名 | 説明 |
---|---|
RefPrivilegePackage |
このユーザーに適用される権限パッケージ(オブジェクト権限、データ・フィルタおよび問合せ権限のセット)を参照します。 |
Groups |
このユーザーが属するアプリケーション・ロールを参照します。 各アプリケーション・ロールは |
DBSignOnList |
このユーザーに対してデータベース固有のログインが定義されている場合に、データベース・ログイン・ユーザー名およびパスワードと、対応するデータベースを参照します。 データベース資格証明とデータベースの各ペアは 各
|
構文
<User … fullName="" loggingLevel=""> <RefPrivilegePackage …/> <Groups> <RefGroup …/> <RefGroup …/> </Groups> <DBSignOnList> <DBSignOnMap> <RefDBSignOn …/> <RefDatabase …/> </DBSignOnMap> …… </DBSignOnList> </User>
例
<User name="mgr" id="1501:7" uid="8" fullName="East Region Manager" loggingLevel="0"> <Description> <![CDATA[ my_desc ]]> </Description> <Groups> <RefGroup id="4206:4" qualifiedName=""Region Manager"" /> </Groups> </User>
グループ要素はメタデータ・リポジトリのアプリケーション・ロール・オブジェクトに対応しています。
グループ・タグには次の子要素があります。
表16-24 グループの子要素
要素名 | 説明 |
---|---|
RefPrivilegePackage |
このアプリケーション・ロールに適用される権限パッケージ(オブジェクト権限、データ・フィルタおよび問合せ権限のセット)を参照します。 |
ChildGroups |
このアプリケーション・ロールに属するアプリケーション・ロールのセットを参照します。 各子要素は |
Users |
このアプリケーション・ロールに属するユーザーを参照します。 各ユーザーは |
グループ・タグには属性はありません。スキーマでlogLevel
とlogStatisticsStatus
の属性をリストしていますが、これらの属性は使用されません。
構文
<Group …> <RefPrivilegePackage …/> <ChildGroups> <RefGroup …/> </ChildGroups> <Users> <RefUser …/> </Users> </Group>
例
<Group name="Region Manager" id="4206:4" uid="5"> <Description /> <RefPrivilegePackage id="4209:469" qualifiedName="" PrivPack_4209:16704985826474"" /> </Group>
DBサインオン要素は、ユーザー・オブジェクトの「ログオン」タグに表示される情報に対応しています。 データベース固有のログインIDとパスワード用にリポジトリが設定されている場合は、データベース固有の資格証明を設定して、権限のあるユーザーが、基礎となるデータベースに接続できるようにすることが可能です。この場合ユーザーのアクセスは、そのデータベースにおいてそのユーザーに付与されている認可レベルで行われます。
DBサインオン・タグには次の属性があります。
DBサインオン・タグには子要素はありません。
構文
<DBSignOn … user="" password=""> </DBSignOn>
例
<DBSignOn name="LOGON_4211:205511263581806" id="4211:20551" uid="2160777097" user="my_db_user" password="D7EDED84BC624A917F5B462A4DCA05CDCE256EEEEEDC97D51DC6FAD705A87E76AC4 D07C3A079829F"> <Description /> </DBSignOn>
FMWセキュリティ要素は使用されません。
この項では、他のどのカテゴリにも該当しないその他の要素について説明します。次の要素があります。
プロジェクト要素はリポジトリ・メタデータのプロジェクト・オブジェクトに対応しています。プロジェクトは、マルチユーザー開発をサポートし、複数の開発者がそれぞれの担当領域で作業を行えるようにします。
プロジェクト・タグには次の子要素があります。
表16-26 プロジェクトの子要素
要素名 | 説明 |
---|---|
Catalogs |
プロジェクトに属するサブジェクト・エリアを参照します。 各サブジェクト・エリアは |
FactTables |
プロジェクトに属する論理ファクト表を参照します。 各ファクト表は |
Groups |
プロジェクトに属するアプリケーション・ロールを参照します。 各アプリケーション・ロールは |
Users |
プロジェクトに属するユーザーを参照します。 各ユーザーは |
Variables |
プロジェクトに属する変数を参照します。 各変数は |
InitBlocks |
プロジェクトに属する初期化ブロックを参照します。 各初期化ブロックは |
ListCatalogs |
プロジェクトに属するリスト・カタログを参照します。 各リスト・カタログは |
Tables |
プロジェクトに属するプレゼンテーション表を参照します。 各プレゼンテーション表は |
Columns |
プロジェクトに属するプレゼンテーション列を参照します。 各プレゼンテーション列は |
Hierarchies |
プロジェクトに属するプレゼンテーション階層を参照します。 各プレゼンテーション階層は |
Levels |
プロジェクトに属するプレゼンテーション・レベルを参照します。 各プレゼンテーション・レベルは |
ExcludedCatalogs |
プロジェクトに属さないが、プロジェクトに属する論理オブジェクトにマップされているサブジェクト・エリアを参照します。 各サブジェクト・エリアは |
ExcludedTables |
プロジェクトに属さないが、プロジェクトに属する論理オブジェクトにマップされているプレゼンテーション表を参照します。 各プレゼンテーション表は |
ExcludedColumns |
プロジェクトに属さないが、プロジェクトに属する論理オブジェクトにマップされているプレゼンテーション列を参照します。 各プレゼンテーション列は |
ExcludedHierarchies |
プロジェクトに属さないが、プロジェクトに属する論理オブジェクトにマップされているプレゼンテーション階層を参照します。 各プレゼンテーション階層は |
ExcludedLevels |
プロジェクトに属さないが、プロジェクトに属する論理オブジェクトにマップされているプレゼンテーション・レベルを参照します。 各サブジェクト・エリアは |
プロジェクト・タグには属性はありません。
構文
<Project …> <Catalogs> <RefPresentationCatalog…/> </Catalogs> <FactTables> <RefLogicalTable …/> </FactTables> <Groups> <RefGroup…/> </Groups> <Users> <RefUser …/> </Users> <Variables> <RefVariable …/> </Variables> <InitBlocks> <RefInitBlock…/> </InitBlocks> <ListCatalogs> <RefListCatalog …/> </ListCatalogs> <Tables> <RefPresentationTable…/> </Tables> <Columns> <RefPresentationColumn…/> </Columns> <Hierarchies> <RefPresentationHierarchy…/> </Hierarchies> <Levels> <RefPresentationLevel…/> </Levels> <ExcludedCatalogs> <RefPresentationCatalog…/> </ExcludedCatalogs> <ExcludedTables> <RefPresentationTable…/> </ExcludedTables> <ExcludedColumns> <RefPresentationColumn…/> </ExcludedColumns> <ExcludedHierarchies> <RefPresentationHierarchy…/> </ExcludedHierarchies> <ExcludedLevels> <RefPresentationLevel…/> </ExcludedLevels> </Project>
例
<Project name="FUSION_SPE" id="4213:281691" uid="2160747109"> <Description></Description> <FactTables> <RefLogicalTable uid="2248630" id="2035:9160" qualifiedName= ""Core"."Fact - CRM - Order Item""/> <RefLogicalTable uid="2248632" id="2035:9371" qualifiedName= ""Core"."Fact - CRM - Service Request""/> <RefLogicalTable uid="2248634" id="2035:9578" qualifiedName= ""Core"."Fact - CRM - Revenue""/> <RefLogicalTable uid="2248653" id="2035:9995" qualifiedName= ""Core"."Fact - CRM - Service Request Year Ago""/> <RefLogicalTable uid="2248654" id="2035:10002" qualifiedName= ""Core"."Fact - CRM - Service Request Quarter Ago""/> <RefLogicalTable uid="2248657" id="2035:10009" qualifiedName= ""Core"."Fact - CRM - Asset""/> </FactTables> <Groups> <RefGroup uid="2351522" id="4206:1" qualifiedName= ""BIAdministrators""/> </Groups> <Users> <RefUser uid="2226247" id="1501:2" qualifiedName= ""Administrator""/> </Users> <Variables> <RefVariable uid="2156160753" id="3031:250" qualifiedName= ""User Hierarchy Level"."HIER_LEVEL""/> <RefVariable uid="2160681301" id="3031:337" qualifiedName= ""GetCRMCalendar". "CRM_CAL_ID""/> <RefVariable uid="2160723641" id="3031:338" qualifiedName=""TERR_HIER_ LEVEL""/> <RefVariable uid="2160708142" id="3031:339" qualifiedName=""Resource Hierarchy Level"."RESOURCE_HIER_LEVEL""/> </Variables> <InitBlocks> <RefInitBlock uid="2156160754" id="3033:68605" qualifiedName= ""User Hierarchy Level""/> <RefInitBlock uid="2160681306" id="3033:68645" qualifiedName= ""GetCRMCalendar""/> <RefInitBlock uid="2160714425" id="3033:68649" qualifiedName= ""Resource Hierarchy Level""/> <RefInitBlock uid="2327724" id="3033:68694" qualifiedName= ""Authentication""/> <RefInitBlock uid="2327727" id="3033:68696" qualifiedName= ""Authorization""/> </InitBlocks> </Project
問合せオブジェクト要素は、リポジトリ・メタデータの保存済問合せオブジェクトに対応しています。問合せの保存は、管理ツールの「リポジトリの問合せ」ダイアログで行えます。
問合せオブジェクト・タグには次の子要素があります。
問合せオブジェクト・タグには属性はありません。
構文
<QueryObject …> <QueryString…/> </QueryObject>
例
<QueryObject name="samplequery" id="4217:20552" uid="2160777099"> <Description /> <QueryString> <![CDATA[ (128 = "*") AND (6 = Business Model) AND (0) ]]> </QueryString> </QueryObject>