Oracle® Fusion Middleware Oracle Business Intelligence Enterprise Editionインテグレーターズ・ガイド

11g リリース1(11.1.1)

B63033-04(原本部品番号:E16364-05)

目次

タイトルおよび著作権情報

はじめに

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメントとその他のリソース

- システム要件と動作要件

- 表記規則

Oracle Business Intelligence開発者向けの新機能

- Oracle BI EE 11g リリース1 (11.1.1.7)の新機能

- Oracle BI EE 11g リリース1 (11.1.1.6)の新機能

- Oracle BI EE 11g リリース1 (11.1.1.5)の新機能

- Oracle BI EE 11g リリース1(11.1.1.3)の新機能

1 Oracle Business Intelligence Webサービスの概要

- 1.1 Oracle Business Intelligence Webサービスの概要

- 1.2 Oracle Business IntelligenceのセッションベースWebサービスとは

- 1.3 Oracle Business IntelligenceのSOA用Webサービスとは

- 1.4 Oracle Business Intelligence SOA用Webサービスの構成と保護

- 1.5 Webサービス通信に対するSSLの有効化

- 1.6 HTTPS経由でのOracle Business Intelligence Webサービスの起動

2 Oracle BI EE Webサービスで使用する構造体について

- 2.1 AccessControlToken構造体

- 2.2 Account構造体

- 2.3 ACL構造体

- 2.4 ArrayofGUIDS構造体

- 2.5 AuthResult構造体

- 2.6 CatalogItemsFilter構造体

- 2.7 CatalogObject構造体

- 2.8 ErrorInfo構造体

- 2.9 GetSubItemsParams構造体

- 2.10 ImportError構造体

- 2.11 ItemInfo構造体

- 2.12 NameValuePair構造体

- 2.13 PathMap構造体

- 2.14 Privilege構造体

- 2.15 QueryResults構造体

- 2.16 ReportHTMLOptions構造体

- 2.16.1 ReportHTMLLinksMode列挙

- 2.17 ReportParams構造体

- 2.18 ReportRef構造体

- 2.19 SAColumn構造体

- 2.19.1 SADataType値

- 2.19.2 AggregationRule値

- 2.20 SASubjectArea構造体

- 2.21 SATable構造体

- 2.22 SAWLocale構造体

- 2.23 SAWSessionParameters構造体

- 2.24 SegmentationOptions構造体

- 2.25 SessionEnvironment構造体

- 2.26 StartPageParams構造体

- 2.27 TreeNodePath構造体

- 2.28 UpdateACLParams構造体

- 2.28.1 UpdateACLMode列挙

- 2.29 UpdateCatalogItemACLParams構造体

- 2.30 Variable構造体

- 2.31 XMLQueryExecutionOptions構造体

3 Oracle BI EE Webサービスで使用するサービスとメソッドについて

- 3.1 ConditionServiceサービス

- 3.1.1 evaluateCondition()メソッド

- 3.1.1.1 シグネチャ

- 3.1.2 evaluateInlineCondition()メソッド

- 3.1.2.1 シグネチャ

- 3.1.3 getConditionCustomizableReportElements()メソッド

- 3.1.3.1 シグネチャ

- 3.2 HtmlViewServiceサービス

- 3.2.1 HtmlViewServiceブリッジおよびコールバックURLについて

- 3.2.2 addReportToPage()メソッド

- 3.2.2.1 シグネチャ

- 3.2.3 endPage()メソッド

- 3.2.3.1 シグネチャ

- 3.2.4 getCommonBodyHTML()メソッド

- 3.2.4.1 シグネチャ

- 3.2.4.2 戻り値

- 3.2.5 getHeadersHTML()メソッド

- 3.2.5.1 シグネチャ

- 3.2.5.2 戻り値

- 3.2.6 getHtmlforPageWithOneReport()メソッド

- 3.2.6.1 シグネチャ

- 3.2.7 getHTMLForReport()メソッド

- 3.2.7.1 シグネチャ

- 3.2.7.2 戻り値

- 3.2.8 setBridge()メソッド

- 3.2.8.1 シグネチャ

- 3.2.8.2 使用方法

- 3.2.8.3 コールバックURLを置換する方法

- 3.2.9 startPage()メソッド

- 3.2.9.1 シグネチャ

- 3.2.9.2 戻り値

- 3.3 iBotServiceサービス

- 3.3.1 writeIBot()メソッド

- 3.3.1.1 シグネチャ

- 3.3.2 deleteIBot()メソッド

- 3.3.2.1 シグネチャ

- 3.3.3 executeIBotNow()メソッド

- 3.3.3.1 シグネチャ

- 3.3.4 moveIBot()メソッド

- 3.3.4.1 シグネチャ

- 3.3.5 sendMessage()メソッド

- 3.3.5.1 シグネチャ

- 3.3.6 subscribe()メソッド

- 3.3.6.1 シグネチャ

- 3.3.7 unsubscribe()メソッド

- 3.3.7.1 シグネチャ

- 3.4 JobManagementServiceサービス

- 3.4.1 cancelJob()メソッド

- 3.4.1.1 シグネチャ

- 3.4.2 deleteResultSet()メソッド

- 3.4.2.1 シグネチャ

- 3.4.3 getCounts()メソッド

- 3.4.3.1 シグネチャ

- 3.4.4 getJobInfo()メソッド

- 3.4.4.1 シグネチャ

- 3.4.5 getPromptedColumns()メソッド

- 3.4.5.1 シグネチャ

- 3.4.6 prepareCache()メソッド

- 3.4.6.1 シグネチャ

- 3.4.7 purgeCache()メソッド

- 3.4.7.1 シグネチャ

- 3.4.8 saveResultSet()メソッド

- 3.4.8.1 シグネチャ

- 3.4.9 writeListFiles()メソッド

- 3.4.9.1 シグネチャ

- 3.5 MetadataServiceサービス

- 3.5.1 clearQueryCache()メソッド

- 3.5.1.1 シグネチャ

- 3.5.2 describeColumn()メソッド

- 3.5.2.1 シグネチャ

- 3.5.2.2 戻り値

- 3.5.3 describeSubjectArea()メソッド

- 3.5.3.1 シグネチャ

- 3.5.3.2 SASubjectAreaDetailsの値

- 3.5.3.3 戻り値

- 3.5.3.4 使用方法

- 3.5.4 describeTable()メソッド

- 3.5.4.1 シグネチャ

- 3.5.4.2 SATablesDetailsの値

- 3.5.4.3 戻り値

- 3.5.5 getSubjectAreas()メソッド

- 3.5.5.1 シグネチャ

- 3.5.5.2 戻り値

- 3.5.5.3 使用方法

- 3.6 ReplicationServiceサービス

- 3.6.1 ExportFlagsの列挙

- 3.6.2 ImportFlagsの列挙

- 3.6.3 Import()メソッド

- 3.6.3.1 シグネチャ

- 3.6.3.2 戻り値

- 3.6.4 export()メソッド

- 3.6.4.1 シグネチャ

- 3.6.5 markForReplication()メソッド

- 3.6.5.1 シグネチャ

- 3.6.6 purgeLog()メソッド

- 3.6.6.1 シグネチャ

- 3.7 ReportEditingServiceサービス

- 3.7.1 applyReportDefaults()メソッド

- 3.7.1.1 シグネチャ

- 3.7.1.2 戻り値

- 3.7.2 applyReportParams()メソッド

- 3.7.2.1 シグネチャ

- 3.7.2.2 戻り値

- 3.7.3 generateReportSQL()メソッド

- 3.7.3.1 シグネチャ

- 3.7.3.2 戻り値

- 3.8 SAWSessionServiceサービス

- 3.8.1 getCurUser()メソッド

- 3.8.1.1 シグネチャ

- 3.8.1.2 戻り値

- 3.8.2 GetSessionEnvironment()メソッド

- 3.8.2.1 シグネチャ

- 3.8.2.2 戻り値

- 3.8.3 getSessionVariable()メソッド

- 3.8.3.1 シグネチャ

- 3.8.3.2 戻り値

- 3.8.4 impersonate()メソッド

- 3.8.4.1 シグネチャ

- 3.8.4.2 戻り値

- 3.8.5 impersonateex()メソッド

- 3.8.5.1 シグネチャ

- 3.8.5.2 戻り値

- 3.8.6 keepAlive()メソッド

- 3.8.6.1 シグネチャ

- 3.8.7 logoff()メソッド

- 3.8.7.1 シグネチャ

- 3.8.8 logon()メソッド

- 3.8.8.1 シグネチャ

- 3.8.8.2 戻り値

- 3.8.9 logonex()メソッド

- 3.8.9.1 シグネチャ

- 3.8.9.2 戻り値

- 3.9 SecurityServiceサービス

- 3.9.1 forgetAccounts()メソッド

- 3.9.1.1 シグネチャ

- 3.9.2 getAccounts()メソッド

- 3.9.2.1 シグネチャ

- 3.9.3 getGlobalPrivilegeACL()メソッド

- 3.9.3.1 シグネチャ

- 3.9.4 getGlobalPrivileges()メソッド

- 3.9.4.1 シグネチャ

- 3.9.5 getGroups()メソッド

- 3.9.5.1 シグネチャ

- 3.9.6 getMembers()メソッド

- 3.9.6.1 シグネチャ

- 3.9.7 getPermissions()メソッド

- 3.9.7.1 シグネチャ

- 3.9.7.2 戻り値

- 3.9.8 getPrivilegesStatus()メソッド

- 3.9.8.1 シグネチャ

- 3.9.9 isMember()メソッド

- 3.9.9.1 シグネチャ

- 3.9.10 joinGroups()メソッド

- 3.9.10.1 シグネチャ

- 3.9.11 leaveGroups()メソッド

- 3.9.11.1 シグネチャ

- 3.9.12 renameAccounts()メソッド

- 3.9.12.1 シグネチャ

- 3.9.12.2 戻り値

- 3.9.13 updateGlobalPrivilegeACL()メソッド

- 3.9.13.1 シグネチャ

- 3.10 WebCatalogServiceサービス

- 3.10.1 ErrorDetailsLevelの列挙

- 3.10.2 ReadObjectsReturnOptionsの列挙

- 3.10.3 copyItem()メソッド

- 3.10.3.1 シグネチャ

- 3.10.4 copyItem2()メソッド

- 3.10.4.1 シグネチャ

- 3.10.5 createFolder()メソッド

- 3.10.5.1 シグネチャ

- 3.10.6 createLink()メソッド

- 3.10.6.1 シグネチャ

- 3.10.7 deleteItem()メソッド

- 3.10.7.1 シグネチャ

- 3.10.8 getItemInfo()メソッド

- 3.10.8.1 シグネチャ

- 3.10.8.2 戻り値

- 3.10.9 getSubItems()メソッド

- 3.10.9.1 シグネチャ

- 3.10.9.2 戻り値

- 3.10.10 maintenanceMode()メソッド

- 3.10.10.1 シグネチャ

- 3.10.11 moveItem()メソッド

- 3.10.11.1 シグネチャ

- 3.10.12 pasteItem2()メソッド

- 3.10.12.1 シグネチャ

- 3.10.13 readObjects()メソッド

- 3.10.13.1 シグネチャ

- 3.10.13.2 戻り値

- 3.10.14 removeFolder()メソッド

- 3.10.14.1 シグネチャ

- 3.10.15 setItemAttributes()メソッド

- 3.10.15.1 シグネチャ

- 3.10.16 setItemProperty()メソッド

- 3.10.16.1 シグネチャ

- 3.10.17 setOwnership()メソッド

- 3.10.17.1 シグネチャ

- 3.10.18 updateCatalogItemACL()メソッド

- 3.10.18.1 シグネチャ

- 3.10.19 writeObjects()メソッド

- 3.10.19.1 シグネチャ

- 3.10.19.2 戻り値

- 3.11 XMLViewServiceサービス

- 3.11.1 XMLQueryOutputFormatの列挙

- 3.11.2 cancelQuery()メソッド

- 3.11.2.1 シグネチャ

- 3.11.3 executeSQLQuery()メソッド

- 3.11.3.1 シグネチャ

- 3.11.3.2 戻り値

- 3.11.4 executeXMLQuery()メソッド

- 3.11.4.1 シグネチャ

- 3.11.4.2 戻り値

- 3.11.5 fetchNext()メソッド

- 3.11.5.1 シグネチャ

- 3.11.5.2 戻り値

- 3.11.6 getPromptedFilters()メソッド

- 3.11.6.1 シグネチャ

- 3.11.7 upgradeXML()メソッド

- 3.11.7.1 シグネチャ

4 Oracle Business IntelligenceサーバーのメタデータWebサービスの使用

- 4.1 Oracle BIサーバーのメタデータWebサービスの概要

- 4.2 Oracle BIサーバーのメタデータWebサービスの構成

- 4.2.1 Oracle BIサーバーのメタデータWebサービスとOracle BIサーバーとの接続の構成

- 4.2.1.1 Oracle Business Intelligence JDBCデータ・ソースの設定

- 4.2.2 Oracle BIサーバーのメタデータWebサービスの保護

- 4.2.2.1 ポリシーの適用

- 4.2.2.2 WSMの構成

- 4.2.2.3 manageRepositories権限の割当て

- 4.3 Oracle BIサーバーのメタデータWebサービスのコール

- 4.3.1 Oracle BIサーバーのメタデータWebサービスの同期コール

- 4.3.1.1 callProcedure()メソッド

- 4.3.1.2 callProcedureWithResults()メソッド

- 4.3.1.3 startExtender()メソッド

- 4.3.1.4 サンプル・コード

- 4.3.2 Oracle BIサーバーのメタデータWebサービスの非同期コール

- 4.3.2.1 コールバック・サービスの作成

- 4.3.2.2 コールバック・サービスの構成

- 4.3.2.3 サンプル・コード

- 4.4 Oracle BIサーバーのXMLプロシージャの使用

- 4.4.1プロジェクト抽出プロシージャ

- 4.4.2 メタデータ変更プロシージャ

- 4.4.3 メタデータ問合せプロシージャ

- 4.4.4 プロジェクト問合せプロシージャ

5 アクションによるOracle BI EEおよび外部システムの統合

- 5.1 アクション・フレームワークの紹介

- 5.1.1 アクション・フレームワークが提供する機能

- 5.1.2 アクション・タイプおよびアクションの実行

- 5.2 アクション・フレームワーク構成の概要

- 5.2.1 アクション・タイプ別の構成チェックリスト

- 5.2.2 ターゲットの概要

- 5.3 アクション・フレームワークの構成

- 5.3.1 エイリアス

- 5.3.2 レジストリ

- 5.3.2.1 「EPMコンテンツにナビゲート」アクション・タイプ・レジストリの例

- 5.3.2.2 「Javaメソッドの起動」アクション・タイプ・レジストリの例

- 5.3.2.3 「Webサービスの起動」アクション・タイプ・レジストリの例

- 5.3.2.4 registry要素の説明

- 5.3.2.5 provider-class要素で有効な値

- 5.3.3 コンテンツ・タイプ

- 5.3.4 アカウント

- 5.3.4.1 accountの各要素および説明

- 5.3.5 ポリシー

- 5.3.5.1 policy要素の説明

- 5.3.5.2 ポリシー・ファイル

- 5.3.6 プロキシ

- 5.3.6.1 proxy要素の説明

- 5.3.7 ebusinesssuiteconfig

- 5.3.8 siebelcrmconfig

- 5.4 アクション・セキュリティの概要

- 5.4.1 Oracle BI EEの資格証明

- 5.4.2 Oracle BI EEの権限

- 5.4.3 Oracle BIプレゼンテーション・カタログ・アクセス権

- 5.5 アクション・フレームワークで使用する資格証明の追加および保守

- 5.5.1 資格証明ストアへの資格証明マップおよび資格証明キーの追加

- 5.5.1.1 資格証明マップおよび資格証明キーの作成例

- 5.5.2 デフォルト・キーストアの作成

- 5.5.3 Oracle Web Services Managerの構成

- 5.6 アクション用のターゲット機能

- 5.6.1 EPMコンテンツにナビゲート

- 5.6.1.1 このアクション・タイプに必要な前提条件

- 5.6.1.2 このアクション・タイプを起動した場合の処理

- 5.6.2 E-Business Suiteにナビゲート

- 5.6.2.1 Oracle E-Business Suite Javaフォームへのコンテキスト引渡しの概要

- 5.6.3 Siebel CRMにナビゲート

- 5.6.4 Webサービスの起動

- 5.6.4.1 このアクション・タイプに必要な前提条件

- 5.6.4.2 WSILドキュメントの例

- 5.6.4.3 「Webサービスの起動」のトラブルシューティング・アクション

- 5.6.4.4 このアクション・タイプを起動した場合の処理

- 5.6.5 Webサービスのコールでサポートされる機能

- 5.6.5.1 トランスポート

- 5.6.5.2 メッセージング

- 5.6.5.3 SOAP

- 5.6.5.4 応答ドキュメント

- 5.6.5.5 サービスの説明

- 5.6.5.6 検出サービス

- 5.6.5.7 セキュリティ

- 5.6.5.8 信頼できるメッセージングおよびトランザクション

- 5.6.6 Javaメソッド(EJB)の起動

- 5.6.6.1 このアクション・タイプに必要な前提条件

- 5.6.6.2 EJB用のパラメータ

- 5.6.6.3 このアクション・タイプを起動した場合の処理

- 5.6.7 ブラウザ・スクリプトの起動

- 5.6.7.1 JavaScript関数

- 5.6.7.2 UserScript.js

- 5.6.7.3 このアクション・タイプを起動した場合の処理

- 5.6.8 サーバー・スクリプトの起動

- 5.6.8.1 このアクション・タイプに必要な前提条件

- 5.6.8.2 このアクション・タイプを起動した場合の処理

- 5.6.9 エージェントの起動

- 5.6.9.1 「エージェントの起動」アクションでのフィルタ機能

- 5.6.9.2 このアクション・タイプ起動時の処理

- 5.6.10 Javaジョブ

- 5.6.10.1 このアクションタイプ起動時の処理

6 HTTPおよびJavaScriptを使用したOracle BIプレゼンテーション・サービスの企業環境への統合

- 6.1 Oracle Business Intelligenceの結果の外部ポータルまたは外部アプリケーションへの取込み

- 6.1.1 Oracle BI Presentation ServicesのプロンプトURLについて

- 6.1.2 Oracle BIプレゼンテーション・サービスのGo URLについて

- 6.1.3 Oracle BIプレゼンテーション・サービスの基本のGo URLの構造

- 6.1.4 Oracle BIプレゼンテーション・サービスのGo URLのオプション・パラメータ

- 6.1.4.1 すべてのレコードの表形式での表示

- 6.2 外部ポータルまたは外部アプリケーションのダッシュボード・コンテンツの参照

- 6.2.1 Oracle BIプレゼンテーション・サービスのダッシュボードURLについて

- 6.2.2 Oracle BIプレゼンテーション・サービスの基本のダッシュボードURLの構造

- 6.2.3 Oracle BIプレゼンテーション・サービスのダッシュボードURLのオプション・コマンドとパラメータ

- 6.3 Oracle BIプレゼンテーション・サービスのGo URLを使用したSQLの発行とフィルタの受渡し

- 6.3.1 SQLコマンドの発行とフィルタの受渡し

- 6.3.2 URL(ナビゲーション)を使用したOracle BIプレゼンテーション・サービスGo URLへのフィルタの受渡し

- 6.3.2.1 ナビゲーション・パラメータ

- 6.3.2.2 ナビゲーションの例

- 6.3.2.3 JavaScriptを使用したナビゲーション

- 6.3.2.4 HTMLの結果からのナビゲーション

- 6.4 Oracle Business Intelligenceとサード・パーティのSQLツールとの統合例

- 6.4.1 サード・パーティのSQLツールの統合例

- 6.5 スクリプトを使用したダッシュボード・ページへのリンクの取得

7 Oracle Business Intelligence Systems Management API

- 7.1 Oracle Business Intelligence Systems Management APIについて

8 Oracle Business Intelligenceと他のクライアントとの統合

- 8.1 Oracle Business Intelligenceとの統合の概要

- 8.2 データ・ソースとしてのOracle BIサーバーとの統合について

- 8.2.1 物理レイヤーへのリクエスト送信について

- 8.2.2 JDBCを使用したOracle BIサーバーとの統合について

- 8.3 ODBC準拠レベル

- 8.4 Windows上のOracle BIサーバーに対するODBC DSNの構成

- 8.4.1 拡張SSL設定用のODBC DSNの構成

- 8.5 LinuxまたはUNIX上のOracle BIサーバーにおけるODBC DSNの構成

9 アプリケーションでのDiscovererデータの使用

- 9.1 アプリケーションでのDiscovererワークシートの公開

- 9.2 Oracle BI EEで使用するDiscovererメタデータの変換

10 Oracle E-Business Suiteセキュリティとの統合

- 10.1 Oracle E-Business Suiteデータベースのデータベース・オブジェクトと接続プールの作成

- 10.2 認証の設定

- 10.2.1 認証のセッション変数の設定

- 10.2.2 authenticationschemas.xmlの更新

- 10.2.3 instanceconfig.xmlの更新

- 10.3 Oracle E-Business SuiteにおけるOracle Business Intelligenceへのリンクの埋込み

- 10.3.1 ドメイン前提条件

- 10.3.2 フォーム関数の作成

- 10.3.3 フォーム関数を起動するメニューの作成

- 10.3.4 職責へのメニューの割当て

- 10.3.5 ユーザーへの職責の割当て

- 10.3.6 プロファイルの設定

11 Oracle BI EEのOracle Siebel CRMへの埋込み

- 11.1 Oracle BI EEのSiebel CRMへの埋込みの概要

- 11.2 Oracle HTTP Serverの構成

- 11.3 HTTPサーバーからOracle BIを検索するためのSiebelアプリケーションの構成

- 11.4 /analyticsディレクトリを参照するためのSiebel URLの変更

A サンプル・ファイル

- A.1 アクション・フレームワーク構成ファイルのサンプル

- A.2 JavaScriptファイルのサンプル

用語集

索引

Oracle® Fusion Middleware

Oracle Business Intelligence Enterprise Editionインテグレーターズ・ガイド

11g リリース1(11.1.1)

B63033-04(原本部品番号:E16364-05)

2013年2月

Webサービスおよび他のAPIを使用して、Oracle Business Intelligence Enterprise Editionを他のシステムに統合する方法について説明します。

Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionインテグレーターズ・ガイド, 11g リリース1(11.1.1)

B63033-04

Copyright © 2010, 2013, Oracle and/or its affiliates.All rights reserved.

原本著者: Nick Fry

原本主協力者: Stefanie Rhone、Marla Azriel、Christine Jacobs

原本協力者: Oracle Business Intelligence development, product management, and quality assurance teams

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントが、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供される場合は、次のNoticeが適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

このソフトウェアまたはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアまたはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用する際、このソフトウェアまたはハードウェアを安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleおよびJavaはOracle およびその関連企業の登録商標です。その他の名称は、他社の商標の可能性があります。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXはThe Open Groupの登録商標です。

このソフトウェアまたはハードウェアおよびドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。

はじめに

Oracle Business Intelligence Foundation Suiteは、レポート作成、非定型の問合せ、OLAP、ダッシュボード、スコアカード、What-If分析など、エンタープライズ・ビジネス・インテリジェンスのあらゆるニーズに応える、オープンかつ統合された完全なソリューションです。Oracle Business Intelligence Foundation SuiteにはOracle Business Intelligence Enterprise Editionが含まれます。

Oracle Business Intelligence Enterprise Edition(Oracle BI EE)は、エンタープライズ・ビジネス・インテリジェンスの包括的なツール群とインフラストラクチャから構成されており、スケーラブルかつ効率的な問合せ/分析用サーバー、非定型の問合せと分析ツール、インタラクティブなダッシュボード、予見的なインテリジェンスとアラート、リアルタイムの予測的インテリジェンス、エンタープライズ・レポート作成エンジンなどの機能を提供します。

Oracle BI EEの各コンポーネントが共有するものには、共通のサービス指向アーキテクチャ、データ・アクセス・サービス、分析および計算インフラストラクチャ、メタデータ管理サービス、セマンティック・ビジネス・モデル、セキュリティ・モデルとユーザー・プリファレンス、管理ツールがあります。Oracle BI EEは、データ・ソース固有のリクエスト生成の最適化、データ・アクセスの最適化、高度な計算、インテリジェントなキャッシュ・サービス、およびクラスタリングによってスケーラビリティとパフォーマンスを実現します。

このガイドには、Oracle BI EEをベースとしたアプリケーションの開発やOracle BI EEと他のOracleシステムとの統合に関する情報が記載されています。

対象読者

このドキュメントは、プログラムからOracle BI EEコンポーネントにアクセスし、それらのコンポーネントを使用してアプリケーションの作成や他のコンポーネントとの統合を行うことを目的とする、アプリケーション開発者、データ・サービス・プロバイダ、および中間層管理者を対象としています。

ドキュメントのアクセシビリティについて

オラクル社のアクセシビリティへの取組みの詳細は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docaccを参照してください。

Oracleサポートへのアクセス

Oracleのお客様は、My Oracle Supportから電子サポートにアクセスできます。詳細は、http://www.oracle.com/pls/topic/lookup?ctx=acc&id=infoまたはhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs (聴覚障害者向け)を参照してください。

関連ドキュメントとその他のリソース

Oracle Business Intelligenceの関連ドキュメントについては、Oracle Business Intelligenceのドキュメント・ライブラリを参照してください。

さらに、Oracle Learning Libraryでは、Oracle Business Intelligenceに関連したオンラインのトレーニング・リソースが提供されます。

システム要件と動作要件

ハードウェアとソフトウェアの要件、プラットフォーム、データベースおよびその他の情報の詳細は、システム要件と動作要件のドキュメントを参照してください。いずれのドキュメントもOracle Technology Network (OTN)から入手できます。

システム要件のドキュメントには、ハードウェアとソフトウェアの要件、ディスク領域とメモリーの最小要件、必要なシステム・ライブラリ、パッケージまたはパッチなどの情報が記載されています。

http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-requirements-100147.html

動作要件のドキュメントには、サポートされているインストール・タイプ、プラットフォーム、オペレーティング・システム、データベース、JDKおよびサードパーティ製品が記載されています。

http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.html

表記規則

このドキュメントでは次の表記規則を使用します。

規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

イタリック体

イタリックは、ユーザーが特定の値を指定するプレースホルダ変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

Oracle Business Intelligence開発者向けの新機能

この序章では、Oracle Business Intelligence 11g リリース1(11.1.1)の新機能とアップグレードに関して考慮すべき事項について説明します。

この序章には、次のトピックが含まれています。

- Oracle BI EE 11g リリース1 (11.1.1.7)の新機能

- Oracle BI EE 11g リリース1 (11.1.1.6)の新機能

- Oracle BI EE 11g リリース1 (11.1.1.5)の新機能

- Oracle BI EE 11g リリース1(11.1.1.3)の新機能

Oracle BI EE 11g リリース1 (11.1.1.7)の新機能

この項では、Oracle BI EE 11gリリース1 (11.1.1.7)の新機能を説明します。内容は、次のとおりです。

- Oracle Business IntelligenceメタデータWebサービスの非同期コール

Oracle Business IntelligenceメタデータWebサービスの非同期コール

Oracle Business IntelligenceメタデータWebサービスは、Oracle BIサーバーのストアド・プロシージャの非同期および同期コールを可能にします。これらのプロシージャを使用すると、メタデータに関する情報を取得し、メタデータを修正できます。第4.3項「Oracle BIサーバーのメタデータWebサービスのコール」を参照してください。

Oracle BI EE 11g リリース1 (11.1.1.6)の新機能

この項では、Oracle BI EE 11g リリース 1 (11.1.1.6)の新機能を説明します。内容は次のとおりです。

- 「11.1.1.6.0の新機能」

- 「11.1.1.6.2の新機能」

11.1.1.6.0の新機能

Oracle BI EE 11gリリース1 (11.1.1.6.0)に新機能はありません。

11.1.1.6.2の新機能

Oracle BI EE 11gリリース1 (11.1.1.6.2)に新機能はありません。

Oracle BI EE 11g リリース1 (11.1.1.5)の新機能

この項では、Oracle BI EE 11gリリース1 (11.1.1.5)の新機能を説明します。内容は次のとおりです。

- Oracle Business IntelligenceメタデータWebサービス

- 「Siebel CRMにナビゲート」アクション・タイプ

Oracle Business IntelligenceメタデータWebサービス

Oracle BIメタデータWebサービスは、Oracle BIサーバーのストアド・プロシージャをコールするためのWebサービス・インタフェースを提供します。これらのプロシージャを使用すると、メタデータに関する情報を取得し、メタデータを修正できます。第4章「Oracle Business IntelligenceサーバーのメタデータWebサービスの使用」を参照してください。

「Siebel CRMにナビゲート」アクション・タイプ

「Siebel CRMにナビゲート」アクション・タイプを使用すると、コンテンツ・デザイナはSiebel CRMアプリケーション内のビュー(商談など)にナビゲートするアクションを追加できます。ユーザーはこのアクション・タイプにより、Siebel CRMアプリケーションに埋め込まれたダッシュボードから、CRMアプリケーション内のビュー内のレコードにナビゲートできます。このアクション・タイプを使用する場合は、Oracle Siebel CRMとOracle BI EEとの間でセキュリティ統合を実行する必要があります。また、アクション・フレームワークをOracle BI EEプレゼンテーション・サービスで使用できるようにするには、事前にアクション・フレームワークを構成しておく必要があります。

第5章「アクションによるOracle BI EEおよび外部システムの統合」および第11章「Oracle BI EEのOracle Siebel CRMへの埋込み」を参照してください。

Oracle BI EE 11g リリース1(11.1.1.3)の新機能

Oracle BI EE 11g リリース1(11.1.1.3)には、次のような新機能があります。

- Webサービス

- アクション・フレームワーク

Webサービス

Oracle Business Intelligenceには、次の新規のWebサービスが含まれます。

- ConditionServiceサービス

- JobManagementServiceサービス

既存のWebサービスにも、新規のメソッドおよび構造体が追加されました。

詳細は、第3章「Oracle BI EE Webサービスで使用するサービスとメソッドについて」を参照してください。

アクション・フレームワーク

アクション・フレームワークは、アクションを作成、管理および起動するための機能を提供します。各アクションは、分析、ダッシュボード、エージェント、KPI、およびスコアカード目標に含めることができます。アクションを使用すると、外部システム内の関連コンテンツにナビゲートでき、外部システム内の操作、関数、またはプロセスを起動できます。

Oracle BIプレゼンテーション・サービスでアクション機能を有効にするには、アクション・フレームワークを構成しておく必要があります。詳細は、第5章「アクションによるOracle BI EEおよび外部システムの統合」を参照してください。

1 Oracle Business Intelligence Webサービスの概要

この章では、Oracle Business IntelligenceのセッションベースWebサービス(SOAP)およびOracle Business Intelligence SOA用Webサービスについて説明します。SOA用Webサービスの構成と保護、SSLの有効化、およびHTTPSを介したWebサービスの起動について説明します。

この章の内容は次のとおりです。

- 第1.1項「Oracle Business Intelligence Webサービスの概要」

- 第1.2項「Oracle Business IntelligenceのセッションベースWebサービスとは」

- 第1.3項「Oracle Business IntelligenceのSOA用Webサービスとは」

- 第1.4項「Oracle Business Intelligence SOA用Webサービスの構成と保護」

- 第1.5項「Webサービス通信に対するSSLの有効化」

- 第1.6項「HTTPS経由でのOracle Business Intelligence Webサービスの起動」

1.1 Oracle Business Intelligence Webサービスの概要

Oracle Business Intelligenceは、2種類のWebサービスを提供します。Oracle Business IntelligenceセッションベースWebサービスと、Oracle Business Intelligence SOA用Webサービスです。

Oracle Business IntelligenceセッションベースWebサービスを使用すると、プログラミングによってOracle Business Intelligenceをコールし、様々なビジネス・インテリジェンス・アイテムを起動できます。このタイプのWebサービスの詳細は、「Oracle Business IntelligenceのセッションベースWebサービスとは」を参照してください。

Oracle Business Intelligence SOA用Webサービスは、Oracle BIプレゼンテーション・カタログに保存される各分析、条件、またはエージェントに固有のWebサービスを提供します。この種類のWebサービスの詳細は、「Oracle Business IntelligenceのSOA用Webサービスとは」を参照してください。

1.2 Oracle Business IntelligenceのセッションベースWebサービスとは

Oracle Business IntelligenceのセッションベースWebサービスは、SOAPを実装するアプリケーション・プログラミング・インタフェース(API)です。これらのWebサービスはプログラムから使用するように設計されており、1つのWebサービスを使用して、様々なビジネス・インテリジェンス・オブジェクトを起動できます。これらのWebサービスは、プレゼンテーション・サービス操作に関する幅広い機能を提供します。

Oracle Business IntelligenceセッションベースWebサービスを使用すると、次の3種類の機能を実行できます。

- Oracle Business Intelligence Presentation Servicesから結果を抽出し、外部アプリケーションやWebアプリケーション環境に配信します。

- Oracle Business Intelligenceプレゼンテーション・サービスの管理機能を実行します。

- Oracle BI EEアラート(インテリジェント・エージェント)を実行します。

Oracle Business IntelligenceセッションベースWebサービスを使用すると、J2EE、.NETなどの外部アプリケーションにおいて、分析計算やデータ統合エンジンとしてOracle Business Intelligenceを使用できます。これにより、外部アプリケーションとOracle Business Intelligenceプレゼンテーション・サービスとの通信を可能とするプレゼンテーション・サービス群が提供されます。

Oracle Business IntelligenceセッションベースWebサービスでは、有効なOracle Business IntelligenceセッションIDをパラメータとして渡す必要があります。つまり、コール側アプリケーションは、Webサービスをコールする前に、まずセッションを取得するコールを行う必要があります。最後に、ログアウトのためのコールを行います。

Oracle BI EE Webサービスの各サービスおよびメソッドの正式な定義は、WSDL形式で取得できます。プロキシ生成ツールを使用して、各サービスにアクセスするためのプロキシおよびスタブ・コードを作成できます。このWSDLドキュメントには、クライアント・バージョンに応じて次のOracle BI EE WebサービスURLのいずれかからアクセスできます。

http://host:port/analytics-ws/saw.dll/wsdl/v6

http://host:port/analytics-ws/saw.dll/wsdl/v7

1.3 Oracle Business IntelligenceのSOA用Webサービスとは

Oracle Business Intelligence SOA用Webサービスは、ExecuteAgent、ExecuteAnalysis、ExecuteConditionという3つのWebサービスで構成され、これらはミドルウェアJ2EEアプリケーションによってホストされます。これらのWebサービスを使用すると、サード・パーティのWebサービス・クライアント(Oracle SOA Suiteなど)を使用して、ビジネス・インテリジェンス・オブジェクトを参照し、サービス指向アーキテクチャ(SOA)コンポーネントに組み込むことができます。これらのWebサービスは、特定の値や小規模の値グループを処理し、条件ロジックや以降の手順に供給するために使用されます。この方法により、エンド・ユーザーは各自のプロセス、イベント・ルーティング、およびビジネス・ルール内で、分析の実行、条件の評価、およびエージェントの起動を行えます。Oracle Business Intelligence SOA用Webサービスは、XML文字列のみを返すことに注意してください。

Oracle Business Intelligence SOA用Webサービスは、コール側のエージェント、分析、および条件のみをサポートします。ビジネス・インテリジェンス・オブジェクトに含まれるプロンプト・フィルタやプレゼンテーション変数もサポートされます。Oracle BI EEは、コンテンツ・デザイナによってカタログに保存される各エージェント、分析、および条件に対し、独自のネームスペースを使用して、専用のWeb Services Description Language(WSDL)ドキュメントを動的に作成します。

Oracle Business Intelligence SOA用Webサービスによって動的に提供されるWSILドキュメントを使用することで、カタログ内に格納されたエージェント、分析、および条件を参照および選択できます。WSILは、使用可能な各ビジネス・インテリジェンス・オブジェクトを、一意の名前を持つWSDLドキュメントとしてリストします。各オブジェクトはそれぞれ専用のWSDLドキュメントを持つため、WSDLはプロンプト・フィルタを明示的にリストして入力を求めます。使用するSOA開発ツールでWSILの参照がサポートされない場合でも、Webブラウザのユーザー・インタフェースを使用してWSILにアクセスできます。WSILにアクセスするには、Oracle Business Intelligence プレゼンテーション・サーバー上で次のURLを入力します。

https://host:port/biservices/inspection?wsil

WSILを使用可能にするには、適切に構成する必要があります。この場合に必要な構成の詳細は、「Oracle Business Intelligence SOA用Webサービスの構成と保護」を参照してください。wsil.browsingキーを資格証明ストアに追加するための具体的な手順は、「アクション・フレームワークを使用するための資格証明の追加と保守」を参照してください。

1.4 Oracle Business Intelligence SOA用Webサービスの構成と保護

インストール時に、各Webサービス(executeAgent、executeAnalysis、executeCondition)には「policy:oracle/wss_username_token_service_policy」セキュリティ・ポリシーが割り当てられます。このポリシーでは、コール元のSOAPメッセージにおいて、WSセキュリティ・ヘッダー内にユーザー名とトークン(パスワード)を含める必要があります。受信するSOAPメッセージを介してWebサービスに渡されるユーザー資格証明には、起動されるターゲット・ビジネス・インテリジェンス・オブジェクトへの適切なアクセス権を持つ、任意の有効なビジネス・インテリジェンス・ユーザーのものを使用できます。このセキュリティ手法を使用すると、1つの手順でWebサービスをコールでき、最初にセッションIDを取得する必要がありません。Webサービスに使用するセキュリティ・ポリシーは、必要に応じて、Oracle WebLogic Serverで使用可能な任意のセキュリティ・ポリシーに変更できます。

Webサービスを起動する場合は、コール元SOAPメッセージに渡されるユーザー資格証明を使用し、ターゲット機能を起動しますが、WSILを使用してWebサービスを参照する場合は、単一のユーザー・アカウントを使用します。現時点では、参照メカニズムを使用して参照を実行しているユーザーの資格証明を使用してこのメカニズムを起動することはできません。

Webサービスの参照を有効にするには、Fusion Middleware Controlに移動して、bifoundation_domain内にあるoracle.bi.enterpriseマップにアクセスし、「wsil.browsing」資格証明を資格証明ストアに手動で追加する必要があります。このキーは、アイデンティティ・ストア内で定義されている有効なユーザーに対するユーザーIDとパスワードを保持します。たとえば、ユーザー「abell」としてターゲットWebサービスを参照する場合は、資格証明ストア内のwsil.browsingキーに「abell」の資格証明を追加します。

実際には、カタログ参照専用の特別なユーザーをアイデンティティ・ストア内に作成して、この機能で使用する必要があります。このユーザーの個人フォルダ(マイ・フォルダ)には、ビジネス・インテリジェンス・オブジェクトを格納しないようにします。他のユーザーがこの機能を起動できなくなるためです。

ユーザーおよび資格証明の設定の詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionセキュリティ・ガイド』を参照してください。

1.5 Webサービス通信に対するSSLの有効化

分析アプリケーションおよびBIミドルウェアJ2EEアプリケーションをホストする管理対象サーバーでは、HTTPSを有効化することをお薦めします。暗号化されていない資格証明は、ターゲットWebサービスに渡す途中でインターセプトされる可能性があり、SSLを使用することでこうしたリスクを緩和できます。SSLの設定を終えたら、証明書について「HTTPS経由でのOracle Business Intelligence Webサービスの起動」を参照してください。

1.6 HTTPS経由でのOracle Business Intelligence Webサービスの起動

HTTPSを使用している場合にOracle Business Intelligence Webサービスを起動するには、サーバー上のWebサービスをコールするクライアント(Oracle Business Intelligence SOA用WebサービスをコールするOracle BPELなど)は、サーバー証明書を信頼する必要があります。十分に認知された認証局から発行された正規の証明書をサーバーが保持しているのであれば、クライアントはサーバー証明書を信頼でき、これ以上の構成は必要ありません。ただし、デフォルトではこのような環境は整っていません。該当のWebサービスをホストするWebLogic管理対象サーバーが使用するルート証明書を、これらのWebサービスをコールするWebサービス・クライアントの適切なキーストアにインポートする必要があります。

本番環境では、十分に認知された認証局が署名した証明書を使用することをお薦めします。

Webサービス・クライアントが信頼する必要のある、管理対象サーバーのルート証明書の場所を確認するには、次の手順を実行します。

ルート証明書の場所を確認するには:

1. ブラウザでWebLogicコンソールを開きます。デフォルトでは、WebLogicコンソールの場所は次のとおりです。

http://host:7001/console

2. Oracle WebLogic Server管理コンソールで「SSL」タブを選択し、「ID」領域に移動します。デフォルトでは、証明書の場所は「デモIDキーストア」となります。この場合は、「キーストア」タブに移動し、デモIDキーストアの場所を確認します。
デモIDキーストアのデフォルトの場所は、次のとおりです。

MW_HOME/wlserver_10.3_server/lib/DemoIdentity.jks

3. Oracle Keytoolユーティリティを使用してルート証明書を表示し、エクスポートします。

2 Oracle BI EE Webサービスで使用する構造体について

この章では、Oracle Business IntelligenceのセッションベースWebサービスで使用する構造体について説明します。

このドキュメントでは、JavaScriptに類似した構文を使用して構造体を表現します。正確な構文および実装は、アプリケーション開発環境で使用されるSOAPコード生成ツールおよびターゲット言語により異なります。

この章の内容は次のとおりです。

- 第2.1項「AccessControlToken構造体」

- 第2.2項「Account構造体」

- 第2.3項「ACL構造体」

- 第2.4項「ArrayofGUIDS構造体」

- 第2.5項「AuthResult構造体」

- 第2.6項「CatalogItemsFilter構造体」

- 第2.7項「CatalogObject構造体」

- 第2.8項「ErrorInfo構造体」

- 第2.9項「GetSubItemsParams構造体」

- 第2.10項「ImportError構造体」

- 第2.11項「ItemInfo構造体」

- 第2.12項「NameValuePair構造体」

- 第2.13項「PathMap構造体」

- 第2.14項「Privilege構造体」

- 第2.15項「QueryResults構造体」

- 第2.16項「ReportHTMLOptions構造体」

- 第2.17項「ReportParams構造体」

- 第2.18項「ReportRef構造体」

- 第2.19項「SAColumn構造体」

- 第2.20項「SASubjectArea構造体」

- 第2.21項「SATable構造体」

- 第2.22項「SAWLocale構造体」

- 第2.23項「SAWSessionParameters構造体」

- 第2.24項「SegmentationOptions構造体」

- 第2.25項「SessionEnvironment構造体」

- 第2.26項「StartPageParams構造体」

- 第2.27項「TreeNodePath構造体」

- 第2,28項「UpdateACLParams構造体」

- 第2.29項「UpdateCatalogItemACLParams構造体」

- 第2.30項「Variable構造体」

- 第2.31項「XMLQueryExecutionOptions構造体」

2.1 AccessControlToken構造体

この構造体を使用して、アクセス制御リストの特定のアカウントに許可されたパーミッションを説明します。この構造体は、SecurityServiceサービスで使用します。

表2-1に、この構造体のフィールドをリストします。

表2-1 AccessControlToken構造体のフィールド

フィールド

説明

Account account

Account構造体への参照を指定します。

int permissionMask

次のフラグの組合せを指定します。

1 = アイテムの内容を読むパーミッション

2 = ディレクトリをトラバースするパーミッション

4 = アイテムの内容を変更するパーミッション

8 = アイテムを削除するパーミッション

16 = 他のアカウントにパーミッションを設定するパーミッション

32 = アイテムの所有権を得るパーミッション

2048 = Oracle BI Publisherレポートを生で実行するパーミッション

4096 = Oracle BI Publisherレポートをスケジュールするパーミッション

8192 = Oracle BI Publisherレポートの出力を参照するパーミッション

65535 = アイテムのフル・コントロール権限を付与するパーミッション

2.2 Account構造体

この構造体を使用して、ユーザー名やグループ名を保持します。これは、名前がユーザー名かグループ名かを示すフラグを持っています。この構造体は、SecurityServiceサービスで使用します。

表2-2に、この構造体のフィールドをリストします。

表2-2 Account構造体のフィールド

フィールド

説明

String accountName

アカウント名またはグループ名を指定します。

int accountType

アカウントがユーザーか、グループか、または両方かを指定します(0 = ユーザー、1 = カタログ・グループ、2 = アプリケーション・ロール、3 = すべて)。

このフィールドの高度な使用方法として、次のことに注意してください。accountTypeが4以上の場合、システムはNameまたはGUIDをパターンとして扱います。すなわち、accountTypeはユーザーをフェッチする場合は4、カテゴリ・グループをフェッチする場合は5、アプリケーション・ロールをフェッチする場合は6、すべてのパターンの場合は7となります。このフィールドをこのように使用した場合、コストがかかり低速になるうえ、システムが大量にレコードを返却する原因となる可能性があります。Accountを受け取ると、NameとGUIDの両方が設定されます。accountTypeは、ユーザーの場合は0、カタログ・グループの場合は1、アプリケーション・ロールの場合は4となります。

String GUID

アカウントを識別する一意のIDを指定します。

2.3 ACL構造体

この構造体を使用して、アクセス制御リスト(ACL)を保持します。この構造体は、SecurityServiceサービスで使用します。

表2-3に、この構造体のフィールドをリストします。

表2-3 ACL構造体のフィールド

フィールド

説明

AccessControlToken[] accessControlTokens

パーミッションの全リストを指定します。

String dummy

内部で使用します。

2.4 ArrayofGUIDS構造体

この構造体を使用して、保存した結果セットを表すGUIDのリストを指定します。この構造体は、SecurityServiceサービスで使用します。

表2-4に、この構造体のフィールドをリストします。

表2-4 ArrayofGUIDS構造体のフィールド

フィールド

説明

String[] guid

保存した結果セットを表すGUIDのリストを指定します。

2.5 AuthResult構造体

この構造体を使用して、認可時の認証の詳細を指定します。この構造体は、SecurityServiceサービスで使用されています(impersonateex()メソッドおよびlogonex()メソッドの中で)。

表2-5に、この構造体のフィールドをリストします。

表2-5 AuthResult構造体のフィールド

フィールド

説明

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

boolean authCompleted

TRUEに設定されている場合、認可は完了しています。FALSEに設定されている場合、認可のプロセスの最中であるため、再度logonexかimpersonatexのプロセスをコールします。

2.6 CatalogItemsFilter構造体

パスとタイムスタンプをもとにカタログ項目および変更をフィルタするために、この構造体を使用します。この構造体は、ReplicationServiceサービスで使用します。

表2-6に、この構造体のフィールドをリストします。

表2-6 CatalogItemsFilter構造体のフィールド

フィールド

説明

String[] items

フィルタに含めるフォルダおよびその子フォルダを指定します。この値がNULLの場合、カタログのすべてのノードが含まれます。

Calendar from

フィルタする期間を指定します。その期間中のタイムスタンプを持つ項目および変更のみがフィルタを満たします。これらフィールドのいずれかまたは両方がNULLである場合、そのフィールドに対する範囲設定がないものとされます。

Calendar to

フィルタする期間を指定します。その期間中のタイムスタンプを持つ項目および変更のみがフィルタを満たします(from <= タイムスタンプ <= to)。これらフィールドのいずれかまたは両方がNULLである場合、そのフィールドに対する範囲設定がないものとされます。

2.7 CatalogObject構造体

この構造体を使用して、単一のメソッドにおける特定のカタログ・オブジェクトのすべての情報を取得または指定します。この構造体はWebCatalogServiceサービスで使用します。

表2-7に、この構造体のフィールドをリストします。

表2-7 CatalogObject構造体のフィールド

フィールド

説明

String catalogObject

オブジェクトのXML表現を指定します。

catalogObjectBytes

カタログ・オブジェクトから返却されるコンテンツが文字列かバイトかを指定します。このフィールドで指定するものは、readObjectsメソッドによって決まります。

ItemInfo itemInfo

ItemInfo共通構造体で提供されているオブジェクトのカタログ情報を指定します。

ItemInfo構造体の詳細は、第2.11項「ItemInfo構造体」を参照してください。

ErrorInfo errorInfo

readObjectsメソッドのErrorDetails引数の指定を受けて、提供するエラー情報のレベルを指定します。

2.8 ErrorInfo構造体

この構造体を使用して、プレゼンテーション・カタログ・サービスのメソッドを呼び出す際のエラー情報を取得します。この構造体は、WebCatalogServiceサービスで使用します。

表2-8に、この構造体のフィールドをリストします。

表2-8 ErrorInfo構造体のフィールド

フィールド

説明

String code

表示するエラー・コードを指定します。

String context

エラーが起きたサービスおよびメソッドを指定します。

String details

エラーの詳細を指定します。

String message

可読形式のエラーの説明を指定します。

2.9 GetSubItemsParams構造体

この構造体を使用して、getSubItemsメソッドで使用されているオプションのパラメータを保持します。この構造体は、WebCatalogServiceサービスで使用します。

表2-9に、この構造体のフィールドをリストします。

表2-9 GetSubItemsParams構造体のフィールド

フィールド

説明

GetSubItemsFilter filter

内部でのみ使用されます。

boolean includeACL

TRUEに設定されている場合、結果のItemInfo構造体にACL情報が含まれます。

int withPermissionおよびint withPermissionMask

結果のアイテム・コレクションをアクセス・レベルでフィルタすることを指定します。次の式でtrueとなるアイテムのみが結果に含まれます。

(itemPermission & withPermissionMask) = (withPermission & withPermissionMask)

itemPermissionは、現在のカタログ項目におけるパーミッション・フラグの組合せです。

int withAttributesおよび

int withAttributesMask

結果のアイテム・コレクションを属性フラグでフィルタすることを指定します。次の式でtrueとなるアイテムのみが結果に含まれます。

(itemAttributes & withAttributesMask) = (withAttributes & withAttributesMask)

itemAttributesは、現在のカタログ項目における属性フラグの組合せです。

2.10 ImportError構造体

この構造体を使用して、インポート時の失敗の原因を説明します。この構造体は、ReplicationServiceサービスで使用します。

表2-10に、この構造体のフィールドをリストします。

表2-10 ImportError構造体のフィールド

フィールド

説明

String item

変更されたアイテムへのパスを指定します。例: /users/jchan/analyses/。

String operation

内部でのみ使用されます。

String catalogError

失敗の理由を説明するエラー文字列を指定します。

String file

どのファイルでエラーが発生したかを指定します。

String line

どの行でエラーが発生したかを指定します。

2.11 ItemInfo構造体

この構造体を使用して、オブジェクトのカタログ情報を保持します。この構造体は、WebCatalogServiceサービスで使用します。

表2-11に、この構造体のフィールドをリストします。

表2-11 ItemInfo構造体のフィールド

フィールド

説明

String path

カタログ内のオブジェクトへのパスを指定します。例: /users/jchan/analyses/。

ItemInfoType type

型を示す文字列を指定します。有効な値は次のとおりです。

- Folder

- Link

- Missing

- NoAccess

- Object

String caption

カタログのオブジェクトのローカル名を指定します。たとえば、フランス語では「My Folders」は「Mes Dossiers」と表示されます。

int attributes

次のフラグの組合せを指定します。

1 = 読取りのみ 2 = アーカイブ 4 = 非表示 8 = システム

Calendar lastModified

オブジェクトを最後に変更した日付と時間をカレンダ形式で指定します。

Calendar created

カタログにオブジェクトを作成(保存)した日付と時間をカレンダ形式で指定します。

Calendar accessed

ユーザーがオブジェクトに最後にアクセスした日付と時間をカレンダ形式で指定します。

String signature

カタログ・オブジェクトのシグネチャを指定します。

NameValuePair[] itemProperties

オブジェクト・プロパティの配列を指定します。

ACL aclXX

このカタログ項目のアクセス制御リストを指定します。

Account owner

オブジェクトのオーナーを指定します。

String targetPath

ItemInfoTypeフィールドが「Link」に設定されている場合、このフィールドはオブジェクトのターゲット・パスを指定します。

2.12 NameValuePair構造体

この構造体を使用して、名前付きプロパティを指定します(COLOR=REDなど)。この構造体は、WebCatalogServiceサービスで使用します。

表2-12に、この構造体のフィールドをリストします。

表2-12 NameValuePair構造体のフィールド

フィールド

説明

String name

プロパティの名前を示す文字列を指定します(COLORなど)。

String value

値を示す文字列を指定します(REDなど)。

2.13 PathMap構造体

この構造体を使用して、出力メソッドに含まれているデータのコピー先を指定します。この構造体は、ReplicationServiceサービスで使用します。

表2-13に、この構造体のフィールドをリストします。

表2-13 PathMap構造体のフィールド

フィールド

説明

PathMapEntry pathMapEntries

出力メソッドに含まれているデータのコピー先を指定します。

2.14 Privilege構造体

この構造体を使用して、グローバル権限を表します。Oracle BI EEでは、「権限の管理」画面を使用してこれらの権限を構成します。この構造体は、第3.9項「SecurityServiceサービス」で使用します。

表2-14に、この構造体のフィールドをリストします。

表2-14 Privilege構造体のフィールド

フィールド

説明

String name

権限の名前を指定します。

String description

権限の説明を指定します。

2.15 QueryResults構造体

この構造体を使用して、問合せ実行時の問合せ詳細を指定します。この構造体は、第3.11項「XMLViewServiceサービス」 (executeXMLQueryメソッド)で使用します。

表2-15に、この構造体のフィールドをリストします。

表2-15 QueryResults構造体のフィールド

フィールド

説明

String rowset

文字列にエンコードされた行セットXMLを指定します。

String queryID

fetchNextコールで使用できる問合せの一意なIDを指定します。

boolean finished

TRUEに設定されている場合、返却する行がもうないことを意味します。FALSEに設定されている場合、行を返却するために再度fetchNextコールが必要であることを意味します。

2.16 ReportHTMLOptions構造体

この構造体を使用して、結果をHTMLページに表示するオプションを定義します。この構造体は、第3.2項「HtmlViewServiceサービス」で使用します。

表2-16に、この構造体のフィールドをリストします。

表2-16 ReportHTMLOptions構造体のフィールド

フィールド

説明

boolean enableDelayLoading

内部でのみ使用します。このフィールドには常に1が設定されます。これは、Oracle Business Intelligence Webサービスはすぐに結果を提供する必要がなく、結果待ちであるというメッセージを表示することを意味します。

String linkMode

ドリルまたはリンクを現在のブラウザ・ウィンドウで表示するか、新しいブラウザ・ウィンドウで表示するかを指定します。有効な値の詳細は、第2.16.1項「ReportHTMLLinksMode列挙」を参照してください。

2.16.1 ReportHTMLLinksMode列挙

この列挙は、ReportHTMLOptions構造体のReportHTMLLinksModeフィールドで有効な値のリストを指定します。

表2-17に、この列挙の値をリストします。

表2-17 ReportHTMLLinksMode列挙の値

値

説明

String InPlace

ドリルまたはリンクは、ページのその他の部分を変更せず、現在の分析の内容のみを置き換えることを指定します。

String NewPage

ドリルまたはリンクを新しいブラウザ・ウィンドウで表示することを指定します。

String SamePage

ドリルまたはリンクは現在のブラウザ・ウィンドウを置き換えることを指定します。

2.17 ReportParams構造体

この構造体を使用して、分析の既存のフィルタおよび変数を置き換えます。この構造体は、Oracle BI EE Webサービスのすべてのサービスで共通です。

表2-18に、この構造体のフィールドをリストします。

表2-18 ReportParams構造体のフィールド

フィールド

説明

String[] filterExpressions

Oracle Business Intelligence Webサービスのフィルタ式の配列を指定します(形式は、Object[] filter_expression, filter_expression ...)。

Variable[] variables

メソッド実行前に設定する変数値の配列を指定します。この構造体は、第3.11.4項「executeXMLQuery()メソッド」および第3.7.3項「generateReportSQL()メソッド」で使用します。

NameValuePair[] nameValues

NULLに設定します。このフィールドは内部で使用します。

TemplateInfo[] templateInfos

NULLに設定します。このフィールドは内部で使用します。

String viewName

分析のXMLデータを生成する際に、どのビューを使用するのかを指定します。

表2-19に、分析にフィルタ式を適用する方法を示します。

表2-19 Oracle BI EE Webサービスの分析にフィルタ式を適用する方法

手順

内部処理

1

分析のXML表現と各フィルタ式を取得します。

2

各式要素ごとに、sqlExpression型の子ノードを特定(型はxsi:type attributeの値によって決定)し、その内部テキストを参照します。

3

分析XMLにおいて、内部テキストが前述の手順で特定されたものと合致するsqlExpression型の子ノードを持つすべてのノードを特定します。

4

ステップ3で特定したすべてのノードを、ステップ2の式で置き換えます。

表2-20に、分析に変数を適用する方法を示します。

表2-20 Oracle BI EE Webサービスの分析に変数を適用する方法

手順

内部処理

1

分析のXML表現を取得します。

2

各変数ごとに、variable型で、属性範囲が分析と同じで、変数名と合致する内部テキストを持つすべてのノードを、分析XMLから特定します。

3

ステップ2で特定した各ノードを、新しい変数値で置き換えます。

2.18 ReportRef構造体

この構造体を使用して、次のいずれかの方法で分析を参照します。

- カタログの分析の場所。

- 分析を定義するReportDefオブジェクト。このフィールドは常にNULLです。

- 分析を定義するXML。

注意:

ReportRefの1つのフィールドのみにデータ移入します。

ReportRef構造体は、Oracle BI EE Webサービスのすべてのサービスに共通です。

表2-21に、この構造体のフィールドをリストします。

表2-21 ReportRef構造体のフィールド

フィールド

説明

String reportPath

カタログの分析へのパスを提供する文字列値を指定します。例: /users/jchan/analyses/。

String reportXML

分析を定義するXMLを含む文字列値を指定します。

2.19 SAColumn構造体

この構造体を使用して、サブジェクト・エリアの論理列を表します。この構造体は、第3.5項「MetadataServiceサービス」で使用します。

表2-22に、この構造体のフィールドをリストします。

表2-22 SAColumn構造体のフィールド

フィールド

説明

String name

SQL文で使用する列名を指定します。

String displayName

Oracle Business Intelligence Answersで使用するローカル名を指定します。

String description

列名の説明を保持する文字列を指定します。

boolean nullable

TRUEに設定されている場合、列はNULLとなる場合があります。

String dataType

列が保持するデータ型を指定します。詳細は、第2.19.1項「SADataType値」を参照してください。

boolean aggregateable

TRUEに設定されている場合、列は集計できます。

String aggrRule

列が集計データを保持する場合、この値は使用されている集計の種類を指定します。詳細は、第2.19.2項「AggregationRule値」を参照してください。

2.19.1 SADataType値

SADataTypeは、列が保持するデータの型を指定します。次のリストに、利用可能なデータ型を示します。

- BigInt

- Binary

- Bit

- Char

- Coordinate

- Date

- Decimal

- Double

- Float

- Integer

- Invalid

- LongVarBinary

- LongVarChar

- Numeric

- Real

- SmallInt

- Time

- TimeStamp

- TinyInt

- Unknown

- VarBinary

- VarChar

2.19.2 AggregationRule値

SADataTypeは、列のデフォルト集計ルールを指定します。次のリストに、利用可能な集計関数を示します。

- Avg

- BottomN

- Complex

- Count

- CountDistinct

- CountStar

- DimensionAggr

- First

- Last

- Max

- Min

- None

- Percentile

- Rank

- ServerDefault

- SubTotal

- Sum

- TopN

2.20 SASubjectArea構造体

この構造体を使用して、サブジェクト・エリア属性を表します。この構造体は、第3.5項「MetadataServiceサービス」で使用します。

表2-23に、この構造体のフィールドをリストします。

表2-23 SASubjectArea構造体のフィールド

フィールド

説明

String name

SQL文で使用する表名を指定します。

String displayName

Oracle Business Intelligence Answersで使用するローカル名を指定します。

String description

サブジェクト・エリアの説明を指定します。

SATable[] tables

このサブジェクト・エリアの表のコレクションを指定します。SATable構造体の詳細は、第2.21項「SATable構造体」を参照してください。

2.21 SATable構造体

この構造体を使用して、サブジェクト・エリアの論理表を表します。この構造体は、第3.5項「MetadataServiceサービス」で使用します。

表2-24に、この構造体のフィールドをリストします。

表2-24 SATable構造体のフィールド

フィールド

説明

String name

SQL文で使用する表名を指定します。

String displayName

Oracle Business Intelligence Answersで使用するローカル名を指定します。

String description

表名の説明を指定します。

SAColumn[] columns

表の列の配列を指定します。SAColumn構造体の詳細は、第2.19項「SAColumn構造体」を参照してください。

2.22 SAWLocale構造体

この構造体を使用して、現在のセッションのロケールを定義します。この構造体は、第3.8項「SAWSessionServiceサービス」で使用します。

表2-25に、この構造体のフィールドをリストします。

表2-25 SAWLocale構造体のフィールド

フィールド

説明

String language

言語コードを指定します。言語の値は、Javaのjava.util.Localeクラス(ISO-639、ISO-3166)で使用されているものに準拠します。

String country

国コードを指定します。国の値は、Javaのjava.util.Localeクラス(ISO-639, ISO-3166)で使用されているものに準拠します。

2.23 SAWSessionParameters構造体

この構造体を使用して、現在のセッションにおけるオプションのパラメータを定義します。この構造体は、第3.8項「SAWSessionServiceサービス」で使用します。

表2-26に、この構造体のフィールドをリストします。

表2-26 SAWSessionParameters構造体のフィールド

フィールド

説明

SAWLocale locale

使用するロケールを指定します(SAWLocale構造体で提供)。SAWLocale構造体の詳細は、第3.8項「SAWSessionServiceサービス」を参照してください。

String userAgent

現在のセッションでHTMLViewサービスを使用するかどうかを指定します。これは、Oracle Business Intelligenceプレゼンテーション・サービスのHTMLコンテンツが表示される、ブラウザのuserAgent文字列を指定します。Oracle Business Intelligenceプレゼンテーション・サービスは、この情報を使用してブラウザ固有のHTMLを作成します。

String syndicate

内部でのみ使用します。

LogonParameter logonParams

認証で使用するパラメータを指定します。

boolean asyncLogon

TRUEに設定されている場合、非同期ログインが有効になります。FALSE(デフォルト)に設定されている場合、非同期ログインは無効となります。

String sessionID

セッションの一意のIDを指定します。このフィールドは、第3.8.9項「logonex()メソッド」および第3.8.5項「impersonateex()メソッド」で使用します。

2.24 SegmentationOptions構造体

この構造体を使用して、Oracle Marketing Analyticsのユーザー・インタフェースで指定されているデフォルトを上書きする、セグメントまたはセグメント・ツリーを定義します。この構造体は、第3.5項「MetadataServiceサービス」で使用します。

表2-27に、この構造体のフィールドをリストします。

表2-27 SegmentationOptions構造体のフィールド

フィールド

説明

OverrideType cacheOverride

Oracle Marketing Analyticsにおける今後の更新カウント・リクエストに対するブロックをキャッシュのユーザー・インタフェース・オプションをどのように上書きするかを指定します。

デフォルトに設定されている場合、構造体でのキャッシュ・オーバーライドが指定されていないか、構造体が指定されていません。デフォルト値は、各基準ブロックのユーザー・インタフェース・オプションで定義されているものを使用することを指定しています。

Noneに設定されている場合、システムはユーザー・インタフェースで定義された値をオーバーライドし、すべての基準ブロックで今後の更新カウント・リクエストに対するブロックをキャッシュのユーザー・インタフェース・オプションを無効にします。

Allに設定されている場合、システムはユーザー・インタフェースで定義された値をオーバーライドし、すべての基準ブロックで今後の更新カウント・リクエストに対するブロックをキャッシュユーザー・インタフェースのオプションを有効にします。

OverrideType countOverride

システムがカウント数の生成にgetCountsメソッドを使用するべきかを指定します。

デフォルトに設定されている場合、構造体でのカウントのオーバーライドが指定されていないか、構造体が指定されていません。

Allに設定されている場合、システムはgetCountsメソッドを実行します。Allに設定されている場合、システムはすべての基準ブロックに対してカウント数を計算します。

NameValuePair
govRules

セグメントまたはセグメント・ツリーに対する契約計画ルールを適用するための値を指定します。

NameValuePair
prompts

セグメントまたはセグメント・ツリーの列に適用するプロンプト値を指定します。このプロセスは、カウント生成時にデータをフィルタします。

このフィールドに値を提供しない場合、システムはセグメントの列に対してフィルタ基準を適用しません。

Boolean removeCacheHits

カウント情報を含むキャッシュ・エントリの消去を指定します。

Trueに設定されている場合、システムは最新のデータに対して問合せを行います。これを行うため、システムはターゲットのセグメントまたはセグメント・ツリーのカウント情報を持つすべての既存キャッシュ・エントリを削除します。システムはその後、getCountsメソッドで計算された新しいカウント数エントリで、キャッシュのデータを再移入します。

BigDecimal samplingFactor

カウントを計算するデータセットのサイズを指定します。getCountsメソッドは、この値によって決定するデータのサブセットに対し、すべての基準ブロックのカウント数を計算します。

デフォルト値は100です。このデフォルト値によって、カウント数は全データセットに対して計算されます。

2.25 SessionEnvironment構造体

この構造体を使用して、現在のセッションの環境情報を返却します。この構造体は、第3.8項「SAWSessionServiceサービス」で使用します。

表2-28に、この構造体のフィールドをリストします。

表2-28 SessionEnvironment構造体のフィールド

フィールド

説明

String userName

現在のユーザーの名前を指定します。

ItemInfo homeDirectory

カタログにおけるユーザーのホーム・ディレクトリへのフルパスを指定します。例: /users/<ユーザー・ログインID>。

ItemInfo[] SharedDirectories

現在のユーザーが最低でも読取りアクセス権を持つ共有ディレクトリへのフルパスを指定します。

注意: デフォルトでは、「/shared」ディレクトリの直下をリストできるのは管理者のみです。ユーザーによる共有エリアのナビゲートは、SessionEnvironmentオブジェクトの取得のみです。

2.26 StartPageParams構造体

この構造体を使用して、startPageメソッド起動のオプションを定義します。この構造体は、第3.2項「HtmlViewServiceサービス」で使用します。

表2-29に、この構造体のフィールドをリストします。

表2-29 StartPageParams構造体のフィールド

フィールド

説明

String idsPrefix

HTMLページでの名前の競合を回避するために、すべてのHTML要素のIDや名前と併用する接頭辞を指定します。

boolean dontUseHttpCookies

TRUEに設定されている場合、Oracle Business Intelligenceプレゼンテーション・サービスはsessionIDを渡すためにCookieを使用できません。そのかわり、sessionIDがコールバックURLにパラメータとして含まれます。

2.27 TreeNodePath構造体

この構造体を使用して、セグメント・ツリーのブランチに対するセグメント・ツリー・パスとブランチIDを指定します。この構造体は、第3.4項「JobManagementServiceサービス」で使用します。

表2-30に、この構造体のフィールドをリストします。

表2-30 TreeNodePath構造体のフィールド

フィールド

説明

String treeNode

リストに含めるメンバーを保持するセグメント・ツリーのブランチID番号を指定します。

String treePath

セグメント・ツリーへのパスを指定します。

2.28 UpdateACLParams構造体

この構造体を使用して、updateACLメソッド起動のオプションを設定します。この構造体は、第3.9項「SecurityServiceサービス」で使用します。

表2-31に、この構造体のフィールドをリストします。

表2-31 UpdateACLParams構造体のフィールド

フィールド

説明

UpdateACLMode updateFlag

ACLモードの更新方法を指定します。詳細は、第2.28.1項「UpdateACLMode列挙」を参照してください。

2.28.1 UpdateACLMode列挙

この列挙は、UpdateACLParams構造体の更新フラグで有効な値のリストを指定します。

表2-32「UpdateACLMode列挙の値」に、この列挙の値をリストします。

表2-32 UpdateACLMode列挙の値

値

説明

String ReplaceACL

更新するACLの値を指定します。

String ReplaceForSpecifiedAccounts

ACLで更新するアカウントのリストを指定します。

String DeleteAccountsFromACL

ACLから削除するアカウントのリストを指定します。

2.29 UpdateCatalogItemACLParams構造体

この構造体を使用して、第3.10.18項「updateCatalogItemACL()メソッド」で追加のパラメータを提供します。この構造体は、第3.10項「WebCatalogServiceサービス」で使用します。

表2-33に、この構造体のフィールドをリストします。

表2-33 UpdateCatalogItemACLParams構造体のフィールド

フィールド

説明

UpdateACLMode updateFlag

ACLモードの更新方法を指定します。詳細は、第2.28.1項「UpdateACLMode列挙」を参照してください。

boolean recursive

TRUEに設定されている場合、メソッドはカタログ項目と、パスによって識別されるそのすべての子孫に適用されます。FALSEに設定されている場合、メソッドはカタログ項目にのみ適用されます。

2.30 Variable構造体

この構造体を使用して、分析の変数を参照し、他の変数で置き換えます。この構造体は、Oracle BI EE Webサービスのすべてのサービスで共通です。

表2-34に、この構造体のフィールドをリストします。

表2-34 Variable構造体のフィールド

フィールド

説明

String name

置き換える変数の名前を示す文字列を指定します。

Object value

変数の値を指定します。

2.31 XMLQueryExecutionOptions構造体

この構造体を使用して、問合せにおけるオプションのパラメータを指定します。この構造体は、第3.11項「XMLViewServiceサービス」 (executeXMLQueryメソッドの中)で使用します。

表2-35に、この構造体のフィールドをリストします。

表2-35 XMLQueryExecutionOptions構造体のフィールド

フィールド

説明

boolean async

TRUEに設定されている場合、非同期問合せ実行が有効です。FALSEに設定されている場合、非同期問合せ実行は無効です。

int maxRowsPerPage

executeXMLQueryまたはfetchNextメソッドによって返却される行の最大数を指定します。

boolean refresh

TRUEに設定されている場合、データをリフレッシュするためにサーバーが問合せを再送信します。FALSEに設定されている場合、Oracle Business Intelligence Serverはキャッシュにあるデータを使用します。

boolean presentationInfo

TRUEに設定されている場合、ローカライズされたプレゼンテーション情報を、レコード・セットXMLのメタデータ・セクションに格納します。

プレゼンテーション情報は次のものから構成されます。

- 列ヘッダー情報(columnHeadingフィールドに格納されています)。

- 表ヘッダー情報(tableHeadingフィールドに格納されています)。

String type

問合せIDを指定します。このIDは、エラーを診断する際に、ログで使用できます。

3 Oracle BI EE Webサービスで使用するサービスとメソッドについて

この章では、Oracle Business IntelligenceのセッションベースWebサービスで使用するサービスおよびメソッドについて説明します。

このドキュメントでは、JavaScriptに類似した構文を使用して構造体を表現します。正確な構文および実装は、アプリケーション開発環境で使用されるSOAPコード生成ツールおよびターゲット言語により異なります。

この章の内容は次のとおりです。

- 第3.1項「ConditionServiceサービス」

- 第3.2項「HtmlViewServiceサービス」

- 第3.3項「iBotServiceサービス」

- 第3.4項「JobManagementServiceサービス」

- 第3.5項「MetadataServiceサービス」

- 第3.6項「ReplicationServiceサービス」

- 第3.7項「ReportEditingServiceサービス」

- 第3.8項「SAWSessionServiceサービス」

- 第3.9項「SecurityServiceサービス」

- 第3.10項「WebCatalogServiceサービス」

- 第3.11項「XMLViewServiceサービス」

3.1 ConditionServiceサービス

このサービスは、Oracle BI EEの条件をプログラムで評価するために使用します。このサービスでは、条件で使用できるカスタマイズ可能なフィルタを取得することもできます。

表3-1は、サポートされるメソッドを示しています。

表3-1 ConditionServiceのメソッド

メソッド名

説明

第3.1.1項「evaluateCondition()メソッド」

カタログに保存されている条件を評価します。

第3.1.2項「evaluateInlineCondition()」メソッド

パラメータとして指定された条件を評価します。

第3.1.3項「getConditionCustomizableReportElements()メソッド」

カタログに保存されている条件のカスタマイズ可能なフィルタを取得します。

3.1.1 evaluateCondition()メソッド

このメソッドを使用して、カタログに保存されている条件を評価します。このメソッドは、条件の結果(trueまたはfalse)を含むXML文字列を戻します。

3.1.1.1 シグネチャ

boolean evaluateCondition(String path, String[] reportCustomizationParameters, String sessionID);

引数

説明

String path

カタログ内の条件のフルパスおよび名前を指定します。例: /users/jchan/Conditions/IsRegionUnderBudget

String [] reportCustomizationParameters

カスタマイズ・パラメータXMLを指定します。これは、条件にカスタマイズ可能なフィルタがある場合のみ使用されます。このXMLは、orahome/bifoundation/web/schemas/analysis_customization.xsdで使用できるカスタマイズ・スキーマに対して検証されます。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.1.2 evaluateInlineCondition()メソッド

このメソッドを使用して、Oracle BI EEプレゼンテーション・サービス外で定義された条件を評価します。条件XMLは、conditionXMLパラメータで指定されます。このメソッドは、条件評価の結果(trueまたはfalse)を含むXML文字列を戻します。

3.1.2.1 シグネチャ

boolean evaluateInlineCondition(String conditionXML, String[] reportCustomizationParameters, String sessionID);

引数

説明

String conditionXML

条件XMLを指定します。このXMLは、orahome/bifoundation/web/schemas/condition.xsdで使用可能な条件スキーマに対して検証されます。

String[] ListreportCustomizationParameters

カスタマイズ・パラメータXMLを指定します。これは、条件にカスタマイズ可能なフィルタがある場合のみ使用されます。このXMLは、orahome/bifoundation/web/schemas/analysis_customization.xsdで使用できるカスタマイズ・スキーマに対して検証されます。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.1.3 getConditionCustomizableReportElements()メソッド

このメソッドを使用して、カタログに格納されている条件で使用できるカスタマイズ可能なフィルタを判断します。このメソッドは、条件内で使用できるカスタマイズ可能なフィルタの定義を含むXML文字列を戻します。XMLは、orahome/bifoundation/web/schemas/analysis_customization.xsdで使用可能なカスタマイズ・スキーマに定義された形式です。

3.1.3.1 シグネチャ

String[] getConditionCustomizableReportElements(String path, String sessionID);

引数

説明

String path

カタログ内の条件のフルパスおよび名前を指定します。例: /users/jchan/Conditions/IsRegionUnderBudget

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.2 HtmlViewServiceサービス

このサービスを使用して、Oracle BI EE HTMLの結果をサード・パーティの動的Webページ(Active Server Pages (ASP)、JavaServer Pages (JSP)など)やポータル・フレームワークに埋め込みます。この埋込みプロセスにより、Oracle BI EEのWebサービス・コンテンツとサード・パーティのWebページのコンテンツがマージされます。

表3-2は、サポートされるメソッドを示しています。

表3-2 HtmlViewServiceのメソッド

メソッド名

説明

第3.2.2項「addReportToPage()メソッド」

結果をHTMLページに追加します。

第3.2.3項「endPage()メソッド」

サーバー・ページ・オブジェクトとそれに関連付けられたすべてのデータを破棄します。

第3.2.4項「getCommonBodyHTML()メソッド」

<BODY>セクションに含めるHTMLを取得します。

第3.2.5項「getHeadersHTML()メソッド」

<HEAD>セクションに含めるHTMLを取得します。

第3.2.6項「getHtmlforPageWithOneReport()メソッド」

1つの分析のみを含むページのHTMLを取得します。

第3.2.7項「getHTMLForReport()メソッド」

特定の結果セットを表示するHTMLを取得します。

第3.2.8項「setBridge()メソッド」

通信を受信するブリッジURLを指定します。Oracle Business Intelligence Webサービス・サーバーとユーザーがアクセスしているプレゼンテーション・サービスが異なるマシン上にある場合や、アプリケーション開発環境で結果を変更する場合に役立つことがあります。

第3.2.9項「startPage()メソッド」

新しいページ・オブジェクトを作成し、そのIDを戻します。

HTMLViewServiceサービスのメソッドは、サード・パーティのWebページに挿入できるHTMLコード部分を抽出します。表3-3では、HTMLコードの抜粋と適切なページ位置について説明します。

表3-3 HtmlViewServiceサービスのHTMLコード部分とページ位置

HTMLコード部分

適切なページ位置

ヘッダー

HTMLページの<HEAD>セクションに挿入します。このコードには、共通のJavaScriptファイルとスタイルシートへのリンクが含まれます。

レポート・オブジェクト

<BODY>セクションの任意の位置に挿入できます。

共通ボディ

<BODY>タグのすべての分析リンクの後に挿入します。このコードには、ドリルダウン・リンクの実装に使用する非表示のHTML要素が含まれます。

HTMLコード部分には、戻される分析オブジェクトごとに、ブラウザがWebページをロードする際に自動的に追跡するコールバック・リンクが含まれます。コード部分には、分析のすべてのユーザー・インタフェース定義は含まれません。Oracle BI EE Presentation Servicesにより分析が構築されている間は、サード・パーティのWebページに埋め込まれたOracle BI EE Webサービスの「検索中...」のイメージが表示されます。

分析が円滑に推移するように、Oracle BI EE Presentation Servicesでは、サード・パーティのWebページの構築時に内部論理ページ・オブジェクト内の情報を管理することにより、サード・パーティのWebページに追加されたOracle Business Intelligenceの分析を追跡します。HtmlViewServiceサービスのメソッドは、そのIDにより明示的に内部論理ページを参照します。

3.2.1 HtmlViewServiceブリッジおよびコールバックURLについて

アクティブなドリルダウン・リンクを持つ分析を埋め込むため、HtmlViewServiceサービスでは、埋め込まれた分析からOracle BI EE Presentation Servicesサーバーへのコールバック・リクエストをWebブラウザが発行できます。リクエストを直接Oracle BI EEプレゼンテーション・サービス・サーバーにルーティングすることも可能ですが、多くの場合、当初サード・パーティのページを処理していたOracle BI EEインスタンスを介してリクエストをルーティングすることをお薦めします。また、Oracle BI EE Presentation Servicesとサード・パーティのWebサーバーが同じDomain Name Service (DNS)ドメインに属していない状況では、クロスドメイン・スクリプトに対するブラウザのセキュリティ制約に関連するJavaScriptエラーが生じる場合があります。

このような問題を回避するには、setBridge()メソッドを使用して、サード・パーティのWebサーバーを指すようにコールバックURLを変更します。リクエストをOracle BI EE Presentation Servicesにルーティングしなおすためにサード・パーティのWebサーバーによって実行されるWebコンポーネントは提供されていません。この機能は、サード・パーティのアプリケーションで実行する必要があります。setBridge()メソッドの詳細は、第3.2.8項「setBridge()メソッド」を参照してください。

3.2.2 addReportToPage()メソッド

このメソッドを使用して、結果をHTMLページに追加します。

3.2.2.1 シグネチャ

void addReportToPage(String pageID, String reportID, ReportRef report, String reportViewName, ReportParams reportParams, ReportHTMLOptions options, String sessionID);

引数

説明

String pageID

startPage()メソッドにより戻された文字列ページIDを指定します。startPage()メソッドの詳細は、第3.2.9項「startPage()メソッド」を参照してください。

String reportID

ページに追加する結果を含む分析を識別する文字列を指定します。これは、後続のメソッドの起動時にこの分析を参照する際に使用されます。たとえば、Oracle Business Intelligenceプレゼンテーション・サービス・サーバーで生成される、対応するユーザー・インタフェース要素は、同じIDを参照します。

ReportRef report

ReportRef構造体で提供される分析定義を指定します。

String reportViewName

表示するビューを指定します。このパラメータがnullの場合、分析のデフォルトのビューが使用されます。ビュー名は、分析XML定義でビューの識別に使用するビュー名と一致している必要があります。

ReportParams reportParams

オプション。実行前に分析に適用するフィルタまたは変数を指定します。これはReportParams共通構造体で提供されます。

詳細は、第3章「Oracle BI EE Webサービスにおけるサービスとメソッドについて」を参照してください。

ReportHTMLOptions options

オプション。実行後に分析に適用する表示オプションを指定します。これはReportHTMLOptions構造体で提供されます。詳細は、第2.15項「QueryResults構造体」を参照してください。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.2.3 endPage()メソッド

このメソッドを使用して、Oracle BI EEプレゼンテーション・サービスのサーバー・ページ・オブジェクトとそれに関連付けられたすべてのデータを破棄します。

3.2.3.1 シグネチャ

void endpage(String pageID, String sessionID);

引数

説明

String pageID

ページ・オブジェクトのIDを指定します。このIDはstartPage()メソッドにより戻されます(詳細は、第3.2.9項「startPage()メソッド」を参照してください)。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.2.4 getCommonBodyHTML()メソッド

このメソッドを使用して、<BODY>セクションに含めるHTMLを取得します。

3.2.4.1 シグネチャ

String getCommonBodyHTML(String pageID, String sessionID);

引数

説明

String pageID

ページ・オブジェクトのIDを指定します。このIDはstartPage()メソッドにより戻されます(詳細は、第3.2.9項「startPage()メソッド」を参照してください)。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.2.4.2 戻り値

<BODY>セクションに含めるHTMLを含む文字列を戻します。

3.2.5 getHeadersHTML()メソッド

このメソッドを使用して、<HEAD>セクションに含めるHTMLを取得します。

3.2.5.1 シグネチャ

String getHeadersHTML(String pageID, String sessionID);

引数

説明

String pageID

ページ・オブジェクトのIDを指定します。このIDはstartPage()メソッドにより戻されます(詳細は、第3.2.9項「startPage()メソッド」を参照してください)。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.2.5.2 戻り値

<HEAD>セクションに含めるHTMLを含む文字列を戻します。

3.2.6 getHtmlforPageWithOneReport()メソッド

このメソッドを使用して、1つの分析のみを含むページのHTMLを取得します。1つの分析のみを含むページには、<BODY>セクションおよび<HEAD>セクションはありません。

3.2.6.1 シグネチャ

String getHtmlForPageWithOneReport(String reportID, ReportRef report, String reportViewName, ReportParams reportParams, ReportHTMLOptions reportOptions, StartPageParams pageParams, String sessionID);

引数

説明

String pageReportID

getHtmlForPageWithOneReport()メソッドによって戻された分析IDを指定します。

addReportToPageメソッドの詳細は、第3.2.2項「addReportToPage()メソッド」を参照してください。

ReportRef report

ReportRef構造体で提供される分析定義を指定します。

String reportViewName

表示するビューを指定します。このパラメータがnullの場合、分析のデフォルトのビューが使用されます。ビュー名は、分析XML定義でビューの識別に使用するビュー名と一致している必要があります。

ReportParams reportParams

オプション。実行前に分析に適用するフィルタまたは変数を指定します。これはReportParams共通構造体で提供されます。

詳細は、第3章「Oracle BI EE Webサービスにおけるサービスとメソッドについて」を参照してください。

ReportHTMLOptions reportOptions

オプション。実行後に分析に適用する表示オプションを指定します。これはReportHTMLOptions構造体で提供されます。詳細は、第2.15項「QueryResults構造体」を参照してください。

StartPageParams pageParams

ページを開始する際に使用するオプションを指定します。これはStartPageParams構造体で提供されます。StartPageParams構造体の詳細は、第2.26項「StartPageParams構造体」を参照してください。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.2.7 getHTMLForReport()メソッド

このメソッドを使用して、特定の分析の結果を表示するHTMLの抜粋を取得します。このメソッドを起動する前に、addReportToPageメソッドを使用してHTMLページに結果を追加してください。

3.2.7.1 シグネチャ

String getHTMLForReport(String pageID, String pageReportID, String sessionID);

引数

説明

String pageID

ページ・オブジェクトのIDを指定します。このIDはstartPage()メソッドにより戻されます(詳細は、第3.2.9項「startPage()メソッド」を参照してください)。

String pageReportID

addReportToPage()メソッドによって戻された分析IDを指定します。

addReportToPageメソッドの詳細は、第3.2.2項「addReportToPage()メソッド」を参照してください。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.2.7.2 戻り値

指定した分析を表示するHTMLの抜粋を含む文字列を戻します。

3.2.8 setBridge()メソッド

このメソッドを使用して、通信を受信するブリッジURLを指定します。ブリッジURLを指定すると、Oracle BI EE Webサービス・サーバーとユーザーのWebサーバーが異なるマシンにある場合や、アプリケーション開発環境で結果を変更する場合に役立つことがあります。

setBridge()メソッドをコールすると、クライアント・ブラウザからOracle BI EEプレゼンテーション・サービス・サーバーへのすべてのリクエストは、ブリッジURLに送信され、そこからOracle BI EEプレゼンテーション・サービス・サーバーに転送されます。

3.2.8.1 シグネチャ

setBridge(String bridge, String sessionID);

引数

説明

String bridge

ブリッジURLを指定します。たとえば、次のようになります。

http://myserver/myapplication/sawbridge

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.2.8.2 使用方法

クライアント・ブラウザが、Javaサーブレット、Active Server Pages (ASP)ページ、Common Gateway Interface (CGI)、Internet Server application programming interface (ISAPI)、または同等のアプリケーションの形式で、ブリッジURLにハンドラを提供していることを確認する必要があります。

また、次のタスクも実行する必要があります。

- リクエスト文字列のRedirectURL引数にあるリクエストされたOracle BI EE Webサービス・リソースのパスをデコードします。RedirectURL引数の詳細は、第3.2.8.3項「コールバックURLを置換する方法」を参照してください。

- その他すべてのリクエスト引数を、すべてのヘッダーとリクエスト・ボディとともに、ブリッジURLに転送します。

- レスポンスをOracle BI EEプレゼンテーション・サービス・サーバーからレスポンス・ストリームにコピーします。

3.2.8.3 コールバックURLを置換する方法

新しいコールバックURLは、ブリッジURLに基づき、RedirectURL引数が追加されたものです。RedirectURL引数の値は、標準のURLエンコーディング・ルールを使用してエンコードされたURLの元の値である必要があります。

通常、Oracle BI EE Webサービスでは、内部的にコールバック・リンクの相対URLが使用されます。たとえば、元のコールバック・リンクがsaw.dll?Goであり、ブリッジURLが次のとおりだとします。

http://myserver/myapplication/sawbridge

この場合、新しいコールバックURLは次のようになります。

http://myserver/myapplication/sawbridge?RedirectURL=saw.dll%3fGo

3.2.9 startPage()メソッド

このメソッドを使用してページ・オブジェクトを作成し、そのIDを戻します。

3.2.9.1 シグネチャ

String startPage(StartPageParams options, String sessionID);

引数

説明

StartPageParams options

ページを開始する際に使用するオプションを指定します。これはStartPageParams構造体で提供されます。StartPageParams構造体の詳細は、第2.26項「StartPageParams構造体」を参照してください。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.2.9.2 戻り値

Oracle Business Intelligenceプレゼンテーション・サービスのページIDを含む文字列を戻します。

3.3 iBotServiceサービス

このサービスを使用して、Oracle BI EEエージェントの保存、編集、削除、登録、登録解除、カスタマイズ、および実行を行います。Oracle Business Intelligence 11g (11.1.1) リリース以降、iBotsという名前はエージェントに変更されました。

表3-4は、サポートされるメソッドを示しています。

表3-4 iBotServiceのメソッド

メソッド名

説明

第3.3.1項「writeIBot()メソッド」

新しいエージェントをカタログに書き込み、これをOracle BIスケジューラに登録します。

第3.3.2項「deleteIBot()メソッド」

エージェントをカタログから削除し、Oracle BIスケジューラから登録解除します。

第3.3.3項「executeIBotNow()メソッド」

カタログに保存されているエージェントを実行します。

第3.3.4項「moveIBot()メソッド」

エージェントをカタログ・フォルダから別のカタログ・フォルダに移動します。

第3.3.5項「sendMessage()メソッド」

Oracle BI EEのユーザー、グループ、またはその両方に、メッセージを送信します。

第3.3.6項「subscribe()メソッド」

公開されているエージェントに登録します。登録のカスタマイズも行います。

第3.3.7項「unsubscribe()メソッド」

エージェントから登録解除します。

3.3.1 writeIBot()メソッド

このメソッドを使用して、新しいエージェントをカタログに書き込み、これをOracle BIスケジューラに登録します。このメソッドは、カタログへの書込みのみを行う、WebCatalogServiceサービスの「writeObjects()メソッド」とは異なります。

3.3.1.1 シグネチャ

int writeIBot (CatalogObject obj, String path, boolean resolveLinks, boolean allowOverwrite, String sessionID);

引数

説明

CatalogObject obj

カタログに書き込まれるオブジェクトを指定します。このオブジェクトのXMLは、orahome/bifoundation/web/schemasディレクトリにあるanalysis_ibot.xsdに対して検証されます。

String path

カタログ内のエージェントのフルパスおよび名前を指定します。例: /users/jchan/iBots/BrandDollars

boolean resolveLinks

TRUEに設定され、カタログ内のパスがリンクを参照する場合、オブジェクトはリンクが指す場所に書き込まれます。

boolean allowOverwrite

既存のオブジェクトをオーバーライドするかどうかを指定します。パスによって指定された場所にすでに存在するオブジェクトをオーバーライドするには、TRUEに設定します。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.3.2 deleteIBot()メソッド

このメソッドを使用して、保存されているエージェントを削除します。エージェントを削除すると、カタログからこれ(オブジェクト)が削除されるだけでなく、Oracle BIスケジューラからエージェントが登録解除されます。このメソッドは、「WebCatalogServiceサービス」のdeleteitemメソッドとは異なります。deleteitemメソッドの場合、エージェントはOracle BIスケジューラから登録解除されません。

3.3.2.1 シグネチャ

void deleteIBot (String path, String sessionID);

引数

説明

String path

カタログ内のエージェントのフルパスおよび名前を指定します。例: /users/jchan/iBots/BrandDollars

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.3.3 executeIBotNow()メソッド

このメソッドを使用して、カタログに保存されているエージェントを実行します。このメソッドでは、エージェントの元のスケジュールは変更されません。

3.3.3.1 シグネチャ

void executeIBotNow(String path, String sessionID);

引数

説明

String path

カタログ内のエージェントのフルパスおよび名前を指定します。例: /users/jchan/iBots/BrandDollars

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.3.4 moveIBot()メソッド

このメソッドを使用して、エージェントをカタログ・フォルダから別のカタログ・フォルダに移動します。このメソッドは、「WebCatalogServiceサービス」のmoveItemメソッドとは異なります。moveItemメソッドの場合、カタログ・オブジェクトを移動し、さらにOracle BIスケジューラにオブジェクトが移動されたことを通知します。

3.3.4.1 シグネチャ

void moveIBot(String fromPath, String toPath, boolean resolveLinks, boolean allowOverwrite, String sessionID);

引数

説明

String fromPath

移動するエージェントのフル・カタログ・パスを指定します。

String toPath

エージェントの移動先のフル・カタログ・パスを指定します。

boolean resolveLinks

子オブジェクトを移動するかどうかを指定します。この引数をTRUEに設定し、fromPath引数に指定したバスがリンクである場合、このリンクが指す子オブジェクトは移動されます。

boolean allowOverwrite

既存のオブジェクトをオーバーライドするかどうかを指定します。この引数をTRUEに設定し、toPathによって指定されたパスに別のカタログ・オブジェクトが存在する場合、このオブジェクトはオーバーライドされます。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.3.5 sendMessage()メソッド

このメソッドを使用して、Oracle BI EEのユーザー、グループ、またはその両方にメッセージを送信します。メッセージは、対応する受信者の配信プロファイルに従って配信されます。このプロファイルは、Oracle BIプレゼンテーション・サービスの「マイ・アカウント」ダイアログで設定されたものです。

3.3.5.1 シグネチャ

String sendMessage(String[] recipient, String[] group, String subject, String body, String priority, String sessionID);

引数

説明

String[] recipient

メッセージを送信するOracle BI EEユーザーのGUIDを指定します。この引数には、1つ以上のユーザーを含めることができます。

String[] group

メッセージを送信するOracle BI EEグループのGUIDを指定します。この引数には、複数のグループを含めることができます。

String subject

メッセージの件名の行を指定します。

String body

メッセージの本文に含めるテキストを指定します。

String priority

メッセージの優先度を指定します。High、Normal、またはLowを指定できます。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.3.6 subscribe()メソッド

このメソッドを使用して、公開されたエージェントに登録します。エージェントでカスタマイズが可能な場合、カスタマイズXMLも指定できます。

3.3.6.1 シグネチャ

void subscribe(String path, String customizationXml, String sessionID);

引数

説明

String path

カタログ内のエージェントのフルパスおよび名前を指定します。例: /users/jchan/iBots/BrandDollars

String customizationXml

カスタマイズXMLを指定します(エージェントがカスタマイズを許可している場合のみ)。このXMLは、orahome/bifoundation/web/schemas/analysis_customizationで使用可能なカスタマイズ・スキーマに対して検証されます。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.3.7 unsubscribe()メソッド

このメソッドを使用して、エージェントから登録解除します。このメソッドでは、ユーザーのカスタマイズの削除も行います。

3.3.7.1 シグネチャ

void unsubscribe(String path, String sessionID);

引数

説明

String path

カタログ内のエージェントのフルパスおよび名前を指定します。例: /users/jchan/iBots/BrandDollars

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.4 JobManagementServiceサービス

このサービスを使用して、マーケティング・セグメンテーションを実行し、生成機能をリストします。

表3-5は、サポートされるメソッドを示しています。

表3-5 JobManagementServiceのメソッド

メソッド名

説明

第3.4.1項「cancelJob()メソッド」

マーケティング・ジョブの実行を取り消します。

第3.4.2項「deleteResultSet()メソッド」

保存されている結果セットを削除します。

第3.4.3項「getCounts()メソッド」

セグメントまたはセグメント・ツリーのカウント数値を生成します。

第3.4.4項「getJobInfo()メソッド」

マーケティング・ジョブのステータスと詳細情報を取得します。

第3.4.5項「getPromptedColumns()メソッド」

セグメントまたはセグメント・ツリーのプロンプト列を戻します。

第3.4.6項「prepareCache()メソッド」

リスト・エクスポートのためのセグメントまたはセグメント・ツリーをキャッシュします。

第3.4.7項「purgeCache()メソッド」

キャッシュ全体、セグメントのエントリ、またはセグメント・ツリーのエントリをパージします。

第3.4.8項「saveResultSet()メソッド」

最近更新されたカウントに基づいてメンバーのリストを保存します。

第3.4.9項「writeListFiles()メソッド」

リスト・エクスポート、セグメント・キャンペーン・ロード、またはセグメント・ツリー・キャンペーン・ロードのリストを生成します。

3.4.1 cancelJob()メソッド

このメソッドを使用して、マーケット・ジョブの実行を取り消します。

3.4.1.1 シグネチャ

JobInfo cancelJob(BigInteger jobID, String sessionID);

引数

説明

BiInteger jobID

マーケティング・ジョブIDを指定します。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.4.2 deleteResultSet()メソッド

このメソッドを使用して、指定のセグメントに属するGUID値のリストによって識別されるターゲットレベルのオブジェクトの保存されている結果セットを、1つ以上削除します。

3.4.2.1 シグネチャ

JobInfo deleteResultSet(String targetLevel, ArrayOfGUIDs guiDs, String segmentPath, String sessionID);

引数

説明

String targetLevel

保存された結果セットのターゲット・レベルを指定します。

ArrayOfGUIDs guiDs

保存された結果セットを表すGUIDのリストを指定します。ArrayOfGUIDs構造体の詳細は、第2.4項「ArrayofGUIDS構造体」を参照してください。

String segmentPath

セグメントへのパスを指定します。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.4.3 getCounts()メソッド

このメソッドを使用して、セグメントまたはセグメント・ツリーのカウント数値を生成します。

3.4.3.1 シグネチャ

JobInfo getCounts(String segmentPath, String treePath, SegmentationOptions segmentationOptions, String sessionID);

引数

説明

String segmentPath

セグメントへのパスを指定します。getCountsがセグメントで実行される際に使用されます。

String treePath

セグメント・ツリーへのパスを指定します。getCountsがセグメント・ツリーで実行される際に使用されます。

Segmentation
Options

SegmentationOptions構造体で提供される、セグメントおよびセグメント・ツリーのオーバーライド・オプションを指定します。これらのオプションは、Oracle Marketing Analyticsのユーザー・インタフェースで指定したとおり、セグメントまたはセグメント・ツリーのデフォルトのかわりに使用されます。SegmentationOptions構造体の詳細は、第2.24項「SegmentationOptions構造体」を参照してください。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.4.4 getJobInfo()メソッド

このメソッドを使用して、マーケティング・ジョブのステータスと詳細なジョブ情報を取得します。

3.4.4.1 シグネチャ

JobInfo getJobInfo(BigInteger jobID, String sessionID);

引数

説明

BigInteger jobID

マーケティング・ジョブIDを指定します。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.4.5 getPromptedColumns()メソッド

このメソッドを使用して、セグメントまたはセグメント・ツリーのプロンプト列を戻します。

3.4.5.1 シグネチャ

PromptedColumnInfo getPromptedColumns(String segmentPath, String treePath, String sessionID);

引数

説明

String segmentPath

セグメントへのパスを指定します。getPromptedColumnsがセグメントで実行される際に使用されます。

String treePath

セグメント・ツリーへのパスを指定します。gePromptedColumnsがセグメント・ツリーで実行される際に使用されます。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.4.6 prepareCache()メソッド

このメソッドを使用して、リスト・エクスポートのためのセグメントまたはセグメント・ツリーをキャッシュします。

3.4.6.1 シグネチャ

JobInfo prepareCache(String segmentPath, String treePath, Boolean refresh, String sessionID);

引数

説明

String segmentPath

セグメントへのパスを指定します。prepareCacheがセグメントで実行される際に使用されます。

String treePath

セグメント・ツリーへのパスを指定します。prepareCacheがセグメント・ツリーで実行される際に使用されます。

Boolean refresh

TRUEに設定されている場合、システムは、キャッシュ・ヒット時にキャッシュ・エントリにデータを移入し、さらにキャッシュ・ミス時にキャッシュ・エントリにデータを移入します。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.4.7 purgeCache()メソッド

このメソッドを使用して、キャッシュ全体のパージ、キャッシュからのセグメントのエントリのパージ、またはキャッシュからのセグメント・ツリーのエントリのパージを行います。

3.4.7.1 シグネチャ

JobInfo purgeCache(String segmentPath, String treePath, Boolean ignoreCacheRef, String sessionID);

引数

説明

String segmentPath

セグメントへのパスを指定します。 purgeCacheがセグメントで実行される際に使用されます。

String treePath

セグメント・ツリーへのパスを指定します。purgeCacheがセグメント・ツリーで実行される際に使用されます。

Boolean ignoreCacheRef

TRUEに設定されている場合、システムは、現在使用され、セグメント、セグメント・ツリー、期限切れキャッシュ・エントリ、および存在しないキャッシュ・エントリにより参照されているキャッシュ・エントリをパージします。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.4.8 saveResultSet()メソッド

このメソッドを使用して、最近更新されたカウントに基づき、セグメントまたはセグメント・ツリーに対して修飾するメンバーのリストを保存します。システムでは、メンバーを抽出し、指定のセグメント・パスに保存します。

3.4.8.1 シグネチャ

JobInfo saveResultSet(String segmentPath, TreeNodePath treeNodePath, String savedSegmentPath, SegmentationOptions segmentationOptions, String srCustomLabel, Boolean appendStaticSegment, String sessionID);

引数

説明

String segmentPath

セグメントへのパスを指定します。

TreeNodePath treeNodePath

セグメント・ツリー・パスおよびブランチID番号を指定します。

String savedSegmentPath

システムが生成されたメンバーを抽出し、保存する新しいセグメントのパスと名前を指定します。

Segmentation
Options segmentation
Options

SegmentationOptions構造体で提供される、セグメントおよびセグメント・ツリーのオーバーライド・オプションを指定します。これらのオプションは、Oracle Marketing Analyticsのユーザー・インタフェースで指定したとおり、セグメントまたはセグメント・ツリーのデフォルトのかわりに使用されます。SegmentationOptions構造体の詳細は、第2.24項「SegmentationOptions構造体」を参照してください。

String srCustomLabel

静的セグメント作成のためのカスタム・ラベルを指定します。

Boolean appendStaticSegment

保存された同じセグメント・パスの下に静的セグメント・エントリを作成するためのフラグを指定します。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.4.9 writeListFiles()メソッド

このメソッドを使用して、リスト・エクスポート、セグメント・キャンペーン・ロード、またはセグメント・ツリー・キャンペーン・ロードのリストを生成します。

3.4.9.1 シグネチャ

JobInfo writeListFiles(ReportRef report, ReportParams reportParams, String segmentPath, TreeNodePath treeNodePath, SegmentationOptions segmentationOptions, String filesystem, BigInteger timeout, String sessionID);

引数

説明

ReportRef report

ReportRef構造体で提供される、分析の参照定義を指定します。ReportRef構造体の詳細は、第2.18項「ReportRef構造体」を参照してください。

ReportParams reportParams

実行前に分析に適用するフィルタまたは変数を指定します。この情報は、ReportParams共通構造体で提供されます。ReportParams構造体の詳細は、第2.17項「ReportParams構造体」を参照してください。

String segmentPath

セグメントへのパスを指定します。

TreeNodePath treeNodePath

セグメント・ツリー・パスおよびブランチIDを指定します。

SegmentationOptions segmentationOptions

SegmentationOptions構造体で提供される、セグメントおよびセグメント・ツリーのオーバーライド・オプションを指定します。これらのオプションは、Oracle Marketing Analyticsのユーザー・インタフェースで指定したとおり、セグメントまたはセグメント・ツリーのデフォルトのかわりに使用されます。SegmentationOptions構造体の詳細は、第2.24項「SegmentationOptions構造体」を参照してください。

String filesystem

リスト・ファイルを含む共有ディレクトリへのパスを指定します。

BigInteger timeout

タイムアウト値を指定します。これは常に0に設定します。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.5 MetadataServiceサービス

このサービスを使用して、Oracle Business Intelligenceプレゼンテーション・サービスのスキーマ・オブジェクト(列、表、サブジェクト・エリアなど)の説明を取得します。

表3-6は、サポートされるメソッドを示しています。

表3-6 MetadataServiceのメソッド

メソッド名

説明

第3.5.1項「clearQueryCache()メソッド」

問合せキャッシュを消去します。

第3.5.2項「describeColumn()メソッド」

指定したサブジェクト・エリアおよび表内の指定した列の列情報を取得します。

第3.5.3項「describeSubjectArea()メソッド」

指定したサブジェクト・エリアのサブジェクト・エリア情報を取得します。

第3.5.4項「describeTable()メソッド」

指定したサブジェクト・エリア内の指定した表の表情報を取得します。

第3.5.5項「getSubjectAreas()メソッド」

使用可能なサブジェクト・エリアのリストを取得します。

3.5.1 clearQueryCache()メソッド

このメソッドを使用して、問合せキャッシュを消去します。

3.5.1.1 シグネチャ

boolean clearQueryCache(String sessionID);

引数

説明

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.5.2 describeColumn()メソッド

このメソッドを使用して、指定したサブジェクト・エリアおよび表内の指定した列の列情報を取得します。

3.5.2.1 シグネチャ

SAColumn describeColumn(String subjectAreaName, String tableName, String columnName, String sessionID);

引数

説明

String subjectAreaName

問い合せるサブジェクト・エリアを指定します。

String tableName

問い合せる表を指定します。

String columnName

問い合せる列の名前を指定します。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.5.2.2 戻り値

SAColumnオブジェクトを戻します。SAColumn構造体の詳細は、第2.19項「SAColumn構造体」を参照してください。

3.5.3 describeSubjectArea()メソッド

このメソッドを使用して、指定したサブジェクト・エリアのサブジェクト・エリア情報を取得します。

3.5.3.1 シグネチャ

SASubjectArea describeSubjectArea (String subjectAreaName, SASubjectAreaDetails detailsLevel, String sessionID);

引数

説明

String subjectAreaName

問い合せるサブジェクト・エリアを指定します。

SASubjectAreaDetails detailsLevel

取得するサブジェクト・エリアについての情報を指定します。SASubjectAreaDetails構造体の詳細は、第3.5.3.2項「SASubjectAreaDetailsの値」を参照してください。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.5.3.2 SASubjectAreaDetailsの値

このメソッドを使用して、サブジェクト・エリアについてどのような情報を取得するのかを指定します。表3-7に、使用可能な値をリストします。

表3-7 SASubjectAreaDetailsの値

値

説明

IncludeTables

各表についての最小限の情報を記載した表リストを含めます。

IncludeTablesAndColumns

表および列の全情報を含めます。

Minimum

表および列の情報を含めません。

3.5.3.3 戻り値

SASubjectAreaオブジェクトを戻します(詳細は、第2.20項「SASubjectArea構造体」を参照してください)。

3.5.3.4 使用方法

detailsLevelパラメータの値に応じて、戻されるオブジェクトには、表3-8に示される情報が含まれます。

表3-8 detailsLevelの値

detailsLevelの値

説明

IncludeTables

表フィールドがnullではなく、このサブジェクト・エリアの表のコレクションを含むことを指定します。各表オブジェクトはnullに設定された列フィールドを含みます。

InludeTablesAndColumns

表フィールドがnullではなく、このサブジェクト・エリアの表のコレクションを含むことを指定します。各表オブジェクトに対し、列フィールドには対応する列のコレクションが含まれます。

Minimum

表リストが使用できないことを指定します。結果のサブジェクト・エリア・オブジェクトの表フィールドはnullです。

3.5.4 describeTable()メソッド

このメソッドを使用して、指定したサブジェクト・エリアの指定した表の表情報を取得します。

3.5.4.1 シグネチャ

SATable describeTable (String subjectAreaName, String tableName, SATableDetails detailsLevel, String sessionID);

引数

説明

String subjectAreaName

問い合せるサブジェクト・エリアを指定します。

String tableName

問い合せる表を指定します。

SATableDetails detailsLevel

取得する表の情報を指定します。SATableDetails構造体の詳細は、第3.5.4.2項「SATablesDetailsの値」を参照してください。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.5.4.2 SATablesDetailsの値

これを使用して、取得する表の情報を指定します。表3-9に、使用できる値をリストします。

表3-9 SATableDetailsの値

値

説明

IncludeColumns

SATableオブジェクトの列フィールドにデータを移入します。

Minimum

列情報は含まれません。SATableオブジェクトの列フィールドはnullに設定されます。

3.5.4.3 戻り値

SATableオブジェクトを戻します。SATable構造体の詳細は、第2.21項「SATable構造体」を参照してください。

3.5.5 getSubjectAreas()メソッド

このメソッドを使用して、使用可能なサブジェクト・エリアのリストを取得します。

3.5.5.1 シグネチャ

List[]getSubjectAreas(String sessionID);

引数

説明

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.5.5.2 戻り値

SASubjectAreaオブジェクトの配列を戻します。SASubjectArea構造体の詳細は、第2.22項「SAWLocale構造体」を参照してください。

3.5.5.3 使用方法

このメソッドで戻されるSASubjectAreaには、使用できる表情報がありません。表フィールドはnullです。すべてのレベルで問合せを行うアプローチは、getSubjectAreas()を使用してサブジェクト・エリアのリストを取得した後、describeSubjectArea()を使用して表のリストを取得するものです。そして、describeTable()を使用して指定の表の列のリストを取得し、最後にdescribeColumn()を使用して指定の列の情報を取得します。

3.6 ReplicationServiceサービス

このサービスを使用して、カタログ・レプリケーション・メソッドを提供します。

表3-10は、サポートされるメソッドを示しています。

表3-10 ReplicationServiceのメソッド

メソッド名

説明

第3.6.3項「Import()メソッド」

ログ・ファイルから変更内容をインポートします。

第3.6.4項「export()メソッド」

指定されたログ・ファイルにカタログの変更内容をエクスポートします。

第3.6.5項「markForReplication()メソッド」

指定されたフォルダとその子フォルダにおいて、レプリケーション可能フラグを変更します。

第3.6.6項「purgeLog()メソッド」

指定したログを消去します。

3.6.1 ExportFlagsの列挙

この列挙では、エクスポート・メソッドでエクスポートする変更内容を指定します。表3-11に、この列挙の値をリストします。

注意:

ExportFlagsの1つのフィールドのみにデータを移入します。

表3-11 ExportFlagsの列挙値

メソッド名

説明

String processAllChanges

最初にレプリケーション・ログを参照してどのような変更が行われたのかを調べた後で、ローカル・コンピュータおよびリモート・コンピュータの指定のディレクトリで変更されたフラグをエクスポートすることを指定します(processLocalChangesとprocessRemoteChangesを組み合せます)。

String processAll_ForMerge

すでに存在する項目で競合を管理する方法を指定します。

項目が存在し、エクスポート項目の最後に変更されたタイム・スタンプが既存の項目のタイムスタンプより大きい場合、既存の項目は置換されます。

項目が存在し、エクスポート項目の最後に変更されたタイム・スタンプが既存の項目のタイムスタンプより小さい場合、既存の項目は置換されません。

String processAll_ForReplace

エクスポート項目と既存の項目の両方のタイムスタンプに関係なく、エクスポート項目を使用することを指定します。

String processAll_ForWriteIfNotExists

エクスポートに含まれる項目が存在する場合、これらは置換されないことを指定します。

String processLocalChanges

最初にレプリケーション・ログを参照してどのような変更が行われたのかを調べた後で、ローカル・コンピュータの指定のディレクトリで変更されたフラグをエクスポートすることを指定します。

String processRemoteChanges

最初にレプリケーション・ログを参照してどのような変更が行われたのかを調べた後で、リモート・コンピュータの指定のディレクトリで変更されたフラグをエクスポートすることを指定します。

3.6.2 ImportFlagsの列挙

この列挙では、インポート・メソッドでインポートする変更内容を指定します。表3-12に、この列挙の値をリストします。

表3-12 ImportFlagsの列挙値

メソッド名

説明

String processAllChanges

最初にレプリケーション・ログを参照してどのような変更が行われたのかを調べた後で、ローカル・コンピュータおよびリモート・コンピュータの指定のディレクトリで変更されたフラグをインポートすることを指定します(processLocalChangesとprocessRemoteChangesを組み合せます)。

String processLocalChanges

最初にレプリケーション・ログを参照してどのような変更が行われたのかを調べた後で、ローカル・コンピュータの指定のディレクトリで変更されたフラグをインポートすることを指定します。

String processRemoteChanges

最初にレプリケーション・ログを参照してどのような変更が行われたのかを調べた後で、リモート・コンピュータの指定のディレクトリで変更されたフラグをインポートすることを指定します。

3.6.3 Import()メソッド

このメソッドを使用して、ログ・ファイルから変更内容をインポートします。

注意:

Java環境では、インポート・メソッドを_import()として指定する必要があります。これにより、予約語importとの競合が回避されます。

3.6.3.1 シグネチャ

List[] (String filename, ImportFlags flag, Calendar lastPurgedLog, boolean updateReplicationLog, boolean returnErrors, CatalogItemsFilter filter, PathMap pathMap, String sessionID);

引数

説明

String filename

ログ・ファイルの名前を指定します。

ImportFlags flag

インポートする変更内容のサブセット(ローカル、リモートなど)を指定します。詳細は、「ImportFlagsの列挙」を参照してください。

Calendar lastPurgedLog

ログが最後に消去された日付と時間を指定します。この時間の後にエクスポート・ファイル内で変更が行われた場合、インポートではローカル・ログを使用して、これをリプレイするかどうかを判断します。変更が行われていない場合、インポートでは最後のアクセス時間を使用します。

boolean updateReplicationLog

TRUEに設定されている場合、レプリケーション・ログは更新されます。FALSEに設定されている場合、レプリケーション・ログは更新されません。

boolean returnErrors

TRUEに設定されている場合、この関数はImportErrorオブジェクトの配列を戻します。この配列には、フィルタ条件を満たすインポート・ファイルに記録された変更内容がリプレイされなかった場合について記述されます。

CatalogItemsFilter filter

特定の期間内に行われた変更と、指定されたフォルダのカタログ項目に対して行われた変更をフィルタすることを指定します。nullに設定することができます。

PathMap pathMap

インポートした変更内容のコピー先のディレクトリを指定します。この引数を使用して、あるディレクトリの項目を別のディレクトリにコピーします。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.6.3.2 戻り値

発生したエラーのリストを含むImportError構造体を戻します。詳細は、第2.10項「ImportError構造体」を参照してください。

3.6.4 export()メソッド

このメソッドを使用して、指定されたログ・ファイルにカタログの変更内容をエクスポートします。

3.6.4.1 シグネチャ

void export (String filename, CatalogItemsFilter filter, ExportFlags flag, boolean exportSecurity, String sessionID);

引数

説明

String filename

ログ・ファイルの名前を指定します。

CatalogItemsFilter filter

エクスポートする変更内容のサブセットを指定します。filter.itemsフィールドをnullに設定することはできません。

ExportImportFlags flag

エクスポートする変更内容(ローカル、リモートなど)を指定します。詳細は、「ExportFlagsの列挙」を参照してください。

exportSecurity

対応するオブジェクトのセキュリティ情報を指定します。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.6.5 markForReplication()メソッド

このメソッドを使用して、指定されたフォルダとその子フォルダにおいて、レプリケーション可能フラグを変更します。

3.6.5.1 シグネチャ

void markForReplication (String item, boolean replicate, String sessionID);

引数

説明

String item

フォルダのパスを指定します。

boolean replicate

TRUEに設定されている場合、フォルダをレプリケーション可能にマークします。FALSEに設定されている場合、レプリケーション可能フラグを削除します。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.6.6 purgeLog()メソッド

指定したログを消去します。

3.6.6.1 シグネチャ

void purgeLog(List[] items, Calendar timestamp, String sessionID);

引数

説明

List[] items

消去するフォルダ・パスのリスト。

Calendar timestamp

最後に変更された時間がタイムスタンプより早いログ項目のみ消去します。

String sessionID

SOAPセッションからログオフするセッションIDを含む文字列値。セッションIDは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.7 ReportEditingServiceサービス

このサービスを使用して、引数とOracle Business Intelligenceプレゼンテーション・サービス・データをマージし、結果を作成して戻します。

表3-13は、サポートされるメソッドを示しています。

表3-13 ReportEditingServiceのメソッド

メソッド名

説明

第3.7.1項「applyReportDefaults()メソッド」

分析のデフォルトの引数を分析に適用し、結果を戻します。

第3.7.2項「applyReportParams()メソッド」

レポートの引数を分析オブジェクトに適用し、結果を戻します。

第3.7.3項「generateReportSQL()メソッド」

指定された分析に対するSQL問合せを取得します。

3.7.1 applyReportDefaults()メソッド

このメソッドを使用して、分析のデフォルトの引数を分析に適用し、結果を戻します。

3.7.1.1 シグネチャ

String applyReportDefaults(ReportRef reportRefs, String sessionID);

引数

説明

ReportRef object

ReportRef共通構造体で提供される、分析定義へのパスを指定します。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.7.1.2 戻り値

デフォルトの分析引数を指定した分析オブジェクトに適用した結果を戻します。

3.7.2 applyReportParams()メソッド

このメソッドを使用して、分析引数を分析に適用し、結果を戻します。

3.7.2.1 シグネチャ

Object applyReportParams(ReportRef reportRef, ReportParams reportParams, boolean encodeInString, String sessionID);

引数

説明

ReportRef reportRef

ReportRef共通構造体で提供される、分析定義へのパスを指定します。

ReportParams reportParams

オプション。実行前に分析に適用するフィルタまたは変数を指定します。これはReportParams共通構造体で提供されます。詳細は、第3章「Oracle BI EE Webサービスにおけるサービスとメソッドについて」を参照してください。

boolean encodeInString

TRUEに設定されている場合、戻される分析オブジェクトは、文字列としてエンコードされます。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.7.2.2 戻り値

分析引数を指定した分析オブジェクトに適用した結果を戻します。encodeInStringをtrueに設定した場合、結果は文字列としてエンコードされます。

3.7.3 generateReportSQL()メソッド

このメソッドを使用して、指定した分析に対する論理SQL問合せを取得します。

3.7.3.1 シグネチャ

String generateReportSQL(ReportRef reportRef, ReportParams reportParams, String sessionID);

引数

説明

ReportRef reportRef

ReportRef共通構造体で提供される、分析定義へのパスを指定します。

ReportParams reportParams

オプション。実行前に分析に適用するフィルタまたは変数へのパスを指定します。これはReportParams共通構造体で提供されます。詳細は、第3章「Oracle BI EE Webサービスにおけるサービスとメソッドについて」を参照してください。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.7.3.2 戻り値

指定した分析のSQL問合せを含む文字列。

3.8 SAWSessionServiceサービス

このサービスを使用して、ログオンやログオフなどの認証メソッド、およびその他のセッション関連のメソッドを提供します。

表3-14は、サポートされるメソッドを示しています。

表3-14 SAWSessionServiceのメソッド

メソッド名

説明

第3.8.1項「getCurUser()メソッド」

セッションの現行ユーザーIDを取得します。

第3.8.2項「GetSessionEnvironment()メソッド」

現行セッションの環境オブジェクトを取得します。

第3.8.3項「getSessionVariable()メソッド」

セッション変数のリストを取得します。

第3.8.4項「impersonate()メソッド」

ログオンしてユーザーを偽装します。

第3.8.5項「impersonateex()メソッド」

ログオンしてユーザーを偽装します。impersonateメソッドと類似していますが、impersonateexではオプションのセッション・パラメータを指定できます。

第3.8.6項「keepAlive()メソッド」

Oracle Business Intelligenceプレゼンテーション・サービスに、特定のセッションが非アクティブであっても終了させないよう指示します。

第3.8.7項「logoff()メソッド」

ユーザーをOracle Business Intelligenceプレゼンテーション・サービスからログオフさせます。

第3.8.8項「logon()メソッド」

ユーザーを認証します。

第3.8.9項「logonex()メソッド」

ユーザーを認証します。logonメソッドと類似していますが、logonexではオプションのセッション・パラメータを指定できます。

3.8.1 getCurUser()メソッド

このメソッドを使用して、セッションの現行ユーザー名を取得します。

3.8.1.1 シグネチャ

String getCurUser(String sessionID);

引数

説明

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.8.1.2 戻り値

セッションの現行ユーザー名を示す文字列を戻します。

3.8.2 GetSessionEnvironment()メソッド

このメソッドを使用して、現行セッションの環境オブジェクトを取得します。

3.8.2.1 シグネチャ

SessionEnvironment getSessionEnvironment (String sessionID);

引数

説明

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.8.2.2 戻り値

このメソッドは、セッション環境オブジェクトを戻します(詳細は、第2.25項「SessionEnvironment構造体」を参照してください)。

3.8.3 getSessionVariable()メソッド

このメソッドを使用して、セッション変数のリストを取得します。

3.8.3.1 シグネチャ

List[] getSessionVariables(List[] names, String sessionID);

引数

説明

List[] names

セッション変数の名前を指定します。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.8.3.2 戻り値

このメソッドは、現行セッションに関連付けられたOracle BI EE変数の値を戻します。

3.8.4 impersonate()メソッド

このメソッドを使用し、SAWSessionServiceサービス中にログオンしてユーザーを偽装します。このメソッドは、管理者の名前とパスワードのみを持っていて、複数のユーザーのセッションを作成する必要がある場合に便利です。impersonate()メソッドを使用する場合、logonメソッドを使用する必要はありません。

ユーザー認証または偽装に失敗した場合、例外がスローされます。

3.8.4.1 シグネチャ

String impersonate(String name, String password, String impersonateID);

引数

説明

String name

ログオンし、認証を行うユーザー名を指定します。

String password

ユーザーのパスワードを指定します。ユーザーにパスワードがない場合、このフィールドは空(void)にします。

String impersonateID

認証対象となるユーザーを偽装するユーザー名を指定します。

3.8.4.2 戻り値

このメソッドは、セッションIDを戻し、HTTPセッションのCookieを設定します。セッションIDは、別のメソッドでOracle Business Intelligence Webサービスのセッションの識別に使用されます。

3.8.5 impersonateex()メソッド

このメソッドを使用し、SAWSessionServiceサービス中にログオンしてユーザーを偽装します。impersonateメソッドに類似していますが、impersonateexではオプションのセッション・パラメータを指定できます。このメソッドは、管理者の名前とパスワードのみを持っていて、複数のユーザーのセッションを作成する必要がある場合に便利です。impersonateex()メソッドを使用する場合、logonメソッドを使用する必要はありません。

ユーザー認証または偽装に失敗した場合、例外がスローされます。

3.8.5.1 シグネチャ

AuthResults impersonateex(String name, String password, String impersonateID, SAWSessionParameters sessionparams);

引数

説明

String name

ログオンし、認証を行うユーザー名を指定します。

String password

ユーザーのパスワードを指定します。ユーザーにパスワードがない場合、このフィールドは空(void)にします。

String impersonateID

認証対象となるユーザーを偽装するユーザー名を指定します。

SAWSessionParameters sessionparams

オプション。使用するセッション・パラメータを指定します。これはSAWSessionParameters構造体で提供されます。SAWSessionParameters構造体の詳細は、第2.23項「SAWSessionParameters構造体」を参照してください。

3.8.5.2 戻り値

このメソッドは、セッションIDを含むAuthResult構造体を戻し、HTTPセッションのCookieを設定します。セッションIDは、別のメソッドでOracle Business Intelligenceプレゼンテーション・サービス・セッションの識別に使用されます。詳細は、第2.5項「AuthResult構造体」を参照してください。

3.8.6 keepAlive()メソッド

このメソッドを使用して、Oracle BI EE Presentation Servicesに、特定のWebユーザーが非アクティブであっても終了しないよう指示します。セッション存続期間におけるこのメソッドの効果は、ユーザーがブラウザでアクティビティを実行した(分析のクリック、メソッドの起動など)場合と同様です。

3.8.6.1 シグネチャ

void keepAlive(String[] sessionID);

引数

説明

String[] sessionID

ログオン状態のままにするセッションIDを指定します。

3.8.7 logoff()メソッド

このメソッドを使用して、ユーザーをOracle BI EEプレゼンテーション・サービスからログオフさせます。

3.8.7.1 シグネチャ

void logoff(String sessionID);

引数

説明

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.8.8 logon()メソッド

このメソッドを使用して、ユーザーを認証します。認証に失敗した場合、例外がスローされます。

3.8.8.1 シグネチャ

String logon(String name, String password);

引数

説明

String name

認証を行うユーザー名を指定します。

String password

ユーザーのパスワードを指定します。パスワードがない場合、このフィールドは空(void)にします。

3.8.8.2 戻り値

このメソッドは、セッションIDを戻し、HTTPセッションのCookieを設定します。セッションIDは、別のメソッドでOracle BI EEプレゼンテーション・サービスのセッションの識別に使用されます。

3.8.9 logonex()メソッド

このメソッドを使用して、ユーザーを認証します。logonメソッドと類似していますが、logonexではオプションのセッション・パラメータを指定できます。認証に失敗した場合、例外がスローされます。

3.8.9.1 シグネチャ

AuthResult logonex(String name, String password, SAWSessionParameters sessionparams);

引数

説明

String name

認証を行うユーザー名を指定します。

String password

ユーザーのパスワードを指定します。パスワードがない場合、このフィールドは空(void)にします。

SAWSessionParameters sessionparams

オプション。使用するセッション・パラメータを指定します。これはSAWSessionParameters構造体で提供されます。SAWSessionParameters構造体の詳細は、第2.23項「SAWSessionParameters構造体」を参照してください。

3.8.9.2 戻り値

このメソッドは、セッションIDを含むAuthResult構造体を戻し、HTTPセッションのCookieを設定します。セッションIDは、別のメソッドでOracle Business Intelligenceプレゼンテーション・サービスのセッションの識別に使用されます。

3.9 SecurityServiceサービス

このサービスを使用して、アカウントと権限を識別するメソッドを提供します。表3-15に、サポートされるメソッドを示します。

表3-15 SecurityServiceのメソッド

メソッド名

説明

第3.9.1項「forgetAccounts()メソッド」

アカウント名マッピングに対するOracle BI EEプレゼンテーション・サービスの内部IDを削除します。

第3.9.2項「getAccounts()メソッド」

Oracle BI EEのユーザー・アカウントを検索します。

第3.9.3項「getGlobalPrivilegeACL()メソッド」

グローバル権限のアクセス制御リストを取得します。

第3.9.4項「getGlobalPrivileges()メソッド」

すべてのグローバル権限のリストを取得します。

第3.9.5項「getGroups()メソッド」

ユーザーやグループなど、アカウントのメンバーであるカタログ・グループのリストを取得します。

第3.9.6項「getMembers()メソッド」

カタログ・グループの直接のメンバーを取得します。

第3.9.7項「getPermissions()メソッド」

指定したユーザーの権限のリストを取得します。

第3.9.8項「getPrivilegesStatus()メソッド」

すべての権限とそのステータスをリストします。

第3.9.9項「isMember()メソッド」

カタログ・グループがユーザーまたはグループのメンバーであるかどうかを確認します。

第3.9.10項「joinGroups()メソッド」

カタログ・グループにメンバーとしてユーザーを追加します。

第3.9.11項「leaveGroups()メソッド」

グループからメンバーを削除します。

第3.9.12項「renameAccounts()メソッド」

ユーザー・アカウントの名前を変更します。

第3.9.13項「updateGlobalPrivilegeACL()メソッド」

グローバル権限のアクセス制御リストを更新します。

3.9.1 forgetAccounts()メソッド

このメソッドを使用して、アカウント名マッピングに対するOracle BI EEプレゼンテーション・サービスの内部IDを削除します。このアクションは、アカウント・マッピングが誤って作成された場合(updateGlobalSAWPrivilegeACLメソッドでアカウント名のスペルを間違えた場合など)に便利です。

3.9.1.1 シグネチャ

void forgetAccounts(List[], int cleanuplevel, String sessionID);

引数

説明

List[]

削除するアカウントを指定します。これはAccount構造体で提供されます。Account構造体の詳細は、第2.3項「ACL構造体」を参照してください。

int cleanuplevel

削除するマッピング情報の量を指定します。0に設定した場合、内部アカウントIDおよび、ユーザーまたはグループの名前からマッピングを削除します。1に設定した場合、アカウントがユーザーを参照していれば、ユーザー・ディレクトリを削除します。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.9.2 getAccounts()メソッド

このメソッドを使用して、Oracle BI EEのユーザー・アカウント(LDAPユーザー、カタログ・グループ、アプリケーション・ロールなど)を検索します。

3.9.2.1 シグネチャ

List[] getAccounts(List[], String sessionID);

引数

説明

List[]

ユーザー名、カタログ・グループ名、およびアプリケーション・ロール名を指定します。フラグは、その名前がユーザー、グループ、またはアプリケーション・ロールであるかどうかを示します。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.9.3 getGlobalPrivilegeACL()メソッド

このメソッドを使用して、グローバル権限のアクセス制御リストを取得します。

3.9.3.1 シグネチャ

ACL getGlobalPrivilegeACL(String privilegeName, String sessionID);

引数

説明

String privilegeName

取得する権限の名前を指定します。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.9.4 getGlobalPrivileges()メソッド

このメソッドを使用して、グローバル権限のリストを取得します。

3.9.4.1 シグネチャ

List[] getGlobalPrivileges(String sessionID);

引数

説明

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.9.5 getGroups()メソッド

このメソッドを使用して、ユーザーやグループなど、アカウントのメンバーであるカタログ・グループのリストを取得します。

3.9.5.1 シグネチャ

List[] getGroups(List[], Boolean expandGroups, String sessionID);

引数

説明

List[]

ユーザーまたはグループを指定します。

Boolean expandGroups

メンバーが所属するグループを開くことを指定します。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.9.6 getMembers()メソッド

このメソッドを使用して、カタログ・グループの直接のメンバーを取得します。

3.9.6.1 シグネチャ

List[] getMembers(List[] group, Boolean expandGroups, String sessionID);

引数

説明

List[]

メンバーのリストが必要なカタログ・グループを指定します。

Boolean expandGroups

メンバーが所属するグループを開くことを指定します。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.9.7 getPermissions()メソッド

このメソッドを使用して、指定のアクセス制御リストに基づき、指定したユーザーの権限のリストを取得します。

注意:

また、このメソッドは、アクセス制御リストでグループの権限が指定されていない場合でも、ユーザーのセキュリティ・グループにより継承されるすべての権限を戻します。

3.9.7.1 シグネチャ

List[] getPermissions(List[], Account account, String sessionID);

引数

説明

List[]

Account accountで指定するユーザーのアクセス制御リストを指定します。

Account account

ACLの権限を検索する対象となるユーザーの名前を指定します。ユーザーの名前またはGUIDを指定できます。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.9.7.2 戻り値

AccessControlToken構造体のpermissionMaskフィールドにある権限情報を戻します(詳細は、第2.1項「AccessControlToken構造体」を参照してください)。

3.9.8 getPrivilegesStatus()メソッド

このメソッドを使用して、すべての権限とそのステータスをリストします。

3.9.8.1 シグネチャ

List[] getPrivilegesStatus(List[] privileges, String sessionID);

引数

説明

List[] privileges

権限のリストを指定します。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.9.9 isMember()メソッド

このメソッドを使用して、カタログ・グループがユーザーまたはグループのメンバーであるかを確認します。

3.9.9.1 シグネチャ

boolean isMember(List[] group, List[] member, Boolean expandGroups, String sessionID);

引数

説明

List[] group

ユーザー名、カタログ・グループ、またはアプリケーション・ロール名を指定します。

List[] member

検証するメンバーの名前を指定します。たとえば、isMember(BIAdministrator, Administrator, false)という例を考えます。この例は、ユーザーAdministratorがBIAdministratorアプリケーション・ロールのメンバーであるかどうかを確認します。

Boolean expandGroups

指定 ....

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.9.10 joinGroups()メソッド

このメソッドを使用して、カタログ・グループにメンバーとして参加します。

3.9.10.1 シグネチャ

void joinGroups(List[] group, List[] member, String sessionID);

引数

説明

List[] group

参加する、またはメンバーとなるグループ名を指定します。たとえば、join(Marketing, UserA)という例を考えます。この例は、UserAがMarketingカタログ・グループに参加することを示しています。

List[] member

ベースとなるメンバーの名前を指定します。詳細は、この前の引数の例を参照してください。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.9.11 leaveGroups()メソッド

このメソッドを使用して、グループからメンバーを削除します。

3.9.11.1 シグネチャ

void leaveGroups(List[] group, List[] member, String sessionID);

引数

説明

List[] group

メンバーを削除するグループを指定します。

List[] member

グループから削除するメンバーを指定します。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.9.12 renameAccounts()メソッド

このメソッドを使用して、カタログ内のユーザー・アカウントの名前を変更します。

3.9.12.1 シグネチャ

void renameAccounts(List[] from, List[] to, String sessionID);

引数

説明

List[] from

アカウントの変更前の名前を指定します。

List[] to

アカウントの新しい名前を指定します。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.9.12.2 戻り値

アカウントの配列を戻します。accountsFilterがnull値を戻す場合、このメソッドは、現行のプレゼンテーション・サービス・インスタンスによりキャッシュされているすべてのアカウントを戻します。

3.9.13 updateGlobalPrivilegeACL()メソッド

このメソッドを使用して、グローバル権限のアクセス制御リストを更新します。

3.9.13.1 シグネチャ

void updateGlobalPrivilegeACL(String privilegeName, ACL acl, UpdateACLParams updateACLParams, String sessionID);

引数

説明

String privilegeName

更新する権限の名前を指定します。

ACL acl

更新するアクセス制御リストを指定します。これはACL構造体で提供されます。ACL構造体の詳細は、第2.3項「ACL構造体」を参照してください。

UpdateACLParams updateACLParams

更新するアクセス制御リストのパラメータを指定します。これはUpdateACLParams構造体で提供されます。UpdateACLParams構造体の詳細は、第2.28項「UpdateACLParams構造体」を参照してください。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.10 WebCatalogServiceサービス

このサービスを使用して、カタログのナビゲートおよび管理を行うメソッドを提供し、XML形式でカタログ・オブジェクトを読み書きします。表3-16 に、サポートされるメソッドを示します。

表3-16 WebCatalogServiceのメソッド

メソッド名

説明

第3.10.3項「copyItem()メソッド」

カタログ内のある場所から別の場所へオブジェクトをコピーします。

第3.10.4項「copyItem2()メソッド」

カタログからアーカイブ・ファイルを生成します。

第3.10.5項「createFolder()メソッド」

カタログに新しいフォルダを作成します。

第3.10.6項「createLink()メソッド」

カタログへのリンクを作成します。

第3.10.7項「deleteItem()メソッド」

カタログからオブジェクトを削除します。

第3.10.8項「getItemInfo()メソッド」

オブジェクトのカタログ情報を取得します。

第3.10.9項「getSubItems()メソッド」

カタログ内のオブジェクトの子サブ項目のコレクションを取得します。

第3.10.10項「maintenanceMode()メソッド」

メンテナンスの間、カタログをロックします。

第3.10.11項「moveItem()メソッド」

カタログ内のオブジェクトをそのカタログ内の別の場所に移動します。

第3.10.12項「pasteItem2()メソッド」

コピーした項目を貼り付けます。

第3.10.13項「readObjects()メソッド」

カタログからオブジェクトを読み取ります。

第3.10.14項「removeFolder()メソッド」

カタログからフォルダを削除します。

第3.10.15項「setItemAttributes()メソッド」

指定したカタログ項目の属性フラグを設定します。

第3.10.16項「setItemProperty()メソッド」

カタログ内のオブジェクトのプロパティを設定します。

第3.10.17項「setOwnership()メソッド」

指定した項目の所有権を取得します。

第3.10.18項「updateCatalogItemACL()メソッド」

カタログ内の項目のアクセス制御リストを更新します。

第3.10.19項「writeObjects()メソッド」

オブジェクトのリストをカタログに書き込みます。

3.10.1 ErrorDetailsLevelの列挙

この列挙では、「WebCatalogServiceサービス」内のメソッドの有効な値のリストを指定します。表3-17に、この列挙の値をリストします。

注意:

ErrorDetailsLevelの1つの値のみが選択されます。

表3-17 ErrorDetailsLevelの列挙値

値

説明

String ErrorCode

ErrorInfo.errorCodeフィールドにデータを移入することを指定します。

String ErrorCodeAndText

ErrorInfo.errorCodeフィールドおよびErrorInfo.messageフィールドにデータを移入することを指定します。

String FullDetails

すべてのErrorInfoフィールドにデータを移入することを指定します。

3.10.2 ReadObjectsReturnOptionsの列挙

この列挙では、「WebCatalogServiceサービス」内のメソッドの有効な値のリストを指定します。表3-18に、この列挙の値をリストします。

表3-18 ReadObjectsReturnOptionsの列挙値

値

説明

String NoObject

catalogObjectフィールドおよびcatalogObjectBytesフィールドにデータを移入しないことを指定します。

String ObjectAsString

catalogObjectフィールドにはデータを移入し、catalogObjectBytesフィールドにはデータを移入しないことを指定します。

String ObjectAsBinary

catalogObjectフィールドにはデータを移入せず、catalogObjectBytesフィールドにはデータを移入することを指定します。

String ObjectAsBinaryUseMtom

catalogObjectフィールドにはデータを移入せず、catalogObjectBytesにはデータを移入し、SOAPメッセージが戻すコンテンツをMTOMを使用してエンコードすることを指定します。

3.10.3 copyItem()メソッド

このメソッドを使用して、カタログ内のある場所からそのカタログ内の別の場所にオブジェクトをコピーします。

3.10.3.1 シグネチャ

void copyItem(String pathSrc, String pathDest, int flagACL, String sessionID);

引数

説明

String pathSrc

カタログ内のオブジェクトへの現在のパスを指定します。

String pathDest

カタログ内のオブジェクトをコピーする場所を指定します。

int flagACL

セキュリティとともに項目をコピーするかどうかを指定します。0は、セキュリティなしで項目をコピーすることを示します。1は、セキュリティとともに項目をコピーすることを示します。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.10.4 copyItem2()メソッド

このメソッドを使用して、カタログからアーカイブ・ファイルを生成します。

3.10.4.1 シグネチャ

DataHandler copyItem2(List[] path, boolean recursive, boolean permissions, boolean timestamps, boolean useMtom, String sessionID);

引数

説明

List[] path

カタログ内のアーカイブの作成元の場所を指定します。

boolean recursive

子レベルのフォルダをアーカイブに含めるかどうかを指定します。

boolean permissions

項目をセキュリティとともにコピーするかどうかを指定します。

boolean timestamps

項目のタイムスタンプを保存するかどうかを指定します。

boolean useMtom

SOAPメッセージにより戻されたコンテンツのエンコードにMTOMを使用するかどうかを指定します。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.10.5 createFolder()メソッド

このメソッドを使用して、カタログにフォルダを作成します。

3.10.5.1 シグネチャ

void createFolder(String path, boolean createIfNotExists, boolean createIntermediateDirs, String sessionID);

引数

説明

String path

カタログ内のフォルダを作成する場所を、新しいフォルダ名を含めて指定します。

boolean createIfNotExists

TRUEに設定されている場合、カタログ内にフォルダ・オブジェクトが存在しなければ、これを作成します。FALSEに設定されている場合、フォルダ・オブジェクトがすでに存在するならば、これを再作成しません。

boolean createIntermediateDirs

TRUEに設定されている場合、中間ディレクトリが作成されます。FALSEに設定されている場合、中間ディレクトリは作成されません。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.10.6 createLink()メソッド

このメソッドを使用して、カタログへのリンクを作成します。

3.10.6.1 シグネチャ

void createLink(String path, String pathTarget, boolean overwriteIfExists, String sessionID);

引数

説明

String Path

カタログ内の親オブジェクトへのパスを指定します。

String TargetPath

カタログ内で、作成するリンクが参照する場所を指定します。

boolean overwriteIfExists

TRUEに設定されている場合、カタログ内にリンクがすでに存在するならば、これをオーバーライドします。FALSEに設定されている場合、カタログ内にリンクがすでに存在するならば、これをオーバーライドしません。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.10.7 deleteItem()メソッド

このメソッドを使用して、カタログからオブジェクトを削除します。フォルダを削除するには、第3.10.14項「removeFolder()メソッド」を参照してください。

3.10.7.1 シグネチャ

void deleteItem(String path, String sessionID);

引数

説明

String path

カタログ内のオブジェクトへのパスを指定します。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.10.8 getItemInfo()メソッド

このメソッドを使用して、オブジェクトのカタログ情報を取得します。

3.10.8.1 シグネチャ

ItemInfo getItemInfo(String path, boolean resolveLinks, String sessionID);

引数

説明

String path

カタログ内のオブジェクトへのパスを指定します。

boolean resolveLinks

TRUEに設定され、カタログ内のパスがリンクを参照する場合、Oracle Business Intelligenceは、リンクが指すオブジェクトの情報を取得します。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.10.8.2 戻り値

ItemInfo構造体のオブジェクトのカタログ情報を戻します。詳細は、第2.11項「ItemInfo構造体」を参照してください。

3.10.9 getSubItems()メソッド

このメソッドを使用して、カタログ内のオブジェクトの子サブ項目のコレクションを取得します。

3.10.9.1 シグネチャ

List[] getSubItems(String path, String mask, boolean resolveLinks, GetSubItemsParams options, String sessionID);

引数

説明

String path

カタログ内の親オブジェクトへのパスを指定します。

String mask

取得する子サブ項目を示すマスクを指定します。マスク文字はアスタリスク(*)です。すべての子サブ項目を取得するには、アスタリスク1つを使用します。

boolean resolveLinks

TRUEに設定され、カタログ内のパスがリンクを参照する場合、リンクが指すオブジェクトの子サブ項目の情報が取得されます。

GetSubItemsParams options

オプション。GetSubItemsParams構造体に提供するパラメータを指定します。GetSubItemsParams構造体の詳細は、第2.9項「GetSubItemsParams構造体」を参照してください。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.10.9.2 戻り値

ItemInfo構造体の子サブ項目のコレクションを戻します。詳細は、第2.11項「ItemInfo構造体」を参照してください。

3.10.10 maintenanceMode()メソッド

このメソッドを使用して、メンテナンスの間、カタログをロックします。

3.10.10.1 シグネチャ

void maintenanceMode(boolean flag, String sessionID);

引数

説明

boolean flag

カタログをロックする場合、TRUEを設定します。

String sessionID)

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.10.11 moveItem()メソッド

このメソッドを使用して、カタログ内のオブジェクトをそのカタログ内の別の場所に移動します。

3.10.11.1 シグネチャ

void moveItem(String pathSrc, String pathDest, int flagACL, String sessionID);

引数

説明

String pathSrc

カタログ内のオブジェクトへの現在のパスを指定します。

String pathDest

カタログ内のオブジェクトを移動する場所を指定します。

int flagACL

セキュリティとともに項目を移動するかどうかを指定します。0は、セキュリティなしで項目を移動することを示します。1は、セキュリティとともに項目を移動することを示します。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.10.12 pasteItem2()メソッド

このメソッドを使用して、コピーした項目を貼り付けます。

3.10.12.1 シグネチャ

void pasteItem2(Binary stream DataHandler archive, String replacePath, int flagACL, int flagOverwrite, String sessionID);

引数

説明

Binary stream DataHandler archive

戻される項目のコンテンツを文字列またはバイトとして指定します。このフィールドで何を指定するかは、readObjectsメソッドにより決定されます。

String replacePath

コピーした項目を貼り付ける場所を指定します。

int flagACL

セキュリティとともに項目を貼り付けるかどうかを指定します。0は、セキュリティなしで項目を貼り付けることを示します。1は、セキュリティとともに項目を貼り付けることを示します。

int flagOverwrite

貼り付ける項目が既存の項目をオーバーライドするかどうかを指定します。0は、すべて置換することを示し、1は、古い項目を置換することを示し、2は、何も置換しないことを示し、3は、強制置換を示します。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.10.13 readObjects()メソッド

このメソッドを使用して、カタログからオブジェクトを読み込み、CatalogObject構造体を戻します。

3.10.13.1 シグネチャ

List[] readObjects(List[] paths, boolean resolveLinks, ErrorDetailsLevel errorMode, ReadObjectsReturnOptions returnOptions, String sessionID);

引数

説明

List[] paths

カタログ内のオブジェクトの場所を指定します。

boolean resolveLinks

TRUEに設定され、カタログ内のパスがリンクを参照する場合、オブジェクトはリンクが指す場所に書き込まれます。

ErrorDetailsLevel errorMode

CatalogObjects構造体のerrorInfoフィールドのエラー情報の量を指定します。詳細は、第2.7項「CatalogObject構造体」を参照してください。

ReadObjectsReturnOptions returnOptions

有効な値のリストを指定します。詳細は、「ReadObjectsReturnOptionsの列挙」を参照してください。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.10.13.2 戻り値

CatalogObjectsの配列を戻します。

注意:

(無効なパスや権限が不十分であることなどにより)カタログ・オブジェクトに対する読取り操作に失敗した場合、そのオブジェクトのerrorInfoフィールドには、エラーの説明が含まれます。

3.10.14 removeFolder()メソッド

このメソッドを使用して、フォルダとそのコンテンツをカタログから削除します。フォルダとそのコンテンツ以外のオブジェクトを削除するには、 第3.10.7項「deleteItem()メソッド」を参照してください。

3.10.14.1 シグネチャ

void removeFolder(String path, boolean recursive, String sessionID);

引数

説明

String path

カタログ内のフォルダへのパスを指定します。

boolean recursive

TRUEに設定されている場合、指定したフォルダとそのコンテンツを削除します。FALSEに設定されている場合は、指定したフォルダが空の場合のみそのフォルダを削除し、空でなければ、例外メッセージを表示します。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.10.15 setItemAttributes()メソッド

このメソッドを使用して、指定したカタログ項目の属性フラグを設定します。

3.10.15.1 シグネチャ

void setItemAttributes (List[] path, int value, int valueOff, boolean recursive, String sessionID);

引数

説明

List[] path

カタログ内のフォルダへのパスを指定します。

int value

追加する属性を指定します。次のフラグの組合せを指定します。

1 = 読取りのみ 2 = アーカイブ 4 = 非表示 8 = システム

int valueOff

削除する属性を指定します。フラグについては、前述のint valueの説明を参照してください。

boolean recursive

サブディレクトリ内の項目のプロパティを設定するかどうかを指定します。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.10.16 setItemProperty()メソッド

このメソッドを使用して、カタログ内のオブジェクトのプロパティを設定します。

3.10.16.1 シグネチャ

void setItemProperty(List[] path, List[] name, List[] value, boolean recursive, String sessionID);

引数

説明

List[] path

カタログ内のオブジェクトへのパスを指定します。

List[] name

設定するプロパティの名前を指定します。

List[] value

プロパティの新しい設定を指定します。

boolean recursive

サブディレクトリ内の項目のプロパティを設定するかどうかを指定します。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.10.17 setOwnership()メソッド

このメソッドを使用して、指定した項目の所有権を取得します。

3.10.17.1 シグネチャ

void setOwnership(List[]path, Account owner, boolean recursive, String sessionID);

引数

説明

List[] path

カタログ内の所有権を取得するオブジェクトの場所を指定します。

Account owner

所有者として割り当てるアカウントを指定します。

boolean recursive

TRUEに設定されている場合、このアクションを指定したフォルダとそのコンテンツに適用します。FALSEに設定されている場合は、指定したフォルダが空の場合のみ、そのフォルダにこのアクションを適用し、空でなければ、例外メッセージを表示します。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.10.18 updateCatalogItemACL()メソッド

このメソッドを使用して、カタログ内の項目のアクセス制御リストを更新します。

3.10.18.1 シグネチャ

void updateCatalogItemACL(List[] path, ACL acl, UpdateCatalogItemACLParams options, String sessionID);

フィールド

説明

List[] path

カタログ内のオブジェクトへのパスを指定します。

ACL acl

アクセス制御リストを指定します。詳細は、第2.3項「ACL構造体」を参照してください。

UpdateCatalogItemACLParams options

追加パラメータを指定します。詳細は、第2.29項「UpdateCatalogItemACLParams構造体」を参照してください。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.10.19 writeObjects()メソッド

このメソッドを使用して、カタログにオブジェクトの配列を書き込みます。

3.10.19.1 シグネチャ

List[] writeObjects(List[] catalogObjects, boolean allowOverwrite, boolean createIntermediateDirs, ErrorDetailsLevel errorMode, String sessionID);

引数

説明

List [] catalogObjects

カタログに書き込むオブジェクトを指定します。これはCatalogObject構造体で提供されます。CatalogObject構造体の詳細は、第2.7項「CatalogObject構造体」を参照してください。

オブジェクトに適用される項目プロパティの配列を除く、object.itemInfoのすべてのフィールドが無視されます。生成されるドキュメントのシグネチャは常にCOXmlDocument1となります。

boolean allowOverwrite

TRUEに設定されている場合、カタログ内にオブジェクトがすでに存在すると、これはオーバーライドされます。FALSEに設定されている場合、カタログ内にオブジェクトがすでに存在すると、これはオーバーライドされません。

boolean createIntermediateDirs

TRUEに設定され、カタログ内のパスがリンクを参照する場合、オブジェクトはリンクが指す場所に書き込まれます。

ErrorDetailsLevel errorMode

CatalogObjects構造体のerrorInfoフィールドのエラー情報の量を指定します。

String sessionID

セッションIDを指定します。これは通常ログオン・メソッドにより戻されます。SOAPクライアント・エンジンがHTTP Cookieを処理できる場合、セッションIDは省略するか、nullに設定することができます。

3.10.19.2 戻り値

ErrorInfoオブジェクトの配列。

3.11 XMLViewServiceサービス

このサービスを使用して、Oracle BI EEプレゼンテーション・サービスから結果をXML形式で取得します。表3-19に、サポートされるメソッドを示します。

表3-19 XMLViewサービス・メソッド

メソッド名

説明

第3.11.2項「cancelQuery()メソッド」

現在の問合せを取り消します。

第3.11.3項「executeSQLQuery()メソッド」

SQL問合せを実行します。

第3.11.4項「executeXMLQuery()メソッド」

XML問合せを実行します。

第3.11.5項「fetchNext()メソッド」

データ行の次のページを戻します。

第3.11.6項「getPromptedFilters()メソッド」

プロンプト・フィルタのある分析の列のみを含むフィルタXML構造体を戻します。

第3.11.7項「upgradeXML()メソッド」

リクエストしたオブジェクトのアップグレード・バージョンを戻します。

3.11.1 XMLQueryOutputFormatの列挙

この列挙では、executeSQLQuery()メソッドおよびexecuteXMLQuery()メソッドの有効な値のリストを指定します。たとえば、データ行とメタデータ、あるいはデータ行のみを戻すことができます。表3-20に、この列挙の値をリストします。

注意:

XMLQueryOutputFormatの1つの値のみを選択できます。

表3-20 XMLQueryOutputFormatの列挙値

値

説明

String SAWRowsetData

問合せでデータ行のみを戻すことを指定します。

String SAWRowsetSchema

問合せでメタデータのみを戻すことを指定します。

String SAWRowsetSchemaAndData

問合せでメタデータとデータ行の両方を戻すことを指定します。

3.11.2 cancelQuery()メソッド

このメソッドを使用して、問合せを取り消し、その問合せに関連付けられたリソースをクリーンアップします。このメソッドは、問合せの行セットが、戻されたデータセットの最後の行までスクロールされない場合にのみ使用されます。

注意:

戻されたデータセットで、問合せ行セットが最後の行までスクロールされるときに、このメソッドを使用すると、問合せデータは、最後のfetchNextメソッドが起動される際にクリーンアップされます。

3.11.2.1 シグネチャ

void cancelQuery(String queryID, String sessionID);

引数

説明

String queryID

問合せの一意のIDを指定します。

String sessionID

セッションの一意のIDを指定します。

3.11.3 executeSQLQuery()メソッド

このメソッドを使用して、SQL問合せを実行し、その問合せの結果を戻します。

注意:

戻される結果が1ページを超える場合、fetchNext()メソッドを使用して、行の次のページを戻す必要があります。

3.11.3.1 シグネチャ

QueryResults executeSQLQuery(String sql, XMLQueryOutputFormat outputFormat, XMLQueryExecutionOptions executionOptions, String sessionID);

引数

説明

String sql

実行するSQLコードの文字列を指定します。

XMLQueryOutputFormat outputFormat

出力形式を指定します(詳細は、第2.31項「XMLQueryExecutionOptions構造体」を参照してください)。

XMLQueryExecutionOptions executionOptions

問合せ実行オプションを指定します(詳細は、第2.31項「XMLQueryExecutionOptions構造体」を参照してください)。

String sessionID

セッションの一意のIDを指定します。

3.11.3.2 戻り値

QueryResults構造体の1行以上のデータとして、問合せの結果を戻します(詳細は、第2.15項「QueryResults構造体」を参照してください)。

3.11.4 executeXMLQuery()メソッド

このメソッドを使用して、XML問合せを実行し、その問合せの結果を戻します。

注意:

戻される結果が1ページを超える場合、fetchNext()メソッドを使用して、行の次のページを戻す必要があります。

3.11.4.1 シグネチャ

QueryResults executeXMLQuery(ReportRef report, XMLQueryOutputFormat outputFormat, XMLQueryExecutionOptions executionOptions, ReportParams reportParams, String sessionID);

引数

説明

ReportRef reportRef

ReportRef共通構造体で提供される分析定義を指定します。

XMLQueryOutputFormat outputFormat

出力形式を指定します(詳細は、第2.31項「XMLQueryExecutionOptions構造体」を参照してください)。

XMLQueryExecutionOptions executionOptions

問合せ実行オプションを指定します(詳細は、第2.31項「XMLQueryExecutionOptions構造体」を参照してください)。

ReportParams reportParams

オプション。実行前に分析に適用するフィルタまたは変数を指定します。この情報は、ReportParams共通構造体で提供されます。ReportParams構造体の詳細は、第2.17項「ReportParams構造体」を参照してください。

String sessionID

セッションの一意のIDを指定します。

3.11.4.2 戻り値

QueryResults構造体の1行以上のデータとして、問合せの結果を戻します(詳細は、第2.15項「QueryResults構造体」を参照してください)。

3.11.5 fetchNext()メソッド

このメソッドを使用して、問合せで取得した行の次のページを戻します。

注意:

戻されたページには、行が含まれていない場合があります。完了フラグが設定されていない場合、残りの行は即座に使用できない場合があります。

3.11.5.1 シグネチャ

QueryResults fetchNext(String queryID, String sessionID);

引数

説明

String queryID

一意の問合せIDを指定します。これはQueryResultsオブジェクトで戻されます。

String sessionID

セッションの一意のIDを指定します。

3.11.5.2 戻り値

QueryResults構造体の1行以上のデータとして、問合せ結果の次のページを戻します(詳細は、第2.15項「QueryResults構造体」を参照してください)。

3.11.6 getPromptedFilters()メソッド

このメソッドを使用して、保存された分析のプロンプト列または、分析のXML定義からのプロンプト列を取得します。プロンプト列を含む分析を作成するには、これにisPrompted演算子を割り当てる必要があります。

3.11.6.1 シグネチャ

List[] getPromptedFilters(ReportRef report, String sessionID);

引数

説明

ReportRef report

分析のreportPathまたはreportXml (レポート定義)を指定します。

String sessionID

セッションの一意のIDを指定します。

3.11.7 upgradeXML()メソッド

このメソッドを使用して、カタログ外のOracle BI EEオブジェクトをアップグレードします。このメソッドでは、オブジェクトをOracle BI EE 10gからOracle BI EE 11gにアップグレードします。このメソッドは、主にOracle BIのMicrosoft Office用アドインに使用し、カタログではなくOracle BI Office内に保存されている分析をアップグレードします。Oracle BI Officeカタログ内のオブジェクトをアップグレードする場合のみ、このメソッドを使用する必要があります。

executeXmlQueryなどのメソッドを使用し、ReportRef引数によりOracle BI EE 10gレポート定義を渡す場合、そのレポートは問合せが実行される前にアップグレードされます。

3.11.7.1 シグネチャ

String upgradeXML(String xml, String sessionID);

引数

説明

String xml

カタログ・オブジェクトのXMLを指定します。

String sessionID

セッションの一意のIDを指定します。

4 Oracle Business IntelligenceサーバーのメタデータWebサービスの使用

この章では、Oracle Business IntelligenceサーバーのメタデータWebサービスの概要を紹介し、Oracle BIサーバーとのWebサービス接続の構成、Webサービスのコールに使用されるメソッド、Webサービスの保護およびOracle BIサーバーのXMLプロシージャの使用について説明します。

この章の内容は次のとおりです。

- 第4.1項「Oracle BIサーバーのメタデータWebサービスの概要」

- 第4.2項「Oracle BIサーバーのメタデータWebサービスの構成」

- 第4.3項「Oracle BIサーバーのメタデータWebサービスのコール」

- 第4.4項「Oracle BIサーバーのXMLプロシージャの使用」

4.1 Oracle BIサーバーのメタデータWebサービスの概要

Oracle BIサーバーではセマンティック・モデルを使用して、操作関連の動作を格納および制御します。セマンティック・レイヤーは共通エンタープライズ情報モデルと呼ばれ、Oracle BI管理ツールによって管理されるメタデータ内で取得されます。

以前のバージョンのOracle Business Intelligenceでは、管理ツールを使用してメタデータ・リポジトリに格納された情報にアクセスしていました。しかし、このバージョンのOracle Business Intelligenceでは、Oracle BIサーバーのメタデータWebサービスにより、Webサービス・インタフェースを使用してOracle BIサーバーのストアド・プロシージャをコールできます。これらのプロシージャにより、メタデータについての情報を取得したり、メタデータを変更したりできます。

たとえば、サーバーのリポジトリを新しいメタデータで更新する場合、開発者は、管理ツールを開いたり、変更後のリポジトリを使用してサーバーを再起動したりする必要がなくなります。開発者は、ストアド・プロシージャを使用して、リポジトリの異なる2つのバージョンから作成されたパッチXMLを直接適用できます。

Oracle BIサーバーのメタデータWebサービスをコールするには、同期と非同期の2つの手法があります。即座にレスポンスが返されるケースでは、同期手法が適している場合があります。ただし、要求の処理が遅延する場合があるため、多くの場合はWebサービスを非同期でコールする手法を使用し、クライアント・アプリケーションの処理を続行して後からレスポンスを処理できるようにすると便利です。

4.2 Oracle BIサーバーのメタデータWebサービスの構成

このトピックには、次の項が含まれています。

- 第4.2.1項「Oracle BIサーバーのメタデータWebサービスとOracle BIサーバーとの接続の構成」

- 第4.2.2項「Oracle BIサーバーのメタデータWebサービスの保護」

4.2.1 Oracle BIサーバーのメタデータWebサービスとOracle BIサーバーとの接続の構成

このトピックでは、BIサーバーのデフォルト・インストールを使用しない場合について説明します。デフォルトでは、Oracle BIサーバーのメタデータWebサービスは、次のURLで実行されるOracle BIサーバー・インスタンスに接続しようとします。

jdbc:oraclebi://localhost:9703/

しかし、BIサーバーが別のマシン上にデプロイされている場合、別のポートを使用する場合、またはWebサービスとサーバー間でSSL接続を構成する場合は、Oracle WebLogic Server管理コンソールで作成したOracle Business Intelligence JDBCデータ・ソースを使用する必要があります。Oracle BIサーバーのメタデータWebサービスは、次の名前のデータ・ソースを探し、見つかった場合はそれを使用してOracle BIサーバーに接続します。

jdbc/bi/server

4.2.1.1 Oracle Business Intelligence JDBCデータ・ソースの設定

Oracle Business Intelligence JDBCデータ・ソースの作成手順は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Edition開発者ガイド』のOracle WebLogicでのBI JDBCデータ・ソースの作成方法に関する項を参照してください。

ただし、Oracle BIサーバーのメタデータWebサービスとともに使用する場合のOracle Business Intelligence JDBCデータ・ソースの設定には、次の要件があります。プリファレンスが適用されるように、このデータ・ソースの設定が完了した時点で、Webサービスを停止および再起動してください。

- 新規JDBCデータ・ソースウィザードの「接続プロパティ」ページの「URL」フィールドで、Oracle BIサーバーに対して構成したポートを指定します。既存の指示では「9703」を指定するようにされていますが、「9703」は正しいポート番号ではない可能性があります。

- BI JDBCデータ・ソースを作成して保存した後は、データ・ソースの設定を変更する必要があります。データ・ソースの「設定」にアクセスし、「接続プール」タブをクリックします。各設定項目を、次のように変更します。

- 「文キャッシュ・サイズ」フィールドに「0」と入力します。この値を指定することで、文のキャッシュが無効になります。

- 「詳細設定」タブで、「接続作成の再試行間隔」フィールドに「10」と入力します(または0より大きな任意の数値)。

4.2.2 Oracle BIサーバーのメタデータWebサービスの保護

Oracle BIサーバーのメタデータWebサービスは、Oracle Web Services Manager (WSM)を使用して保護します。Oracle BIサーバーのメタデータWebサービスをコールするには、クライアント・コードを適切なクライアント側ポリシーによって構成し、ストアド・プロシージャのコール権限を持つユーザーにセキュリティ資格証明を提供する必要があります。

このトピックには、次の項が含まれています。

- 第4.2.2.1項「ポリシーの適用」

- 第4.2.2.2項「WSMの構成」

- 第4.2.2.3項「manageRepositories権限の割当て」

4.2.2.1 ポリシーの適用

事前定義済のリストから組織のセキュリティ指針に合ったセキュリティ・ポリシーを選択して、Webサービスに割り当てます。

Webサービスのセキュリティ・ポリシーの例を次に示します。

oracle/wss11_saml_token_with_message_protection_service_policy

Oracle BIサーバーのメタデータWebサービスを正常にコールするには、一致するクライアント側ポリシーをクライアント・コードで設定し、必要な情報を指定する必要があります。たとえば、前述のサービス・ポリシーに一致するクライアント側ポリシーは、次のとおりです。

oracle/wss11_saml_token_with_message_protection_client_policy

この例では、クライアント・コードで、ストアド・プロシージャをコールする権限を持つユーザーの有効なSAMLトークンを、SOAPメッセージ・ヘッダーに追加する必要があります。Webサービスのセキュリティ・ポリシーにより、有効なトークンを持たないSOAPメッセージは必ずすべて拒否されます。トークンが有効な場合は、Webサービスがシステムのユーザー資格証明を使用してOracle BIサーバーに接続し、トークンで指定されたユーザーを偽装します。

WSMの詳細、および定義済ポリシーの適用および構成方法は、Oracle Fusion Middleware Webサービスのセキュリティおよび管理者ガイドを参照してください。

4.2.2.2 WSMの構成

Oracle BIサーバーのメタデータWebサービスを正常に使用するには、事前にWSMを構成しておく必要があります。Oracle BIサーバーのメタデータWebサービスおよびアクション・フレームワークには、同じ構成を使用します。

Oracle BIサーバーのメタデータWebサービスを使用するためのWSMの構成は、「Oracle Web Services Managerの構成」を参照してください。

4.2.2.3 manageRepositories権限の割当て

Oracle BIサーバーのメタデータWebサービスを実行するユーザーには、manageRepositories権限を付与する必要があります。セキュリティの設定方法、およびこの権限の適用方法は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionセキュリティ・ガイド』を参照してください。

4.3 Oracle BIサーバーのメタデータWebサービスのコール

この項では、Oracle BIサーバーのメタデータWebサービスのコールについて説明します。

- 第4.3.1項「Oracle BIサーバーのメタデータWebサービスの同期コール」

- 第4.3.2項「Oracle BIサーバーのメタデータWebサービスの非同期コール」

4.3.1 Oracle BIサーバーのメタデータWebサービスの同期コール

通常、同期コールの場合は、Oracle BIサーバーのメタデータWebサービスは次の場所にデプロイされます。

http://server:port/AdminService/AdminService

WSDLは次の場所にあります。

http://server:port/AdminService/AdminService?WSDL

Oracle BIサーバー上のストアド・プロシージャを同期的にコールするには、次のメソッドを使用します。

- 第4.3.1.1項「callProcedure()メソッド」

- 第4.3.1.2項「callProcedureWithResults()メソッド」

- 第4.3.1.3項「startExtender()メソッド」

- 第4.3.1.4項「サンプル・コード」

4.3.1.1 callProcedure()メソッド

このメソッドは、結果セットを返すことが想定されていないプロシージャのコールに使用します。表4-1は、このメソッドの各引数についての情報を示します。

表4-1 callProcedureメソッドの引数

引数

データ型

説明

procedureName

文字列

コールするプロシージャの名前です。

parameters

パラメータのリスト

一連のパラメータ・オブジェクト。各パラメータは、ストアド・プロシージャ引数に対応するタイプと値を定義します。

サポートされるパラメータ・タイプは、WSDLを参照してください。

4.3.1.2 callProcedureWithResults()メソッド

このメソッドは、結果セットを返すことが想定されるプロシージャのコールに使用します。

このメソッドは、結果セットを一連のResultsRowオブジェクトとして模倣するオブジェクトを返します。各ResultsRowにはそれぞれ1つ以上の列が含まれ、各列はタイプと値を定義します。エラーが発生した場合、ほとんどのストアド・プロシージャは、文字列による1つの列からなる行を1つ以上返します。このため、返された結果を注意深く確認することが重要です。

結果セットを返すプロシージャは、、NQSModifyMetadata、NQSQueryMetadata、NQSExtractMetadataProject (レコード・セットをバイナリ・データとして返す)およびNQSQueryProjectsです。これらはすべて問合せタイプのプロシージャで、単にプロシージャの実行中に発生したエラー・メッセージ(存在する場合)を返すNQSModifyMetadataを除いて、興味深い結果を返します。NQSModifyMetadataは、callProcedureWithResultsと一緒でなくても同期的にコールできますが、その場合はどのようなメッセージが返されたかを知ることはできません。

表4-2は、このメソッドの各引数についての情報を示します。

表4-2 callProcedureメソッドの引数

引数

データ型

説明

procedureName

文字列

コールするプロシージャの名前です。

parameters

パラメータのリスト

一連のパラメータ・オブジェクト。各パラメータは、ストアド・プロシージャ引数に対応するタイプと値を定義します。

サポートされるパラメータ・タイプは、WSDLを参照してください。

4.3.1.3 startExtender()メソッド

このメソッドは内部のみで使用され、BIサーバー拡張ユーティリティをコールします。このユーティリティはADFソースのフレックス・オブジェクトの変更をインポートし、ビジネス・モデルとマッピングのレイヤーとプレゼンテーション・レイヤーにマップします。

このメソッドは、startExtenderコマンドが起動されたことを示す文字列を返します。

詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイド』のbiserverextenderユーティリティを使用したフレックス・オブジェクト変更の自動マッピングに関する項を参照してください。

WSDLのstartExtender()メソッド用のシグネチャは、次のとおりです。

<xsd:sequence>
<xsd:element name="adminBeanServerUrl" type="xsd:string"/>
<xsd:element name="biAdminUser" type="xsd:string"/>
<xsd:element name="biAdminPassword" type="xsd:string"/>
<xsd:element name="jobID" type="xsd:string"/>
<xsd:element name="connectionDetails" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<xsd:element name="startExtender" type="tns:startExtender"/>
<xsd:complexType name="startExtenderResponse">
<xsd:sequence>
<xsd:element name="return" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>

たとえば、startExtender()のコールは、次のようになります。

startExtender(localhost:7001", "wlsuser", "wlspassword", "
<ConnectionDetails>
<ConnectionPool>
<ConnectionPoolName>"oracle.apps.fscm.model.analytics.
applicationModule.FscmTopModelAM_FscmTopModelAMLocal"."Connection Pool"
</ConnectionPoolName>
</ConnectionPool>
<NewEssbaseConnection>
<DatabaseName>computer.example.com:10215</DatabaseName>
<UserName>FUSION_APPS_GL_ESSBASE_APPID</UserName>
<Password>D7EDED84BC624A917F5B462A4DCA05
CDCE256EEEEEDC97D5575BA27BADBC24F0E7675
6D92C558D91CA53D63E2D7450E3FAEA57FA6B914D4D</Password>
<CubeNamesList>
<CubeName>BI_VF_USA_Accounting_Flexfie</CubeName>
</CubeNamesList>
</NewEssbaseConnection>
</ConnectionDetails>");

表4-3は、このメソッドの各引数についての情報を示します。

表4-3 startExtender()メソッドの引数

引数

データ型

説明

procedureName

文字列

コールするプロシージャの名前です。

parameters

パラメータのリスト

一連のパラメータ・オブジェクト。各パラメータは、ストアド・プロシージャ引数に対応するタイプと値を定義します。

サポートされるパラメータ・タイプは、WSDLを参照してください。

4.3.1.4 サンプル・コード

次のコードを使用してクライアント側のセキュリティを設定します。このコードを使用すると、SAMLトークン内の認証情報を渡すように構成された、管理サービスのクライアント側インスタンスを設定できます。このコードは認証されたWebアプリケーションに格納されている必要があります。セッションの認証情報は、Oracle BIサーバーのメタデータWebサービスに自動的に渡されます。次の例のようなコードを使用するには、クライアント側のプロキシ・クラスを生成する必要があります。

次の例では、adminwebservice.clientパッケージ内でプロキシが生成されています。

import adminwebservice.client.*;

/**
* Looks up an instance of the Admin Service and sets the correct
authentication information on it.
* @return Admin Proxy to the admin service.
*/
protected Admin getAdminService() throws Exception {

String SERVICE_NAMESPACE = "http://ws.admin.obiee.oracle/";
String SERVICE_NAME = "AdminService";
String PORT_NAME = "AdminPort";
String WSS_POLICY_CONFIG_FILE_SAML = "wss-policy-saml.xml";

URL wsdlURL = new URL
("http://localhost:7001/AdminService/AdminService?WSDL");
QName serviceQname = new QName(SERVICE_NAMESPACE, SERVICE_NAME);
QName portQname = new QName(SERVICE_NAMESPACE, PORT_NAME);

ServiceDelegateImpl serviceDelegate = new ServiceDelegateImpl
(wsdlURL, serviceQname, OracleService.class);
Admin admin = serviceDelegate.getPort( portQname, Admin.class);

((BindingProvider)admin).getRequestContext().put(ClientConstants.CLIENT_
CONFIG,toElement(this.getClass().getResourceAsStream(WSS_POLICY_CONFIG_
FILE_SAML)));

((BindingProvider)admin).getRequestContext().put(BindingProvider.
ENDPOINT_ADDRESS_PROPERTY, getServiceUrl());
return admin;
}

WSS_POLICY_CONFIG_FILE_SAML

WSS_POLICY_CONFIG_FILE_SAMLは、次のような内容を持つファイルのリソース名です。

<?xml version="1.0" encoding="UTF-8"?>
<oracle-webservice-clients>
<webservice-client>
<port-info>
<policy-references>
<policy-reference uri="oracle/wss11_saml_token_with_
message_protection_client_
policy"category="security"/>
</policy-references>
</port-info>
</webservice-client>
</oracle-webservice-clients>

4.3.2 Oracle BIサーバーのメタデータWebサービスの非同期コール

通常、非同期コールの場合は、Oracle BIサーバーのメタデータWebサービスは次の場所にデプロイされます。

http://server:port/AsyncAdminService/service

非同期サービスでは、WSDLは次の場所にあります。

http://server:port/AsyncAdminService/service?wsdl

クライアントから見ると、非同期メソッド・コールは2つの一方向メッセージ交換で構成されています。クライアントは非同期コールを開始する前に、非同期Webサービスからのレスポンスをリスニングするためのコールバック・サービスをデプロイする必要があります。

内容は次のとおりです。

- 第4.3.2.1項「コールバック・サービスの作成」

- 第4.3.2.2項「コールバック・サービスの構成」

- 第4.3.2.3項「サンプル・コード」

4.3.2.1 コールバック・サービスの作成

JDeveloperのWebサービス・プロキシの作成ウィザードを使用して、「非同期として生成」オプションを選択すると、非同期プロキシが生成されます。このウィザードを使用してWebサービス・クライアントを作成する場合の詳細は、JDeveloperのオンライン・ヘルプのWebサービス・プロキシの作成に関する項を参照してください。生成されたコールバック・サービス・コードを変更して、レスポンスを処理できます。その後、コールバック・サービスをWebサービスとしてデプロイする必要があります。デプロイした後は、コールバック・サービスのURLをreplyToフィールドとしてクライアント・コードに追加します。

コールバック・サービス作成の詳細は、『Oracle Fusion Middleware Oracle Infrastructure Webサービス開発者ガイド』の非同期Webサービス・クライアントの定義に関する項を参照してください。

4.3.2.2 コールバック・サービスの構成

ポリシーは次の非同期コンポーネントにアタッチできます。

- 非同期Webサービスをコールするクライアント

- 非同期Webサービス

- 非同期コールバック・クライアント

- 非同期コールバック・サービス

実行時にコンポーネントにポリシーをアタッチするには、Fusion Middleware Controlを使用します。非同期Webサービスとクライアント・ポリシーは互いに適合している必要があります。同様に、非同期コールバック・クライアントとコールバック・サービス・ポリシーも互いに適合している必要があります。

コールバック・サービスのセキュリティ構成の詳細は、『Oracle Fusion Middleware Oracle Infrastructure Webサービス開発者ガイド』の非同期Webサービスとクライアントへのポリシーのアタッチに関する項を参照してください。

4.3.2.3 サンプル・コード

次のコードを使用して、非同期メタデータWebサービスのクライアント側インスタンスを作成および初期化できます。このコードに含まれているのは、クライアント側のインスタンスを構成し、oracle/wss_username_token_client_policyポリシーに必要な認証情報を渡す場合の例です。次の例のようなコードを使用するには、クライアント側のプロキシ・クラスを生成する必要があります。

/**
* Looks up an instance of the Asynchronous Admin Service and
* sets the correct authentication information on it.
* @return Asynchronous Admin Proxy to the admin service.
*/
protected AsyncAdmin getAsyncAdminService() throws Exception {
String SERVICE_NAMESPACE = "http://ws.admin.obiee.oracle/";
String SERVICE_NAME = "AsyncAdminService";
String SECURITY_POLICY = "oracle/wss_username_token_client_policy";

URL wsdlURL = new URL("http://localhost:7001/AsyncAdminService/service?wsdl");
QName serviceQname = new QName(SERVICE_NAMESPACE, SERVICE_NAME);

AsyncAdminService service = new AsyncAdminService(wsdlURL, serviceQname);
SecurityPoliciesFeature securityFeature =
new SecurityPoliciesFeature(new String[] { SECURITY_POLICY });
AsyncAdmin admin = service.getAsyncAdminPort(securityFeature);

Map<String, Object> requestContext = ((BindingProvider) admin).getRequestContext();
requestContext.put(BindingProvider.USERNAME_PROPERTY, "weblogic");
requestContext.put(BindingProvider.PASSWORD_PROPERTY, "welcome1");

return admin;
}

次のコードに、非同期メタデータWebサービスのメソッドをコールする前にコールバック情報を指定する方法を示します。

String CALLBACK_URL =  "http://localhost:7001/ClienCallback/AsyncAdminResponseImplPort";
AddressingVersion WS_ADDR_VER = AddressingVersion.W3C;

WSEndpointReference replyTo = new WSEndpointReference(CALLBACK_URL, WS_ADDR_VER);
Header replyToHeader = replyTo.createHeader(WS_ADDR_VER.replyToTag);

String messageID = UUID.randomUUID().toString();
WSBindingProvider wsbp = (WSBindingProvider) getAsyncAdminService();
wsbp.setOutboundHeaders(new StringHeader(WS_ADDR_VER.messageIDTag, messageID), replyToHeader);

4.4 Oracle BIサーバーのXMLプロシージャの使用

Oracle Business Intelligenceには、JDBCまたはODBC経由でOracle BIサーバーをコールする場合に使用できる、いくつかのOracle BIサーバーXMLプロシージャが用意されています。Oracle BIサーバーXMLプロシージャは、バイナリ(RPD)形式のリポジトリでのみ使用できます。

ここでは、次のプロシージャについて詳しく説明します。

- 第4.4.1項「プロジェクト抽出プロシージャ」

- 第4.4.2項「メタデータ変更プロシージャ」

- 第4.4.3項「メタデータ問合せプロシージャ」

- 第4.4.4項「プロジェクト問合せプロシージャ」

4.4.1プロジェクト抽出プロシージャ

プロジェクト抽出プロシージャは、リポジトリからプロジェクトを抽出するために使用します。出力される結果セットには、リポジトリ内で定義された各プロジェクトを示す行が含まれます。

このプロシージャの構造は、次のとおりです。

NQSExtractMetadataProject
Input
1.      PROJECT_NAMES
2.RPD_NAME (optional)
Output
1.      RPD_OBJECT

表4-4は、プロジェクト抽出プロシージャの入力および出力パラメータと、それぞれの説明を示します。

表4-4 プロジェクト抽出プロシージャのパラメータと説明

パラメータ

説明

PROJECT_NAMES

プロシージャに送られ、抽出されるプロジェクト名のデリミタ付きリストです。

RPD_NAME

(オプション)このパラメータは現在使用されていません。今後使用するために予約されています。

RPD_OBJECT

抽出されたリポジトリのバイナリ表現となる、単一のBLOBオブジェクトを保持します。

4.4.2 メタデータ変更プロシージャ

メタデータ変更プロシージャは、変更をリポジトリに適用するために使用します。出力される結果セットには、0または1つの行が含まれます。1行が返された場合、この行にはエラー・メッセージが含まれます。

メタデータは、コマンドラインXMLユーティリティ(biserverxmlgen、biserverxmlexecおよびbiserverxmlcliなど)のような他のメソッドを使用し、管理ツール内でコピーおよび貼付けを行うことによって変更できます。biserverxmlgen、biserverxmlexecおよびbiserverxmlcliのコマンドライン・ツールの詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Edition XMLスキーマ・リファレンス』のXMLの生成および実行に関する項を参照してください。

このプロシージャの構造は、次のとおりです。

NQSModifyMetadata
Input
1.      XUDML_TEXT
2.      ORIGINAL_RPD      (optional)
3.      RPD_NAME          (optional)
4.      IGNORE_XUDML_ERRORS        (optional)
Output
1.      ERROR_MESSAGES

表4-5は、メタデータ変更プロシージャの入力および出力パラメータと、それぞれの説明を示します。

表4-5 メタデータ変更プロシージャのパラメータと説明

パラメータ

説明

XUMDL_TEXT

サーバーに適用される完全なOracle BI Server XMLテキスト。元のリポジトリが入力パラメータに設定されている場合を除き、通常はメタデータ定義は直接適用され、既存の定義を上書きします。

ORIGINAL_RPD

(オプション) Oracle Business IntelligenceがOracle BIサーバーXMLを比較するためのリポジトリ名。Oracle Business Intelligenceは、Oracle BIサーバーのXMLフラグメントを、指定された元のRPDと比較します。競合が検出された場合、Oracle BIサーバーXMLは適用されません。競合が検出されない場合は、Oracle BIサーバーXMLが適用されます。

RPD_NAME

(オプション)このパラメータは現在使用されていません。今後使用するために予約されています。

IGNORE_XUDML_ERRORS

(オプション)致命的でないエラーはすべて無視されます。致命的でないエラーには、たとえば未解決のオブジェクト、重複したオブジェクト、壊れた式などがあります。

このパラメータはtrueに設定します。値の大文字と小文字は区別されません。

ERROR_MESSAGES

問合せの実行の結果返されたすべてのエラーを保持します。

4.4.3 メタデータ問合せプロシージャ

メタデータ問合せプロシージャは、リポジトリにメタデータを問い合せるために使用します。出力される結果セットには、一致したオブジェクトの数だけの行が含まれます。完全な形式のOracle BI Server XMLドキュメントを得るには、結果行を連結する必要があります。

このプロシージャの構造は、次のとおりです。

NQSQueryMetadataObjects
Input
1.      OBJECT_TYPES
2.      OBJECT_NAME       (optional)
3.      OBJECT_PARENT     (optional)
4.      CHILD_FLAG        (optional)
5.      QNAME_QUERY_FLAG   (optional)
6.      RPD_NAME          (optional)
7.      CHILD_TYPE        (optional)
Output
1.      XUDML_TEXT
2.      ERROR_MESSAGES

表4-6は、メタデータ問合せプロシージャの入力および出力パラメータと、それぞれの説明を示します。

表4-6 メタデータ問合せプロシージャのパラメータと説明

パラメータ

説明

OBJECT_TYPES

検索するオブジェクト・タイプのリスト。複数のオブジェクト・タイプを問い合せるには、各オブジェクト・タイプをカンマで区切って追加します。

たとえば、サブジェクト領域オブジェクトとプレゼンテーション・カタログ・オブジェクトを問い合せるには、object_typesの値を「2000,4004」と設定します。この例では、サブジェクト領域オブジェクトのタイプID値は2000であり、プレゼンテーション・カタログ・オブジェクトのタイプID値は4004です。

OBJECT_NAME

(オプション)名前に一致するオブジェクトをフィルタします。この名前は、完全修飾名ではありません。

たとえば、「AtomicStar」という名前のすべてのサブジェクト領域を問い合せるには、OBJECT_TYPESパラメータを「2000」に、OBJECT_NAMEパラメータを「AtomicStar」に設定します。

OBJECT_PARENTを使用している場合は、OBJECT_NAMEを空にすることはできません。

OBJECT_PARENT

(オプション)親オブジェクト名に基づいてオブジェクトをフィルタします。このパラメータは、完全修飾名を指定する場合に使用します。

CHILD_FLAG

(オプション)このパラメータをtrueに設定して問合せを行うと、問い合せたオブジェクトのすべての子オブジェクトが返されます。たとえば、オブジェクト・タイプ・パラメータをビジネス・モデルと設定して、子フラグ・パラメータをtrueに設定すると、ツリー内のビジネス・モデルの下位にあるすべてのオブジェクトが返されます。

QNAME_QUERY_FLAG

(オプション)このパラメータをtrueに設定して問合せを行うと、XUDMLフラグメントではなく修飾名が返されます。このパラメータを設定しないで問合せを行うと、デフォルトでXUDMLフラグメントが返されます。

RPD_NAME

(オプション)このパラメータは現在使用されていません。今後使用するために予約されています。

CHILD_TYPE

(オプション)このパラメータをtrueに設定して問合せを行うと、子のリストがタイプIDのカンマ区切りリストで指定されたタイプでフィルタされ、該当するタイプの子のみが返されます。このパラメータをデフォルトの空のままにすると、すべてのタイプの子オブジェクトが返されます。このパラメータは、CHILD_FLAGパラメータがtrueに設定されている場合にのみ適用できます。

XUDML_TEXT

すべてのメタデータに対して返されたXML表現。XMLデータが大きすぎて1行に収まらない場合は、複数行に分割された結果が返されます。完全な形式のOracle BI Server XMLドキュメントを得るには、結果行を連結する必要があります。

ERROR_MESSAGES

問合せの実行の結果返されたすべてのエラーを保持します。

4.4.4 プロジェクト問合せプロシージャ

プロジェクト問合せプロシージャは、リポジトリ内のプロジェクトを確認するために使用します。出力される結果セットには、リポジトリ内で定義されたプロジェクトのリストが含まれます。

このプロシージャの構造は、次のとおりです。

NQSQueryMetadataProjects
Input
1.      RPD_NAME          (optional)
Output
1.      PROJECT_NAME

表4-7は、プロジェクト問合せプロシージャの入力および出力パラメータと、それぞれの説明を示します。

表4-7 プロジェクト問合せプロシージャのパラメータと説明

パラメータ

説明

RPD_NAME

(オプション)このパラメータは現在使用されていません。今後使用するために予約されています。

PROJECT_NAME

各プロジェクトを示す行セット。行セット全体を収集するのは、コール元の責任であることに注意してください。

5 アクションによるOracle BI EEおよび外部システムの統合

この章では、Oracle BI EE Action Frameworkについて紹介し、アクション・フレームワークの有効化に必要な構成について説明します。Oracle BI EEコンテンツへのアクションの追加に必要な資格証明および権限について説明します。アクション・タイプ(「Siebel CRMにナビゲート」や「Webサービスの起動」など)別にターゲットを設定する方法について説明します。

この章の内容は次のとおりです。

- 第5.1項「アクション・フレームワークの紹介」

- 第5.2項「アクション・フレームワーク構成の概要」

- 第5.3項「アクション・フレームワークの構成」

- 第5.4項「アクション・セキュリティの概要」

- 第5.5項「アクション・フレームワークで使用する資格証明の追加および保守」

- 第5.6項「アクション用のターゲット機能」

5.1 アクション・フレームワークの紹介

アクション・フレームワークはOracle BI EEアーキテクチャのコンポーネントです。アクション・フレームワークは次の内容で構成されています。

- アクションWebサービス。アプリケーション・サーバーにデプロイされるアクションの作成および起動に使用します。

- プレゼンテーション・サーバーおよびスケジューラ・サービスに配置されるコンポーネント群。

- プレゼンテーション層にあるアクション固有のJavaScript。アクションを作成し、特定のアクション・タイプをブラウザから直接起動するために使用します。

Oracle BIプレゼンテーション・サービスでアクション・フレームワークを使用するように準備するには、次のタスクを実行する必要があります。

- アクション・フレームワークを構成します。詳細は、第5.2項 「アクション・フレームワーク構成の概要」および第5.3項 「アクション・フレームワークの構成」を参照してください。

- アクションを保護します。詳細は、第5.4項 「アクション・セキュリティの概要」および第5.5 項 「アクション・フレームワークで使用する資格証明の追加および保守」を参照してください。

- アクション・ターゲットを設定します。詳細は、第5.6項「アクション用のターゲット機能」を参照してください。

5.1.1 アクション・フレームワークが提供する機能

アクション・フレームワークは、アクションの作成、管理、起動を行うための機能を提供します。アクションが提供する機能は次のとおりです。

- 関連するコンテンツにナビゲートします。

- 外部システムの操作、関数、またはプロセスを起動します。

アクションはOracle BIプレゼンテーション・サービスのユーザー・インタフェースで作成および管理します。アクションは分析、ダッシュボード、エージェント、KPIおよびスコアカードの目標に含めることができます。アクションは、「Webページにナビゲート」、「Webサービスの起動」、および「ブラウザ・スクリプトの起動」などの、いくつかのタイプに分かれています。

アクションのタイプとその説明の一覧、およびアクションの作成方法と使用方法については、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionユーザーズ・ガイド』のアクションの使用に関する項を参照してください。

5.1.2 アクション・タイプおよびアクションの実行

Oracle BI EEで使用可能なアクションは、関連するコンテンツにナビゲートするアクション、および、外部システムの操作、関数またはプロセスを起動するアクションの、2つのグループにカテゴリ分けされています。アクションは、それらが起動するテクノロジ(URL、Webサービスなど)に基づくアクション・タイプに、さらにカテゴリ分けされます。

各アクション・タイプの説明およびビジネス・インテリジェンス・コンテンツへのアクション・リンクの追加に関する詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionユーザーズ・ガイド』のアクションの使用に関する項を参照してください。

Oracle BI EEオブジェクトをOracle ADFに追加する際に開発者が使用できるコンテキスト・イベント・アクション・タイプの詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Edition開発者ガイド』のOracle BI EEコンテキスト・イベント・アクションでBusiness Intelligenceコンテンツを渡す方法に関する項を参照してください。

表5-1「アクションを実行するシステム・コンポーネント」に、アクション・タイプおよびアクションを実行するシステム・コンポーネントを示します。特定のアクション・タイプの実行方法およびプロセスで使用される他のコンポーネントの詳細は、第5.6項「アクション用のターゲット機能」を参照してください。

表5-1 「アクションを実行するシステム・コンポーネント」

アクション・タイプ

実行元

BIコンテンツにナビゲート

ブラウザ

Webページにナビゲート

ブラウザ

EPMコンテンツにナビゲート

ブラウザ

E-Business Suiteにナビゲート

ブラウザ

Siebel CRMにナビゲート

ブラウザ

Webサービスの起動

AES

Javaメソッド(EJB)の起動

AES

ブラウザ・スクリプトの起動

ブラウザ

HTTPリクエストの起動

AES

サーバー・スクリプトの起動

スケジューラ

エージェントの起動

スケジューラ

Javaジョブ

Javahost

5.2 アクション・フレームワーク構成の概要

一部のアクション・タイプはOracle BI EEをインストールすると自動的に使用可能になりますが、その他アクション・タイプを使用できるようにするには特定の構成が必要です。追加構成が必要なアクション・タイプの場合、アクションによって起動される機能をホストする外部システムの情報(ターゲット機能の場所やアクセス方法など)を設定する必要があります。

セキュリティ・ポリシーがアクション・ターゲット(たとえばSAMLベースのポリシーを使用してセキュリティ設定を行ったターゲットWebサービス)に適用されている場所と同じ場所に、セキュリティ・ポリシー・ファイルを作成する必要があります。

また、暗号化や署名を含むセキュリティ・ポリシーには、キーストアが必要です。セキュリティ・ポリシー・ファイルおよびキーストアの詳細は、5.4項「アクション・セキュリティの概要」を参照してください。

特定のアクションは、資格証明ストアに登録される資格証明を必要とします。これらの資格証明は、アクション・ターゲットが、アクションの作成時またはターゲット・アクションの起動時に参照するために使用します。アクション用に追加する資格証明の詳細は、第5.5項「アクション・フレームワークで使用する資格証明の追加および保守」を参照してください。

5.2.1 アクション・タイプ別の構成チェックリスト

この項では、各アクション・タイプを使用するために実施する必要のある構成について要約します。表5-2「アクション・タイプ別構成要件」に、アクション・タイプおよび必要となる構成の一覧を示します。各列の説明は次のとおりです。

- 第1列は、Oracle BI EEインタフェースで表示される各アクション・タイプの名前です。

- 第2列は、Oracle BI EEプレゼンテーション・サービスのアクション・メニューにアクション・タイプを表示する場合に構成ファイルのエントリが必要となるかどうかを示します。

- 第3列には、Webフロントエンドでアクション・ターゲットのリストを参照できるようにするために、レジストリのエントリを構成ファイルに追加することができるかどうかを示します。

- 第4列には、資格証明ストアで追加の資格証明が必要となるかどうかを示します。

- 第5列には、様々なセキュリティ・ポリシーを実装できる(したがって、ポリシー・ファイルと、場合によっては追加のキーストア情報を必要とする)アクション・タイプを示します。

表5-2 アクション・タイプ別構成要件

アクション・タイプ

構成エントリの必要性

レジストリのサポート

追加資格証明の必要性

ポリシーの有効化

BIコンテンツにナビゲート

不要

なし(デフォルトで有効化されているナビゲーション・ターゲットを参照する)

不要

不要

Webページにナビゲート

不要

不要

不要

不要

EPMコンテンツにナビゲート

必要(レジストリ)

あり(必須)

必要

不要

E-Business Suiteにナビゲート

必要

不要

不要(Oracle E-Business Suiteのセキュリティとの統合が必要)

不要

Siebel CRMにナビゲート

必要

不要

不要(Oracle Siebel CRMとの統合が必要)

不要

Webサービスの起動

不要

あり(オプション)

不要(オプション)

必要

Javaメソッド(EJB)の起動

必要(レジストリ)

あり(必須)

必要

不要

ブラウザ・スクリプトの起動

不要

なし(デフォルトで有効化されているナビゲーション・ターゲットを参照する)

不要

不要

HTTPリクエストの起動

不要

不要

不要

不要

サーバー・スクリプトの起動

不要

不要

不要

不要

エージェントの起動

不要

不要

不要

不要

Javaジョブ

不要

不要

不要

不要

5.2.2 ターゲットの概要

すべてのアクションにはターゲットが必要です。ターゲットとは、何かのナビゲート先、あるいは、起動する操作、関数またはプロセス を指します。アクションを作成する前に、アクションに対するターゲットが準備されているか確認する必要があります。たとえば「Webページにナビゲート」アクションに対してターゲットのURLを使用できるようにしておき、「Webサービスの起動」アクションに対してはターゲットのWebサービスを配置しておく必要があります。

一部のアクション・タイプのターゲットはOracle Business Intelligenceシステム内にありますが(「BIコンテンツにナビゲート」など)、その他のアクション・タイプは、主に外部システムにある機能の起動やコンテンツへのナビゲートをターゲットとします(「Javaメソッドの起動」など)。いずれの場合も、アクションを作成するプロセスでは、アクションで使用する適切なターゲットの存在が前提となります。

たとえば、コンテンツ・デザイナがダッシュボードを作成していると仮定します。このダッシュボードには、ユーザーが会議室を予約する際にクリックするアクションが必要です。このタスクを実行するには、Oracle JDeveloperを使用して、bookRoomという名前の操作を含むRoom Booking Serviceという名前のWebサービスを作成し、デプロイできます。これが、アクションから起動されるターゲットWebサービスの操作です。Webサービスの作成とデプロイが終わると、コンテンツ・デザイナが「Webサービスの起動」アクションを作成できるようになります。

5.3 アクション・フレームワークの構成

Oracle BI EEのインストールでは、ActionFrameworkConfig.xmlという名前の構成ファイルを使用します。この構成ファイルを手動で編集し、アクション・フレームワークの動作方法を必要に合せて指定します。この構成ファイルは、デフォルトでは次の場所にあります。

<Oracle Middleware Home>\user_projects\domains\bifoundation_domain\config\fmwconfig\biinstances\coreapplication

構成ファイルは、いくつかの要素からなります。各要素を、表5-3 「アクション・フレームワークの構成要素」で説明します。

表5-3 アクション・フレームワークの構成要素

要素名

説明

location-alias

固定URLではなくロケーション・エイリアスでアクションが参照できるようにするために使用します。エイリアスを設定することで、テスト・システムおよび本番システム間の移行が容易になります。この要素の詳細は、第5.3.1項「エイリアス」を参照してください。

registry

Webサービス、EJBなどのための事前構成済レジストリに関する情報を指定するために使用します。これによりアクションの一連のターゲットを事前に定義します。この要素の詳細は、第5.3.2「レジストリ」を参照してください。

content-type

レジストリが返す情報のコンテンツ・タイプに関する情報を指定するために使用します。この要素の詳細は、第5.3.3項「コンテンツ・タイプ」を参照してください。

account

ゲートウェイのアカウントに関する情報を指定するために使用します。また、アクション・ターゲットへの認証を行う際に使用します。この要素の詳細は、第5.3.4項「アカウント」を参照してください。

policy

Oracle Web Services Manager(OWSM)の場所に関する情報を指定するために使用します。この要素の詳細は、第5.3.5項「ポリシー」を参照してください。

proxy

WebサービスやURLにアクセスするためのプロキシ設定に関する情報を指定するために使用します。この要素の詳細は、第5.3.6項「プロキシ」を参照してください。

ebusinesssuiteconfig

カスタム・アクション「E-Business Suiteにナビゲート」をOracle BIプレゼンテーション・サービスのユーザー・インタフェース内で表示するかどうかを指定するために使用します。この要素の詳細は、第5.3.7項「ebusinesssuiteconfig」を参照してください。

siebelcrmconfig

カスタム・アクション「Siebel CRMにナビゲート」をOracle BIプレゼンテーション・サービスのユーザー・インタフェース内で表示するかどうかを指定するために使用します。この要素の詳細は、第5.3.8項「siebelcrmconfig」を参照してください。

サンプルのアクション構成ファイルは、付録A「サンプル・ファイル」にあります。この付録に含まれるサンプルをこの項の情報と併せて使用することで、アクションの様々な構成方法を理解できます。

構成ファイルを修正した後、Oracle BI EE環境をホストしているWebLogic Serverの管理対象サーバーを再起動する必要があります。WebLogic Serverの管理対象サーバーの再起動方法に関する一般情報については、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionシステム管理者ガイド』の管理対象サーバーの実行および起動の確認に関する項を参照してください。

5.3.1 エイリアス

この項では、location-alias要素について説明します。ロケーション・エイリアスは、アクションが固定URLではなくエイリアスを参照するための置換メカニズムを提供します。エイリアスは、テスト・システムと本番システムを切り替える場合、役に立ちます。alias要素には、0個以上のlocation-alias要素を含めることが可能です。次の例を参考にしてください。

<location-alias>
<alias>webservicehost</alias>
<actual>myserver.mycompany.com:7001</actual>
</location-alias>

Oracle BI EEユーザーは、この例のwebservicehostというエイリアスに基づいて、次に示すWSDLによってターゲットWebサービスを起動するアクションを作成することができます。

http://msyserver.mycompany.com:7001/MyWebService/myservice.wsdl

カタログに保存されるアクションは、このWSDLへの参照を次のような形式で格納します。

http://@[webservicehost]/MyWebService/myservice.wsdl

このアクションが起動されると、アクション・フレームワークは実際の値のかわりにエイリアスを使用してサービスを起動します。

管理者はlocation-alias要素内のactual要素の値を後から変更することができ、そのため保存されたアクションは、更新せずに別のURLを参照することができます。

エイリアスでは、サーバー・パスおよびアプリケーション・パスを参照することができます。したがって、次に示す例も有効です。エイリアスには、ターゲットWSDLへのフルパスは指定できません。

<location-alias>
<alias>webservicehost</alias>
<actual>myserver.mycompany.com:7001/MyWebService/</actual>
</location-alias>

5.3.2 レジストリ

この項では、registry要素について説明します。レジストリは、アクション・フレームワークがどのようにアクション・ターゲットの参照可能なライブラリにアクセスするかを定義します。アクション・タイプと、それらの構成要件の詳細は、第5.2項「アクション・フレームワーク構成の概要」を参照してください。

レジストリ定義を作成すると、次に示すアクション・タイプをサポートできます。

- Oracle Hyperion Enterprise Performance Management(EPM)コンテンツにナビゲート

- Webサービスの起動

- Javaメソッド(EJB)の起動

5.3.2.1 「EPMコンテンツにナビゲート」アクション・タイプ・レジストリの例

Hyperionレジストリは、標準のregistry要素以外の追加要素を含みません。location要素を使用して、問合せ先のHyperionのURLを定義する必要があります。Hyperionのターゲットへのアクセスに使用するアカウントを指定する必要があります。次の例は、EPMコンテンツ・アクション・タイプ用のエントリです。各要素の説明については、表5-4「レジストリ・エントリの各要素および説明」を参照してください。

<registry>
<id>HDPreg</id>
<name>Hyperion Directory Provider</name>
<content-type>
<typename>epm</typename>
<displayname>Hyperion Applications</displayname>
<actionType>URLActionType</actionType>
</content-type>
<provider-class>oracle.bi.action.registry.epm.HDPRegistry
</provider-class>
<description>Hyperion Financial Reports Registry</description>
<location>
<path>http://epms.mycompany.com:1901/workspace/browse/listXML</path>
</location>
<service-access>
<account>EPM</account>
</service-access>
</registry>

5.3.2.2 「Javaメソッドの起動」アクション・タイプ・レジストリの例

次の例は、JavaメソッドのEJBレジストリ用のエントリです。custom-config要素に埋め込まれているejb-targets要素内で、EJBをホストするアプリケーション・サーバーおよびサーバーからレジストリに従って公開されるEJBについて、EJBレジストリが具体的に記述されています。

各要素の説明については、表5-4「レジストリ・エントリの各要素および説明」を参照してください。

<registry>
<id>reg03</id>
<name>Sample EJBs</name>
<content-type>java</content-type>
<provider-class>oracle.bi.action.registry.java.EJBRegistry</provider-class>
<description>Custom Java classes which can be invoked as action
targets</description>
<location>
<path/>
</location>
<custom-config>
<ejb-targets>
<appserver>
<context-factory>weblogic.jndi.WLInitialContextFactory
</context-factory>
<jndi-url>t3://localhost:9704</jndi-url>
<server-name>localhost</server-name>
<account>WLSJNDI</account>
<ejb-exclude>mgmt</ejb-exclude>
<ejb-exclude>PopulationServiceBean</ejb-exclude>
</appserver>
<ejb-app>
<server>localhost</server>
<app-context>ActionSamplesEJB</app-context>
</ejb-app>
</ejb-targets>
</custom-config>
</registry>

5.3.2.3 「Webサービスの起動」アクション・タイプ・レジストリの例

次の例は、WebサービスのWSILレジストリ用のエントリです。各要素の説明については、表5-4「レジストリ・エントリの各要素および説明」を参照してください。

<registry>
<id>reg1</id>
<name>Sample Web Services</name>
<content-type>webservices</content-type>
<provider-class>oracle.bi.action.registry.wsil.WSILRegistry</provider-class>
<description></description>
<location>
<path>http://localhost:9704/ActionSamples/inspection.wsil</path>
</location>
<service-access>
<path>/Sample Web Services/Rating Service</path>
<policy>SAMLPolicy</policy>
<propagateIdentity>true</propagateIdentity>
</service-access>
<service-access>
<path>/Sample Web Services/Customer Rating Service</path>
<account>PayrollUser</account>
<policy>userNamePolicy</policy>
<propagateIdentity>false</propagateIdentity>
</service-access>
</registry>

5.3.2.4 registry要素の説明

表5-4「レジストリ・エントリの各要素および説明」に、各registry要素とその説明を示します。

表5-4 レジストリ・エントリの各要素および説明

要素

説明

registry

レジストリ定義を包含する最上位の要素です。

id

この要素は、各レジストリに対して一意に指定する必要のある内部識別子を保持します。

name

レジストリの一覧を表示する際にActionRegistryServiceによって使用される表示名です。この要素で指定した名前は、このレジストリ内のどのターゲットに対してもルート・パスとして使用されます。

content-type

Oracleが提供する値のみ使用できます。この要素はcontent-typeを参照します。このcontent-typeは、アクション・フレームワーク構成ファイル内で定義されている別の要素です。この要素で指定可能なコンテンツ・タイプの詳細は、第5.3.3項「コンテンツ・タイプ」を参照してください。

この要素でEPMを指定する場合は、<typename>、<displayname>および<actionType>サブ要素を追加する必要があります。この要素を正しく入力しないと、Oracle BI Presentation Servicesのユーザー・インタフェースに「EPMコンテンツにナビゲート」アクション・タイプが表示されません。この要素をEPM用に適切に入力する方法の例については、第5.3.2.1項「「EPMコンテンツにナビゲート」アクション・タイプ・レジストリの例」を参照してください。

provider-class

Oracleが提供する値のみ使用できます。この要素に対する有効な値は、表5-5「provider-class要素の値」を参照してください。

description

この要素は、今後使用するために予約されています。

location

この要素は、別名の要素を含んでいる可能性のあるレジストリへのパスを指定します。例: WSILファイル。

service-access

この要素はオプションです。レジストリ定義内で、0個以上のservice-access要素を定義できます。

service-access要素は、レジストリにアクセスするために必要な認証、および、定められている場合はレジストリ内のサブパスを指定します。次の点に注意してください。

- registry要素にservice-access要素がない場合に、そのレジストリからサービスにアクセスすると、認証は使用されません。

- path要素を指定するservice-access要素は、レジストリ内の指定したパスの下に存在するサービスに対してのみ、account要素を適用します。

- account要素で定義されているアカウントを参照するaccount要素を1つだけ持つservice-access要素がregistry要素に含まれている場合、そのアカウントはレジストリ内のすべてのサービスにアクセスするために使用されますが、サービスは特定のパスに基づいたservice-access要素で指定されていないものに限られます。

path

この要素はオプションです。この要素はservice-access要素内に定義し、レジストリに含まれるサービスのサブセットへのパスを指定します。このパスは物理的な位置ではありません。新しいアクションを作成する場合は、レジストリ名でパスの階層を開始し、特定のアクション・ターゲットまでノードを拡張することで、ユーザー・インタフェース内で参照できます。

account

この要素はオプションです。この要素はservice-access要素内で定義され、構成ファイル内の他の場所で定義されているaccount要素のインスタンスを参照します。

account要素を1つだけ持つservice-access要素がregistry要素に含まれている場合、そのアカウントはレジストリ内のすべてのサービスにアクセスするために使用されますが、サービスは特定のパスに基づいたservice-access要素で指定されていないものに限られます。

webservicesレジストリについては、propagateIdentity要素の値がfalseの場合、ターゲット・アクションを起動するために、参照するアカウントに対して保持される資格証明がアクション・フレームワークによって使用されます。

EPMレジストリについては、EPMコンテンツを参照するために、アカウントに対して保持された資格証明がアクション・フレームワークによって使用されます。

policy

この要素はオプションです。この要素は、webservicesレジストリに対してのみ使用します。この要素はservice-access要素内で定義し、構成ファイル内の他の場所にあるポリシー・セクション内で定義されたポリシーを参照します。この要素は、WSセキュリティ・ポリシーを定義しているターゲットWebサービスにアクセスする場合に必要です。

この方法でセキュリティ設定済のWebサービスを起動する場合、OWSMを正しく構成してアクションを使用する必要があります。詳細は、第5.5.3項「Oracle Web Services Managerの構成」を参照してください。

propogateIdentity

この要素は、Webサービス・レジストリに対してのみ使用します。policy要素を設定する場合は、この要素を必ず設定してください。この要素はservice-access要素内で定義し、trueまたはfalseを設定します。

trueの値が有効なのは、IDをアサートするポリシー(たとえばSAMLベース・ポリシー)と併用し、最初にアクションを起動したユーザーのIDを伝搬できるようにする場合です。propagateIdentity要素をtrueに設定すると、account要素は不要となるため、かわりにターゲットWebサービスの起動には、アクションを起動(たとえばOracle BI Presentation Servicesから、または、スケジューラで実行)したユーザーのIDが使用されます。

この要素をtrueに設定し、ユーザー名/パスワード・トークン・ポリシーと併用する方法は、サポートされていません。

custom-config

この要素は、Javaレジストリに対してのみ使用します。この要素は、ターゲット・アプリケーション・サーバー上のEJBへのアクセス方法を指定するために使用します。

ejb-targets

この要素は、Javaレジストリに対してのみ使用します。この要素は、EJBがデプロイされるアプリケーション・サーバーをappserver要素内で定義します。また、指定した公開用のappserveにあるEJBで構成された複数のJ2EEアプリケーションをejb-app要素内で定義します。

appserver

この要素は、Javaレジストリに対してのみ使用します。この要素はejb-target要素内で記述され、EJBをデプロイするアプリケーション・サーバーに接続するための接続情報および認証情報を定義します。この要素は次の各要素で構成されます。

- context-factory - この要素には、アクション・フレームワークのWebサービスがデプロイされるアプリケーション・サーバーへのJNDIルックアップを実行する際に使用するクラス名を指定します。この要素にはweblogic.jndi.WLInitialContextFactoryを設定する必要があります。

- jndi-url - この要素には、JNDIルックアップで使用されるURLを指定します。このURLは、ターゲットEJBをホストするアプリケーション・サーバー上のJNDIディレクトリを問い合せる際に使用します。

- server-name - この要素には、このappserver要素を逆参照する際に内部で使用される名前を指定します。この名前は、次に示すejb-app要素のserver要素内で定義されます。

- account - この要素には、構成ファイル内の別の場所で定義されるアカウント名を指定します。この要素には、ターゲットEJBをホストしているアプリケーション・サーバー上のJNDIディレクトリを問い合せるために十分な権限を持つ資格証明を指定する必要があります。

- ejb-exclude - この要素は、既存のアプリケーションまたはアプリケーション・サーバーから、EJBまはたアプリケーションを除外するために使用します。EJBレジストリが、JNDI階層内でこの値との一致を検出すると、JNDIツリーで検出された分岐より下方に向かうEJBの検索は行われません。

ejb-app

この要素は、Javaレジストリにのみ使用します。この要素は、EJBで構成される複数のJ2EEアプリケーションを参照します。この要素は次の要素で構成されます。

- server - この要素の値は、appserver要素内で定義されたserver-name要素の値と一致する必要があります。

- app-context - この要素には、ターゲットEJBがデプロイされるアプリケーション・コンテキストを指定します。

5.3.2.5 provider-class要素で有効な値

表5-5「provider-class要素の値」に、provider-class要素に対して有効な値を示します。provider-class要素の詳細は、表5-4「レジストリ・エントリの各要素および説明」を参照してください。

表5-5 provider-class要素の値

関連アクションタイプ

コンテンツ・タイプ

SPIクラス

EPMコンテンツにナビゲート

EPM

oracle.bi.action.registry.epm.HDPRegistry

Javaメソッド(EJB)の起動

Java

oracle.bi.action.registry.java.EJBRegistry

Webサービスの起動

Webサービス

oracle.bi.action.registry.wsil.WSILRegistry

5.3.3 コンテンツ・タイプ

この項では、content-type要素について説明します。各content-type要素は、レジストリが接続しているサービスの種類に関するメタ情報を提供します。インストール時に設定したコンテンツ・タイプは変更できません。次の例で示すコンテンツ・タイプのみを使用できます。

<content-types>
<content-type>
<typename>webservices</typename>
<displayname>Web Services and BPEL Processes</displayname>
<actionType>WebServiceActionType</actionType>
</content-type>
<content-type>
<typename>epm</typename>
<displayname>Hyperion Applications</displayname>
<actionType>URLActionType</actionType>
</content-type>
<content-type>
<typename>misc</typename>
<displayname>Mixed Services</displayname>
<actionType>URLActionType</actionType>
</content-type>
<content-type>
<typename>java</typename>
<displayname>Java Actions</displayname>
<actionType>JavaActionType</actionType>
</content-type>
</content-types>

5.3.4 アカウント

この項では、account要素について説明します。account要素は、アクション・ターゲットに対する認証に使用されるゲートウェイのアカウントを定義します。そしてregistry要素のservice-access要素が、指定されたアカウントを参照します。レジストリ・セクションの詳細は、第5.3.2項「レジストリ」を参照してください。

次にアカウント・エントリの例を示します。表5-6「accountの各要素と説明」で、各要素について説明します。

<account>
<name>SAMLTest</name>
<description>Test SAML Account</description>
<adminonly>false</adminonly>
<credentialkey>SAMLTest</credentialkey>
</account>

5.3.4.1 accountの各要素と説明

表5-6「accountの各要素および説明」に、それぞれのaccount要素と説明を示します。格納する資格証明に関する詳細は、表5.5「アクション・フレームワークで使用する資格証明の追加および保守」を参照してください。

表5-6 accountの各要素および説明

要素

説明

name

この要素はレジストリのservice-access要素内、またはJavaレジストリ用のappserver要素内で参照する名前を指定します。各accountには、アクション・フレームワーク構成内で一意となる名前を付ける必要があります。

description

この要素は、今後使用するために予約されています。

adminonly

この要素は今後使用するために予約されています。この要素にはfalseを設定してください。

credentialkey

この要素は、Oracleの資格証明ストア・フレームワーク(CSF)内で資格証明を検索するために使用します。指定された鍵を含む資格証明の一式が、oracle.bi.actionsという資格証明マップにあるドメインの資格証明ストア内に存在する必要があります。このマップはデフォルトでは存在せず、作成する必要があることに注意してください。「アクション・フレームワークで使用する資格証明の追加および保守」を参照してください。

5.3.5 ポリシー

policy要素は、OWSMクライアント・ポリシー・ファイルの場所を記述するために使用します。OWSMクライアントポリシー・ファイルは、アクション・ターゲットとしてセキュリティ設定済のWebサービスにアクセスする場合に使用します。各policy要素には、ポリシーを参照するための名前を定義します。この名前は、service-access要素において、AESにポリシー・ファイルを適用するよう指定するための省略表現として使用する場合があります。このservice-access要素が対象とするアクション・ターゲットを起動する場合、指定したポリシー・ファイルが参照されます。

注意:

前述のようにセキュリティ設定済のWebサービスを起動するには、OWSMを構成してアクションを使用する必要があります。詳細は、第5.5.3項「Oracle Web Services Managerの構成」を参照してください。

次にpolicyエントリの例を示します。表5-7「policyの各要素および説明」で、それぞれの要素を説明します。

<policy>
<name>SAMLPolicy</name>
<policyfile>ActionsSAMLPolicy.xml</policyfile>
</policy>

5.3.5.1 policy要素の説明

表5-7「policyの各要素および説明」に、それぞれのpolicy要素とその説明を示します。

表5-7 policyの各要素および説明

要素

説明

name

この要素は、service-access要素内で参照される名前を指定します。各要素には、アクション・フレームワーク構成内で一意となる名前を付ける必要があります。service-access要素の詳細は、第5.3.2.4項「registry要素の説明」を参照してください。

policyfile

この要素を使用して、WSポリシーが適用されたWebサービスを、アクションから起動できるようにします。この要素には、ActionFrameworkConfig.xmlファイルと同じディレクトリに保存されたファイルの名前を指定します。このファイルは、Webサービス・アクションを実行する際にOWSMが適用するOWSMポリシーを含みます。Webサービス・アクションは、このポリシーを使用してレジストリ・パスから実行時に生成されます。service-access要素に関する詳細は、 第5.3.2.4項「registry要素の説明」を参照してください。

5.3.5.2 ポリシー・ファイル

ターゲットWebサービスの保護に使用する個別のクライアント・セキュリティ・ポリシーごとに、別々のアクション・フレームワークのポリシー・ファイルを手動で作成する必要があります。アクション・フレームワークのポリシー・ファイルには、OWSMで定義されたWebサービス・クライアント・ポリシーへの参照が含まれます。その参照では、ターゲットWebサービスの起動に使用する標準的なWSポリシーのPolicyReference要素を指定します。

このようなファイルを手動で作成するか、コピーする場合は、付録A「サンプル・ファイル」にあるサンプル・ファイルを使用します。

ファイルの作成またはコピーを行った後、それらをメインとなるActionFrameworkConfig.xmlと同じフォルダに保存します。

次に示すアクション・フレームワーク・ポリシー・ファイルの記述例を参照してください。

<?xml version="1.0" encoding="UTF-8"?>
<oracle-webservice-clients>
<webservice-client>
<port-info>
<policy-references>
<policy-reference uri="oracle/log_policy" category="management"/>
<policy-reference uri="oracle/wss11_saml_token_with_message_
protection_client_policy" category="security"/>
</policy-references>
</port-info>
</webservice-client>
</oracle-webservice-clients>

サービス・ポリシーによってセキュリティ設定済のWebサービスを起動するために、アクション・フレームワークのポリシー・ファイルでは、適切なクライアント・ポリシーを指し示す必要があります。

たとえば、ターゲットWebサービスが、「oracle/wss11_saml_token_with_message_protection_service_policy」というポリシーでセキュリティ設定されている場合、Webサービス・クライアント(つまりこの場合、アクション・フレームワーク)は対応するクライアント・ポリシーを使用してこのWebサービスを起動する必要があります。この例の場合、適切なクライアント・ポリシーは「oracle/wss11_saml_token_with_message_protection_client_policy」です。

アクション・フレームワークのポリシー・ファイル内において、categoryに「security」を設定したpolicy-reference uri要素に対して、適切なクライアント・ポリシー名を入力する必要があります。

OWSMで使用可能なサービスおよびクライアントWebサービス・ポリシーは、Fusion Middleware Controlにおいて、WebLogicドメインから「Webサービス」を選択してから「ポリシー」を選択することで表示できます。OWSMで使用可能な事前定義済ポリシーに関する詳細は、『Oracle Fusion Middleware Webサービスのためのセキュリティおよび管理者ガイド』の事前定義済ポリシーに関する項を参照してください。

5.3.6 プロキシ

proxy要素では、プロキシ設定を指定します。プロキシ設定は、アクション・フレームワークのWebサービスがデプロイされているWebLogicサーバーが存在するネットワークからは通常アクセスすることのできない、WebサービスやURLなどのアイテムにアクセスするために使用されます。

次にproxyエントリの例を示します。表5-8「proxyの各要素および説明」で、各要素について説明します。

<proxy>
<host>proxyserver.mycompany.com</host>
<port>80</port>
<userid>jsmith</userid>
<password>johsmi</password>
<nonProxyHosts>localhost|*.mycompany.com|10.1.10.78
</nonProxyHosts>
</proxy>

5.3.6.1 proxy要素の説明

表5-8「proxyの各要素および説明」に、それぞれのproxy要素とその説明を示します。

表5-8 proxyの各要素および説明

要素

説明

host

この要素では、プロキシ・サーバーが存在するサーバーのホスト名を指定します。

port

この要素では、プロキシ・サーバーのポート番号を指定します。

userid

password

これらの要素では、プロキシ・サーバー用のユーザーIDおよびパスワードを指定します。これらの要素は、認証を必要とするプロキシに対して使用します。認証を行わないプロキシに対しては、これらの要素は空白のままにします。

nonProxyHosts

この要素では、プロキシ対象から除外するサーバー、ドメイン名およびパターンを、パイプ文字(|)区切りのリストで指定することができます。システムが内部リソースへのアクセスにプロキシを使用しないようにするため、この要素を使用します。

5.3.7 ebusinesssuiteconfig

ebusinesssuiteconfig要素は、Oracle E-Business Suiteシステムが使用可能であることを示します。この要素が構成ファイルに存在する場合、Oracle BIプレゼンテーション・サービスは、ユーザーが「E-Business Suiteにナビゲート」アクションを作成できるようにするメニュー・オプションを表示します。ユーザーは、Oracle BIプレゼンテーション・サービスからE-Business Suiteにアクセスするために、適切な権限を持つ必要があります。この統合の構成に関する詳細は、第10章「Oracle E-Business Suiteセキュリティとの統合」を参照してください。

ebusinesssuiteconfigエントリの例を次に示します。

<ebusinesssuiteconfig>
<visible>true</visible>
</ebusinesssuiteconfig>

5.3.8 siebelcrmconfig

siebelcrmconfig要素は、Oracle Siebel CRMシステムが使用可能であることを示します。この要素が構成ファイルに存在する場合、Oracle BIプレゼンテーション・サービスは、ユーザーが「Siebel CRMにナビゲート」アクションを作成できるようにするメニュー・オプションを表示します。ユーザーは、Oracle BIプレゼンテーション・サービスからSiebel CRMにアクセスするために、適切な権限を持つ必要があります。

Oracle BIプレゼンテーション・サービスから「Siebel CRMにナビゲート」アクション・タイプを起動するには、Oracle BIサーバーとSiebel CRMサーバーを統合する必要があります。この統合の詳細は、第11章「Oracle Siebel CRMへのOracle BI EEの埋込み」を参照してください。

siebelcrmconfigエントリの例を次に示します。

<siebelcrmconfig>
<visible>true</visible>
</siebelcrmconfig>

5.4 アクション・セキュリティの概要

アクション・フレームワークおよびアクション・セキュリティは、資格証明、権限および許可によって決定されます。

5.4.1 Oracle BI EEの資格証明

資格証明は、セキュリティに関連する属性です。資格証明は、アクションなどOracle BI EEのリソースへのアクセスを要求するユーザーおよびシステムに対して、認証または権限付与を行うために使用します。アクション・ターゲットの参照またはアクションの起動に対して資格証明ストア内の資格証明を適用するため、アクション・フレームワーク内で1つ以上のレジストリを構成した場合(すなわち、ActionFrameworkConfig.xml内でaccount要素を指定した場合)、ActionFramworkConfig.xmlの各account要素と一致させるため資格証明ストアに資格証明を入力する必要があります。account要素によって参照されるすべての資格証明は、oracle.bi.actionsという資格証明マップに存在する必要があります。

たとえば、次のアカウントを構成ファイル内で定義する場合、JNDIUserに対する資格証明をoracle.bi.actionsと呼ばれるマップに入力する必要があります。

<account>
<name>WLSJNDI</name>
<description>Account used to access WLS JNDI.</description>
<adminonly>false</adminonly>
<credentialkey>JNDIUser</credentialkey>
</account>

資格証明ストアへの資格証明の入力方法の詳細は、第5.5項「アクション・フレームワークで使用する資格証明の追加および保守」を参照してください。

5.4.2 Oracle BI EEの権限

アクション権限は、Oracle BIプレゼンテーション・サービスにおいてアクションの機能にアクセスする必要のあるユーザーの権限を管理します。Oracle BI EE管理者は、特定のアプリケーション・ロール、個別ユーザーおよびカタログ・グループに対して、権限の付与または否認を行います。アクション権限は次のとおりです。

- ナビゲート・アクションの作成

- 起動アクションの作成

- 埋込みHTMLが含まれるアクションの保存

アクション権限の詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionセキュリティ・ガイド』のプレゼンテーション・サービス権限の管理に関する項を参照してください。

5.4.3 Oracle BIプレゼンテーション・カタログ・アクセス権

アクション・アクセス権は、アクションの所有者がユーザーまたはロールに対して行う権限付与です。アクセス権は、ユーザーがアクションで実行可能なタスク(アクションの実行など)を決定します。アクションの所有者がアクセス権をアクション・カタログ・オブジェクトに割り当てるには、Oracle BI EE管理者がアクションの所有者に対して必要な権限を付与する必要があります。アクセス権は次のとおりです。

- 削除

- 実行

- 読取り

- 書込み

カタログに格納されたアクション・オブジェクトへのアクセス権割当てに関する詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionユーザーズ・ガイド』のアクセス権の定義に関する項を参照してください。

5.5 アクション・フレームワークで使用する資格証明の追加および保守

この項では次の手順について説明します。

- 第5.5.1項「資格証明ストアへの資格証明マップおよび資格証明キーの追加」

- 第5.5.3項「Oracle Web Services Managerの構成」

- 第5.5.2項「デフォルト・キーストアの作成」

ActionFrameworkConfig.xmlファイル内の各account要素と整合するように、前述の手順を使用して資格証明を資格証明ストアに入力します。アクション・フレームワークでの資格証明の設定に関する詳細は、第5.4.1項「Oracle BI EEの資格証明」を参照してください。

5.5.1 資格証明ストアへの資格証明マップおよび資格証明キーの追加

次の手順に従って、資格証明ストアへの資格証明マップおよび資格証明キーの追加を行います。

1. Fusion Middleware Controlにログインします。デフォルトの場所は次のとおりです。

http://<your host name>:7001/em

2. ツリー・メニューを開いてドメインを表示し、ドメイン名を右クリックします。オプションのリストが表示されます。

3. リストから「セキュリティ」オプションを強調表示して、「資格証明」を選択します。「資格証明」ダイアログが表示されます。

4. 「マップの作成」をクリックし、oracle.bi.actionsという新しいマップを追加します。アクションが参照できるマップはoracle.bi.actionsのみであるため、アクションで使用するには、この名前でマップを作成し、これに資格証明を追加する必要があることに注意してください。

5. 「キーの作成」 をクリックし、作成したoracle.bi.actionsの資格証明マップに対するキーを追加します。

6. キーおよびマップを追加します。

5.5.1.1 資格証明マップおよび資格証明キーの作成例

次のaccount要素に注目してください。

<account>
<name>SecureTest</name>
<description>Test Secure Account</description>
<adminonly>false</adminonly>
<credentialkey>SecureTest</credentialkey>
</account>

このaccount要素がActionFrameworkConfig.xml内に存在し、次の条件が成立すると仮定します。

- このaccount要素は、ユーザー名/パスワード・ポリシーを使用してセキュリティ設定されたWebサービスを起動するために、レジストリから参照されます。

- propagateIdentity要素にfalseが設定されています。

account要素が前述の条件に該当する場合、ターゲットWebサービスの起動に対して有効なユーザー名とパスワードを入力する必要があります。SecureTestのcredentialkeyに対応するユーザー名とパスワードを、oracle.bi.actionsと呼ばれる資格証明マップに追加する必要があります。

5.5.2 デフォルト・キーストアの作成

次に示す手順を使用して、デフォルトの自己署名付きキーストアを作成します。デフォルト・キーストアの作成は、デモ用または開発用には適してますが、本番用には適していません。本番用には、keytoolのドキュメントに記載されているとおり、正しく署名された有効な証明書をインポートすることによって作成されたキーストアを使用する必要があります。署名または暗号を呼び出すセキュリティ・ポリシーに対しては、bifoundation_domain keystoreにも証明書を追加する必要があります。

keytoolおよびSolaris/Linuxの詳細は、次の場所にあるドキュメントを参照してください。

http://java.sun.com/javase/6/docs/technotes/tools/solaris/keytool.htm

keytoolおよびWindowsの詳細は、次の場所にあるドキュメントを参照してください。

http://java.sun.com/javase/6/docs/technotes/tools/windows/keytool.html

1. インストーラによってJDKのbinディレクトリがインストールされ、パスに表示されていることを確認します。例: <MIDDLEWARE_HOME>/jdk160_11/bin/。

2. <MIDDLEWARE_HOME>/user_projects/domains/bifoundation_domain/config/fmwconfigに移動して、コマンド・プロンプトを開きます。

3. 次のコマンドを実行してデフォルトのキーストアを作成します。

keytool -genkeypair -keyalg RSA -alias orakey -keypass orakey_passphrase -keystore default-keystore.jks -storepass store_passphrase -validity 3600

このコマンドは、default-keystore.jksという名前でキーストアを作成し(存在しない場合)、「orakey」というエイリアスおよび「orakey」というパスワードを持つ新しいプライベート・キー・エントリを追加します。エイリアス、パスワードおよびコマンドのストア・パスは変更できますが、それらは第5.5.3項「Oracle Web Services Managerの構成」の手順で資格証明ストアに追加したOWSMの資格証明と一致する必要があります。

4. プロンプトが表示されたら質問に答えます。所属の組織に関する情報を入力します。例を参照してください。この例では、weblogicというユーザーが、インストール時に作成されたシステム管理者ユーザーを参照しています。weblogic以外のユーザーを選択する場合は、かわりにそのユーザー名を入力します。

What is your first and last name?
[Unknown]:  weblogic
What is the name of your organizational unit?
[Unknown]:  J2EE Test Encryption Purposes Only
What is the name of your organization?
[Unknown]:  Oracle
What is the name of your City or Locality?
[Unknown]:  US
What is the name of your State or Province?
[Unknown]:  US
What is the two-letter country code for this unit?
[Unknown]:  US
Is CN=weblogic, OU=J2EE Test Encryption Purposes Only, O=Oracle, L=US, ST=US, C=US correct?
[no]:  yes

5. 次のコマンドを使用してキーストアの内容を表示し、キーストアが正しく生成されたことを確認します。

keytool -list -v -keystore default-keystore.jks -storepass welcome1

このコマンドを実行すると、次の例のような応答が返ります。

Keystore type: JKS
Keystore provider: SUN

Your keystore contains 1 entry

Alias name: orakey
Creation date: 16-Sep-2009
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=weblogic, OU=J2EE Test Encryption purposes Only, O=Oracle, L=US, ST=US
, C=US
Issuer: CN=weblogic, OU=J2EE Test Encryption purposes Only, O=Oracle, L=US, ST=U
S, C=US
Serial number: 4ab0ee4e
Valid from: Wed Sep 16 14:55:26 BST 2009 until: Fri Jul 26 14:55:26 BST 2019
Certificate fingerprints:
MD5:  84:0E:F4:F4:F3:30:0B:FF:4C:D4:E5:E6:BE:AE:64:DF
SHA1: E4:73:80:4D:96:A6:9F:DE:06:0E:82:3B:D3:18:86:57:FE:CD:C6:37
Signature algorithm name: SHA1withRSA
Version: 3

*******************************************
*******************************************

6. default-keystore.jksファイルが前述のパスに存在することを確認します。ファイルが存在しない場合、次のパスにコピーします。

<MIDDLEWARE_HOME>/user_projects/domains/bifoundation_domain/config/fmwconfig

5.5.3 Oracle Web Services Managerの構成

次の手順に従ってOracle Web Services Manager(WSM)を構成して、アクションと連動するようにします。この手順を実行することで、Webサービスを起動するアクションを作成可能にします。ターゲットのWebサービスには、WSセキュリティ・ポリシーが適用されます。

また、署名または暗号化を含むセキュリティ・ポリシーについては、キーストアに証明書を追加する必要があります。enc-csf-key、keystore-csf-key、およびsign-csf-keyの資格証明は、keytool実行時の引数keypassおよびstorepassで与えられる、対応するpassphrasesと一致する必要があります。

1. Fusion Middleware Control内で、oracle.wsm.securityという名前の資格証明マップを追加します。資格証明マップの追加方法については、第5.5.1項「資格証明ストアへの資格証明マップおよび資格証明キーの追加」を参照してください。

2. oracle.wsm.securityマップに次のキーを追加します。

表5-9 oracle.wsm.securityマップのキー

キー名

タイプ

ユーザー名

パスワード

basic.credentials

パスワード

weblogic*

welcome1

enc-csf-key

パスワード

orakey

welcome1

keystore-csf-key

パスワード

owsm

welcome1

sign-csf-key

パスワード

orakey

welcome1

* このユーザー名は、インストール時に作成されるシステム管理者ユーザーを参照します。「weblogic」以外のユーザー名を選択する場合は、そのユーザー名をかわりに入力します。同様に、インストール時にそのアカウントに対して指定したパスワードを使用する必要があります。

3. マップを保存します。

5.6 アクション用のターゲット機能

この項では、外部システム内にあるターゲット機能の設定に関して詳細に説明します。ビジネス・インテリジェンス・コンテンツに追加されるアクション・リンクは、これらのターゲット機能を起動します。この項で説明するアクション・タイプは次のとおりです。

- 第5.6.1項「EPMコンテンツにナビゲート」

- 第5.6.2項「E-Business Suiteにナビゲート」

- 第5.6.3項「Siebel CRMにナビゲート」

- 第5.6.4項「Webサービスの起動」

- 第5.6.6項「Invoke a Java Method (EJB)」

- 第5.6.7項「ブラウザ・スクリプトの起動」

- 第5.6.8項「サーバー・スクリプトの起動」

- 第5.6.9項「エージェントの起動」

- 第5.6.10項「Javaジョブ」

5.6.1 EPMコンテンツにナビゲート

このアクション・タイプは、ユーザーがEPMリポジトリ内のターゲット・コンテンツを参照し、アクションを作成して選択したコンテンツにナビゲートできるようにします。現在は、Oracle Hyperion Financial Reportingコンテンツへのナビゲートのみをサポートしています。

プレゼンテーション・サービスにおける、このアクション・タイプの作成に関する詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionユーザーズ・ガイド』のアクションの使用に関する項を参照してください。

5.6.1.1 このアクション・タイプに必要な前提条件

アクション・フレームワークがこのアクション・タイプを提供するためには、次のタスクが完了している必要があります。

- 構成ファイルのregistry要素が修正されている必要があります。これに必要な構成に関する詳細は、第5.3.2.1項「「EPMコンテンツにナビゲート」アクション・タイプ・レジストリの例」を参照してください。

- 資格証明ストアに資格証明を追加し、EPMコンテンツ機能の参照が可能となっている必要があります。詳細は、第5.4.1項「Oracle BI EEの資格証明」および第5.5項「アクション・フレームワークで使用する資格証明の追加および保守」を参照してください。

5.6.1.2 このアクション・タイプを起動した場合の処理

図5-1「「EPMコンテンツにナビゲート」の処理フロー」に、「EPMコンテンツにナビゲート」アクション・タイプの処理フローを示します。

図5-1「EPMコンテンツにナビゲート」の処理フロー

「図5-1 「EPMコンテンツにナビゲート」の処理フロー」の説明

5.6.2 E-Business Suiteにナビゲート

このアクション・タイプは、ユーザーによるOracle BI EEからOracle E-Business Suiteへのナビゲートを可能にします。Oracle BI EEセッションは、Oracle BI EEセッション変数にある現在のOracle E-Business Suiteの職責など、ユーザーのOracle E-Business Suiteセッションのコンテキストを保持します。

「Oracle E-Business Suiteにナビゲート」アクションには、次の2つのパラメータを使用します。

- Connection Pool - このパラメータには、ターゲットとなるOracle E-Business Suite環境に接続するBI接続プールの名前を、リポジトリで定義されているとおりに指定します。

- Function - このパラメータは、ナビゲート先のターゲットとなるOracle E-Business Suite機能の名前を指定します。Oracle E-Business Suite管理者は、ターゲット関数のIDを指定する必要があります。

「E-Business Suiteにナビゲート」アクションを起動するには、Oracle E-Business Suiteの接続プールに対するデータベース・リクエストを直接実行する権限を保有している必要があります。

正常に「E-Business Suiteにナビゲート」アクションを起動するには、ユーザーが現在使用しているOracle E-Business SuiteからターゲットのOracle E-Business関数にアクセス可能となっている必要があります。

このアクション・タイプで必要なセキュリティ統合の構成に関する詳細は、第10章「Oracle E-Business Suiteセキュリティの統合」を参照してください。

5.6.2.1 Oracle E-Business Suite Javaフォームへのコンテキスト受渡しの概要

Oracle Forms Builderを使用してターゲット・フォームをカスタマイズし、Oracle BI EEから移入される1つ以上のカスタム・パラメータを新たに追加することができます。このタスクの実行に関する詳細は、Oracle Forms DeveloperおよびOracle E-Business Suiteのドキュメントを参照してください。

Oracle E-Business Suiteのフォーム・パーソナライズを使用して、1つまたは複数の値を、それらの新しいカスタム・パラメータからOracle E-Business Suiteがトランザクション検索で使用するフォーム・フィールドにマップすることができます。このタスクの実行に関する詳細は、Oracle E-Business Suiteのドキュメントを参照してください。

ターゲットのOracle E-Business Suite関数にナビゲートするためにアクションを作成する場合、Oracle E-Business Suiteフォームに追加したカスタム・パラメータと同じ名前を持つ新規パラメータを、手動で追加する必要があります。追加する新規パラメータは、2つのデフォルト・パラメータ(Connection PoolおよびFunction)に対して追加されます。

パラメータを追加してアクションを起動した後、Oracle BI EEはパラメータをターゲットのOracle E-Business Suiteのフォームに受渡します。受渡されたパラメータ値は最終的にフォーム・パーソナライズが受け取り、要求されたターゲット・トランザクションの取得に使用されます。

5.6.3 Siebel CRMにナビゲート

このアクション・タイプは、ユーザーによるOracle BI EEからSiebel CRMアプリケーションのビュー(機会など)へのナビゲートを可能にします。このアクション・タイプを使用することで、ユーザーはSiebel CRMアプリケーションに埋め込まれたダッシュボードからCRMアプリケーションのビューに含まれるレコードにナビゲートすることが可能になります。

「Siebel CRMにナビゲート」アクションは、次の3つのパラメータを受取ります。

- View - このパラメータは、ナビゲート先のレコードを表示するビュー名を指定します。例: Opportunity List View。

- Applet - このパラメータは、ナビゲート先のレコードを表示するビュー内の親アプレット名を指定します。例: Opportunity List Applet。

- Pass Value - ナビゲート先のレコードの行番号を指定します。例: 3SIA-2O5VU。

ビュー名、アプレット名および行番号の決定に関する詳細は、Oracle Siebel CRMアプリケーションのドキュメントを参照してください。

「Siebel CRMにナビゲート」アクションを使用するには、Oracle Business IntelligenceをOracle Siebel CRMアプリケーションに埋め込む必要があります。詳細は、第11章「Oracle Siebel CRMへのOracle BI EEの埋込み」を参照してください。

5.6.4 Webサービスの起動

このアクション・タイプを使用すると、ターゲットWebサービスの操作を参照して、選択したコンテンツを起動するためのアクションを作成できます。アクション・フレームワークでWebサービスのコールがどのようにサポートされるかについては、第5.6.5項「Webサービスのコールでサポートされる機能」を参照してください。

プレゼンテーション・サービスにおける、このアクション・タイプの作成に関する詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionユーザーズ・ガイド』のアクションの使用に関する項を参照してください。

5.6.4.1 このアクション・タイプに必要な前提条件

アクション・フレームワークでこのアクション・タイプを使用し、「Webサービスの起動」アクションを作成するには、次のタスクが完了している必要があります。

- そのWebサービスのWSDLへのURLを使用するターゲットWebサービスが存在することを確認します。

- ユーザーに対してWebサービスへの参照を許可する場合、1つ以上のWSDLドキュメントを指し示すWSILドキュメントを追加しておく必要があります。WSILドキュメントは、URLを介してアクセス可能である必要があります。詳細は、 第5.6.4.2項「WSILドキュメントの例」を参照してください。

- Webサービス操作の参照またはセキュリティ・ポリシーの適用を行う場合、ターゲットのWSILドキュメントを参照するように構成ファイルのregistry要素を修正しておく必要があります。必要な構成の詳細は、第5.3.2.3項「「Webサービスの起動」アクション・タイプ・レジストリの例」を参照してください。

- Webサービスを起動するために、資格証明を資格証明ストアに追加する必要があるかを確認します。ターゲットWebサービスがセキュリティ設定済の場合、適切な構成を追加して、Webサービス操作の起動時に資格証明を渡す必要があります。適切なキーストアが必要となる場合もあります。詳細は、第5.4.1項「Oracle BI EEの資格証明」、第5.5項「アクション・フレームワークで使用する資格証明の追加および保守」,および第5.5.2項「デフォルト・キーストアの作成」を参照してください。

5.6.4.2 WSILドキュメントの例

WSILでは、Webサービスの説明の参照用にXML形式を定義します。これらの参照はWSILドキュメントに含まれ、Webサービスの説明(WSDLファイルなど)およびWebサービスの他の集合(別のWSILドキュメントまたはUDDIレジストリなど)を参照します。次のWSILの例を参考にしてください。

<?xml version="1.0" encoding="UTF-8"?>
<inspection xmlns="http://schemas.xmlsoap.org/ws/2001/10/inspection/">
<service>
<abstract>Web Service: Order Services</abstract>
<name>Order Service</name>
<description referencedNamespace="http://schemas.xmlsoap.org/
wsdl/"location="http://localhost:9704/ActionSamples/
OrderProcessPort?wsdl"/>
</service>
</inspection>

5.6.4.3 「Webサービスの起動」のトラブルシューティング・アクション

次の手順に従って、Webサービスを起動する場合のトラブルシューティングを行います。

1. JDeveloperのHTTPアナライザなどのテスト・クライアントから、ターゲットWebサービスが起動可能であることを確認します。

2. ターゲットWebサービスにセキュリティ・ポリシーが設定されている場合は、ActionFrameworkConfig.xmlファイルで、Action Execution Service(AES)が適切なクライアント・ポリシーを使用していることを確認します。

3. Fusion Middleware Controlに移動し、アクション・サービスのログおよび診断を確認します。ログ・ファイルにアクセスするには、Fusion Middleware Control上で「Business Intelligence」ナビゲーション・ツリーにアクセスし、coreapplicationsを選択してOracle BIインスタンスに関する情報を表示します。「診断」タブを選択し、「ログ・メッセージ」サブ・タブを選択します。「ログ・ファイルの表示/検索」エリア内で、「アクション・サービス・ログ」をクリックします。
次のエントリをstartWebLogic.cmd/*.shファイル内のJAVA_OPTIONS変数に追加することで、WebLogicに関する詳細なロギングが可能になります。JAVA_OPTIONS変数を修正した後、WebLogicを再起動する必要があります。

-Doracle.multitenant.enabled=true -Dweblogic.wsee.verbose=* -Dweblogic.log.RedirectStdoutToServerLogEnabled=true -Dweblogic.webservice.client.verbose=true"

4. ActionFrameworkConfig.xmlファイルに誤りや不足がないかを確認します。

5. 関連するポリシー・ファイルをよく確認し、それらが正しい場所に配置されていることを確認します。

6. ターゲットWebサービスがメッセージ保護または暗号化を含むセキュリティ・ポリシーを適用している場合は、資格証明ストア内に追加したOWSM資格証明をよく確認します。

5.6.4.4 このアクション・タイプを起動した場合の処理

図5-2「Webサービス起動時の処理フロー」に、Webサービス・アクション・タイプの処理フローを示します。

図5-2 Webサービス起動時の処理フロー

「図5-2 Webサービス起動時の処理フロー」の説明

5.6.5 Webサービスのコールでサポートされる機能

この項では、アクション・フレームワークがWebサービスを起動する際に使用する、サポート対象のテクノロジと制限事項について説明します。

5.6.5.1 トランスポート

次の項目に留意してください。

- アクション・フレームワークは、アクションによるWSDL参照およびWebサービスのコールの両方に対して、HTTPをサポートします。

- アクション・フレームワークは、WebサービスのWSDL参照に対して、HTTPSをサポートします。

- アクション・フレームワークは、AESおよびターゲットWebサービス間のセキュアなチャネル上でのメッセージ送信に対して、HTTPSをサポートします。ただし、AEServiceおよびターゲットWebサービス間での認証に対するデジタル証明書の使用については、アクション・フレームワークは現在サポートしていません。

5.6.5.2 メッセージング

次の項目に留意してください。

- アクション・フレームワークからコールされるWebサービスは、SOAPベースである必要があります。

- アクション・フレームワークは同期型のリクエスト/レスポンス・メッセージをサポートします。

- アクション・フレームワークはWSアドレスをサポートしていません。

5.6.5.3 SOAP

アクション・フレームワークは、SOAP 1.1および1.2のメッセージの送信および受信において、次のデータ・タイプをサポートします。

SOAPの送信メッセージでは、1つのパラメータに複数の値を入力できないことに注意してください。ベースとなるスキーマが、パラメータが(配列またはコレクションなど)複数の値を受け入れるように指定している場合も同様です。

- xsd:any

- xsd:base64Binary

- xsd:string

- xsd:date

- xsd:time

- xsd:dateTime

- xsd:double

- xsd:decimal

- xsd:int

- xsd:short

- xsd:long

- xsd:byte

- xsd:Boolean

- xsd:float

5.6.5.4 応答ドキュメント

SOAPの応答ドキュメントは、ユーザー・インタフェースで使用可能となっており、XPATH形式およびhtml形式を適用することが可能です。ドキュメントから、同じパラメータの検索により複数の出現を取り出すことができますが、各出現は特定のXPATHパラメータにマップされている必要があります。

5.6.5.5 サービスの説明

次の項目に留意してください。

- アクション・フレームワークはWSDLをサポートします。

- アクション・フレームワークは同期型のリクエスト/レスポンス・メッセージをサポートします。

5.6.5.6 検出サービス

次の項目に留意してください。

- アクション・フレームワークはWSILをサポートします。

- アクション・フレームワークは、現在UDDIをサポートしていません。

5.6.5.7 セキュリティ

アクション・フレームワークは、OWSMに使用可能なポリシーに基づくWSセキュリティをサポートします。

5.6.5.8 信頼できるメッセージングおよびトランザクション

アクション・フレームワークは現在、メッセージ配信の保証やトランザクションの整合性維持のためのメカニズムをサポートしていません。

5.6.6 Javaメソッド(EJB)の起動

このアクション・タイプによって、ユーザーはEnterprise Java Beans (EJB)にデプロイされたターゲットJavaメソッドを参照し、アクションを作成して選択したメソッドを起動することが可能になります。

プレゼンテーション・サービスにおける、このアクション・タイプの作成に関する詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionユーザーズ・ガイド』のアクションの使用に関する項を参照してください。

5.6.6.1 このアクション・タイプに必要な前提条件

アクション・フレームワークでこのアクション・タイプを使用し、Javaメソッド(EJB)の起動アクションを作成するには、次のタスクが完了している必要があります。

- ターゲットEJBをURLとともに、そのEJB用のJNDIロケーションに追加します。アクション・フレームワークでは、EJBがデフォルトのロケーション/ejbにデプロイされることが前提となる点に注意してください。

- 構成ファイルのregistry要素を、ターゲットEJBを参照するように変更します。これに必要な構成の詳細は、第5.3.2.2項「「Javaメソッドの起動」アクション・タイプ・レジストリの例」を参照してください。

- EJBメソッドを起動するために、資格証明ストアに資格証明を追加します。EJBメソッドの起動時に資格証明を渡すために、適切な構成を追加する必要があります。詳細は、第5.4.1項「Oracle BI EEの資格証明」および第5.5項「アクション・フレームワークで使用する資格証明の追加および保守」を参照してください。

5.6.6.2 EJB用のパラメータ

アクション・フレームワークは、公開されたJavaメソッドをEJBのリモート・インタフェースによって検索します。公開されたメソッドのパラメータは、アクション用のパラメータとなります。

EJBメソッドをデプロイする場合、Actionframework-common.jarにあるoracle.bi.action.annotation.OBIActionParameterクラスをインポートできますが、変更はできません。このクラスは、Oracle Business Intelligenceのインストールとともにデプロイされるため、アクションの作成時にこのクラスを使用して、アクション・フレームワークが使用するパラメータに注釈を付けることができます。

次の例は、ArchiveReportという名前のメソッドを公開するリモート・インタフェースを定義するためのコードを示しています。oracle.bi.action.annotation.OBIActionParameterのインポート文、および
@ OBIActionParameterというアノテーションを参考にしてください。このアノテーションによって、アクションの作成時に表示するパラメータ名およびプロンプト値を指定することができます。

package project1;
import java.io.FileNotFoundException;
import java.io.IOException;
import javax.activation.DataHandler;
import javax.ejb.Remote;
import oracle.bi.action.annotation.OBIActionParameter;

@Remote
public interface ArchiveReport {
String ArchiveReport( @OBIActionParameter (name = "Filename", prompt = "Enter filename location:")
String filename, @OBIActionParameter (name = "Analysis", prompt = "Report to Archive:") DataHandler document) throws
FileNotFoundException, IOException;
}

カタログからEJB内のJavaメソッドに、ドキュメントを送信することができます。ドキュメントに含まれるバイナリ・データは、特定のJavaデータ・タイプを使用して送信されます。そのため、分析をパラメータで受け取るJavaメソッドを作成する場合、そのJavaメソッドのパラメータに特定のJavaデータ・タイプ(javax.activation.DataHandler)を含める必要があります。アクション・フレームワークは、このデータ・タイプを、サポート済エクスポート・フォーマット(PDF、HTMLなど)のドキュメントのうちの1つが受信可能なデータ・タイプと認識します。

5.6.6.3 このアクション・タイプを起動した場合の処理

図5-3「Javaメソッド(EJB)の起動の処理フロー」に、Javaメソッド(EJB)の起動アクション・タイプの処理フローを示します。

図5-3 Javaメソッド(EJB)の起動の処理フロー

「図5-3 Javaメソッド(EJB)の起動の処理フロー」の説明

5.6.7 ブラウザ・スクリプトの起動

このアクション・タイプによって、ユーザーはターゲットのJavaScript関数を参照し、アクションを作成して選択した関数を起動することが可能になります。

プレゼンテーション・サービスにおける、このアクション・タイプの作成に関する詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionユーザーズ・ガイド』のアクションの使用に関する項を参照してください。

5.6.7.1 JavaScript関数

次の情報を使用すると、JavaScript関数の作成に便利です。

- アクションで「ブラウザ・スクリプトの起動」のコールに使用されるターゲットJavaScript関数は、次の場所にあるUserScripts.jsファイル内にあります。
MW_HOME/user_projects/domains/bifoundation_domain/servers/bi_server1/tmp/_WL_user/analytics_11.1.1.2.0/<installation dependent folder>/war/res/b_mozilla/actions/UserScripts.js

- サンプルのUserScript.jsファイルは、付録A「サンプル・ファイル」にあります。

- UserScripts.jsファイルを使用してユーザー定義のJavaScript関数を追加し、クライアント側のスクリプト・アクションから起動することができます。

- カスタム関数は、関数名が製品のコードと競合しないようにするとともに、アクションの作成時にアクション・フレームワークが関数を識別できるようにするために、USERSCRIPTというネームスペースを使用する必要があります。

- ユーザー定義のJavaScript関数をUserScripts.jsファイルに追加したら、プレゼンテーション・サーバーと、analyticsを実行しているWeblogic Serverを再起動し、ブラウザ・キャッシュをクリアする必要があります。

5.6.7.2 UserScript.js

UserScripts.jsファイル内のカスタム関数群は、アクション起動時にコールされる実際のコードを記述した関数からなります。またオプションで、アクション・フレームワークがアクションの作成時に関数を参照するとともに、関数のパラメータに値をマッピングするために使用する、関数に関連付けられた「publish」オブジェクトがファイルに含まれます。

5.6.7.2.1 JavaScriptの例1

この例では、アクションからのコールが可能なJavaScript関数、USERSCRIPT.example_displayParametersを示します。ターゲット関数は、1つのパラメータと名前付き(パラメータ名で索引付けされた)の値の配列を受け取ります。

/** This is an example function to display all parameters that are received
* @params {Array} aParams an array of values indexed by the parameter name
*/
USERSCRIPT.example_displayParameters = function(aParams)
{
var sArgs = "";
for( args in aParams )
{
var argName  = args;
var argValue = aParams[argName];

sArgs += "Parameter name: " + argName + "  Value: " + argValue;
sArgs += "\n";
}

alert( sArgs.length == 0 ? "No Parameters" : sArgs );
};

5.6.7.2.2 JavaScriptの例2

USERSCRIPT.parameterオブジェクトは、UserScripts.jsファイルの先頭で定義されます。このオブジェクトは、「ブラウザ・スクリプトの起動」アクションの作成時に使用するカスタムJavaScript関数内のパラメータを定義するため、アクション・フレームワークによって使用されます。各パラメータ・オブジェクトには、名前、アクション作成時にパラメータに対して表示されるテキストを保持するプロンプト値、および、デフォルト値が含まれます。

/** This is the parameter object you can create to supply default parameters on creation of Script action.
* See the 'displayParameters' example below for usage.
* @param {String} sName is the unique name of parameter.
* @param {String} sPrompt is the display text used to prompt for the parameter
value.
* @param {String} sValue (Optional) is the default value for the parameter.
*/
USERSCRIPT.parameter = function(sName, sPrompt, sValue)
{
this.name   = sName;
this.prompt = sPrompt;
this.value  = sValue;
};

この例では、アクション・フレームワークのためのパラメータを定義する「publish」オブジェクトの定義を示します。「publish」オブジェクトを含めUSERSCRIPTネームスペース内のすべての関数は、アクション作成時に参照して選択することが可能です。publishオブジェクトは、アクションによってターゲットJavaScript関数に渡されるパラメータの配列を定義します。関連付けられた「publish」オブジェクトを持たない関数もアクションから起動することは可能ですが、アクション・フレームワークはそのようなプライベート関数を参照することができません。その場合は、パラメータを手動でアクション定義に追加する必要があります。

USERSCRIPT.example_displayParameters.publish =
{
// The existence of this 'publish' object causes the 'USERSCRIPT.example_displayParameters' function to be
// shown when browing the available user script functions (during creation of a Script action).

// If you wish the Script function to have parameters automatically created on selection of the function,
// create a 'parameters' object as shown below.
// You can have any number of parameters, with each parameter requiring a
unique name, prompt and an
// optional value.
parameters :
[
new USERSCRIPT.parameter( 'p1', 'Enter value for Param 1', 'p1 default
value' ),
new USERSCRIPT.parameter( 'p2', 'Enter value for Param 2', 'p2 default
value' ),
new USERSCRIPT.parameter( 'p3', 'Enter value for Param 3'  )
]

// If no generated parameters are required, either create an empty array
//    parameters : []
// or don't declare the 'parameters' object at all.
};

5.6.7.3 このアクション・タイプを起動した場合の処理

図5-4「「ブラウザ・スクリプトの起動」の処理フロー」に、「ブラウザ・スクリプトの起動」アクション・タイプの処理フローを示します。

図5-4 「ブラウザ・スクリプトの起動」の処理フロー

「図5-4 「ブラウザ・スクリプトの起動」の処理フロー」の説明

5.6.8 サーバー・スクリプトの起動

このアクション・タイプは、現在のエージェントの完了時に、カスタム・スクリプトのファイル名を指定して(Microsoft Windows上で)実行できます。カスタム・スクリプトのタイプは、JavaScriptまたはVBScriptのどちらかが可能です。デフォルトでは、スクリプトは次のディレクトリに保存されます。

ORACLE_INSTANCE\bifoundation\OracleBISchedulerComponent\coreapplication_obischn\scripts\common

例:

D:\OBI11g\instances\instance1\bifoundation\OracleBISchedulerComponent\coreapplication_obisch1\scripts\common

ただし、管理者はこのデフォルト・パスを変更できます。このデフォルト・パスを制御する構成の設定の詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionシステム管理者ガイド』のエージェントの構成および管理に関する項、および『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionジョブ・スケジューリング・ガイド』のOracle BI Schedulerの導入に関する項を参照してください。

このアクション・タイプの設定時に、スクリプトに結果を渡すかどうか選択できるほかに、フォーマットを指定できます。追加パラメータを手動で追加することも可能です。渡されるコンテンツ・タイプ(条件付きリクエストまたは配信コンテンツのどちらか)に応じて、次のいずれかのフォーマットで結果を渡すことができます。

- PDF

- MHTML (電子メールで使用されるMIME HTML)

- プレーン・テキスト

- XML

- CSV

- Excel

- Powerpoint

5.6.8.1 このアクション・タイプに必要な前提条件

「サーバー・スクリプトの起動」アクションを作成するには、カスタム・スクリプト・ファイルがOracle BIデリバー・サーバー(スケジューラ)と同じサーバー上に存在しているかどうか確認する必要があります。スクリプトがデフォルトで保存されるディレクトリの詳細は、前述の項を参照してください。

5.6.8.2 このアクション・タイプを起動した場合の処理

図5-5「「サーバー・スクリプトの起動」の処理フロー」に、「サーバー・スクリプトの起動」アクション・タイプの処理フローを示します。

図5-5 「サーバー・スクリプトの起動」の処理フロー

「図5-5 「サーバー・スクリプトの起動」の処理フロー」の説明

5.6.9 エージェントの起動

エージェントは、データが条件を満たすかどうかに応じてアクションを実行できます。エージェント、エージェント作成手順、およびエージェントへのアクションの追加に関する概念的な詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionユーザーズ・ガイド』のコンテンツの配信に関する項およびアクションの使用に関する項を参照してください。

5.6.9.1 「エージェントの起動」アクションでのフィルタ機能

「エージェントの起動」アクションをエージェントに追加し、次の条件が該当する場合、親エージェントの結果から生成されたフィルタの値を使用して子エージェントが1回起動されます。

- 「エージェントの起動」アクションの追加先となる親エージェントは、自らのコンテンツを配信し、関連付けられたアクションを実行するかどうかを決定する際に条件を使用します。

- 「エージェントの起動」アクションは子エージェントを起動し、子エージェントもまた、自らのコンテンツを配信し、関連付けられたアクションを実行するかどうかを決定する際に条件を使用します。そして、その条件は、列プロンプトによって自身のデータをフィルタする分析に基づきます。

たとえば、次のものがあるとします:

- 地域、地区、市および合計(売上)の列を使用する分析に基づく条件を使用する親エージェント。

- 地域、地区、市および合計(売上)の列を使用し、地域と市をフィルタする分析に基づく条件を使用する子エージェント。

そして、親エージェントを実行した場合、次の結果が生成されるとします:

地域

地区

市

合計(売上)

中央

A

C1

100

西部

B

C2

200

子エージェントは、親エージェントの結果によって生成されたフィルタの値(地域=中央かつ市=C1、または、地域=西部かつ市=C2)を使用して、1回実行されます。

5.6.9.2 このアクション・タイプ起動時の処理

図5-6は、「エージェントの起動」アクション・タイプの処理フローを示しています。

図5-6 「エージェントの起動」の処理フロー

「図5-6 「エージェントの起動」の処理フロー」の説明

5.6.10 Javaジョブ

Oracle BI EE 10gでは、カスタムJavaプログラムをiBotの終了時にWindowsおよびUNIX上で実行するよう指定することができます。最新のOracle BI EEに移行する場合、これらのアクションは読取り専用のJavaジョブ・アクションにアップグレードされます。

新規アクションを作成してJavaメソッドを実行しようとする場合、Javaメソッド(EJB)を起動アクション・タイプを使用する必要があります。10gからアップグレードしたJavaジョブ・アクションを使用するためには、ターゲットJavaクラスを含むJARファイルを、Oracle BI JavaHostで指定されたとおり、デフォルトのユーザーJARファイル・パスにコピーする必要があります。ターゲットJavaクラスがOracle BI EEのクラスをインポートしている場合、11gのOracle BI EEのクラスをクラスパスで参照しながらターゲットJavaクラスを再コンパイルする必要があります。また、ターゲットJavaクラスの起動時に11gのOracle BI EEのクラスが使用可能であることを確認します。詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionジョブ・スケジューリング・ガイド』のOracle BIスケジューラの導入に関する項を参照してください。

5.6.10.1 このアクションタイプ起動時の処理

図5-7「「Javaジョブ」の処理フロー」に、「Javaジョブ」アクション・タイプの処理フローを示します。

図5-7 「Javaジョブ」の処理フロー

「図5-7 「Javaジョブ」の処理フロー」の説明

6 HTTPおよびJavaScriptを使用したOracle BIプレゼンテーション・サービスの企業環境への統合

この章では、Oracle BIプレゼンテーション・サービスを企業環境に統合するために使用するHTTPおよびJavaScriptのメソッドについて説明します。Go URL、Go URLを使用したSQLの発行とフィルタの受渡し方法、およびダッシュボードURLについて説明します。

この章の内容は次のとおりです。

- 第6.1項「Oracle Business Intelligenceの結果の外部ポータルまたは外部アプリケーションへの取込み」

- 第6.2項「外部ポータルまたは外部アプリケーションのダッシュボード・コンテンツの参照」

- 第6.3項「Oracle BIプレゼンテーション・サービスのGo URLを使用したSQLの発行とフィルタの受渡し」

- 第6.4項「Oracle Business Intelligenceサード・パーティSQLツールの統合例」

- 第6.5項「スクリプトを使用したダッシュボード・ページへのリンクの取得」

6.1 Oracle Business Intelligenceの結果の外部ポータルまたは外部アプリケーションへの取込み

この項では、Oracle BIプレゼンテーション・サービスGo URLを使用して、結果を外部のポータルや外部アプリケーションに取り込む方法を説明します。内容は次のとおりです。

- 第6.1.1項「Oracle BI Presentation ServicesのプロンプトURLについて」

- 第6.1.2項「Oracle BIプレゼンテーション・サービスのGo URLについて」

- 第6.2.2項「Oracle BIプレゼンテーション・サービスの基本のダッシュボードURLの構造」

- 第6.1.4項「Oracle BIプレゼンテーション・サービスのGo URLのオプション・パラメータ」

6.1.1 Oracle BI Presentation ServicesのプロンプトURLについて

Oracle BI Presentation ServicesのプロンプトURLコマンドを使用すると、ダッシュボード・ページへのパスと簡素化したダッシュボード・プロンプト表示を外部ポータルやアプリケーションに組み込むことができます。基本構文の詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionユーザーズ・ガイド』のプロンプト・リンクの概要に関する項を参照してください。

6.1.2 Oracle BIプレゼンテーション・サービスのGo URLについて

Oracle BIプレゼンテーション・サービスのGo URLコマンドは、特定のOracle Business Intelligenceの結果を外部ポータルや外部アプリケーションに取り込むために使用します。Go URLは、結果をお気に入りに追加したり、ダッシュボードや外部Webサイトへのリクエストにリンクを追加したりする場合に使用します。このコマンドの動作は、様々な書式やオプション引数を使用して制御できます。

攻撃者がインライン・フレーム内でアプリケーションを表示しないように、フレーム・バスティングを使用できます。このセキュリティメソッドの使用の詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionシステム管理者ガイド』の「攻撃からのOracle BI EEページの保護」を参照してください。

Go URLは、フォームとしてポストすることも、URLとして発行することもできます。URLの一部としてパラメータを発行する場合は、適切なエスケープが必要になります。スペースはプラス(+)記号で置き換える必要があります。たとえば、East Regionを値として渡すには、「East+Region」と入力します。

Oracle BIプレゼンテーション・サービス画面(ダッシュボードやHTMLの結果画面からコールするときは、URLの先頭に次の文字を使用する必要があります。

saw.dll?Go

同じWebサーバーの別の画面からコールする場合は、URLの先頭に次の文字を使用する必要があります。

/analytics/saw.dll?Go

別のサーバーの画面から参照する場合(電子メールで送信する場合など)は、URLの先頭に完全修飾されたサーバー名またはIPアドレスを使用する必要があります。

http://server_name_or_ip_address/analytics/saw.dll?Go

Go URLの起動時は、User-Agentストリング・ヘッダーが設定されている必要があります。

これらのコマンドをテストするには、ブラウザのアドレス・フィールドに完全修飾されたコマンドを入力します。

6.1.3 Oracle BIプレゼンテーション・サービスの基本のGo URLの構造

基本のGo URLコマンドには、実行するリクエストの完全なカタログ・パスを記述する必要があります。これにより、リクエストに定義されているデフォルトの結果ビューが返されます。

たとえば、次のGo URLコマンドを実行すると、SB2 という名前のリクエストに定義されているデフォルトの結果ビューが返されます。

saw.dll?Go&Path=%2Fshared%2FTest%2FSB2

6.1.4 Oracle BIプレゼンテーション・サービスのGo URLのオプション・パラメータ

Go URLの動作は、次の1つ以上のパラメータを追加することによって変更できます。無効なURLを指定した場合(たとえば、間違ったパラメータを入力した場合)、「ページが見つかりません」というエラーが詳細テキスト「HTTP 400 - Bad Request」とともにブラウザに表示されます。

注意:

パラメータの記述に使用されているSB2は、実行するリクエストの名前です。

- ユーザーIDとパスワード。リクエストにこの情報が指定されていない場合、ユーザーはユーザーIDとパスワードの入力を求められます。
書式は次のとおりです。uuuはユーザーID、pppはパスワードです。

&NQUser=uuu&NQPassword=ppp

例:

saw.dll?Go&Path=/Shared/Test/SB2&NQUser=user1&NQPassword=rock

このコマンドは、user1というユーザーIDでrockというパスワードを使用してログオンしてリクエストを実行します。

- リンク・オプション。結果にリンクが表示されます。
書式は次のとおりです。

&Options=x

xには、次の文字を1つ以上使用できます。

- m = リクエストを修正

- f = プリンタ優先

- d = Excelにダウンロード

- r = 結果のリフレッシュ

例:

saw.dll?Go&Path=/Shared/Test/SB2&Options=md
This displays results with the links Modify Request and Download.

- プリンタ優先。結果が印刷用フォーマットで表示されます。ページ・コントロール、ホット・リンクなどは表示されません。
書式は次のとおりです。

&Action=print

例:

saw.dll?Go&Path=/Shared/Test/SB2&Action=Print

- アプリケーション優先。結果がMicrosoft Excelなどのアプリケーション用フォーマットで表示されます。ページ・コントロール、ホット・リンクなどは表示されません。
書式は次のとおりです。

&Action=Extract

例:

saw.dll?Go&Path=/Shared/Test/SB2&Action=Extract

抽出処理もナビゲーション処理として機能するため((第6.3.2項「URL(ナビゲーション)を使用したOracle BIプレゼンテーション・サービスのGo URLへのフィルタの受渡し」を参照)、コールによって返される結果をフィルタできます。

- 個別のビュー。デフォルトの複合ビューではなく個別の結果ビューを表示します。
書式は次のとおりです。xxはビューの名前です。

saw.dll?Go&Path=/Shared/Test/SB2&ViewName=xx

例:

saw.dll?Go&Path=/Shared/Test/SB2&ViewName=Chart

リクエストにChartという名前のチャート・ビューが含まれていると仮定した場合、これによってチャート・ビューのみが表示されます。

- 特定のスタイル。指定されたスタイルで結果を表示します。スタイルが存在しない場合は、デフォルトが使用されます。
書式は次のとおりです。xxはスタイルの名前です。

saw.dll?Go&Path=/Shared/Test/SB2&Style=xx

例:

saw.dll?Go&Path=/Shared/Test/SB2&Style=Lime

このコマンドは、Limeという名前のスタイルを使用して結果を表示します。

- 結果フォーマット。結果のフォーマットを制御します。
書式は次のとおりです。xxはXML、HTMLまたはCSVです。

saw.dll?Go&Path=/Shared/Test/SB2&Format=xx

例:

saw.dll?Go&Path=/Shared/Test/SB2&Format=XML

このコマンドは、XML形式で結果を表示します。

6.1.4.1 すべてのレコードの表形式での表示

すべてのレコードを表形式で表示するには、次の2通りの方法があります。

- 「表」ビューの「1ページの行数」プロパティを10,000に設定し、基本のGoコマンドを使用します。この方法は、もう1つの方法よりも簡単です。

- 次のURLを発行します。

saw.dll?Go&Path=/users/Administrator/a&Action=Scroll&P5=-1&ViewID=o:go~r:report~v:compoundView!1~v:tableView!1

6.2 外部ポータルまたは外部アプリケーションのダッシュボード・コンテンツの参照

この項では、Oracle BIプレゼンテーション・サービス・ダッシュボードURLの使用方法を説明します。この項の内容は次のとおりです。

- Oracle BIプレゼンテーション・サービスのダッシュボードURLについて

- Oracle BIプレゼンテーション・サービスの基本のダッシュボードURLの構造

- Oracle BIプレゼンテーション・サービスのダッシュボードURLのオプション・コマンドとパラメータ

6.2.1 Oracle BIプレゼンテーション・サービスのダッシュボードURLについて

Oracle BIプレゼンテーション・サービスのダッシュボードURLは、外部ポータルまたは外部アプリケーションで、特定のダッシュボード・コンテンツを取り込んだり、参照したりする際に使用できます。このコマンドの動作は、様々な書式やオプション引数を使用して制御できます。

ダッシュボードURLコマンドは、フォームとしてポストすることも、URLとして発行することもできます。URLの一部としてパラメータを発行する場合は、適切なエスケープが必要となります。スペースはプラス(+)記号で置き換える必要があります。たとえば、値としてEast Regionを渡す場合は、「East+Region」と入力します。

Oracle BIプレゼンテーション・サービスの画面(ダッシュボードやHTML形式の結果ビューなど)からコールする場合は、URLの先頭に次の文字を使用する必要があります。

saw.dll?Dashboard

同じWebサーバーの別の画面からコールする場合は、URLの先頭に次の文字を使用する必要があります。

/analytics/saw.dll?Dashboard

別のサーバーの画面から参照する場合(電子メールで送信する場合など)は、URLの先頭に完全修飾されたサーバー名またはIPアドレスを使用する必要があります。

http://server_name_or_ip_address/analytics/saw.dll?Dashboard

これらのコマンドをテストするには、ブラウザのアドレス・フィールドに完全修飾されたバージョンを入力します。

6.2.2 Oracle BIプレゼンテーション・サービスの基本のダッシュボードURLの構造

基本のダッシュボードURLコマンドにはパラメータは不要です。このコマンドは、ユーザーを認証した後、ユーザーのデフォルト・ポータルを表示します。

基本のダッシュボードURLコマンドの書式は次のとおりです。

http://server_name_or_ip_address/analytics/saw.dll?Dashboard&PortalPath=path of your dashboard

PortalPathは、ダッシュボードのパスです。ユーザーがこのURLをクリックすると、ダッシュボードの最初のページが表示されます。

例

http://localhost:9704/analytics/saw.dll?Dashboard&PortalPath=/shared/Paint Demo/_portal/Paint Dashboard

オプションのPage引数を追加し、ユーザーがURLをクリックしたときに表示されるダッシュボード・ページを指定できます。ダッシュボード・ページ・タブのページ番号をこの引数の値として使用します。Page引数を含むURLの書式は次のとおりです。

http://server_name_or_ip_address/analytics/saw.dll?Dashboard&PortalPath=path of your dashboard&Page=page of your dashboard

例

http://localhost:9704/analytics/saw.dll?Dashboard&PortalPath=/shared/Paint Demo/_portal/Paint Dashboard&Page=page 3

6.2.3 Oracle BIプレゼンテーション・サービスのダッシュボードURLのオプション・コマンドとパラメータ

ダッシュボードURLには、オプションのコマンドとパラメータを追加できます。コマンドとパラメータの様々な使用例とその説明を次に示します。

ユーザーIDとパスワードの例

ユーザーIDとパスワードのパラメータを追加することにより、ダッシュボードURLコマンドの動作を変更できます。これらのパラメータを省略すると、ユーザーは、最後のログオン時にログオン情報を記憶するオプションを選択していないかぎり、ユーザーIDとパスワードの入力を求められます。セッションIDまたはチケットを使用している場合は、それをNQUserパラメータとして渡します。次のパラメータの記述に使用されているSB2は、実行のリクエストの名前です。

書式は次のとおりです。uuuはユーザーID、pppはパスワードです。

&NQUser=uuu&NQPassword=ppp

URLの例:

http://localhost:9704/analytics/saw.dll?Dashboard&PortalPath=/shared/Paint Demo/_portal/Paint Dashboard&NQUser=user1&NQPassword=rock

PortalPagesの例

PortalPagesコマンドを追加することにより、ダッシュボードURLコマンドの動作を変更できます。このコマンドは、共通ヘッダーを使用せずにダッシュボード・ページを開きます。このコマンドを使用して、指定したダッシュボード・ページにリンクやイメージをリンク先として作成できます。さらに、新しいブラウザ・ウィンドウにダッシュボード・ページを開くことができます。

書式は次のとおりです。xxxはカタログ・パスのポータル・ページ、yyyはダッシュボード・ページ名です。

PortalPages&PortalPath=xxx&Page=yyy&Done=close

コマンドの説明は次のとおりです。

- PortalPath - このパラメータには、ダッシュボードのカタログ・パス指定します。

- Page - (オプション)このパラメータには、ダッシュボードのページ名を指定します。

URLの例:

http://localhost:8080/analytics/saw.dll?PortalPages&PortalPath=%2fshared%2fdashboardfolder1%2f_portal%2fdefault&Page=page%202&Done=close

Goの例

Goコマンドを追加して、分析へのカタログ・パス指定することにより、ダッシュボードURLコマンドの動作を変更できます。このコマンドは、共通ヘッダーを使用せずに分析を開きます。このコマンドを使用して、指定した分析にリンクまたはイメージをリンク先として作成できます。さらに、新しいブラウザ・ウィンドウに分析を開くことができます。

書式は次のとおりです。パスはxxで、Doneはcloseです。

Go&Path=xxx&Done=close

パラメータの説明は次のとおりです。

- Path - このパラメータには、分析のカタログ・パスを指定します。

- Done - このパラメータは分析のパスには不要です。

URLの例:

http://localhost:8080/analytics/saw.dll?Go&Path=%2fusers%2fadministrator%2fdashboard_actionlink_report&Action=Prompt&Done=close

PortalGoの例

PortalGoパラメータを追加して、カタログ・パスを分析に指定することにより、ダッシュボードURLコマンドの動作を変更できます。このパラメータは、ダッシュボードで分析を開きます。このパラメータを使用して、分析にリンクまたはイメージをリンク先として作成できます。さらに、既存のブラウザ・ウィンドウに分析を開くことができます。

書式は次のとおりです。ポータル・パスはxxx、パスはyyy、Doneはzzzです。

PortalGo&PortalPath=xxx&Path=yyy&Done=zzz

パラメータの説明は次のとおりです。

- PortalPath - このパラメータはダッシュボードのカタログ・パスです。これは、分析が表示されるこのダッシュボード内になります。

- Path - このパラメータは、分析のカタログ・パスです。

- Done - このパラメータは、Returnリンクで使用する、戻る位置を指定します。

URLの例:

http://localhost:8080/analytics/saw.dll?PortalGo&PortalPath=%2fusers%
2fadministrator%2f_portal&Path=%2fusers%2fadministrator%2fSalesInMarket

6.3 Oracle BIプレゼンテーション・サービスのGo URLを使用したSQLの発行とフィルタの受渡し

この項では、Go URLコマンドを使用してSQLを発行する方法、およびナビゲーションに使用するフィルタを渡す方法を説明します。この項の内容は次のとおりです。

- 第6.3.1項「SQLコマンドの発行とフィルタの受渡し」

- 第6.3.2項「URL(ナビゲーション)を使用したOracle BIプレゼンテーション・サービスGo URLへのフィルタの受渡し」

6.3.1 SQLコマンドの発行とフィルタの受渡し

Go URLコマンドを使用して、Oracle Business Intelligence SQLを発行できます。この書式のGo URLのは、表形式の結果を返します。このコマンドにも、基本的なオプションである&Style=および&Options=を使用できます。

Oracle Business Intelligenceの簡易SQLを発行するには、Go URLへのパラメータとしてエスケープしたSQLを入力します。例:

saw.dll?Go&SQL=select+Region,Dollars+from+SupplierSales

FROM句は問い合せるサブジェクト・エリアの名前です。

また、IssueRawSQLコマンドを使用すると、Web処理をバイパスして、BIサーバーに直接SQLを発行することもできます。

6.3.2 URL(ナビゲーション)を使用したOracle BIプレゼンテーション・サービスGo URLへのフィルタの受渡し

Go URLは、フィルタなどのコンテキストを宛先リクエストに渡す場合にも使用できます。これには、コールにパラメータを追加します。受渡しの対象となるすべての列が、Is Promptedフィルタまたは特定のデフォルトのフィルタとともに宛先に設定されていることを確認する必要があります。

6.3.2.1 ナビゲーション・パラメータ

ナビゲーション・コマンドの基本構文は、第6.2.2項「Oracle BIプレゼンテーション・サービスの基本のダッシュボードURLの構造」で説明した構文と同じですが、さらにAction=Navigateパラメータを追加し、P1 - Pnのパラメータを必要な数だけ使用できます。

デフォルトでは、100個までパラメータを追加できます。ただし、パラメータの数は、instanceconfig.xmlにあるPrompts/MaxPromptedURLParamsの設定を変更することによって調整できます。詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionシステム管理者ガイド』のテキスト・エディタを使用した構成設定の更新に関する項を参照してください。

&Action=Navigate

&P0=n  nは、フィルタする列の数です。現在使用できる数は1～6です。

&P1=op  opは次の演算子のいずれかです。

演算子

意味

eq

等しい

neq

等しくない

lt

より小さい

gt

より大きい

ge

以上

le

以下

bwith

次で始まる

ewith

次で終わる

cany

(&P3内の値の)いずれかを含む

call

(&P3内の値の)すべてを含む

like

通常の%ワイルドカードのかわりに、%25を入力する必要があります。後続の例を参照してください。

top

&P3の値は1+nです。nは、先頭に表示する項目の数です。

bottom

&P3の値は1+nです。nは、末尾に表示する項目の数です。

bet

間にある(&P3には2つの値を指定します)

null

NULL(&P3は0になるか、省略されます)

nnul

NULLでない(&P3は0になるか、省略されます)

&P2=ttt.ccc

このパラメータでは、tttは表名、cccは列名です。表または列にスペースが含まれる場合は、二重引用符で囲む必要があります。スペースは、%20としてエスケープする必要があります(例: Measures."Dollar%20Sales)。

&P3=n+xxx+yyy+...+zzz

このパラメータでは、nは値の数、xxx、yyyおよびzzzは実際の値です。

注意: P3の値が数字で始まる場合は、値全体を引用符で囲む必要があります。例:

saw.dll?Go&Path=/Shared/Test/SB2&Action=Navigate&P0=1&P1=top&P2=Customers.Region&P3="7West"

注意:

&P1、&P2および&P3の設定は、&P0の値に応じて、&P4 - P6、&P7 - P9、&P10 - P12、&P13 - P15および&P16 - P18についても必要なだけ繰り返すことができます。

6.3.2.2 ナビゲーションの例

次の例は、EastおよびCentral地域のレコードを返します。

Saw.dll?Go&Path=/Shared/Test/SB2&Action=Navigate&P0=1&P1=eq&P2=Customers.Region&P3=2+Central+East

次の例は、名前の最初の文字がEで末尾がt(E....t)の地域のレコードを返します。

saw.dll?Go&Path=/Shared/Test/SB2&Action=Navigate&P0=1&P1=like&P2=Customers.Region&P3=1+E%25t

次の例は、販売額(ドル)を基準とした上位2つの地域を返します。

saw.dll?Go&Path=/Shared/Test/SB2&Action=Navigate&P0=1&P1=top&P2="Sales%20Facts".Dollars&P3=1+2

次の例は、引数の数が指定されていない構文を示しています。

saw.dll?Go&Path=/Shared/Test/SB2&Action=Navigate&P0=1&P1=top&P2=Customers.Region&P3=Central

注意:

引数の数の指定を省略できるのは、引数の値を1つしか使用しない場合のみです。

次の例は、販売額が2,000,000 - 2,500,000ドルに該当するレコードを返します。

saw.dll?Go&Path=/Shared/Test/SB2&Action=Navigate&P0=1&P1=top&P2="Sales%20Facts".Dollars&P3=2+2000000+2500000

次の例は、名前が文字Eで始まる地域のレコードを返します。

saw.dll?Go&Path=vate&P0=1&P1=bwith&P2=Customers.Region&P3=1+E

次の例は、名前に文字Eが含まれ、販売額が2000万ドルを上回っている地域のレコードを返します。

saw.dll?Go&Path=/Shared/Test/SB2&Action=Navigate&P0=2&P1=cany&P2=Customers.Region&P3=1+e&P4=gt&P5="Sales%20Facts".Dollars&P6=1+20000000

Oracle BI Presentation Servicesでは、現在、グラフ・ビュー、表ビュー、ピボット・テーブル・ビュー、HTMLビュー、外部アプリケーションおよびWebページからのナビゲーションがサポートされています。宛先の検索には、コンテキストを取得する列に定義されているフィルタを設定する必要があります。これには、特定のフィルタ(通常はIs Promptedフィルタ)を指定できます。宛先に適用されるのは、ナビゲーション・コールで具体的に参照されるTable.Column値だけでなく、対応するtable.columnsが宛先に設定されているソース・リクエストのすべてのフィルタです。したがって、ソースの適切なコンテキストを宛先に渡すことができます。

6.3.2.3 JavaScriptを使用したナビゲーション

ナビゲーションは、現在、列のカスタムのテキスト/日付フォーマッタを使用して実行できます。この主要概念は、ナビゲート元の列を検索に追加することです。その後、列のプロパティで「Custom Text Format」を選択し、提供されている2つのJavaScript関数のいずれかをコールするHTMLを入力します。この手法は、列のソートやカスタムJavaScript関数のコールなど、多くの処理を実行するために使用できます。

Oracle BIプレゼンテーション・サービスには、表ビューおよびピボット・ビューからナビゲートできる2つのJavaScript関数(GoNavおよびPortalNav)が含まれています。これらの関数はORACLE_HOME/bifoundation/web/app/res/b_mozilla/viewhelper.jsにあります。前者は、特定の検索へのナビゲーションを処理します。後者は、特定のダッシュボードへのナビゲーションを処理します。これらの構文について、ナビゲーションの実装に使用できるカスタム・テキスト・フォーマットの例とともに次に説明します。

注意:

スタイル・シートを使用してナビゲート可能なテキストの外観を制御するために、Oracle BIプレゼンテーション・サービスでは、class=Navで標準で使用します。

GoNav関数

function GoNav(event, sPath, sTbl, sCol, sVal, sTarget)

パラメータの内容は次のとおりです。

event = イベント・インジケータ

sPath = 宛先検索のカタログ・パス

sTbl = フィルタ対象の論理表名

sCol = フィルタ対象の論理列名

sVal = フィルタ処理の基準となる値

sTarget (オプション) = 新しいブラウザ・ウィンドウに結果を表示するには「_blank」と指定します。

GoNavコールのカスタム・テキスト・フォーマットの例

GoNavコールおよびPortalNavコールはHTML文に記述できます(引用符を含む)。

[html]"<font class=nav onclick=\"JavaScript:GoNav(event, '/shared/topaz/performance/transaction details','
Transaction','Quality','"@"');\">"@"</font>

表6-1はこの例の要素を説明しています。

表6-1 GoNavコールの要素の分析

要素

説明

[html]

Oracle BIプレゼンテーション・サービスに、後続のテキストをHTMLとして解釈するよう指示します。「より小さい」を示す文字(<)は、HTMLタグ内で使用する場合、二重引用符(")を前に付ける必要があります。

"<font

JavaScriptコールを添付できるHTMLタグ。<div>、<span>、<a>などを使用できます。

class=nav

HTMLタグのフォーマット設定に使用するCSSスタイル・クラス。

onclick=\"JavaScript:GoNav('event, /shared/topaz/performance/transaction details','Transaction','Quality','"@"');\"

JavaScript関数をコールするメソッド。ユーザーがこのHTMLタグの内容をクリックすると、JavaScript関数がコールされます。

>

フォント・タグの最後の文字。

"@"

Oracle BIプレゼンテーション・サービスに、アットマーク(@)を実際の列の値に置換するよう指示します。[html]を使用する場合、@記号は二重引用符(")で囲む必要があります。

</font>

<font>タグに対応する終了タグ。

次のGoNavの例は、このHTMLをダッシュボードに配置します。

<a href="javascript:GoNav(event, '/shared/topaz/performance/transaction details','Transaction','Quality','Some value');">Click here to navigate to Transaction Details with ''Some value'</a>

PortalNav関数

function PortalNav(event, sPortal,sTbl,sCol,sVal)

event = イベント・インジケータ

sPortal = 宛先ポータルのカタログ・パス

sTbl = フィルタ対象の論理表名

sCol = フィルタ対象の論理列名

sVal = フィルタ処理の基準となる値

PortalNavコールのカスタム・テキスト・フォーマットの例

引用符は必ず次の例と同じ位置に挿入してください。

"<font class=nav onclick=\"JavaScript:PortalNav(event, '/shared/topaz/_portal/transaction analysis','
Transaction','Type','"@"');\">"@"</font>"

6.3.2.4 HTMLの結果からのナビゲーション

この方法は、第6.3.2.3項「JavaScriptを使用したナビゲーション」で説明した方法と同じです。ただし、カスタム・フォーマッタを使用するのではなく、HTML構文に@記号にかわる静的な値を入力します。

6.4 Oracle Business Intelligenceとサード・パーティのSQLツールとの統合例

この項では、Microsoft Accessとの統合例を取り上げながら、サード・パーティのSQLツールをOracle Business Intelligenceに統合する際の要件について説明します。Oracle Business Intelligenceは企業データのアクセスと統合に使用するミドルウェア・プラットフォームとして設計されているため、一般的なレポート・ライターやビジネス・インテリジェンス・ツールはBIサーバーとネイティブに通信できます。

サード・パーティのSQLツールのほとんどは、クロス結合を避けるために、問合せ内に結合条件を記述する必要があります。クロス結合は、リクエストにWHERE句が使用されていない場合に発生し、それにより、結合に使用される表のデカルト積が作成されます。デカルト積のサイズは、1つ目の表の行数と2つ目の表の行数の積になります。

Microsoft AccessをBIサーバーに統合するには、BIサーバーの管理者がOracle BI管理ツールのプレゼンテーション・レイヤー内のキーを公開する必要があります。

6.4.1 サード・パーティのSQLツールの統合例

1. ビジネス・モデルとマッピング・レイヤーのキーをプレゼンテーション・レイヤーにドラッグ・アンド・ドロップし、リポジトリを保存します。

2. Microsoft Accessを開いて、「Blank Access Database」オプションを選択します。プロンプトが表示されたら、名前に「oracle-analytics.mdb」と入力し、「Create」をクリックします。

3. 新しいMicrosoft Accessデータベースが作成されたら、画面の空白部分を右クリックして、「Link Tables」を選択します。

4. 「Files of Type」ドロップダウン・リスト・ボックスで、「ODBC Databases」を選択します。
「Select a Source」ダイアログが表示され、データ・ソース名を入力するよう求められます。

5. 「Machine Data Source」タブをクリックし、Analytics_Web DNSを選択して、「OK」をクリックします。
Oracle BIサーバーにログインするよう要求されます。

6. ユーザーIDとパスワードを入力します。
「Import Objects」ダイアログ・ボックスが表示されます。

7. 「Select All」ボタンをクリックするか、Oracle Business Intelligenceから目的の論理表を選択します。
インポートの完了にはしばらく時間がかかる場合があります。

8. インポートが完了したら、画面の空白部分を右クリックして、「Relationships」を選択します。

1. 目的の表を追加し、ディメンション表(Period、Market、Product)からファクト表(Sales Measures)にキーをドラッグ・アンド・ドロップします。

2. Periodキーをperkey列の上にドラッグ・アンド・ドロップします。対応するキーごとにこの操作を繰り返して、結合を作成します。

これで、リクエストのテストと実行を行えるようになりました。

9. 「Queries」ボタンから「Create query in Design view」を選択します。

1. 「Markets」、「Products」および「Sales Facts」を選択します。

2. 「Region」、「Brand」、「Units」および「Dollars」をそれぞれ追加して「Run」をクリックします。

6.5 スクリプトを使用したダッシュボード・ページへのリンクの取得

ダッシュボード・ページのカスタム・スクリプトで、表6-2の説明にあるJavaScript関数を使用することによって、ダッシュボード・ページへのリンク(ブックマーク・リンクとプロンプト・リンクの両方)を取得できます。

注意:

これらのJavaScript関数が機能するようにするには、HardenXSS要素をfalseに設定する必要があります。詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionシステム管理者ガイド』のプレゼンテーション・サービスの詳細構成の変更に関する項を参照してください。

ブックマーク・リンクとプロンプト・リンクの詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionユーザーズ・ガイド』のダッシュボード・ページへのリンクの作成に関する項を参照してください。

表6-2 ダッシュボード・ページへのリンクを取得するJavaScript関数

JavaScript関数

説明

LinkToPage(bInlineDrill,bGetBookmarkOnly)

変数saw.bookmarkURLの値をブックマーク・リンクに設定します。

次のように引数を設定します。

- bInlineDrill - 「ページ・オプション」ボタンをページに表示する場合はtrueを設定し、表示しない場合はfalseを設定します。

- bGetBookmarkOnly - ブックマークURLがブラウザのアドレス・バーでリフレッシュされないようにするにはtrueを設定します。ブックマークURLがブラウザのアドレス・バーでリフレッシュされるようにするにはfalseを設定します(または省略します)。

GetPURL()

プロンプト・リンクを文字列として返します。

7 Oracle Business Intelligence Systems Management API

この章では、Oracle Business Intelligence Systems Management APIについて説明します。これにより開発者は、Oracle Business Intelligenceのシステム管理タスクをプログラムによって実行できるようになります。

この章の内容は次のとおりです。

- 第7.1項「Oracle Business Intelligence Systems Management APIについて」

7.1 Oracle Business Intelligence Systems Management APIについて

Oracle Business Intelligence Systems Management APIは、Business Intelligence JMX管理MBeanへのアクセスを可能にし、開発者がOracle Business Intelligenceのシステム管理タスクをプログラムによって実行できるようにするプログラミング・インタフェースです。BI Systems Management APIを使用して実行できるシステム管理タスクは、Fusion Middleware Controlを使用しても実行できます。

詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionシステム管理者ガイド』のBI Systems Management APIの導入に関する項を参照してください。

8 Oracle Business Intelligenceと他のクライアントとの統合

この章では、WindowsおよびUNIXプラットフォーム上のOracle BIサーバーに接続するためのODBC DSNの構成方法について説明します。

この章の内容は次のとおりです。

- 第8.1項「Oracle Business Intelligenceとの統合の概要」

- 第8.2項「データ・ソースとしてのOracle BIサーバーとの統合について」

- 第8.3項「ODBC準拠レベル」

- 第8.4項「Windows上のOracle BIサーバーに対するODBC DSNの構成」

- 第8.5項「LinuxまたはUNIX上のOracle BIサーバーに対するODBC DSNの構成」

8.1 Oracle Business Intelligenceとの統合の概要

Oracle BIサーバーには様々なODBC準拠の問合せおよびレポート・ツール、リモート管理ツール・クライアントなどのその他のクライアントを使用して接続できます。

注意:

Oracleでは、Oracle BIサーバーODBCインタフェースとサード・パーティ製のクライアント・ツールとの互換性の確認またはテストを通常行いません。サード・パーティー製のツールおよびOracle BIサーバーODBCインタフェースに関する個別の動作保証情報については、Oracle BI EEの動作保証ドキュメントを確認してください。動作保証ドキュメントの詳細は、「システム要件と動作要件」を参照してください。

リモート・クライアントで接続するには、リモート・クライアント・コンピュータでOracle BIサーバーのODBC DSNを構成し、そのDSNを使用して問合せツールからリポジトリに接続します。

「Oracle BIプレゼンテーション・サービス」クライアントもODBC DSNを使用してOracle BIサーバーに接続します。プレゼンテーション・サービスのデフォルトODBC DSNは、Oracle Business Intelligenceのインストール時に作成および構成されます。

プレゼンテーション・サービス・インスタンスと同じホスト上にある管理ツール・クライアントも、デフォルトDSNを使用してOracle BIサーバーに接続できます。または、管理ツールが使用する個別のDSNを作成できます。

クラスタ・コントローラの接続パラメータとデフォルトDSNのSSLパラメータは、Fusion Middleware Controlによって集中管理されています。これらのパラメータを更新しないでください。集中管理されているパラメータの更新を手動で試みた場合、これらの値は次にシステムが起動した際に上書きされます。

また、集中管理されているデフォルトDSNの名前を変えないでください。デフォルトDSNは、"coreapplication_OHid_number"のような名前を持ちます。id_numberは、インストールされたOracleホーム固有の番号です。

この章は、WindowsおよびUNIXプラットフォーム上でODBCを使用し、データ・ソースとしてのOracle BIサーバーと統合する方法を説明します。

8.2 データ・ソースとしてのOracle BIサーバーとの統合について

Open Database Connectivity (ODBC)は、データベースに接続するための業界標準インタフェースです。データ・ソース名(DSN)は、ODBCを経由して、特定のデータベースに特定のデータベース・ユーザーとして接続するための情報の保管に使用します。

Oracle BIサーバーのODBCドライバを使用してDSNを構成し、クラスタ・コントローラを介したクラスタ化Oracle BIサーバーのセットに接続したり、個別のOracle BIサーバーに接続したりします。構成したDSNは、任意のODBCに準拠した問合せおよびレポート・ツールで使用できます。

プレゼンテーション・レイヤーは、ツールのルールおよび表記規則と一貫性が保たれるようにビジネス・モデルのプレゼンテーションを構成し、Oracle BIサーバーの分析エンジンおよびデータの抽象化を活用できるようにします。これによって、複雑な集計および計算ルールを持つ列を、問合せやレポートに含めることが容易になります。また、企業が現在問合せやレポート・ツールを使用している場合、Oracle BIサーバーをデータ・ソースとして利用することによって、これらのツールの価値を高めるとともに、使用そのものを簡単にします。

注意:

非英語環境では、リモート・クライアントからOracle BIサーバーへの直接的なODBC接続を使用できます。ですが、「Oracle BIプレゼンテーション・サービス」で提供されている翻訳およびローカライゼーション・オプションは使用できません。そのかわり、Oracle BIサーバー・メタデータ(Oracle BIリポジトリ)に含まれる翻訳およびローカライゼーションは使用できます。たとえば、プレゼンテーション・レイヤーのメタデータ・オブジェクトがフランス語で定義されている場合、サード・パーティ・アプリケーションではフランス語で表示されます。

8.2.1 物理レイヤーへのリクエスト送信について

Oracle BIサーバー・クライアントは、すべてのSELECT問合せをSELECT_PHYSICAL問合せとして扱うOracle BIサーバーへの専用の物理接続を作成できます。SELECT_PHYSICAL問合せは、プレゼンテーション・レイヤーおよびビジネス・モデルとマッピング・レイヤーを無視し、メタデータ・リポジトリの物理レイヤーに対して直接オブジェクト問合せを行います。この直接接続をODBCクライアントで行うには、DSN設定で「リクエストを物理レイヤーに送信」を選択します。

単一のODBC接続は、プレゼンテーション・レイヤーと物理レイヤーの両方に問合せを送信できないことに注意してください。そのかわり、プレゼンテーション・レイヤーにリクエストを送信する通常の接続と、物理レイヤーにリクエストを送信するもう1つの接続を作成できます。

SELECT_PHYSICAL問合せに関する詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイド』のSELECT_PHYSICALの構文と使用上の注意に関する項を参照してください。

8.2.2 JDBCを使用したOracle BIサーバーとの統合について

ODBCを使用する以外に、JDBCを使用してOracle BIサーバーと統合できます。詳細は、bijdbc.jarファイルに含まれているREADME.TXTを参照してください。bijdbc.jarファイルは、次のディレクトリにあります。

ORACLE_HOME/bifoundation/jdbc

8.3 ODBC準拠レベル

Oracle BIサーバーは、次のクライアント・アプリケーションから受けるODBCコールをサポートしています。

- SQLAllocConnect

- SQLAllocEnv

- SQLAllocStmt

- SQLBindCol

- SQLCancel

- SQLColumns

- SQLConnect

- SQLDescribeCol

- SQLDisconnect

- SQLDriverConnect

- SQLError

- SQLExecDirect

- SQLExecute

- SQLExtendedFetch

- SQLFetch

- SQLFreeConnect

- SQLFreeEnv

- SQLFreeStmt

- SQLGetConnectOption

- SQLGetCursorName

- SQLGetData

- SQLGetFunctions

- SQLGetInfo

- SQLGetStmtOption

- SQLGetTypeInfo

- SQLColAttributes

- SQLNumResultCols

- SQLPrepare

- SQLRowCount

- SQLSetConnectOption

- SQLSetStmtOption

- SQL表

Oracle Business Intelligence ODBCは、静的、動的、前方検索、キーセット・ドリブンなどのカーソルによる全スクロール・カーソルをサポートします。Oracle Business Intelligence ODBCは、非同期および同期の処理と取消しもサポートします。

8.4 Windows上のOracle BIサーバーに対するODBC DSNの構成

この項では、Windows上のOracle BIサーバーのODBC DSNを作成し、リモート・クライアント・アクセスを可能にする方法を説明します。「Oracle BIサーバーDSNの構成」ウィザードを使用してODBC DSNを設定します。このODBC DSNは、Oracle BIサーバーを介してリポジトリに接続する際に使用します。

Oracle BIサーバーのODBCドライバ(BI管理ツールとともにインストールされる)は、インストールするBI管理ツールが何ビットかに応じて、32ビットまたは64ビットになります。32ビット版のODBCデータソース アドミニストレータは、C:\Windows\SysWOW64\odbcad32.exe、64ビット版はC:\Windows\system32\odbcad32.exeです。

Windows上のOracle BIサーバーのDSNを作成するには:

1. 「スタート」→「設定」→「コントロール パネル」を選択してWindowsのコントロール・パネルを開き、「管理ツール」をダブルクリックし、「データ ソース (ODBC)」をダブルクリックします。

2. 「ODBC データ ソース アドミニストレータ」ダイアログで、「システム DSN」タブをクリックし、「追加」をクリックします。

3. 「データ ソースの新規作成」ダイアログで、ドライバ「Oracle BI Server 11g_OHid_number」(id_numberは、インストールされたOracleホーム固有の番号)を選択し、「完了」をクリックします。「Oracle BI DSNの構成」ウィザードの最初のページが表示されます。

4. データ・ソースの名前を「名前」フィールドに入力します。
注意: プレゼンテーション・サービスおよび管理ツールの場合、集中管理されているデフォルトDSNの名前を変更しないでください。

5. 必要に応じて、「説明」フィールドに説明を入力します。

6. クラスタの一部ではない単一のOracle BIサーバーと接続するには、「サーバー」フィールドにOracle BIサーバーが実行しているコンピュータを選択します。
サーバー名がリストに表示されない場合、「サーバー」フィールドにコンピュータ名を入力します。

注意: Oracle Business Intelligenceシステムはデフォルトでクラスタ化されているため、このフィールドはプレゼンテーション・サービスのために作成されたデフォルトDSNでは使用されません。

7. クラスタ化されたOracle BIサーバーのセットにクラスタ・コントローラを介して接続するには、次のように行います。

1. 「クラスタ化されたDSN」を選択します。

2. プライマリおよびセカンダリ・クラスタ・コントローラの情報を、次のように入力します。

- 「プライマリ・コントローラ」フィールドに、プライマリ・クラスタ・コントローラとして指定されているコンピュータの名前を入力します。次に、プライマリ・コントローラのポート番号を、適切な「ポート」フィールドに入力します。

- セカンダリ・クラスタ・コントローラが設定されている場合、セカンダリ・コントローラが稼動しているホストの名前を「セカンダリ・コントローラ」フィールドに入力します。次に、セカンダリ・コントローラのポート番号を、適切な「ポート」フィールドに入力します。

プライマリおよびセカンダリ・コントローラのホストおよびポートの詳細は、Fusion Middleware Controlの「容量管理」ページの「可用性」タブを参照してください。

3. クラスタ・コントローラへの接続を確認するには、「クラスタ接続のテスト」をクリックします。
テストが成功しない場合は、メッセージから識別できるすべてのエラーを修正し、再度接続のテストを行います。

注意: プレゼンテーション・サービスの集中管理されているデフォルトDSNに、プライマリ・コントローラ、セカンダリ・コントローラ、およびポートのパラメータの変更を行わないでください。

8. 「リクエストを物理レイヤーに送信」を選択し、このDSNを使用しているクライアント用に、Oracle BIサーバーへの専用の物理接続を作成します。この接続を介したすべてのSELECT問合せは、SELECT_PHYSICAL問合せとして扱われます。
SELECT_PHYSICAL問合せは、プレゼンテーション・レイヤーおよびビジネス・モデルとマッピング・レイヤーを無視し、メタデータ・リポジトリの物理レイヤーに対して直接オブジェクト問合せを行います。

9. ODBCカーソルをデフォルトのスクロール・モードから前方検索に変更するには、「前方検索カーソルの使用」を選択します。

10. このDSNをSSLで通信するように構成するには、「SSLの使用」を選択します。
拡張SSL設定を構成するには、「拡張SSL設定用のODBC DSNの構成」を参照してください。

注意: プレゼンテーション・サービスの集中管理されたデフォルトDSNに、SSLパラメータの変更は行わないでください。

11. 「次へ」をクリックします。「Oracle BI DSNの構成」ウィザードの2ページ目が表示されます。

12. 必要に応じて、「ログインID」と「パスワード」に、Oracle BIサーバーのユーザー名とパスワードを入力します。

13. ユーザー名をこのクライアントのWindowsレジストリで保存する場合、「ログインIDの保存」を選択します。このオプションを選択した場合、接続するたびにユーザー名を入力する必要がなくなります。ただし、パスワードの入力は必要です。

14. Oracle BIサーバーのポート番号を「ポート」フィールドに入力します。このオプションは、ウィザードの最初のページで「クラスタ化されたDSN」が選択されていない場合、有効となります。
Oracle BIサーバーのポートの詳細は、Fusion Middleware Controlの「容量管理」ページの「可用性」タブを参照してください。

15. デフォルト・リポジトリ以外のリポジトリに接続する場合は、「デフォルト・リポジトリを次に変更」を選択し、接続するリポジトリの論理名を入力します。
この設定は、Oracle BIサーバーに複数のリポジトリをホストするように構成した場合のみ、使用できます。単一のOracle BIサーバーで複数のリポジトリをホストすることは、本番配置ではお薦めできないことに注意してください。

注意:

プレゼンテーション・サービス・クライアントに対して、各プレゼンテーション・サービス・インスタンスは単一のリポジトリのみアクセスできます。複数のリポジトリをアクセスするように複数のプレゼンテーション・サービスを構成するには、次の手順を行います。

1. 各リポジトリ・インスタンスごとに、プレゼンテーション・サービスを1つのコンピュータにインストールします。たとえば、Oracle BIサーバーで3つのリポジトリが稼動している場合、3つのプレゼンテーション・サービス・インスタンスをそれぞれ3つの異なるコンピュータにインストールします。

2. 各プレゼンテーション・サービス・インスタンスのDSNで、「デフォルト・リポジトリを次に変更」の設定を調整します。

3. Webクライアントのエンド・ユーザーは、どのリポジトリにアクセスするのかを、クライアント・ブラウザから選択できます。この選択は、作業を行うリポジトリを指し示すプレゼンテーション・サービス・インスタンスのURLの該当箇所を、適切なWebサーバーのコンピュータ名またはIPアドレスで置き換えることによって行えます。

http://host_name_or_IP_address/analytics/saw.dll?

16. 必要に応じて、追加の構成オプションのデフォルト設定を取得するために、「接続」を選択します。
このオプションを選択した場合、ウィザードは、次の画面の構成設定のためにデフォルト値を取得しようと、サーバーに接続を試みます。このオプションを選択しない場合でも、次の画面で情報を手動で入力することによって、DSNを構成できます。

このオプションを選択した場合、「ログインID」と「パスワード」の値が必要です。

17. 「次へ」をクリックします。「Oracle BIサーバーDSNの構成」ウィザードの3ページ目が表示されます。

18. デフォルトのサブジェクト・エリア名を変更するには、「デフォルトのサブジェクト・エリアを次に変更」を選択し、サブジェクト・エリアの名前を入力します。前の画面で「接続」を選択していた場合、リストから名前を選択できます。
Oracle BIプレゼンテーション・サービスで使用されているDSNには、このオプションを選択しないでください。

このオプションを選択しない場合、デフォルトのサブジェクト・エリアは内部コール問合せメタデータで定義されているものとなります。DATABASE SQL関数を使用して、デフォルトのサブジェクト・エリアを特定できます。詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイド』を参照してください。

19. デフォルトのエラー・メッセージ言語を変更するには、「デフォルトのエラー・メッセージ言語を次に変更」を選択し、エラー・メッセージに使用したい言語を選択します。エラー・メッセージ言語の選択に関する詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionシステム管理者ガイド』を参照してください。

20. 必要であれば、「日付と時刻の出力時に地域設定を使用」を選択します。このオプションが選択されている場合、「日付」、「時間」、または「日時」の書式のデータは、Oracle BIサーバーのデフォルトの書式ではなく、Windowsの地域設定を使用して表示されます。Windowsの地域設定を参照するには、コントロール パネルを開き、「地域と言語のオプション」をダブルクリックします。

21. データベース固有のログインIDとパスワードがリポジトリで設定されている場合、ベースとなるデータベースのユーザー名とパスワードを入力できます。データベース固有の資格証明によって権限が付与されているユーザーは、ベースとなるデータベースに、データベースのユーザーに付与されている権限レベルで接続できます。ベースとなるデータベースのユーザー名とパスワードを入力するには、次の手順を行います。

1. ユーザー名とパスワードを入力するデータベースを選択し、「編集」をクリックします。

2. 選択したデータベースに対するログインIDとパスワードを入力し、「OK」をクリックします。

3. 必要に応じて、これらの手順を他のデータベースで繰り返します。

22. 「終了」をクリックし、DSN構成を保存します。

8.4.1 拡張SSL設定用のODBC DSNの構成

この項の手順に従って、追加のSSL拡張設定を構成します。

注意: プレゼンテーション・サービスの集中管理されたデフォルトDSNに、SSLパラメータの変更は行わないでください。

拡張SSL設定用にOracle BIサーバーDSNを構成するには:

1. 「Oracle BIサーバーDSNの構成」ウィザードの最初のページで、「SSLの使用」を選択し、「SSLの構成」ボタンを押します。「Secure Socket Layer構成」ダイアログが表示されます。

2. 「証明書ファイル」には、クライアント証明書ファイルのパスとファイル名を入力するか、「選択」をクリックしてファイルを参照します。たとえば、次のように入力します。

ORACLE_HOME\ssl\client-cert.pem

3. 「証明書秘密鍵ファイル」には、クライアント秘密鍵ファイルのパスとファイル名を入力するか、「選択」をクリックしてファイルを参照します。たとえば、次のように入力します。

ORACLE_HOME\ssl\client-key.pem

4. 「パス・フレーズを含むファイル」には、クライアント秘密鍵のパス・フレーズ・ファイルのパスとファイル名を入力するか、「選択」をクリックしてファイルを参照します。たとえば、次のように入力します。

ORACLE_HOME\ssl\clientpwd.txt

5. 「ピアの検証」を選択します。

6. CA証明書のハッシュ版を使用している場合、ハッシュ・ファイルが置かれているディレクトリを、「CA証明書ディレクトリ」フィールドに入力します。たとえば、次のように入力します。

ORACLE_HOME\ssl

7. CA証明書を使用している場合、CA証明書のパスとファイル名を「CA証明書ファイル」フィールドに入力します。たとえば、次のように入力します。

ORACLE_HOME\ssl\cacert.pem

8. 「暗号リスト」には、使用する暗号のリストを入力します。たとえば、次のように入力します。

EXP-DES-56-SHA

9. 「証明書検証の深さ」には、1を指定します。

10. 「信頼できるピア識別名」には、接続が許可されるサーバーのDNを入力します。たとえば、次のように入力します。

C=US/ST=CA/L=Redwood Shores/O=Oracle/ OU=BI/CN=servercertificate

11. 「OK」をクリックします。

12. 前項のステップ11以降を参照し、DSNを構成するための追加の手順を完了します。

これらの手順が完了したら、パラメータで指定したディレクトリに、クライアント証明書、クライアント秘密鍵、およびパス・フレーズのファイル(たとえば、client-cert.pem、client-key.pem、およびclientpwd.txt)をコピーします。CA証明書ファイルのパラメータを設定した場合、CA証明書ファイル(たとえば、cacert.pem)も指定したディレクトリにコピーする必要があります。CA証明書ディレクトリのパラメータを設定した場合、CA証明書のハッシュ版を指定したディレクトリにコピーします。

8.5 LinuxまたはUNIX上のOracle BIサーバーにおけるODBC DSNの構成

この項では、LinuxまたはUNIX上のOracle BIサーバーにおけるODBC DSNを作成して、リモート・クライアント・アクセスを有効にする方法を説明します。

LinuxおよびUNIXシステム上では、 Oracle BIプレゼンテーション・サービスおよびnqcmdプロセスで使用されている標準またはクラスタ化されたOracle BI ODBC接続詳細が、odbc.iniのファイルに含まれています。

DSNの論理名、プライマリおよびセカンダリ・クラスタ・コントローラとポートのパラメータ、集中管理されているデフォルトDSNのSSLパラメータは変更しないでください。

LinuxまたはUNIX上のOracle BIサーバーにおけるODBC DSNを作成するには:

1. 個別のTelnetセッションとしてログオンします。

2. odbc.iniファイルを開き、編集します。このファイルは次の場所にあります。

ORACLE_INSTANCE/bifoundation/OracleBIApplication/coreapplication/setup/odbc.ini

3. [ODBC Data Sources]の項では、作成する新しいデータ・ソース名を追加し、Oracle BIサーバーのデータ・ソースとして定義します。たとえば、次のようにします。

[ODBC Data Sources]
my_new_dsn = Oracle BI Server

4. 新しいDSNの項を追加し、次のようにパラメータを提供します。

[my_new_dsn]
Driver = ORACLE_HOME/bifoundation/server/bin/call_interface.library_suffix
ServerMachine = local
Port = bi_server_port_number
ForwardOnlyCursor = No
SelectPhysical = No
Regional = Yes

次の点に注意してください。

- call_interfaceには、ODBC35(デフォルト)の場合はnqsodbcを、ODBC20の場合はnqsodbc20を入力します。

- library_suffixには、使用しているオペレーティング・システムに適したライブラリの接尾辞を入力します。たとえば、Linux、Solaris、およびAIXの場合は.soを、HP-UXの場合は.slを入力します。

- Portには、Oracle BIサーバーのポート番号を入力します。このデータ・ソースをクラスタ化されたOracle BIサーバーに接続したい場合は、このオプションを提供しないでください。
Oracle BIサーバーのポート番号の詳細は、Fusion Middleware Controlの「容量管理」ページの「可用性」タブを参照してください。

- ODBCカーソルをデフォルトのスクロール・モードから前方検索に変更するには、ForwardOnlyCursorにYesを設定します。

- クライアントの統合を有効にし、すべてのSELECT問合せをSELECT_PHYSICAL問合せとして扱うOracle BIサーバーへの専用の物理接続を作成するには、SelectPhysicalにYesを設定します。

- 「日付」、「時間」、または「日時」の書式のデータを、Oracle BIサーバーのデフォルトの書式ではなく、オペレーティング・システムの地域設定を使用して表示する場合は、RegionalにYesと設定します。

5. このデータ・ソースをクラスタ化されたOracle BIサーバーに接続する場合は、次の追加パラメータを提供します。プライマリCCSとセカンダリCCSは、同じコンピュータ上にないことが望ましいことに注意してください。

IsClusteredDSN=Yes
PrimaryCCS=primary_cluster_controller_name
PrimaryCCSPort=primary_cluster_controller_port_number
SecondaryCCS=secondary_cluster_controller_name
SecondaryCCSPort=secondary_cluster_controller_port_number

次の点に注意してください。

- このデータ・ソースを単一のOracle BIサーバーに接続する場合は、IsClusteredDSNをNoに設定します。

- プライマリおよびセカンダリ・コントローラのホストおよびポートの詳細は、Fusion Middleware Controlの「容量管理」ページの「可用性」タブを参照してください。

6. このデータ・ソースのSSLを構成するには、次のようにSSL配置に適切な追加パラメータを提供します。

SSL = Yes
SSLCertificateFile = path_to_client_certificate_file
SSLPrivateKeyFile = path_to_client_private_key_file
SSLPassphraseFile = path_to_passphrase_file_for_client_key
SSLCipherList = list_of_cipers
SSLVerifyPeer = Yes
SSLCACertificateDir = path_to_hashed_version_of_ca_certificate_file
SSLCACertificateFile = path_to_ca_certificate_file
SSLTrustedPeerDNs = list_of_server_DNs_allowed_to_connect
SSLCertVerificationDepth = 1

7. ファイルを保存して閉じます。

8. プレゼンテーション・サービスで使用されているDSNを更新する場合、プレゼンテーション・サービスを再起動する必要があります。

9 アプリケーションでのDiscovererデータの使用

この章では、サード・パーティー・クライアント・アプリケーションでのOracle Business Intelligence Discovererワークシートの公開について説明します。Oracle BI EEで使用するDiscovererメタデータの変換について説明します。

この章の内容は次のとおりです。

- 第9.1項「アプリケーションでのDiscovererワークシートの公開」

- 第9.2項「Oracle BI EEで使用するDiscovererメタデータの変換」

9.1 アプリケーションでのDiscovererワークシートの公開

Oracle Business Intelligence Discoverer WebサービスAPI(アプリケーション・プログラミング・インタフェース)を使用し、サードパーティ・クライアント・アプリケーションで使用するDiscovererワークシートを公開できます。サードパーティ・クライアント・アプリケーションでは、Discoverer WebサービスAPIを使用することで、プログラムによるDiscoverer接続、ワークブック、およびワークシートの取得、ワークシート問合せの実行、ワークシート・コンテンツの表示が可能になります。

詳細は、Oracle Fusion Middleware Oracle Business Intelligence Discoverer WebサービスAPIユーザーズ・ガイドを参照してください。

9.2 Oracle BI EEで使用するDiscovererメタデータの変換

メタデータ変換アシスタント・ツールを実行することで、DiscovererメタデータをOracle BI EEで使用する形式に変換できます。メタデータ変換アシスタント・ツールは、エンド・ユーザー・レイヤー(EUL)からOracle BI EEへのDiscovererメタデータの移行を促進するコマンドライン・ユーティリティです。このコマンドライン・ユーティリティは、Discoverer EEX公開ファイルをもとに、Oracle BI EEで使用できるRPDファイルを生成します。このRPDファイルはOracle BI EE 10gと互換性がありますが、Oracle BI EE Upgrade Assistantを使用してアップグレードすることによって、Oracle BI EE 11gでも使用できます。

メタデータ変換アシスタント(MigrateEUL.exe)は、次の場所にあります。

ORACLE_HOME\bifoundation\server\bin

メタデータ変換アシスタントの使用方法に関するドキュメントは次の場所にあります。

ORACLE_HOME\bifoundation\server\document

注意: このユーティリティは、リレーショナル・データ・ソース用にDiscovererメタデータのみを移行します。

10 Oracle E-Business Suiteセキュリティとの統合

この章では、Oracle E-Business SuiteにナビゲートするユーザーをOracle E-Business Suiteセキュリティを使用して認証するようOracle Business Intelligenceを設定する方法について説明します。データベースのデータベース・オブジェクトおよび接続プールの作成、認証の設定、およびOracle Business Intelligenceダッシュボードを開くリンクのOracle E-Business Suiteへの埋込みについて説明します。

この章の内容は次のとおりです。

- 第10.1項「Oracle E-Business Suiteデータベースのデータベース・オブジェクトと接続プールの作成」

- 第10.2項「認証の設定」

- 第10.3項「Oracle E-Business SuiteにおけるOracle Business Intelligenceへのリンクの埋込み」

10.1 Oracle E-Business Suiteデータベースのデータベース・オブジェクトと接続プールの作成

Oracle E-Business Suiteとの統合を有効にするには、Oracle E-Business Suiteデータベースのデータベース・オブジェクトと接続プールをOracle BIリポジトリ内に作成する必要があります。

Oracle E-Business Suiteデータベースのデータベース・オブジェクトと接続プールを作成するには:

1. 管理ツールで、Oracle E-Business Suiteと統合するリポジトリを開きます。

2. 「物理レイヤー」を右クリックし、新規データベースを選択します。

3. 新規データベースの名前を入力します(「Oracle E-Business Suite 12」など)。

4. 「データベース」に、使用するOracle E-Business Suiteデータベースに対する適切なOracle Databaseタイプを選択します(「Oracle 10g R2」、「Oracle 11g」など)。

5. 「OK」をクリックします。

6. 新規作成したデータベース・オブジェクトを右クリックし、「新規オブジェクト」を選択して、「接続プール」を選択します。

7. 接続プールの名前を入力します(「Oracle E-Business Suite 12」など)。
この接続プールには、一意の名前を付ける必要があります。この要件に従い、「Connection Pool」といったオブジェクト名を作成しないようにしてください。

8. 「呼出しインタフェース」では「OCI 10g/11g」を選択します。

9. 「データ・ソース名」に、Oracle E-Business SuiteデータベースのTNS名を入力します。

10. 「ユーザー名」および「パスワード」に、Oracle E-Business Suiteスーパーユーザーのユーザー名およびパスワードを入力します。

11. 「接続スクリプト」タブを選択します。

12. 「接続時に実行」の「新規」をクリックします。

13. 次の物理SQLを入力して、「OK」をクリックします。

call APP_SESSION.validate_icx_session('valueof(NQ_SESSION.ICX_SESSION_COOKIE)')

このスクリプトが有効化されていることを確認します。

14. 「接続プール」ダイアログで「OK」をクリックします。

15. リポジトリを保存します。

10.2 認証の設定

ここでは、Oracle Business IntelligenceとOracle E-Business Suiteとの間で共有される認証の設定方法について説明します。

注意:

この項の説明に従って、EBS ICX認証Cookieを使用して共有認証を設定する場合、シングル・サインオンを使用してOracle Business IntelligenceからOracle BI Publisherへシームレスにナビゲートできません。

この項の構成は、次のとおりです。

- 第10.2.1項「認証のセッション変数の設定」

- 第10.2.2項「authenticationschemas.xmlの更新」

- 第10.2.3項「instanceconfig.xmlの更新」

10.2.1 認証のセッション変数の設定

統合環境に対して適切な認証を設定するには、いくつかのセッション変数、および1つの初期化ブロックをOracle BIリポジトリに設定する必要があります。

管理ツールで認証用セッション変数を設定するには:

1. 管理ツールで、Oracle E-Business Suiteと統合するリポジトリを開きます。

2. 「管理」を選択し、「変数」を選択します。

3. 「アクション」メニューから「新規」、「セッション」、「初期化ブロック」の順に選択します。

4. 初期化ブロックの名前を入力します(「Oracle E-Business SSO」など)。

5. 「データ・ソースの編集」をクリックします。

6. 「デフォルトの初期化文字列」で、次のように入力します。

SELECT
FND_GLOBAL.RESP_ID,
FND_GLOBAL.RESP_APPL_ID,
FND_GLOBAL.SECURITY_GROUP_ID,
FND_GLOBAL.RESP_NAME,
FND_GLOBAL.USER_ID,
FND_GLOBAL.EMPLOYEE_ID,
FND_GLOBAL.USER_NAME
FROM DUAL

7. 「接続プール」で「参照」をクリックし、Oracle E-Business Suiteデータベースに対して作成した接続プール(「Oracle E-Business Suite 12」など)を選択して、「選択」をクリックします。
図10-1は、「デフォルトの初期化文字列」および「接続プール」にサンプル値を表示したセッション変数初期化ブロックデータ・ソースダイアログを示します。

図10-1 セッション変数初期化ブロックデータ・ソースダイアログ

「図10-1 セッション変数初期化ブロックデータ・ソースダイアログ」の説明

8. 「OK」をクリックします。

9. 「データ・ターゲットの編集」をクリックします。

10. 次のセッション変数を作成します。

EBS_RESP_ID
EBS_RESP_APPL_ID
EBS_SEC_GROUP_ID
EBS_RESP_NAME
EBS_USER_ID
EBS_EMPLOYEE_ID
USER

これには、「新規」をクリックして変数名を入力し、「OK」をクリックします。USER変数の特別目的についての警告が表示されたら、「はい」をクリックします。

オプションとして、各変数に対して「OK」をクリックする前に「セキュリティ・センシティブ」を選択することもできます。このオプションの詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionシステム管理者ガイド』を参照してください。

各変数が、指定した順にリストされていることを確認します。必要に応じて、「上へ」または「下へ」をクリックしてリストを並べ替えます。

図10-2は、必要な変数が必要な順序で表示されたセッション変数初期化ブロック変数ターゲットダイアログを示します。

図10-2 セッション変数初期化ブロック変数ターゲットダイアログ

「図10-2 セッション変数初期化ブロック変数ターゲットダイアログ」の説明

11. セッション変数初期化ブロック変数ターゲットダイアログで「OK」をクリックします。

12. 「セッション変数初期化ブロック」ダイアログで「認証のために必要」を選択します。

13. 「OK」をクリックします。

14. リポジトリを保存します。

10.2.2 authenticationschemas.xmlの更新

authenticationschemas.xmlファイルを更新して、EBS ICX認証Cookieの名前を追加する必要があります。

authenticationschemas.xmlを更新するには:

1. authenticationschemas.xmlファイルを開いて編集します。このファイルの場所は次のとおりです。

ORACLE_HOME/bifoundation/web/display

2. 次の要素を検索します。

<AuthenticationSchema name="EBS-ICX">

3. サブ要素RequestVariable source="cookie"の場所を探し、nameInSource属性の値をICX_SESSIONから、EBS ICX認証Cookie名の接頭辞に変更します。たとえば、次のようにします。

<RequestVariable source="cookie" type="auth" nameInSource="VIS" biVariableName=
"NQ_SESSION.ICX_SESSION_COOKIE" />

RequestVariable source="url"サブ要素は更新しないでください。

注意:

EBS ICX認証Cookie名がわからない場合は、Oracle E-Business Suite管理者に確認してください。または、次の手順によってCookie名を確認することもできます。

1. Oracle E-Business Suiteにログインします。

2. ブラウザのアドレス・バーに、次のテキストを入力します。

javascript:document.writeln(document.cookie);

3. Cookieが表示されます。例:

ORA_BIPS_LBINFO=1262d6a5f9a; ORA_MOS_LOCALE=en%7CUS; ORA_UCM_
INFO=3~00027147766664614052270216870092~LastName~FirstName~Firstname.LastName@mycompany.com~USA~en~~~~~1; ORA_UCM_VER=
%2FMP%2F8kgic%2Cr_ wjmp%3Emp_ajc%2CamkMP%2F8iega*p%5Duhkn%3Ckn
%5D_ha*_kiMP%2F8%2F26%2C65%2C7%2C22MP%2F8-04*43*5*00; ORA_UCM_
SRVC=3*OTN~1~0~//~null~*OPN~1~0~//~SE1%3ASE1%3ASE1%3ASE1%3ASE1%
3ASE1%3ASE1%3ASE1%3A~*EMP~1~0~/34/~null~*GMO~1~0~//~null; ORA_
TAHITI_PREFS=-0--------------; VIS=ZcEJeoLNVqcHGiGYvCpzTx3N:S;
ADMINCONSOLESESSION=0yQmLP2D67vJKgtXLxsNl534QTWlThYkyvXfR0fjFK0
LPsD3Hh83!1322564050

authenticationschemas.xmlで指定する必要がある値は、EBS ICX認証Cookieの接頭辞です。前述の例では、EBS ICX認証CookieはVIS=ZcEJeoLNVqcHGiGYvCpzTx3N:S;であり、接頭辞はVISです。

4. 同じエントリで(RequestVariable source="cookie")、biVariableName属性の値が、Oracle E-Business Suiteデータベースに対して接続プールを作成したときの接続スクリプトの一部として入力した値と同じであることを確認します。詳細は、第10.1項「Oracle E-Business Suiteデータベースのデータベース・オブジェクトと接続プールの作成」のステップ13を参照してください。

5. 次の要素を検索します。

<SchemaKeyVariable source="cookie">

6. nameInSource属性の値を、ICX_SESSIONから、EBS ICX認証Cookie名の接頭辞に変更します(多くの場合はVIS)。例:

<SchemaKeyVariable source="cookie" nameInSource="VIS" forceValue="EBS-ICX"/>

7. ファイルを保存して閉じます。

10.2.3 instanceconfig.xmlの更新

instanceconfig.xmlファイルを更新して、有効化されたスキーマの1つとしてEBS ICXを追加し、これをデフォルトとして設定する必要があります。instanceconfig.xmlファイルを更新して、ログインおよびログアウト情報を構成する必要があります。

instanceconfig.xmlを更新するには:

1. Oracle Business IntelligenceがカスタムSSOプロバイダを使用するように構成します。これについては、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionセキュリティ・ガイド』のFusion Middleware Controlを使用したSSO認証の有効化に関する項を参照してください。

2. instanceconfig.xmlファイルを開いて編集します。このファイルの場所は次のとおりです。

ORACLE_INSTANCE/config/OracleBIPresentationServicesComponent/coreapplication_obipsn

3. Authentication要素の場所を特定します。

4. 有効化されたスキーマのリストにEBS ICXを追加します。次に例を示します。

<EnabledSchemas>UidPwd,Impersonate,UidPwd-soap,Impersonate-soap,EBS-ICX</EnabledSchemas>

instanceconfig.xml内の、この設定は集中管理されているという内容のコメントは無視します。EBS ICXは、EnabledSchemas要素に手動で追加する必要があります。

5. ファイルを保存して閉じます。

6. Oracle Business Intelligenceを再起動します。

10.3 Oracle E-Business SuiteにおけるOracle Business Intelligenceへのリンクの埋込み

Oracle Business Intelligenceダッシュボードを開くリンクをOracle E-Business Suiteに埋め込むには、フォーム関数を作成してから、メニューおよび職責を割り当てる必要があります。

作業を開始する前に、Oracle E-Business Suiteにシステム管理者(sysadminなど)としてログインします。次に、左側の職責ナビゲータ・ペインからシステム管理者職責を選択します。使用可能なメニューが右側に表示されます。

この項で説明する各手順を実行して、次のオブジェクトをこの順序で作成します。

- 関数

- メニュー

- 職責

- ユーザー

- プロファイル

この項の構成は、次のとおりです。

- 第10.3.1項「ドメイン前提条件」

- 第10.3.2項「フォーム関数の作成」

- 第10.3.3項「フォーム関数を起動するメニューの作成」

- 第10.3.4項「職責へのメニューの割当て」

- 第10.3.5項「ユーザーへの職責の割当て」

- 第10.3.6項「プロファイルの設定」

10.3.1 ドメイン前提条件

Oracle E-Business SuiteインスタンスおよびOracle Business IntelligenceインスタンスのURLのエントリ・ポインが異なるインターネット・ドメインを使用して構成されている場合、適切なメカニズムを使用して、2つのURLに対する単一の論理的ドメインを作成する必要があります。この手順は、Oracle E-Business SuiteとOracle Business Intelligenceとの間にリンクを構成し、Oracle E-Business Suiteのセッション情報をOracle Business Intelligenceに渡せるようにするために必要です。

たとえば、Oracle E-Business Suiteが次の場所で使用可能であるとします。

http://ebshost.ebsdomain.com:8001

また、Oracle Business Intelligenceが次の場所で使用可能であるとします。

http://bihost.bidomain.com:9704

適切なメカニズムを導入し、同じドメインを使用して、ブラウザから両方のURLにアクセスできるようにする必要があります。

これを実現する方法の1つは、サポートされるHTTPサーバー(Oracle HTTP Serverなど)をインストールすることです。前述の例では、Oracle Business Intelligenceに対してHTTPサーバーを構成し、次に対する要求を

http://bihost.ebsdomain.com:9704

次にマップできます。

http://bihost.bidomain.com:9704

この方法では、クライアント・ブラウザは次のURLにリンクできます。

http://bihost.ebsdomain.com:9704

しかし、HTTPサーバーは実際には本来の場所をポイントしています。

Oracle HTTP Serverの構成と保護の詳細は、『Oracle Fusion Middleware Oracle HTTP Server管理者ガイド』を参照してください。

10.3.2 フォーム関数の作成

ここでは、Oracle E-Business Suiteでフォーム関数を作成する方法について説明します。

フォーム関数を作成するには:

1. アプリケーションメニューから関数を選択します。フォーム関数ダイアログが表示されます。
図10-3は、フォーム関数ダイアログを示します。

図10-3 フォーム関数ダイアログ

「図10-3 フォーム関数ダイアログ」の説明

2. 関数フィールドに関数名を入力します(「OBIEE」など)。

3. ユーザー関数名を入力します。(「OBIEE」など)。

4. 説明を入力します。(「Oracle BIへのリンク」など)。

5. ツールバーの保存ボタンを使用して、変更を保存します。

6. 「 プロパティ 」タブを選択します。

7. タイプに、「SSWA jsp function」と入力します。

8. Web HTMLタブを選択します。

9. HTMLコールに、次のいずれかのオプションを入力します。

- アンサーにリンクする場合は、次のように入力します。
OracleOasis.jsp?mode=OBIEE&function=Answers

- ダッシュボードにリンクする場合は、次のように入力します。
OracleOasis.jsp?mode=OBIEE&function=Dashboard

10. ツールバーの保存ボタンを使用して変更を保存し、フォーム関数ダイアログを閉じます。

10.3.3 フォーム関数を起動するメニューの作成

ここでは、フォーム関数を起動するメニューをOracle E-Business Suiteに作成する方法について説明します。メニューは、更新されるたびにコンパイルされます。

フォーム関数を起動するメニューを作成するには:

1. アプリケーションメニューからメニューを選択します。メニューダイアログが表示されます。
ヒント: すでに「フォーム」を開いている場合は、上位10件リストからメニューを選択できます。

図10-4はメニューダイアログを示します。

図10-4 メニューダイアログ

「図10-4 メニューダイアログ」の説明

2. メニューフィールドにメニュー名を入力します(「OBIEE」など)。

3. ユーザー・メニュー名を入力します(「OBIEE」など)。

4. メニュー・タイプに「Standard」と入力します。

5. 関数には、第10.3.2項「フォーム関数の作成」で作成した関数名を入力します。

6. ツールバーの保存ボタンを使用して変更を保存し、メニューダイアログを閉じます。

メニューに1つの関数しか含まれない場合は、この関数はユーザーに対し、デフォルトで選択されます。この場合、関数の表示などの中間手順は省略されます。

10.3.4 職責へのメニューの割当て

第10.3.3項「フォーム関数を起動するメニューの作成」で作成したメニューは、職責に関連付ける必要があります。既存の職責を再利用することもできますが、次の手順に示すとおり、職責を作成することもできます。

メニューを新規の職責に割り当てるには:

1. 上位10件リストから職責を選択します。
図10-5は、職責ダイアログを示します。

図10-5 職責ダイアログ

「図10-5 職責ダイアログ」の説明

2. 職責の名前を入力します(「OBIEE」など)。

3. アプリケーションに、メニューを作成したアプリケーションを入力します。

4. 職責キーに、任意の一意の値を定義します。この値の一意性を保つために、職責キーは翻訳されません。

5. 使用可能な場所で、OracleセルフサービスWebアプリケーションを選択します。

6. データ・グループでは、名前に「Standard」と入力し、アプリケーションにアプリケーション名を再入力します。

7. メニューに、第10.3.3項「フォーム関数を起動するメニューの作成」で作成したメニューの名前を入力します。

8. ツールバーの保存ボタンを使用して変更を保存し、職責ダイアログを閉じます。

10.3.5 ユーザーへの職責の割当て

メニューに関連付けられている職責は、ユーザーに割り当てる必要があります。ユーザーを作成することもできますが、次の手順に示すとおり、既存のユーザーに職責を割り当てることもできます。

職責を既存のユーザーに割り当てるには:

1. 上位10件リストからユーザーを選択します。
図10-6はユーザーダイアログを示します。

図10-6 ユーザーダイアログ

「図10-6 ユーザーダイアログ」の説明

2. 編集するユーザーに対し、直接の職責タブに職責の詳細を入力します。職責名、アプリケーション、セキュリティ・グループ(Standard)、および有効期間を入力します。

3. ツールバーの保存ボタンを使用して変更を保存し、ユーザーダイアログを閉じます。

10.3.6 プロファイルの設定

プロファイルの一環として、Oracle BIサーバーのURLを入力する必要があります。職責、ユーザー、またはサイトに対するプロファイルを設定できます。次に、職責に対してプロファイル・オプションを設定する手順を示します。

職責に対してプロファイル・オプションを設定するには:

1. アプリケーションメニューからプロファイルを選択します。
図10-7は、システム・プロファイル値の検索ダイアログを示します。

図10-7 システム・プロファイル値の検索ダイアログ

「図10-7 システム・プロファイル値の検索ダイアログ」の説明

2. 職責を選択し、第10.3.4項「職責へのメニューの割当て」でメニューを割り当てた職責の名前を入力します。

3. プロファイルフィールドに「%Business Intelligence%」と入力します。

4. 検索をクリックします。

5. 結果の表示画面で、職責の下にOracle Business IntelligenceのURLを入力します。たとえば、次のように入力します。

http://my_server.domain.com:port/analytics

IPアドレスや単なるホスト名でななく、完全修飾された名前(ホスト名.ドメイン名)を使用する必要があります。Oracle Business Intelligenceドメインは、 Oracle E-Business Suiteドメインと同一である必要があります。これは、ユーザーのブラウザからOracle Business IntelligenceにEBS ICXのCookieを表示するために必要です。詳細は、「ドメイン前提条件」を参照してください。

ポートには、Oracle Business Intelligenceを実行しているWebサーバーのポート番号を入力します(9704など)。

6. ツールバーの保存ボタンを使用して、変更を保存します。

11 Oracle BI EEのOracle Siebel CRMへの埋込み

この章では、Oracle Siebel CRMにOracle BI EEを埋め込む方法について説明します。Oracle HTTP Serverのプロキシ設定の構成、SiebelアプリケーションのHTTPSサーバーの構成、およびOracle BI EEディレクトリを特定するためのSiebelのシンボリックURLの構成について記述します。

この章の内容は次のとおりです。

- 第11.1項「Oracle BI EEのOracle Siebel CRMへの埋込みの概要」

- 第11.2項「Oracle HTTP Serverの構成」

- 第11.3項「HTTPサーバーからOracle BIを検索するためのSiebelアプリケーションの構成」

- 第11.4項「/analyticsディレクトリを参照するためのSiebel URLの変更」

11.1 Oracle BI EEのSiebel CRMへの埋込みの概要

たとえば、Oracle Siebel Web Extension(SWE)とOracle Business Intelligence Presentation Servicesをそれぞれ別のWebサーバー上で実行する場合は、なんらかのネットワーク処理または負荷分散メカニズムを使用して、2台のマシンに対する単一の論理ドメイン(または仮想IPアドレス)を作成する必要があります。これを実現する方法の1つは、サポートされるHTTPサーバー(Oracle HTTP Serverなど)をインストールすることです。次に、Siebel CRM アプリケーション(SWE)およびOracle Business Intelligenceへのエントリ・ポイントに対し、HTTPサーバーを構成します。これはリバース・プロキシが構成されることを意味し、クライアント・ブラウザからは、Oracle Siebel CRMとOracle Business Intelligenceの両方が同一マシン上で処理されているように見えます。

HTTPサーバーのプロキシ設定が完了したら、Oracle Siebel CRMの管理設定を更新して、HTTPサーバーをNQHOSTおよびNQHOSTHOME変数にマップする必要があります。最後に、Oracle BI EEのanalyticsディレクトリへの正しいフォーマットによる参照が、各URLに含まれていることを確認する必要があります。

11.2 Oracle HTTP Serverの構成

ここでは、Oracle HTTP Serverのプロキシ設定を構成して、リバース・プロキシを設定する手順について説明します。これにより、クライアント・ブラウザからは、Oracle BI EEとOracle Siebel CRMアプリケーションが同一マシン上で実行されているように見えます。HTTPサーバーはクライアント・ブラウザからのリクエストを、適切なマシンにルーティングします。HTTPサーバーは、Oracle Siebel CRMサーバーと同じポート上で実行される必要があることに注意してください。

この手順ではOracle HTTP Serverが使用されていることを想定していますが、サポートされる任意のHTTPサーバーを使用して、Oracle BI EEをOracle Siebel CRMに埋め込むことができます。

本番環境で作業している場合は、基礎となるビジネス・インテリジェンス・オブジェクトにユーザーが直接アクセスできないように、HTTPサーバーにセキュリティ・ポリシーを追加することをお薦めします。

Oracle HTTP Serverのインストールの詳細は、『Oracle Fusion Middleware Oracle Web Tierクイック・インストレーション・ガイド』を参照してください。Oracle HTTP Serverの構成と保護の詳細は、『Oracle Fusion Middleware Oracle HTTP Server管理者ガイド』を参照してください。

Oracle HTTP Serverのプロキシ設定を構成するには:

1. Oracle HTTP Serverのmod_wl_ohs.confファイルを開きます。

2. 次のプロキシ・リクエスト情報を構成ファイル内に挿入します。詳細は、次の例を参照してください。

ProxyRequest Off
<Proxy*>
Order deny,allow
Allow from all
</Proxy*>

Location/Oracle's Siebel CRM subdirectory
ProxyPass http://location of Oracle's Siebel CRM server/
Oracle's Siebel CRM subdirectory

ProxyPassReverse http://location of Oracle's Siebel CRM server/
Oracle's Siebel CRM subdirectory
/Location

Location/Oracle BI EE subdirectory
ProxyPass http://location of Oracle BI EE server/
Oracle BI EE subdirectory
ProxyPassReverse http://location of Oracle BI EE server/
Oracle BI EE subdirectory
/Location

3. 構成ファイルを保存して閉じます。

4. Oracle HTTP Serverから完全修飾名を使用してOracle Siebel CRMにログインし、構成をテストします。

例

次のプロキシ構成例を参考にしてください。

ProxyRequests Off
<Proxy *>
Order deny,allow
Allow from all
</Proxy>

<Location /sales_enu>
ProxyPass http://myserver.mycompany.com/sales_enu
ProxyPassReverse http://myserver.mycompany.com/sales_enu
</Location>

<Location /analytics>
ProxyPass http://myserver:9704/analytics
ProxyPassReverse http://myserver:9704/analytics
</Location>

11.3 HTTPサーバーからOracle BIを検索するためのSiebelアプリケーションの構成

ここでは、Siebelアプリケーションの設定を更新し、HTTPサーバーをNQHOSTおよびNQHOSTHOME変数にマップする手順について説明します。

管理設定の処理方法の詳細は、Siebel製品のドキュメントを参照してください。

Siebelアプリケーションを構成するには:

1. Siebelアプリケーションの管理→統合タブにナビゲートします。

2. ホスト管理フレームにナビゲートします。

3. 仮想名列から、NQHOSTおよびNQHOSTNAMEを特定します。

4. 「名前」列の名前を、Oracle BI Presentation Servicesを提供しているHTTPサーバーのホスト名に更新します。これは、Oracle HTTP Serverのmod_wl_ohs.confファイルで指定したロケーション名です。この場所の詳細は、「Oracle HTTP Serverの構成」を参照してください。
HTTPサーバーが80以外のポートで実行されている場合は、ポート番号を指定する必要があります。

11.4 /analyticsディレクトリを参照するためのSiebel URLの変更

この手順を使用して、Oracle Siebel CRM内の各シンボリックURLに、Oracle BI EE /analyticsディレクトリへの適切にフォーマットされた参照が含まれていることを確認します。

Siebel URLを変更するには:

1. Siebelアプリケーションの管理→統合タブにナビゲートします。

2. シンボリックURLの管理フレームにナビゲートします。

3. クエリーをクリックし、URL列から「*Analytics*」を検索します。この検索基準に一致するURLのリストが返されます。

4. /Analytics(先頭が大文字のA)を含むすべてのビジネス・インテリジェンス・オブジェクトURLを、/analytics(先頭が小文字のa)に変更します。

A サンプル・ファイル

この付録には、アクションを構成したり、アクションからブラウザ・スクリプトのコールを起動できるようにしたりするサンプル・ファイルのコンテンツが含まれています。

この付録の内容は次のとおりです。

- 第A.1項「アクション・フレームワーク構成ファイルのサンプル」

- 第A.2項「JavaScriptファイルのサンプル」

A.1 アクション・フレームワーク構成ファイルのサンプル

ActionFrameworkConfig.xmlサンプル・ファイルを第5章「アクションによるOracle BI EEおよび外部システムの統合」に記載されている情報とともに使用すると、アクションを構成する様々な方法がわかります。

<?xml version="1.0" encoding="UTF-8" ?>
- <obi-action-config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="afconfig.xsd">
- <aliases>
- <location-alias>
<alias>actionsrv</alias>
<actual>localhost:9704</actual>
</location-alias>
- <location-alias>
<alias>biserver</alias>
<actual>http://localhost:9704/analytics/saw.dll?WSDL</actual>
</location-alias>
</aliases>
- <registries>
- <registry>
<id>reg1</id>
<name>Sample Web Services</name>
<content-type>webservices</content-type>
<provider-class>oracle.bi.action.registry.wsil.WSILRegistry</provider-class>
<description />
- <location>
<path>http://localhost:9704/ActionSamples/inspection.wsil</path>
</location>
- <service-access>
<path>/Sample Web Services/Rating Service</path>
<policy>SAMLPolicy</policy>
<propagateIdentity>true</propagateIdentity>
</service-access>
</registry>
- <registry>
<id>reg1b</id>
<name>BI EE Web Services for SOA</name>
<content-type>webservices</content-type>
<provider-class>oracle.bi.action.registry.wsil.WSILRegistry</provider-class>
<description />
- <location>
<path>http://localhost:9704/biservices/inspection?wsil</path>
</location>
- <service-access>
<account>wsil.browsing</account>
<policy>wss_username_token_policy</policy>
<propagateIdentity>false</propagateIdentity>
</service-access>
</registry>
- <registry>
<id>reg1c</id>
<name>Built-in BI EE Web Services</name>
<content-type>webservices</content-type>
<provider-class>oracle.bi.action.registry.wsil.WSILRegistry</provider-class>
<description />
- <location>
<path>http://localhost:9704/ActionSamples/Builtin.wsil</path>
</location>
</registry>
- <registry>
<id>reg2</id>
<name>Secure Web Services Sample</name>
<content-type>webservices</content-type>
<provider-class>oracle.bi.action.registry.wsil.WSILRegistry</provider-class>
<description />
- <location>
<path>http://localhost:9704/ActionSamples/secure.wsil</path>
</location>
- <service-access>
<path>/Secure Web Services  Sample/RatingService/CreditRatingService/CreditRatingPort/processRating</path>
<policy>SAMLPolicy</policy>
<propagateIdentity>true</propagateIdentity>
</service-access>
</registry>
- <registry>
<id>reg03</id>
<name>Sample EJBs</name>
<content-type>java</content-type>
<provider-class>oracle.bi.action.registry.java.EJBRegistry</provider-class>
<description>Custom Java classes which can be invoked as action  targets</description>
- <location>
<path />
</location>
- <custom-config>
- <ejb-targets>
- <appserver>
<context-factory>weblogic.jndi.WLInitialContextFactory</context-factory>
<jndi-url>t3://localhost:9704</jndi-url>
<server-name>localhost</server-name>
<account>WLSJNDI</account>
<ejb-exclude>mgmt</ejb-exclude>
<ejb-exclude>PopulationServiceBean</ejb-exclude>
</appserver>
- <ejb-app>
<server>localhost</server>
<app-context>ActionSamplesEJB</app-context>
</ejb-app>
</ejb-targets>
</custom-config>
</registry>
</registries>
- <content-types>
- <content-type>
<typename>webservices</typename>
<displayname>Web Services and BPEL Processes</displayname>
<actionType>WebServiceActionType</actionType>
</content-type>
- <content-type>
<typename>psft</typename>
<displayname>PeopleSoft Applications</displayname>
<actionType>URLActionType</actionType>
</content-type>
- <content-type>
<typename>epm</typename>
<displayname>Hyperion Applications</displayname>
<actionType>URLActionType</actionType>
</content-type>
- <content-type>
<typename>misc</typename>
<displayname>Mixed Services</displayname>
<actionType>URLActionType</actionType>
</content-type>
- <content-type>
<typename>java</typename>
<displayname>Java Actions</displayname>
<actionType>JavaActionType</actionType>
</content-type>
</content-types>
- <accounts>
- <account>
<name>wsil.browsing</name>
<description>Account for BI WS for SOA</description>
<adminonly>false</adminonly>
<credentialkey>browsing</credentialkey>
</account>
- <account>
<name>WLSJNDI</name>
<description>Account used to access WLS JNDI.</description>
<adminonly>false</adminonly>
<credentialkey>JNDIUser</credentialkey>
</account>
- <account>
<name>EPM</name>
<description>Account used to connect to EPM.</description>
<adminonly>false</adminonly>
<credentialkey>EPM</credentialkey>
</account>
</accounts>
- <policies>
- <policy>
<name>SAMLPolicy</name>
<policyfile>ActionsSAMLPolicy.xml</policyfile>
</policy>
- <policy>
<name>wss_username_token_policy</name>
<policyfile>wss_username_token_policy.xml</policyfile>
</policy>
</policies>
- <!--
Uncomment this element to enable support for using proxy settings to enable browsing/invocation
of external web services when running behind a firewall

<proxy>
<host>@proxy.host@</host>
<port>@proxy.port@</port>
<userid>@proxy.user@</userid>
<password>@proxy.password@</password>
<nonProxyHosts>localhost|*.oracle.com|@proxy.nonProxyHosts@</nonProxyHosts>
</proxy>

-->
- <ebusinesssuiteconfig>
<visible>true</visible>
</ebusinesssuiteconfig>
</obi-action-config>

A.2 JavaScriptファイルのサンプル

UserScripts.jsサンプル・ファイルを第5章「アクションによるOracle BI EEおよび外部システムの統合」に記載されている情報とともに使用すると、アクションでブラウザ・スクリプトのコールを起動できるようにする方法がわかります。

/ --------------------------------------------------------------------------------------------------------------------
/** USER-DEFINED SCRIPTS
*
* Use this file to enter any user-defined JavaScript functions you wish to invoke from a client-side Script action.
* By using the namespace of USERSCRIPT (as shown in the example code below), you will ensure that no function name
* conflicts occur with with the product code, and all PUBLISHED functions (in the USERSCRIPT namespace) can be
* browsed for selection, at Action creation time.
*
* By default, all functions in here are PRIVATE, in so much that they are not displayed within the Browse dialog
* during Action creation.
* Note - They ARE still usable, providing you know the correct function name.
*
* To publish (make visible) a function, simply add the 'publish' static member as shown in the example below, along
* with any parameters you want automatically created.
*
* ALL functions will receive ONE parameter; a named array of values, indexed by the parameter name.
*/
// --------------------------------------------------------------------------------------------------------------------

USERSCRIPT = function(){};

// --------------------------------------------------------------------------------------------------------------------
/** This is the parameter object you can create to supply default parameters on creation of Script action.
* See the 'displayParameters' example below for usage.
* @param {String} sName is the unique name of parameter.
* @param {String} sPrompt is the display text used to prompt for the parameter value.
* @param {String} sValue (Optional) is the default value for the parameter.
*/
USERSCRIPT.parameter = function(sName, sPrompt, sValue)
{
this.name   = sName;
this.prompt = sPrompt;
this.value  = sValue;
};

/** This is an example function to display all parameters that are recieved
* @params {Array} aParams an array of values indexed by the parameter name
*/
USERSCRIPT.example_displayParameters = function(aParams)
{
var sArgs = "";
for( args in aParams )
{
var argName  = args;
var argValue = aParams[argName];

sArgs += "Parameter name: " + argName + "  Value: " + argValue;
sArgs += "\n";
}

alert( sArgs.length == 0 ? "No Parameters" : sArgs );
};
USERSCRIPT.example_displayParameters.publish =
{
// The existence of this 'publish' object causes the 'USERSCRIPT.example_displayParameters' function to be
// shown when browing the available user script functions (during creation of a Script action).

// If you wish the Script function to have parameters automatically created on selection of the function,
// create a 'parameters' object as shown below.
// You can have any number of parameters, with each parameter requiring a unique name, prompt and an
// optional value.
parameters :
[
new USERSCRIPT.parameter( 'p1', 'Enter value for Param 1', 'p1 default value' ),
new USERSCRIPT.parameter( 'p2', 'Enter value for Param 2', 'p2 default value' ),
new USERSCRIPT.parameter( 'p3', 'Enter value for Param 3'  )
]

// If no generated parameters are required, either create an empty array
//    parameters : []
// or don't declare the 'parameters' object at all.
};
//global variables
var newWin;
var sArgs;

// ----------------------------------------------------------------------------------------------
/** This is an example of a private function, which is not shown when browsing available
* user-defined functions.  It is private as is does NOT have the 'publish' static member declaration.
* However, the function CAN still be called if you know the function name.
*/
USERSCRIPT.example_hideMeDuringBrowse = function()
{
alert("But I can still be called");
};

// ----------------------------------------------------------------------------------------------

用語集

この用語集では、Oracle Business Intelligence Enterprise Editionの用語を定義します。その他の用語と定義については、Oracle Fusion Middlewareマスター用語集を参照してください。

アクション

関連コンテンツへ移動したり、外部システムで操作、関数またはプロセスを起動する機能を提供します。アクションは、分析、ダッシュボード・ページ、エージェント、スコアカードの目標、スコアカードのイニシアティブおよびKPIに含めることができます。

「アクション・リンク」も参照してください。

アクション・フレームワーク

アクション・フレームワークは、Oracle BI EEアーキテクチャのコンポーネントで、アクション実行サービス(AES)と呼ばれるJ2EEアプリケーションと、Oracle BI EEの一部としてデプロイされる、アクションに固有のJavaScript機能を含んでいます。アクション・フレームワークには、アクションの作成や特定のアクション・タイプをブラウザから直接起動するクライアント側の機能も含まれています。

アクション・リンク

分析、ダッシュボード・ページ、スコアカードの目標、スコアカードのイニシアティブまたはKPIに埋め込まれたアクションへのリンクで、クリックすると、関連付けられているアクションが実行されます。

「アクション」も参照してください。

ADFビジネス・インテリジェンス・コンポーネント

Oracle Business Intelligenceのカタログ・オブジェクトをADFアプリケーションに含める機能を開発者に提供します。このコンポーネントでは、カタログへのアクセスにSOAP接続が使用されます。

管理サーバー

Oracle Business Intelligenceのコンポーネントを管理する、WebLogic Serverドメインの一部。管理サーバーには、Oracle WebLogic Server管理コンソール、Oracle Fusion Middleware ControlおよびJMX MBeansが含まれます。簡易インストール・タイプでは、Oracle BI PublisherやOracle Real-Time DecisionsなどのOracle Business Intelligence用Javaコンポーネントも管理サーバーに含まれます。

「Fusion Middleware Control」、「Javaコンポーネント」および「管理対象サーバー」も参照してください。

管理ツール

「Oracle BI管理ツール」を参照してください。

拡張トレリス

たとえばスパーク折れ線グラフ、スパーク棒グラフ、数字など、トレリス・ビューは複数の可視化タイプをグリッド内に表示できます。各可視化タイプには異なるメジャーが表示されます。

拡張トレリスはピボット表と見なすことができますが、ピボット表に追加する各メジャーに対して、オプションでディメンションを関連付けて、そのディメンションをスパーク・グラフの可視化として表示できる点が異なります。

トレリスおよび可視化も参照してください。

エージェント

ビジネス・プロセスの自動化を可能にします。エージェントを使用することによって、イベント駆動型アラートの生成、スケジュールされたコンテンツの公開、および条件付きイベント駆動型アクションの実行が可能になります。

エージェントは、情報ベースで問題と機会を動的に検出し、通知する必要がある適切なユーザーを判断し、そのユーザーに様々なデバイス(電子メール、電話など)で情報を配信します。

集計の永続性

集計表とこれに対応するOracle Business Intelligenceメタデータ・マッピングの作成とロードを自動化し、集計ナビゲーションを可能にする機能。

集計表

ディメンション属性のセットに対して集計される、あらかじめ計算されたメジャーからの結果を格納する表。集計表の各列には、特定のレベルのセットのデータが含まれます。たとえば、月間売上表には、各月の各店舗での各製品の収益の合計があらかじめ計算されて含まれます。集計表を使用すると、パフォーマンスが向上します。

集計ルール

Oracle BIリポジトリで論理列または物理キューブ列に適用されるルールで、SUMなどの特定の集計関数を列データに適用するよう指定します。

プレゼンテーション・サービスで、ユーザーは、リポジトリで適用されたルールを表示できます。ユーザーは、メジャー列に対するデフォルトの集計ルールを変更することもできます。

別名表

別の物理表をソースとして参照する物理表。1つの物理表に様々な役割を持たせる必要がある場合に、別名表を使用することによって、それぞれ異なるキー、名前または結合を持つ複数の表を設定できます。また、別名表の名前は物理SQL問合せで使用されるため、別名表に意味のある名前を付けて、SQL文をわかりやすくすることもできます。

分析

ユーザーがプレゼンテーション・サービスの「基準」タブで作成する問合せ。分析には、オプションでフィルタまたは選択ステップを1つ以上含め、結果を限定することができます。

「フィルタ」および「選択ステップ」も参照してください。

分析基準

分析に指定された列、フィルタおよび選択ステップで構成されます。

「分析」も参照してください。

分析プロンプト

分析に追加されたプロンプト。ユーザーがプロンプト値を選択すると、そのプロンプトが含まれている分析についてのみ、その値によって分析の表示内容が決まります。

「ダッシュボード・プロンプト」および「プロンプト」を参照してください。

属性

Oracle BIリポジトリでのディメンションの詳細。属性は、通常、ディメンション表の列として表示されます。

属性列

プレゼンテーション・サービスで、メンバーとも呼ばれる値のフラット・リストを保持する列。これらのメンバー間に、階層列のメンバーのような階層関係はありません。製品IDや市などがこの例です。

「階層列」を参照してください。

BIコンポーザ

BIコンポーザは、複雑な分析エディタを使わずに、分析の作成、編集または表示をすばやく簡単に行える、使いやすいウィザードです。

BIドメイン

構成可能なシステム・コンポーネント(コアアプリケーション)とJavaコンポーネント(WebLogic Serverドメイン)が含まれ、Webベースの管理ツールとリソースを利用するアプリケーションも含まれます。

BIドメインは、1つ以上の物理サーバーにまたがるミドルウェア・ホームのセットの場合もあります。

「BIインスタンス」も参照してください。

BIインスタンス

BIドメインのシステム・コンポーネント(コアアプリケーション)のことです。

「BIドメイン」も参照してください。

BIオブジェクト

プレゼンテーション・サービスを使用して作成され、Oracle BIプレゼンテーション・カタログに保存される各ビジネス・インテリジェンス・コンテンツ。BIオブジェクトの例には、分析、ダッシュボード・ページ、スコアカード、KPIなどがあります。

BI検索

プレゼンテーション・サービスの外部にある検索ツール。管理者によってBI検索のURLへのリンクが追加されていると、ホーム・ページからBI検索を使用できます。BI検索は、Oracle BIプレゼンテーション・カタログ内のオブジェクトを検索できる、全文検索エンジンに似たメカニズムを備えています。

ブックマーク・リンク

ダッシュボード・ページへのパスとページの状態のあらゆる側面を取り込みます。

「プロンプト・リンク」を参照してください。

ブリッジ表

2つの表の間の多対多関係を解決する表。

ブリーフィング・ブック

「Oracle BIブリーフィング・ブック」を参照してください。

ビジネス・モデル

ビジネス・モデル定義と、論理表と物理表のマッピングが含まれているOracle BIリポジトリ内のオブジェクト。ビジネス・モデルは、物理レイヤーのオブジェクトと異なり、常にディメンション化され、データ・ソースの編成が反映されます。各ビジネス・モデルには、論理表、列および結合が含まれます。

ビジネス・モデルとマッピング・レイヤー

データのビジネス・モデルまたは論理モデルを定義し、ビジネス・モデルと物理レイヤー・スキームとの間のマッピングを指定するOracle BIリポジトリのレイヤー。このレイヤーには、1つ以上のビジネス・モデルが含まれます。

ビジネス・モデルとマッピング・レイヤーによって、ユーザーから見える分析の動作が決まり、ユーザーが使用できるオブジェクトのスーパーセットが定義されます。また、ソース・データ・モデルの複雑さも隠されます。

ビジネス所有者

目標や原因/結果マップなどのKPIまたはスコアカード・オブジェクトのパフォーマンスとビジネス値の管理および強化の責任者。

カタログ

「Oracle BIプレゼンテーション・カタログ」を参照してください。

原因/結果マップ

目標またはKPIの因果関係を示すスコアカードのコンポーネント。

「Oracle Scorecard and Strategy Management」も参照してください。

時系列キー

ディメンション・レベル内のメンバーの時系列を示す時間ディメンションンの列。キーは、そのレベルで一意である必要があります。

クラスタ・コントローラ

プレゼンテーション・サービスや他のクライアントからの新規リクエストの最初の接点となるプロセス。クラスタ・コントローラは、Oracle BIサーバーの可用性と負荷に基づいて、リクエストの振分け先とするクラスタ内のOracle BIサーバーを決定します。また、Oracle BI Schedulerインスタンスなどのクラスタ内のサーバーの処理をモニターします。クラスタ・コントローラは、アクティブ/パッシブ構成にデプロイされます。

列

Oracle BIリポジトリでは、列は、物理列、論理列またはプレゼンテーション列です。

プレゼンテーション・サービスでは、分析によって返される個々のデータを表します。列とフィルタや選択ステップとの組合せによって、分析に含まれるデータが決まります。また列には、その列に含まれる情報のタイプを示す名前(アカウント、連絡先など)が付けられます。

「分析」、「属性列」、「階層列」および「メジャー列」も参照してください。

列フィルタ

「フィルタ」を参照してください。

列プロンプト

データ列に対する特定の値プロンプトの作成を可能にするフィルタのタイプ。ダッシュボードまたは分析上に単独で作成するか、既存のダッシュボード・フィルタや分析フィルタの拡張または改良として作成できます。

「プロンプト」も参照してください。

複合結合

等号以外の式を使用する、Oracle BIリポジトリの物理レイヤーでの結合。

条件

分析またはキー・パフォーマンス・インディケータ(KPI)の評価に基づいて1つのブール値を返すオブジェクト。条件を使用して、エージェントがコンテンツを配信してアクションを実行するかどうか、アクション・リンクをダッシュボード・ページに表示するかどうか、セクションとそのコンテンツをダッシュボード・ページに表示するかどうかが決まります。

「アクション」、「アクション・リンク」、「エージェント」および「キー・パフォーマンス・インディケータ(KPI)」も参照してください。

接続プール

データ・ソースの接続情報を含む、Oracle BIリポジトリの物理レイヤーのオブジェクト。

「物理レイヤー」も参照してください。

コンテンツ・デザイナ

分析、ダッシュボード、スコアカードなどのビジネス・インテリジェンス・オブジェクトを作成するユーザー。

コンテキスト・イベント・アクション

アクション・フレームワークを使用して、ビジネス・インテリジェンス・オブジェクトからADFページの別のリージョンにコンテンツを渡す、事前配信済アクション。

「アクション」、「アクション・フレームワーク」および「アクション・リンク」も参照してください。

基準

「分析基準」を参照してください。

キューブ

リレーショナル・データベースよりデータの分析時間が短く、柔軟性が高いOLAP(オンライン分析処理)データ構造。キューブはメジャーで構成され、ディメンションで編成されます。多次元データ・ソースのキューブは、リレーショナル・データベース・モデルのスター・スキーマにほぼ相当します。

通貨プロンプト

分析またはダッシュボードの通貨列に表示される通貨タイプをユーザーが変更できるようにするプロンプト。

「プロンプト」も参照してください。

カスタム・ビュー

ビジネスと戦略のデータのカスタマイズされたビューを表示できるようにするスコアカードのコンポーネント。

「Oracle Scorecard and Strategy Management」も参照してください。

ダッシュボード

企業や外部情報のパーソナライズされたビューを提供するオブジェクト。ダッシュボードは、1つ以上のページで構成されます。ページには、分析の結果、イメージ、エージェントからのアラートなどのWebブラウザでアクセスしたり開くことのできる任意のオブジェクトを表示できます。

ダッシュボード・プロンプト

ダッシュボードに追加されたプロンプト。ユーザーがプロンプト値を選択すると、ダッシュボードに含まれているすべての分析の表示内容がその値によって決まります。

「分析プロンプト」および「プロンプト」を参照してください。

ダッシュボードURL

外部ポータルまたはアプリケーションでの特定のダッシュボードのコンテンツの組込みや参照に使用されます。様々な形式と、動作の制御に使用されるオプションの引数があります。

データ・ソース名(DSN)

特定のデータベースに関する情報を含むデータ構造。通常、ODBCドライバによってデータベースへの接続に使用されます。DSNには、名前、ディレクトリ、データベースのドライバなどの情報が含まれます。

Oracle BIリポジトリの物理レイヤーの接続プール・オブジェクトには、各データ・ソースのDSN情報が含まれています。

データベース・ヒント

SQL文内にある、最も効率的に文を実行する方法をデータベース問合せオプティマイザに指定する指示。ヒントはオプティマイザの実行計画をオーバーライドするため、ヒントを使用してオプティマイザにより効率的な計画を使用させ、パフォーマンスを向上させることができます。ヒントは、Oracle Databaseデータ・ソースに対してのみサポートされます。

ディメンション

論理列(属性)の階層状の編成。1つのディメンションに、1つだけでなく複数の論理ディメンションが関連付けられることもあります。

ディメンションには、1つ以上の(名前なし)階層が含まれることがあります。論理ディメンションには、レベル・ベースの階層(構造階層)を持つディメンションと親子階層(値階層)を持つディメンションの2種類があります。

時間ディメンションと呼ばれる特定のタイプのレベル・ベースのディメンションは、時系列データをモデリングするための特別な機能を提供します。

「階層」も参照してください。

ディメンション表

特定のディメンションで使用される列を含む論理表。ディメンション表をファクト表にすることはできません。

「ファクト表」も参照してください。

駆動表

一方の表が非常に小さく(駆動表)、他方の表が非常に大きい場合にOracle BIサーバー・プロセスが複数データベース結合を処理する方法の最適化に使用されるメカニズム。

DSN

「データ・ソース名(DSN)」を参照してください。

イベント・ポーリング表

イベント・ポーリング表(イベント表とも呼ばれる)は、更新された物理表に関する情報をOracle BIサーバーに提供します。問合せキャッシュを最新に保つために使用されます。Oracle BIサーバー・キャッシュ・システムはイベント表を調べ、物理表の情報を行から抽出し、それらの物理表を参照する古いキャッシュ・エントリをパージします。

Essbase

Oracleから使用できる多次元データベース管理システムで、ビジネス・インテリジェンス・アプリケーションを構築するベースとなる多次元データベース・プラットフォームを提供します。Oracle Hyperion Essbaseとも呼ばれます。

ファクト表

メジャーを含み、ディメンション表と複雑な結合関係にある、Oracle BIリポジトリ内のビジネス・モデルとマッピング・レイヤーの論理表。

「ディメンション表」も参照してください。

フィルタ

分析の実行時に表示される結果を限定する、属性列とメジャー列に適用される基準。メジャー列の場合、フィルタは問合せの集計前に適用され、問合せと結果の値に作用します。

「プロンプト」および「選択ステップ」も参照してください。

フォーカス・ノード

図の開始目標を表す、戦略貢献ホイールのセンター・サークルです。

「戦略貢献ホイール」と「フォーカス追跡」も参照してください。

フォーカス追跡

戦略貢献ホイールの中央にあるノード、および図に表示されているその祖先を表す一連の連鎖した円です。各円には、対応するノードのステータス色が表示されます。

「戦略貢献ホイール」と「フォーカス・ノード」も参照してください。

外部キー

別の表の主キー列を参照する、表の列または列のセット。

断片化の内容

指定されたレベルのデータのセット全体が論理表ソースに含まれていない場合の論理表ソース内の指定されたデータのセットの一部。断片化の内容は、「論理表ソース」ダイアログ・ボックスの「内容」タブの「断片化の内容」ボックスに入力された論理列によって定義されます。

Fusion Middleware Control

Fusion Middlewareコンポーネントのモニターと構成を行えるWebベースの管理ツール。

グローバル・ヘッダー

ユーザーがOracle BIプレゼンテーション・カタログ内の特定のオブジェクトの検索やタスクの開始をすばやく実行できるようにするためのリンクとオプションを含む、Oracle BI Presentation Servicesのユーザー・インタフェース内のオブジェクト。グローバル・ヘッダーはプレゼンテーション・サービスのユーザー・インタフェースに常に表示されるため、ユーザーは、ホーム・ページやカタログ・ページに移動することなく、リンクにすばやくアクセスし、カタログを検索できます。

Go URL

特定のビジネス・インテリジェンスの結果の外部ポータルやアプリケーションへの組込みに使用されます。Go URLは、結果をお気に入りに追加したり、ダッシュボードや外部Webサイトへのリクエストにリンクを追加する場合に使用されます。様々な形式と、動作の制御に使用されるオプションの引数があります。

階層列

名前付きレベルと親子関係の両方を使用して編成されたデータ値が含まれたプレゼンテーション・サービス内の列。この列は、ツリーのような構造を使用して表示されます。個々のメンバーは、下位メンバーが上位メンバーにまとめられて略示されます。たとえば、特定の日は特定の月に属し、特定の月は特定の年内にあります。時間や地域などがこの例です。

「属性列」も参照してください。

階層

1対多関係で相互に関連を持つ、Oracle BIリポジトリ内の論理ディメンションのレベルのシステム。すべての階層は共通のリーフ・レベルと共通のルート・レベルを持つ必要があります。

階層は、メタデータでは個別のオブジェクトとしてモデル化されていません。かわりに、ディメンション・オブジェクトに暗黙的に含まれています。

「ディメンション」、「論理レベル」および「プレゼンテーション階層」も参照してください。

階層レベル

ロールアップしたり、他のレベルからロールアップされる、プレゼンテーション・サービスの階層列内のオブジェクト。Oracle BIリポジトリのプレゼンテーション・レベルに相当します。

「プレゼンテーション・レベル」も参照してください。

ホーム・ページ

プレゼンテーション・サービスの機能に直観的にアクセスできる、タスク・ベースの入口。ホーム・ページはセクションごとに構成されているため、該当するセクションで特定のタスクの開始、オブジェクトの検索、またはテクニカル・ドキュメントへのアクセスを迅速に行えます。

イメージ・プロンプト

特定の値がマップされた異なる領域のイメージを提供するプロンプト。ユーザーがイメージ領域をクリックすると、プロンプト値が選択され、分析またはダッシュボードに移入されます。

「プロンプト」も参照してください。

初期化ブロック

動的リポジトリ変数、システム・セッション変数およびシステム以外のセッション変数の初期化に使用されます。初期化ブロックには、そのブロックに関連付けられた変数の初期化やリフレッシュのために実行されるSQL文が含まれます。

イニシアティブ

スコアカードで使用されます。イニシアティブは、目標を達成するために必要な、時間に固有のタスクまたはプロジェクトです。したがって、目標をサポートするイニシアティブを、戦略ターゲットに対する進捗を示すマイルストンとして使用できます。

「目標」および「Oracle Scorecard and Strategy Management」も参照してください。

内部グラフ

トレリス・グラフのグリッド内のネストされたグラフ。各内部グラフには、「レイアウト」ペインの「可視化」領域に指定された独自のディメンションがあります。

トレリスおよび外部エッジも参照してください。

Javaコンポーネント

1つ以上のJava EEアプリケーション(およびリソースのセット)としてデプロイされ、ノード・マネージャによって管理されるFusion Middleware Controlコンポーネント。

「ノード・マネージャ」も参照してください。

キー・パフォーマンス・インディケータ(KPI)

特定のビジネス・ゴールと戦略目標を定義し、追跡する測定法。KPIをまとめると、モニター、改善および評価を必要とする、より大きな組織の戦略につながることが多くあります。KPIは、通常時間とともに変わる測定可能な値で、スコアとパフォーマンス・ステータスを決定するためのターゲットを持ちます。詳細な分析を可能にするディメンションが含まれ、トレンド用およびパフォーマンス・パターンの特定のために経時的な比較を行えます。

「Oracle Scorecard and Strategy Management」も参照してください。

KPI監視リスト

エンド・ユーザーへのKPIの配信方法の1つ。監視リストは、Oracle BIプレゼンテーション・カタログに格納されているKPIを追加することによって構成されたKPIの集まりです。構成して保存したKPI監視リストは、カタログ・オブジェクトとして格納され、ダッシュボードとスコアカードに追加できます。

キー・パフォーマンス・インディケータ(KPI)、ウォッチリストおよびOracle Scorecard and Strategy Managementも参照してください。

レベル

「階層レベル」を参照してください。

論理表示フォルダ

Oracle BIリポジトリのビジネス・モデルとマッピング・レイヤーでのオブジェクトの編成に使用されるフォルダ。メタデータ上の意味はありません。

論理結合

論理表間の関係を表す結合。論理結合は、物理的な結合ではなく概念上の結合です。つまり、特定のキーまたは列を結合しません。1つの論理結合が、多数の物理結合に相当することがあります。

論理レイヤー

「ビジネス・モデルとマッピング・レイヤー」を参照してください。

論理レベル

ロールアップしたり、他のレベルからロールアップされる、Oracle BIリポジトリ内のレベル・ベースの階層のコンポーネント。

親子階層では、祖先と子孫の間にメタデータの論理レベル・オブジェクトとして表されない、暗黙的なメンバー間のレベルがあります。親子階層には論理レベル・オブジェクトも含まれますが、それらのレベルはシステムで生成されたもので、全メンバーの集計を可能にするためにのみ存在します。

「ディメンション」および「階層」を参照してください。

論理SQL

Oracle BIサーバーによって解釈されるSQL文。Oracle BIサーバーの論理SQLには、標準のSQLとAGO、TODATE、EVALUATEなどの特別な関数(拡張SQL)が含まれます。

ユーザーがリクエストを行うと、プレゼンテーション・サービスなどのクライアントは、論理SQLをOracle BIサーバーに送信します。また、論理SQLはビジネス・モデルとマッピング・レイヤーで使用され、異機種データベース・アクセスと移植を可能にします。Oracle BIサーバーは、論理SQLを、ソース・データベースで解釈可能な物理SQLに変換します。

論理表

Oracle BIリポジトリのビジネス・モデルとマッピング・レイヤーの表オブジェクト。1つの論理表は、1つ以上の物理表にマップできます。論理表は、ファクト表またはディメンション表のいずれでもかまいません。

「ディメンション表」および「ファクト表」も参照してください。

論理表ソース

1つの論理表から1つ以上の物理表へのマッピングを定義する、Oracle BIリポジトリのビジネス・モデルとマッピング・レイヤー内のオブジェクト。物理/論理間のマッピングは、物理レイヤーとビジネス・モデルおよびマッピング・レイヤーとの間で発生する変換を指定するためや、集計ナビゲーションと断片化を有効にするために使用されることもあります。

管理対象サーバー

個々のJ2EEアプリケーション・コンテナ(JMX MBeanコンテナ)。ローカル・ミドルウェア・ホーム内に格納されているJavaコンポーネントとシステム・コンポーネントに対するローカル管理機能を個々のホストで提供します。構成とデプロイメントの全情報については、管理サーバーを参照します。

「管理サーバー」と「Fusion Middleware Control」も参照してください。

MDS

Oracle Metadata Services。Application Development Frameworkの中核テクノロジ。MDSは、メタデータを拡張可能でカスタマイズ可能な形で定義および使用するための統一アーキテクチャを提供します。

「MDS XML」も参照してください。

MDS XML

Oracle Metadata Servicesと互換性があるXML形式。MDS XMLはOracle BIリポジトリでサポートされている形式です。サードパーティのソース・コントロール管理システムとの統合が可能になり、オフラインのリポジトリ開発が可能になります。

MDS XML形式は、Oracle BIサーバーXML APIで生成されるXMLとは異なる形式です。

「MDS」、「Oracle BIリポジトリ」および「Oracle BIサーバーXML API」も参照してください。

メジャー列

レコードごとに可変で、合計や集計を行える列。売上金額や注文数量は典型的なメジャーです。メジャーは、問合せ時にデータ・ソースから計算されます。

メジャー列は、Oracle BIリポジトリ(通常はファクト表)またはプレゼンテーション・サービスで表示されます。

メタデータ

データに関するデータ。メタデータ・オブジェクトには、スキーマの説明(表、列、データ型、主キー、外部キーなど)と論理構造(ファクト表、ディメンション、論理表ソース・マッピングなど)が含まれます。

Oracle BIリポジトリは、Oracle BIサーバーによって問合せの処理に使用されるメタデータで構成されます。

メタデータ・ディクショナリ

列などのメタデータ・オブジェクトについて、そのプロパティや他のメタデータ・オブジェクトとの関係などが記述された静的なXMLドキュメントのセット。メタデータ・ディクショナリは、ユーザーがリポジトリ・オブジェクトのメトリックや属性の詳細を得る場合に役立ちます。

マイクロチャート

他の小さなグラフおよび数値とともにグリッドに表示される小さなグラフで、拡張トレリス・ビューのセル内容を構成します。Oracle BI EEでは、マイクロチャートは常にスパーク・グラフになります。

拡張トレリスおよびスパーク・グラフも参照してください。

ミッション・ステートメント

ビジョンを達成するために必要な主要なビジネス・ゴールと優先度を指定したスコアカード内のステートメント。

ビジョン記述書およびOracle Scorecard and Strategy Managementも参照してください。

複数データベース結合

Oracle BIリポジトリ内の2つの表の結合。各表は異なるデータベース内にあります。

ノード・マネージャ

Javaプロセスが応答しなくなったり、予期せず終了した場合にリモート・サーバーの起動、停止および再起動の機能を提供するデーモン・プロセス。

「Javaコンポーネント」も参照してください。

OCI

「Oracle Call Interface(OCI)」を参照してください。

ODBC

「Open Database Connectivity(ODBC)」を参照してください。

オブジェクト・プロパティ

オブジェクト、および所有者がオブジェクトに割り当てた属性に関する情報。プロパティの例には、名前、説明、日付スタンプ、読取り専用アクセス、索引付けなしフラグなどがあります。

「パーミッション」も参照してください。

目標

企業の戦略をまとめたスコアカード内の要求される成果または望ましい結果。

「イニシアティブ」および「Oracle Scorecard and Strategy Management」も参照してください。

オフライン・モード

Oracle BIサーバーにロードされていないリポジトリをリポジトリ・ビルダーが編集できるOracle BI管理ツール内のモード。

オンライン・モード

リポジトリを問合せ処理に使用すると同時にリポジトリ・ビルダーが編集できるOracle BI管理ツール内のモード。オンライン・モードでは、リポジトリ内のサブジェクト・エリアに接続しているユーザーのユーザー・セッション・モニタリングも可能です。

不透明なビュー

SELECT文を構成する物理レイヤー表。Oracle BIリポジトリでは、不透明なビューは、物理データベース内のビュー表のように見えますが、ビューは実際には存在しません。

Open Database Connectivity(ODBC)

リレーショナル・データベースとリレーショナル以外のデータベースの両方のデータへのアクセスに使用される標準インタフェース。データ格納形式やプログラミング・インタフェースがデータベース間で異なっていても、ODBCを使用することによって、様々なタイプのデータベース管理システムにデータベース・アプリケーションからアクセスできます。

OPMN

「Oracle Process Manager and Notification Server(OPMN)」を参照してください。

Oracle BI管理ツール

Oracle BIリポジトリの作成や編集に使用されるWindowsアプリケーション。管理ツールでは、リポジトリのツリー部分(物理レイヤー、ビジネス・モデルとマッピング・レイヤー、およびプレゼンテーション・レイヤー)がグラフィック表示されます。

Oracle BIブリーフィング・ブック

ダッシュボード・ページ、個々の分析およびBI Publisherレポートの静的または更新可能なスナップショットの集まり。ブリーフィング・ブックをPDFまたはMHTML形式でダウンロードし、印刷または表示できます。エージェントを使用して、ブリーフィング・ブックの更新、スケジュールおよび配信を行うこともできます。

Oracle BI JavaHost

Javaライブラリに用意されている、グラフなどのコンポーネントをサポートするための機能をプレゼンテーション・サービスが使用できるようにするサービス。サービスは、リクエスト/レスポンス・モデルに基づいて提供されます。

Oracle BI論理SQLビュー・オブジェクト

開発者が、Oracle BIサーバーにアクセスしてビジネス・インテリジェンス・データをフェッチし、ネイティブADFコンポーネントにバインドしてADFページに含める論理SQL文を作成できるようにします。このビュー・オブジェクトは、BI JDBC接続を使用してOracle BIサーバーに接続します。

Oracle BIプレゼンテーション・カタログ

分析やダッシュボードなどのビジネス・インテリジェンス・オブジェクトを格納し、ユーザーが、オブジェクトの作成、アクセスおよび管理を行ったり、オブジェクト・ベースの特定のタスク(エクスポート、印刷、編集など)を行うインタフェースを提供します。カタログは、共有または個人のいずれかのフォルダに編成されます。

Oracle BIプレゼンテーション・サービス

Webクライアントへのビジネス・インテリジェンス・データのプレゼンテーションに使用されるフレームワークとインタフェースを提供します。また、このプレゼンテーション・フレームワークのカスタマイズ用に、ファイル・システム上にプレゼンテーション・カタログ・サービスを保持します。スタンドアロン・プロセスであり、ODBC over TCP/IPを使用してOracle BIサーバーと通信します。アンサー、デリバーおよびインタラクティブ・ダッシュボードと呼ばれるコンポーネントで構成されます。

「ODBC」、「Oracle BIサーバー」、「Oracle BIプレゼンテーション・カタログ」、「Oracle BIプレゼンテーション・サービス・サーバー」も参照してください。

Oracle BIプレゼンテーション・サービス・サーバー

情報とデータをOracle BIサーバーと交換するOracle BI Webサーバー。

Oracle BI Publisher

エンタープライズ全体の公開サービスを提供するOracle Business Intelligence内のJ2EEアプリケーション。高度に書式設定された、ピクセル・パーフェクトなレポートを生成します。

「レポート」も参照してください。

Oracle BI Publisherレポート

「レポート」を参照してください。

Oracle BIリポジトリ

Oracle Business Intelligenceメタデータのセットで、論理スキーマ、物理スキーマ、物理から論理へのマッピング、集計表ナビゲーションやその他の構成体を定義します。Oracle BIリポジトリの形式をバイナリ形式(RPD)にして、リポジトリ・メタデータを拡張子.rpdの単一ファイルまたはMDS XMLドキュメントのセットに格納できます。MDS XML形式のリポジトリを使用できるのはオフライン開発時のみで、この形式のリポジトリはOracle BIサーバーにロードできません。Oracle BIリポジトリは両形式とも、Oracle BI管理ツールを使用して編集できます。

「メタデータ」および「Oracle BI管理ツール」も参照してください。

Oracle BIスケジューラ

指定された時間に結果をユーザーに配信するようスケジュールするための拡張可能なスケジューリング・アプリケーション。Oracle BI Deliversの機能をサポートするエンジンです。

「結果」も参照してください。

Oracle BIサーバー

ODBCを介してプレゼンテーション・サービスや他のクライアントに提供する論理データ・モデルを保持するスタンドアロン・プロセス。データ・モデルに関するメタデータは、リポジトリ・ファイルと呼ばれるローカルの専用ファイルに保持されます。Oracle BIサーバーは、ユーザー・リクエストやベースとなるデータ・ソースの問合せを処理します。

Oracle BIサーバーXML API

Oracle BIリポジトリ・メタデータの汎用的なXMLベースのプレゼンテーションを作成するユーティティを提供します。このXMLファイル版のリポジトリは、プログラムによるメタデータの変更に使用されます。Oracle BIサーバーのXML APIオブジェクトは、RPDファイル内のメタデータ・リポジトリ・オブジェクトに対応しています。これらのオブジェクトは、Oracle BIプレゼンテーション・カタログのXMLオブジェクトとは異なります。

Oracle BIサーバーXML APIで生成されるXMLは、サードパーティのソース・コントロール管理システムと統合されたOracle BIリポジトリで使用されるMDS XMLとは異なります。

「MDS XML」も参照してください。

Oracle Business Intelligence Mobile

Oracle Business Intelligence Mobileは、Apple iPhoneやApple iPadなどのサポートされているモバイル・デバイスでのOracle BI EEコンテンツの表示を可能にします。

Oracle Business Intelligence Mobileを使用することによって、分析やダッシュボード、BI Publisherコンテンツ、スコアカード・コンテンツ、エージェントによって配信されたコンテンツなどのBIコンテンツを表示および分析できます。

Oracle Business Intelligence Webサービス

「Oracle Business Intelligenceセッション・ベースWebサービス」および「Oracle Business Intelligence SOA用Webサービス」を参照してください。

Oracle Business Intelligenceセッション・ベースWebサービス

SOAPを実装するAPI。これらのWebサービスはプログラムでの使用を目的として設計されており、開発者は、1つのWebサービスから多様なビジネス・インテリジェンス・オブジェクトを起動します。これらのWebサービスは、様々なプレゼンテーション・サービス処理に対する機能を提供します。これらのWebサービスによって、開発者は、Oracle BIプレゼンテーション・サービスから結果を抽出して外部アプリケーションに配信したり、プレゼンテーション・サービス管理機能を実行したり、Oracle Business Intelligenceアラート(インテリジェント・エージェンとも呼ばれる)を実行できます。

「Oracle Business Intelligence SOA用Webサービス」も参照してください。

Oracle Business Intelligence SOA用Webサービス

BIミドルウェアJ2EEアプリケーションによってホストされる、ExecuteAgent、ExecuteAnalysisおよびExecuteConditionの3つのWebサービスを含みます。これらのWebサービスは、開発者がサード・パーティWebサービス・クライアント(Oracle SOA Suiteなど)を使用して、ビジネス・インテリジェンス・オブジェクトを検索したり、サービス指向アーキテクチャ・コンポーネントに含めたりすることを可能にするよう設計されています。

「Oracle Business Intelligenceセッション・ベースWebサービス」も参照してください。

Oracle Call Interface(OCI)

Oracle Databaseデータ・ソースへの接続にOracle BIサーバーが使用する接続インタフェース。Oracle DatabaseからのメタデータのインポートやOracle Databaseへの接続には常にOCIを使用する必要があります。

Oracle OLAP

Oracle Databaseは、分析処理をオンラインで実行するフル装備の埋込みサーバーを提供するOLAPオプションを備えています。

Oracle Business Intelligenceはデータ・ソースとしてOracle OLAPをサポートしています。Oracle OLAPソースからメタデータをインポートすると、管理ツールの物理レイヤーにそのOracle OLAPオブジェクトが表示されます。Oracle OLAPオブジェクトには、関連キューブを格納するコンテナであるアナリティック・ワークスペースも含まれます。

Oracle Process Manager and Notification Server(OPMN)

すべてのシステム・コンポーネント(サーバー・プロセス)を管理するとともに、ローカル・プロセスと分散プロセスの管理、自動プロセス・リサイクリング、およびプロセスの状態(稼働、停止、起動中、停止中)の伝達をサポートするプロセス管理ツール。OPMNはプロセスの使用不可の状態を検知し、プロセスを自動的に再起動します。

「システム・コンポーネント」も参照してください。

Oracle Scorecard and Strategy Management

ビジネス戦略を表明して伝達することができる業績管理ツール。企業の戦略や業績をトップ・ダウンまたはボトム・アップで推進したり評価できます。

Oracle Technology Network(OTN)

オラクル社製品に関する技術情報のリポジトリで、記事の検索、ディスカッションへの参加、ユーザー・コミュニティへの技術的な質問およびオラクル社製品とドキュメントの検索とダウンロードを行えます。

外部エッジ

外部エッジは、内部グラフの境界に使用されるトレリス・ビューの部品です。これには、列および行のヘッダー、セクション・ヘッダーなどが含まれます。

トレリスおよび内部グラフも参照してください。

親子階層

タイプがすべて同じメンバーの階層。親子階層のディメンション・メンバーはすべて1つのデータ・ソースに存在します。親子階層では、メンバー間の関係は、ディメンション・メンバー間の親子関係です。

「ディメンション」も参照してください。

親子関係表

親子階層でのメンバー間の関係を明示的に定義する値を持つ表。クローズ表とも呼ばれます。

パススルー計算

Oracle BIサーバーによって計算されず、別のデータ・ソースに渡される計算。上級ユーザーが、Oracle BIリポジトリを変更することなく、データ・ソースの機能と関数を活用できるようにします。

パフォーマンス・タイル

ビュー・タイプの1つで、視覚的に単純かつ目立つ方法で1つの集計メジャー値を表示しながら、ダッシュボード・ビューに詳細に表示される可能性があるサマリー・メトリックをただちに示します。パフォーマンス・タイル・ビューは、色、ラベルおよび限定されたスタイルを使用して、または背景色またはメジャー値の条件付き書式設定を使用して、単純な書式で視覚的に目立つようにステータスを通知します。

パーミッション

どのユーザーがオブジェクトにアクセスできるかを指定し、ユーザーのオブジェクトとの対話方法を制限します。パーミッションの例には、書込み、削除、変更などのパーミッションがあります。

「オブジェクト・プロパティ」を参照してください。

パースペクティブ

スコアカードでイニシアティブ、目標およびKPIに関連付ける組織内のカテゴリ。パースペクティブでは、主な利害関係者(顧客、従業員、株主/財務関係者など)や主なコンピテンシー分野(時間、コスト、品質など)を表すことができます。

「イニシアティブ」、「キー・パフォーマンス・インディケータ(KPI)」、「目標」および「Oracle Scorecard and Strategy Management」も参照してください。

物理カタログ

Oracle BIリポジトリの物理レイヤーにある、異なるスキーマをまとめるオブジェクト。カタログには、データベース・オブジェクトのすべてのスキーマ(メタデータ)が含まれます。

物理表示フォルダ

Oracle BIリポジトリの物理レイヤーにオブジェクトを編成するフォルダ。メタデータ上の意味はありません。

物理結合

Oracle BIリポジトリの物理レイヤーの表同士の結合。

物理レイヤー

バックエンド・データ・ソースからの物理データ構成体を表すオブジェクトを含むOracle BIリポジトリのレイヤー。物理レイヤーは、物理問合せの記述に使用できるオブジェクトと関係を定義します。このレイヤーによってソースの依存性がカプセル化され、移植とフェデレーションが可能になります。

物理スキーマ

バックエンド・データベースからのスキーマを表すOracle BIリポジトリの物理レイヤーのオブジェクト。

物理表

Oracle BIリポジトリの物理レイヤーのオブジェクトで、通常、物理データベースに存在する表に相当します。

「物理レイヤー」も参照してください。

視点領域

KPIおよびスコアカード内で、担当しているビジネス分野など、関心のある特定のデータを示す領域です。視点領域には、イニシアティブと目標の進捗とパフォーマンスを測定するためにスコアカードで使用されるKPIのディメンションに対するコントロールが表示されます。

「イニシアティブ」、「キー・パフォーマンス・インディケータ(KPI)」および 「目標」も参照してください。

プレゼンテーション階層

プレゼンテーション・サービスやその他のクライアントで多次元モデルを公開する明示的な方法を提供するOracle BIリポジトリの物理レイヤーのオブジェクト。プレゼンテーション階層は、メンバーの選択、カスタム・メンバー・グループ、非対称型問合せなどの分析機能を公開します。ユーザーは、プレゼンテーション階層を使用して階層ベースの問合せを作成できます。

プレゼンテーション・サービスで、プレゼンテーション階層は階層列として表示されます。

「階層列」および「プレゼンテーション・レベル」も参照してください。

プレゼンテーション・レイヤー

カスタマイズされた、ロール・ベースのセキュアなビジネス・モデルのビューをユーザーに表示する方法を提供します。Oracle BIリポジトリのビジネス・モデルとマッピング・レイヤー上に抽象化レベルを追加します。プレゼンテーション・レイヤーは、プレゼンテーション・サービスやその他のクライアント・ツールおよびアプリケーションで分析を作成したユーザーに表示されるデータ・ビューを提供します。

「ビジネス・モデルとマッピング・レイヤー」も参照してください。

プレゼンテーション・レベル

ロールアップしたり、他のレベルからロールアップされる、Oracle BIリポジトリ内のプレゼンテーション階層のコンポーネント。プレゼンテーション・レベルは、プレゼンテーション・サービスで階層列内のレベルとして表示されます。

「階層レベル」および「プレゼンテーション階層」も参照してください。

プレゼンテーション・サービス

「Oracle BIプレゼンテーション・サービス」を参照してください。

プレゼンテーション・サービス・サーバー

「Oracle BIプレゼンテーション・サービス・サーバー」を参照してください。

プレゼンテーション表

ユーザー・コミュニティにとって意味のあるカテゴリへの列の編成に使用されるOracle BIリポジトリのプレゼンテーション・レイヤーのオブジェクト。プレゼンテーション表には、1つ以上の論理表から列を含めることができます。プレゼンテーション表の名前とオブジェクト・プロパティは論理表のプロパティとは無関係です。

主キー

各値が一意で、表の1行を識別する列(または列のセット)。

プロセス・インスタンス

BIインスタンスに関連付けられている、個々のワークステーション上の一意のプロセス。

「BIインスタンス」も参照してください。

プロンプト

フィルタの一種。コンテンツ・デザイナによるデータ値の作成および指定を可能にするほか、エンド・ユーザーが特定の値を選択してダッシュボードまたはダッシュボード・ページに含まれている個々の分析または複数の分析に対する結果セットを取得できるようにします。プロンプトによって、既存のダッシュボード・フィルタおよび分析フィルタが拡張または改良されます。

プロンプトのタイプには、列プロンプト、通貨プロンプト、イメージ・プロンプトおよび変数プロンプトがあります。

「列プロンプト」、「通貨プロンプト」、「フィルタ」、「イメージ・プロンプト」および「変数プロンプト」も参照してください。

プロンプト・リンク

ダッシュボード・ページへのパスとダッシュボード・プロンプトの単純化されたプレゼンテーションを取り込みます。

「ブックマーク・リンク」を参照してください。

問合せ

Oracle BIサーバーに発行される、ベースとなるSQL文が含まれています。Oracle Business Intelligenceの使用に問合せ言語の知識は必要ありません。

問合せキャッシュ

他の問合せで使用できるよう問合せの結果を格納する機能。

不規則な階層

「非バランス型階層」を参照してください。

レポート

問合せの実行からユーザーに返される、Oracle BI Publisherを使用して作成されるレスポンス。レポートは、書式設定、ダッシュボード・ページでの表示、Oracle BIプレゼンテーション・カタログでの保存および他のユーザーとの共有が可能です。

「分析」も参照してください。

リポジトリ

「Oracle BIリポジトリ」を参照してください。

リポジトリ変数

「変数」を参照してください。

結果

Oracle BIサーバーから返される、分析に対する出力。

「分析」も参照してください。

スコアカード

「Oracle Scorecard and Strategy Management」を参照してください。

選択ステップ

問合せの集計後に適用される値の選択。表示されているメンバーにのみ作用し、結果の集計値には作用しません。フィルタ同様、選択ステップは分析の結果を限定します。

「分析」および「フィルタ」も参照してください。

セッション変数

「変数」を参照してください。

単純トレリス

すべてが散布図の場合のように、トレリス・ビューはすべて同じタイプで内部の可視化を表示します。内部の可視化には、共通の軸が常に使用され、同期されたスケールとも呼ばれます。

トレリス、同期されたスケールおよび可視化も参照してください。

レベル・スキップ階層

一部のメンバーが特定の祖先レベルの値を持たない階層。たとえば、米国で、コロンビア特別区のワシントン市は州に属していません。州がなくても、国レベル(米国)からワシントン以下にユーザーが移動できることが期待されます。

「階層」も参照してください。

スマート・ウォッチリスト

スマート・ウォッチリストとは、指定した基準に基づいた、特定のスコアカードに対するビューのことです。たとえば、スマート・ウォッチリストには、スコアカードのパフォーマンス上位10位までのKPI、または特定のビジネス所有者が所有するスコアカードのすべての目標、イニシアティブおよびKPIなどを表示できます。

ウォッチリストおよびOracle Scorecard and Strategy Managementも参照してください。

スノーフレーク・スキーマ

1つ以上のディメンションが部分的あるいは完全に正規化されたディメンション・スキーマ。

スパーク・グラフ

他のミニグラフおよび数値と組み合せて、1つのトレンドを表す埋込みミニグラフ。スパーク・グラフはスパークとも呼ばれます。

スパークには軸またはラベルは含まれず、周囲のコンテンツからコンテキストが取得されます。スパーク・グラフの各タイプには、1つのメジャーのみが存在します。このメジャーは非表示で、自分のみに対して相対的なスケールになります。

スパーク・グラフには、スパーク折れ線、スパーク棒、スパーク面のいずれかのグラフ・サブタイプを指定できます。

マイクロチャートも参照してください。

SQL

「構造化問合せ言語(SQL)」を参照してください。

スター・スキーマ

履歴情報のディメンション分析を可能にするリレーショナル・スキーマ。スター・スキーマでは、論理ディメンション表と論理ファクト表の間に1対多関係があります。各スターは、1つのファクト表と正規化されていない表のセットで構成されます。

戦略貢献ホイール

スコアカードのコンポーネントで、これを使用すると、親目標に対する特定の目標またはKPIの貢献(または影響)を一連の同心円(ホイール図)の中で簡単に確認できます。目標とそれをサポートする子の目標、およびKPIを階層的に表示する場合に、戦略貢献ホイール図を使用します。

「Oracle Scorecard and Strategy Management」も参照してください。

戦略マップ

スコアカードに定義された目標とその進捗を測定するKPIが、パースペクティブに基づいていかに連携しているかを示す、スコアカードのコンポーネント。因果関係も示します。

「Oracle Scorecard and Strategy Management」も参照してください。

戦略ツリー

目標とこれをサポートする子目標およびKPIがツリー図に階層状に表示されるスコアカードのコンポーネント。

「Oracle Scorecard and Strategy Management」も参照してください。

構造化問合せ言語(SQL)

データの問合せと変更のための標準的なプログラミング言語。

「論理SQL」も参照してください。

サブジェクト領域

ビジネス・モデルに関するデータを編成および表示する、Oracle BIリポジトリのプレゼンテーション・レイヤー内のオブジェクト。プレゼンテーション・レイヤーの最上位オブジェクトであり、プレゼンテーション・サービスでユーザーに表示されるデータのビューを表します。Oracle BIリポジトリのサブジェクト・エリアには、プレゼンテーション表、プレゼンテーション列およびプレゼンテーション階層が含まれます。

プレゼンテーション・サービスでは、サブジェクト・エリアに、フォルダ、メジャー列、属性列、階層列およびレベルが含まれます。

同期されたスケール

(単純トレリスのみに該当) 同期されたスケールとは、トレリス内のすべての可視化が同じスケールで表示される、つまり共通の軸を共有することです。共通の軸があれば、すべてのグラフ・マーカーを行と列で簡単に比較できます。

単純トレリスおよび可視化も参照してください。

システム・コンポーネント

Oracle Process Manager and Notification Server(OPMN)によって管理されるサーバー・プロセス(Javaアプリケーションではない)。

「Oracle Process Manager and Notification Server(OPMN)」も参照してください。

変換

データベースから他の場所(他のデータベースの場合もある)に移動する際にデータに行われる処理。一部の変換は、通常、トランザクション・システムからデータ・ウェアハウス・システムへの移動時にデータに対して行われます。

トレリス

多次元データが、グリッド内の一連のセルとして表示され、各セルは特定のグラフ・タイプを使用するデータのサブセットを表しています。データは、グラフ、マイクロチャートおよび数値で表されます。

トレリス・ビューには、単純トレリスと拡張トレリスの2つのサブタイプがあります。

拡張トレリスおよび単純トレリスも参照してください。

非バランス型階層

リーフの深さが異なる階層。たとえば、現在の月は日レベルでデータを持ち、前年は月レベルで、過去5年間は四半期レベルでデータを持つよう選択できます。

「階層」も参照してください。

値階層

「親子階層」を参照してください。

変数

管理タスクを効率化したり、変化するデータ環境に合せてメタデータの内容を動的に変更するために使用されるOracle BIリポジトリ内のオブジェクト。

変数は次のいずれかのタイプです。

- リポジトリ変数は、任意の時点で1つの値を持ちます。リポジトリ変数には、静的と動的の2種類があります。

- セッション変数は、各ユーザーのログイン時に作成され、値が割り当てられます。セッション変数には、システムとシステム以外の2種類があります。

変数プロンプト

ユーザーは、変数プロンプトに指定されている値を選択してダッシュボードに表示できます。変数プロンプトは列データに依存しませんが、変数プロンプトによって分析の列データの操作(加算や乗算など)が可能になります。

「プロンプト」も参照してください。

仮想物理表

ストアド・プロシージャまたはSELECT文から作成される物理表。仮想表を作成することによって、Oracle BIサーバーおよびベースとなるデータベースに、高度な問合せリクエストの実行に適したメタデータが提供されます。

ビジョン・ステートメント

組織が将来的にどうありたいかを表した、スコアカード内の簡潔なステートメントです。たとえば、南米ポリプロピレン市場で最も成功した企業になるなどです。

「ミッション・ステートメント」および「Oracle Scorecard and Strategy Management」も参照してください。

可視化

Oracle BI EEの場合、可視化とは、トレリス・ビューのデータ・セル内に表示されるグラフの選択肢のことです。棒グラフ、散布図、スパーク・グラフなど、トレリス・ビューを作成する際には、多数の可視化の中から選択できます。

トレリスも参照してください。

ウォッチリスト

スコアカードの特定の観点に関係し、特定の目的のためにグループ化された、スコアカード・オブジェクト(つまり、イニシアティブ、目標およびKPI)をリストする表。たとえば、KPIウォッチリストやスマート・ウォッチリストなどの様々なタイプのウォッチリストがあります。

KPIウォッチリスト、スマート・ウォッチリストおよびOracle Scorecard and Strategy Managementも参照してください。

ウォーターフォール・グラフ

連続的および累積的に値が増加または減少する状況を可視化できるグラフ・タイプです。ウォーターフォール・グラフでは、各メジャーの全体に対する貢献度が色を使用した単純な書式で示され、ユーザーがそこに注目できるようになっています。

WebLogic Serverドメイン

SOAP、HTTPおよびその他の形式のリクエストのサービスに加わるよう構成されたJavaコンポーネントが含まれます。

WebLogic Scripting Tool(WLST)

WebLogic Serverインスタンスとドメインの構成、管理および変更の保持と、サーバーの実行時のイベントのモニターおよび管理を可能にするコマンドライン・スクリプティング・インタフェース。

XML API

「Oracle BIサーバーXML API」を参照してください。

索引

A  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X

記号

_import()メソッド, 3.6.3

A

Access(Microsoft), Oracle Business Intelligenceとの統合例, 6.4

AccessControlToken構造体, 2.1

account要素, 5.3.4

Account構造体, 2.2

ACL構造体, 2.3

アクション・フレームワーク

概要, 5.1

資格証明の追加および保守, 5.5

資格証明, 5.4.1

提供される機能, 5.1.1

セキュリティ, 5.4

account要素, 5.3.4

content type要素, 5.3.3

ebusinesssuiteconfig要素, 5.3.7

location alias要素, 5.3.1

policy要素, 5.3.5

proxy要素, 5.3.6

registry要素, 5.3.2

構成チェックリスト, 5.2.1

構成の概要, 5.2

構成, 5.3

ActionFrameworkConfig.xml, 5.3 アクション

概要, 5.1.1

アクセス権, 5.4.3

権限, 5.4.2

セキュリティ, 5.4

ターゲット, 5.2.2, 5.6

OWSMの構成, 5.5.3

実行, 5.1.2

ブラウザ・スクリプトの起動, 5.6.7

Javaメソッド(EJB)の起動, 5.6.6

サーバー・スクリプトの起動, 5.6.8

Webサービスの起動, 5.6.4

エージェントの起動, 5.6.9

Javaジョブ, 5.6.10

E-Business Suiteにナビゲート, 5.6.2

EPMコンテンツにナビゲート, 5.6.1

タイプ, 5.1.2

addReportToPage()メソッド, 3.2.2 AggregationRule値, 2.19.2 API

ダッシュボードURL, 使用, 6.2

Go URL

Oracle Business Intelligence Systems Management, 7.1

SQL, Goコマンドを使用した発行, 6.3

サード・パーティのSQLツール, 統合例, 6.4

アプリケーション・プログラミング・インタフェース

「API」を参照

applyReportParams()メソッド, 3.7.1, 3.7.2 ArrayofGUIDS構造体, 2.4 認証, Oracle E-Business Suiteの設定, 10.2 authenticationschemas.xml file, Oracle E-Business Suite統合用の更新, 10.2.2 AuthResult構造体, 2.5

C

コールバックURL

変更, 3.2.1

置換, 3.2.8.3

cancelJob()メソッド, 3.4.1 cancelQuery()メソッド, 3.11.2 CatalogItemsFilter構造体, 2.6 CatalogObject構造体, 2.7 動作要件, はじめに アクション・フレームワーク構成のチェックリスト, 5.2.1 clearQueryCache()メソッド, 3.5.1 ConditionService

サービス, 3.1

構成

SOA用Webサービス, 1.4

接続性

ODBCデータ・ソース名, 構成, 8.4, 8.5

問合せおよびレポート・ツール, 使用について, 8.1

content type要素, 5.3.3 copyItem()メソッド, 3.10.3 copyItem2()メソッド, 3.10.4 createFolder()メソッド, 3.10.5 createLink()メソッド, 3.10.6 資格証明キー, 5.5.1 資格証明マップ, 5.5.1 資格証明

概要, 5.4.1

追加および保守, 5.5

D

ダッシュボードURL

概要と書式, 6.2

基本のダッシュボードURL, 概要および書式, 6.2.2

PortalPathパラメータ, 使用, 6.2.3

ユーザーIDとパスワードのパラメータ, 使用, 6.2.3

データ・ソース名, 概要, 8.2 データベース, サポート対象, はじめに デフォルトのキーストア, 5.5.2 deleteIBot()メソッド, 3.3.2 deleteItem()メソッド, 3.10.7 deleteResultSet()メソッド, 3.4.2 describeColumn()メソッド, 3.5.2, 3.5.2 describeSubjectArea()メソッド, 3.5.3 describeTable()メソッド, 3.5.4 Discovererメタデータ, 9.2 Discovererワークシート, 9.1 ドリルダウン・リンク, 3.2.1 ドライバ, Oracle BI DSN用, 8.4

E

EBS ICX認証Cookie, 10.2.2

ebusinesssuiteconfig要素, 5.3.7

使用可能

Webサービス通信に対するSSL, 1.5

SOA用Webサービス, 1.4

endPage()メソッド, 3.2.3 エラー・メッセージ言語, ODBC DSNの設定, 8.4 ErrorDetailsLevel構造体, 3.10.1 ErrorInfo構造体, 2.8 evaluateCondition()メソッド, 3.1.1 evaluateInlineCondition()メソッド, 3.1.2 ExecuteAgent, 1.3 ExecuteAnalysis, 1.3 ExecuteCondition, 1.3 executeIBotNow()メソッド, 3.3.3 executeSQLQuery()メソッド, 3.11.3 executeXMLQuery()メソッド, 3.11.4 アクションの実行, 5.1.2 export()メソッド, 3.6.4 ExportFlags構造体, 3.6.1

F

fetchNext()メソッド, 3.11.5

ファイル, ActionFrameworkConfig.xml, 5.3

フィルタ

Go URL, URLを使用した受渡し, 6.3.2

forgetAccount()メソッド, 3.9.1 フォーム関数, Oracle E-Business Suiteでの作成, 10.3.2

G

generateReportSQL()メソッド, 3.7.3

getAccounts()メソッド, 3.9.2

getCommonBodyHTML()メソッド, 3.2.4

getConditionCustomizableReportElements()メソッド, 3.1.3

getCounts()メソッド, 3.4.3

getCurUser()メソッド, 3.8.1

getGlobalPrivilegeACL()メソッド, 3.9.3

getGlobalSAWPrivileges()メソッド, 3.9.4

getGroups()メソッド, 3.9.5

getHeadersHTML()メソッド, 3.2.5

getHtmlforPageWithOneReport()メソッド, 3.2.6

getHTMLForReport()メソッド, 3.2.7

getItemInfo()メソッド, 3.10.8

getJobInfo()メソッド, 3.4.4

getMembers()メソッド, 3.9.6

getPermissions()メソッド, 3.9.7

getPrivilegesStatus()メソッド, 3.9.8

getPromptedColumns()メソッド, 3.4.5

getPromptedFilters()メソッド, 3.11.6

getSessionVariable()メソッド, 3.8.3

getSubItems()メソッド, 3.10.9

GetSubItemsParams構造体, 2.9

getSubjectAreas()メソッド, 3.5.5

Go URL

概要, 6.1

アプリケーション優先フォーマット, 結果の表示, 6.1.4

基本のGo URL, 概要と例, 6.1.3

フィルタ, URLを使用した受渡しについて, 6.3.2

HTMLの結果, ナビゲーション, 6.3.2.4

JavaScript, ナビゲーションに使用, 6.3.2.3

リンク・オプション, 書式と例, 6.1.4

ナビゲーションの例, 6.3.2.2

ナビゲーション・パラメータの構文, 6.3.2.1

プリンタ優先フォーマットと例, 6.1.4

結果フォーマット, 制御, 6.1.4

特定のスタイル, 結果の表示, 6.1.4

ビューの指定, 表示, 6.1.4

SQL, 発行とフィルタの受渡しに使用, 6.3

表, すべてのレコードの表示, 6.1.4.1

ユーザーIDとパスワード, プロンプト表示, 6.1.4

GoNav JavaScript関数, 概要, 6.3.2.3

H

HtmlViewService

ブリッジ, 3.2.1

サービス, 3.2

HTTPS

Webサービスの起動, 1.6

I

iBotService

サービス, 3.3

impersonate()メソッド, 3.8.4 impersonateex()メソッド, 3.8.5 import()メソッド, 3.6.3 ImportError構造体, 2.10 ImportFlags構造体, 3.6.2 instanceconfig.xmlファイル, Oracle E-Business Suite統合用の更新, 10.2.3 Oracle Business Intelligenceの統合

ダッシュボードURL, 使用, 6.2

フィルタ, URLを使用したGoコマンドへの受渡し, 6.3.2

Go URL, 使用, 6.1

SQL, Goコマンドを使用した発行, 6.3

サード・パーティのSQLツール, 統合例, 6.4

Oracle E-Business Suiteセキュリティ, 10

その他のクライアント, 8

「ブラウザ・スクリプトの起動」アクション, 5.6.7 Javaメソッド(EJB)を起動アクション, 5.6.6 「サーバー・スクリプトの起動」アクション, 5.6.8 「Webサービスの起動」アクション, 5.6.4 「エージェントの起動」アクション, 5.6.9 起動

HTTPSを使用したWebサービス, 1.6

isMember()メソッド, 3.9.9 ItemInfo構造体, 2.11

J

「Javaジョブ」アクション, 5.6.10

JDBC, Oracle BIサーバーとの統合に使用, 8.2.2

JobManagementService

サービス, 3.4

joinGroups()メソッド, 3.9.10

K

keepAlive()メソッド, 3.8.6

キーストア, 5.5.2

L

leaveGroups()メソッド, 3.9.11

ロケーション・エイリアス要素, 5.3.1

logoff()メソッド, 3.8.7

logon()メソッド, 3.8.8

logonex()メソッド, 3.8.9

M

maintenanceMode()メソッド, 3.10.10

markForReplication()メソッド, 3.6.5

メモリー要件, はじめに

メニュー

Oracle E-Business Suiteでの職責への割当て, 10.3.4

Oracle E-Business Suiteでの作成, 10.3.3

メタデータ変換アシスタント・ツール, 9.2 メタデータ, Discoverer, 9.2 MetadataService

サービス, 3.5

メソッド

getConditionCustomizableReportElements(), 3.1.3

メソッド

_import(), 3.6.3

addReportToPage(), 3.2.2

applyReportParams(), 3.7.1, 3.7.2

cancelJob(), 3.4.1

cancelQuery(), 3.11.2

clearQueryCache(), 3.5.1

copyItem(), 3.10.3

copyItem2(), 3.10.4

createFolder(), 3.10.5

createLink(), 3.10.6

deleteIBot(), 3.3.2

deleteItem(), 3.10.7

deleteResultSet(), 3.4.2

describeColumn(), 3.5.2, 3.5.2

describeSubjectArea(), 3.5.3

describeTable(), 3.5.4

endPage(), 3.2.3

evaluateCondition(), 3.1.1

evaluateInlineCondition(), 3.1.2

executeIBotNow(), 3.3.3

executeSQLQuery(), 3.11.3

executeXMLQuery(), 3.11.4

export(), 3.6.4

fetchNext(), 3.11.5

forgetAccount(), 3.9.1

generateReportSQL(), 3.7.3

getAccounts(), 3.9.2

getCommonBodyHTML(), 3.2.4

getCounts(), 3.4.3

getCurUser(), 3.8.1

getGlobalPrivilegeACL(), 3.9.3

getGlobalSAWPrivileges(), 3.9.4

getGroups(), 3.9.5

getHeadersHTML(), 3.2.5

getHtmlforPageWithOneReport(), 3.2.6

getHTMLForReport(), 3.2.7

getItemInfo(), 3.10.8

getJobInfo(), 3.4.4

getMembers(), 3.9.6

getPermissions(), 3.9.7

getPrivilegesStatus(), 3.9.8

getPromptedColumns(), 3.4.5

getPromptedFilters(), 3.11.6

getSessionVariable(), 3.8.3

getSubItems(), 3.10.9

getSubjectAreas(), 3.5.5

impersonate(), 3.8.4

impersonateex(), 3.8.5

インポート, 3.6.3

isMember(), 3.9.9

joinGroups(), 3.9.10

keepAlive(), 3.8.6

leaveGroups(), 3.9.11

logoff(), 3.8.7

logon(), 3.8.8

logonex(), 3.8.9

maintenanceMode(), 3.10.10

markForReplication(), 3.6.5

moveIBot(), 3.3.4

moveItem(), 3.10.11

pasteItem2(), 3.10.12

prepareCache(), 3.4.6

purgeCache(), 3.4.7

purgeLog(), 3.6.6

readObject(), 3.10.13

removeFolder(), 3.10.14

renameAccounts(), 3.9.12

SASubjectAreaDetails(), 3.5.3.2

SATablesDetails(), 3.5.4.2

saveResultSet(), 3.4.8

sendMessage(), 3.3.5

sessionEnvironment(), 3.8.2

setBridge(), 3.2.8

setBridge(), コールバックURLに使用, 3.2.1

setItemAttributes(), 3.10.15

setItemProperty(), 3.10.16

setOwnership(), 3.10.17

startPage(), 3.2.9

subscribe(), 3.3.6

unsubscribe(), 3.3.7

updateGlobalPrivilegeACL(), 3.9.13

upgradeXML(), 3.11.7

writeIBot(), 3.3.1

writeListFiles(), 3.4.9

writeObjects(), 3.10.19

Microsoft

Access, Oracle Business Intelligenceとの統合例, 6.4

最小ディスク領域, はじめに moveIBot()メソッド, 3.3.4 moveItem()メソッド, 3.10.11

N

NameValuePair構造体, 2.12

「E-Business Suiteにナビゲート」アクション, 5.6.2

「EPMコンテンツにナビゲート」アクション, 5.6.1

O

ODBC

概要, 8.2

拡張SSL設定, 8.4.1

物理レイヤーへの専用接続の作成, 8.2.1

データ・ソース名, 構成, 8.4, 8.5

ローカライゼーションに関する考慮事項, 8.2

問合せおよびレポート・ツール, 接続について, 8.1

サポートされるクライアント・アプリケーションからのコール, 8.3

オペレーティング・システム, サポート対象, はじめに Oracle BIリポジトリ

Oracle E-Business Suite統合用の物理レイヤーの構成, 10.1

Oracle E-Business Suite統合用のセッション変数の設定, 10.2.1

Oracle BIサーバー

JDBCを介した統合について, 8.2.2

ODBCを介した統合について, 8.2

Oracle Business Intelligence Systems Management API, 7.1 Oracle E-Business Suite

職責へのメニューの割当て, 10.3.4

ユーザーへの職責の割当て, 10.3.5

Oracle BIリポジトリの構成, 10.1

フォーム関数の作成, 10.3.2

メニューの作成, 10.3.3

Oracle Business Intelligenceへのリンクの埋込み, 10.3

プロファイルの設定, 10.3.6

共有認証の設定, 10.2

OWSM, 5.5.3

P

pasteItem2()メソッド, 3.10.12

PathMap構造体, 2.13

権限, 5.4.3

プラットフォーム, サポート対象, はじめに

ポリシー要素, 5.3.5

PortalNav JavaScript関数, 概要, 6.3.2.3

prepareCache()メソッド, 3.4.6

Privilege構造体, 2.14

権限, 5.4.2

プロファイル, Oracle E-Business Suiteでの設定, 10.3.6

プロンプトURL

概要, 6.1.1

プロキシ要素, 5.3.6 purgeCache()メソッド, 3.4.7 purgeLog()メソッド, 3.6.6

Q

問合せツール, 接続について, 8.1

QueryResults構造体, 2.15

R

readObject()メソッド, 3.10.13

ReadObjectReturnOptions

構造体, 3.10.2

レジストリ要素, 5.3.2 removeFolder()メソッド, 3.10.14 renameAccounts()メソッド, 3.9.12 ReplicationService

サービス, 3.6

ReportEditingService

サービス, 3.7

ReportHTMLLinksMode構造体, 2.16.1 ReportHTMLOptions構造体, 2.16 レポート・ツール, 接続について, 8.1 ReportParams構造体, 2.17 ReportRef構造体, 2.18 要件, システム, はじめに 職責, Oracle E-Business Suiteでのユーザーへの割当て, 10.3.5

S

SAColumn構造体, 2.19

SADataType値, 2.19.1

SASubjectArea構造体, 2.20

SASubjectAreaDetails()メソッド, 3.5.3.2

SATable構造体, 2.21

SATablesDetails()メソッド, 3.5.4.2

saveResultSet()メソッド, 3.4.8

SAWLocale構造体, 2.22

SAWSessionParameters構造体, 2.23

SAWSessionService

サービス, 3.8

保護

SOA用Webサービス, 1.4

SecurityService

サービス, 3.9

SegmentationOptions構造体, 2.24 SELECT_PHYSICAL, ODBC接続の設定, 8.2.1 sendMessage()メソッド, 3.3.5 サービス

ConditionService, 3.1

HtmlViewService, 3.2

iBotService, 3.3

JobManagementService, 3.4

MetadataService, 3.5

ReplicationService, 3.6

ReportEditingService, 3.7

SAWSessionService, 3.8

SecurityService, 3.9

WebCatalogService, 3.10

XMLViewService, 3.11

セッション変数, Oracle E-Business Suite統合用の設定, 10.2.1 セッションベースWebサービス

概要, 1.1, 1.2

SessionEnvironment構造体, 2.25 sessionEnvironment()メソッド, 3.8.2 setBridge()メソッド, 3.2.1, 3.2.8 setItemAttributes()メソッド, 3.10.15 setItemProperty()メソッド, 3.10.16 setOwnership()メソッド, 3.10.17 共有認証, Oracle E-Business Suite, 10.2 シングル・サインオン, EBS-ICX認証Cookieを使用する場合の制限事項, 10.2 SOA

SOA用Webサービス, 1.3

SQL

サード・パーティ・ツールの統合例, 6.4

Goコマンドを使用したSQLの発行とフィルタの受渡し, 6.3

SSL

Webサービス通信の有効化, 1.5

SSL, ODBC DSNの構成 8.4.1 startPage()メソッド, 3.2.9 StartPageParams構造体, 2.26 構造体, 2

AccessControlToken, 2.1

Account, 2.2

ACL, 2.3

ArrayofGUIDS, 2.4

AuthResult, 2.5

CatalogItemsFilter, 2.6

CatalogObject, 2.7

ErrorDetailsLevel, 3.10.1

ErrorInfo, 2.8

ExportFlags, 3.6.1

GetSubItemsParams, 2.9

ImportError, 2.10

ImportFlags, 3.6.2

ItemInfo, 2.11

NameValuePair, 2.12

PathMap, 2.13

Privilege, 2.14

QueryResults, 2.15

ReadObjectReturnOptions, 3.10.2

ReportHTMLLinksMode, 2.16.1

ReportHTMLOptions, 2.16

ReportParams, 2.17

ReportRef, 2.18

SAColumn, 2.19

SASubjectArea, 2.20

SATable, 2.21

SAWLocale, 2.22

SAWSessionParameters, 2.23

SegmentationOptions, 2.24

SessionEnvironment, 2.25

StartPageParams, 2.26

TreeNodePath, 2.27

UpdateACLMode, 2.28.1

UpdateACLParams, 2.28

UpdateCatalogItemACL, 3.10.18

UpdateCatalogItemACLParams, 2.29

Variable, 2.30

XMLQueryExecutionOptions, 2.31

XMLQueryOutputFormat, 3.11.1

subscribe()メソッド, 3.3.6 サポートされるインストール・タイプ, はじめに システム要件, はじめに

T

アクションのターゲット, 5.2.2, 5.6

サード・パーティのSQLツール, 統合例, 6.4

ツール, メタデータ変換アシスタント, 9.2

TreeNodePath構造体, 2.27

U

UNIX, ODBCデータ・ソース名の構成, 8.5

unsubscribe()メソッド, 3.3.7

UpdateACLMode構造体, 2.28.1

UpdateACLParams構造体, 2.28

UpdateCatalogItemACL構造体, 3.10.18

UpdateCatalogItemACLParams構造体, 2.29

updateGlobalPrivilegeACL()メソッド, 3.9.13

upgradeXML()メソッド, 3.11.7

URL, コールバック, 3.2.1

V

Variable構造体, 2.30

W

Webサービス

セッションベースの概要, 1.1, 1.2

SOAの概要, 1.3

WebCatalogServiceサービス, 3.10 Windows, ODBCデータ・ソース名の構成, 8.4 ワークシート, Discoverer, 9.1 writeIBot()メソッド, 3.3.1 writeListFiles()メソッド, 3.4.9 writeObjects()メソッド, 3.10.19 WSDL

セッションベースWebサービス, 1.1, 1.2

SOA用Webサービス, 1.3

WSIL

SOA用Webサービス, 1.3

X

XMLQueryExecutionOptions構造体, 2.31

XMLQueryOutputFormat構造体, 3.11.1

XMLViewServiceサービス, 3.11

Copyright © 2010, 2013, Oracle and/or its affiliates. All rights reserved.