SAP BusinessObjects Web Intelligence (Webi) XI - インポート

ブリッジの仕様

ベンダー	SAP
ツール名	BusinessObjects (BO) Web Intelligence (Webi)
ツールバージョン	11.x〜14.x
ツールのWebサイト	http://www.sap.com/solutions/sapbusinessobjects/large/intelligenceplatform/bi/qra/web_intelligence/
サポートされている方法論	[Business Intelligence] BI Design (Transformation Lineage, Expression Parsing), BI Report (Relational Source, Dimensional Source, Expression Parsing, Report Structure) via Java API
データプロファイリング
増分収集
マルチモデル収集
モデル選択のためのリモートリポジトリーの参照

仕様
ツール: REST API経由のSAP / BusinessObjects (BO) Web Intelligence (Webi)バージョン11.x〜14.x
http://www.sap.com/solutions/sapbusinessobjects/large/intelligenceplatform/bi/qra/web_intelligence/をご覧ください。
メタデータ: [ビジネスインテリジェンス] BIデザイン(変換来歴、式解析)、BIレポート(リレーショナルソース、ディメンショナルソース、式解析、レポートストクラチャー)
コンポーネント: BoWebIntelligenceバージョン11.2.0

免責事項
このインポートブリッジでは、インターネットに接続して次のサードパーティライブラリーをダウンロードする必要があります:
- オープンソースのサードパーティライブラリーをダウンロードする場合はhttps://repo.maven.apache.org/maven2/など
- その他のサードパーティソフトウェア(データベース特定のJDBCドライバーなど)は該当するサイトへ

ダウンロードされたサードパーティライブラリーは、$HOME/data/download/MIMB/に格納されています。
HTTPSが失敗した場合、インポートブリッジはHTTPを試します。
- インターネットへのアクセスにプロキシを使用している場合は、JREでそのプロキシを設定する必要があります(Miscellaneousパラメーターで -j オプションをご覧ください。)。
- インポートブリッジではインターネットにフルにアクセスできない場合は、インターネットアクセスがある別のサーバーから$HOME/data/download/MIMB/ディレクトリーをコピーします。$HOME/bin/MIMB.sh (または.bat) -dというコマンドを使えば、すべてのブリッジで使用される全サードパーティライブラリーを一度にダウンロードできます。

このインポートブリッジを実行すると、ライセンス規約の責任、およびダウンロードしたサードパーティソフトウェアライブラリーによって生じる潜在的なセキュリティの脆弱性を受け入れることになります。

概要
このインポートブリッジは、次に説明するようにSAP BusinessObjects SDKと特定のJava JREを必要とします。

要件
JAVAの要件
BusinessObjectsはJava 8しかサポートしておらず、デフォルトのJREとなりうるOpenJDKのどのバージョンとも互換性はありません。
Miscellaneousパラメーターを使い、BusinessObjectsによってサポートされているJava環境をポイントします。

BUSINESSOBJECTS SDKの要件
このインポートブリッジは、SAP BusinessObjects WebIntelligence Java APIに依存してレポーティングメタデータをインポートします。そのため、このインポートブリッジを実行するマシンではSAP BusinessObjects WebIntelligence APIが利用可能であることが必要です。

XIバージョン4.0 SP6以降の場合、このブリッジはWebIntelligence RESTful Web Service SDKを使います。
XIバージョン4.0〜SP5の場合、このインポートブリッジはメタデータが限定されている非推奨のWebIntelligence Report Engine (Rebean) SDKを使います。
XIバージョン3.xまでの場合、このインポートブリッジはWebIntelligence Report Engine (Rebean) SDKを使います。

APIが正しくインストールされて機能していることを確認するためには、サーバーに接続できるこのマシンにBusinessObjectsクライアントがインストールされている必要があります。

SAP BusinessObjectsには、接続の問題の一部をテストできるツールがあります。[スタート] -> [すべてのプログラム] -> [Business Objects XI] -> [診断ツール]に移動します。MIMBインポートブリッジの場合と同じ認証情報でログインする必要があります。次に、[Tests] (テスト)メニューで[Run All Tests] (テストをすべて実行)を選択します。テストがすべてパスしたことが表示されます。

さらに、実行するテストの制御に使われる設定ファイルをカスタマイズできます。設定ファイルは、SAP BusinessObjectsのデフォルトによるクライアントインストールであるC:\Program Files (x86)\Business Objects\common\4.0\java\lib\TestClasses.xmlにあります。

いずれかのテストが失敗した場合は、ローカルのSAP BusinessObjects管理者に連絡して問題を解決してください。「SAP BusinessObjects Administration Guide」 の第5章、「Working with Firewalls」 を参照してください。

実行時に、インポートブリッジでは以下のSAP BusinessObjectsの「サーバー」がSAP BusinessObjects環境で起動し有効になっている必要があります。
- WebIntelligence Report Engine (Rebean) SDKの場合: WebIntelligenceProcessingServer
- WebIntelligence RESTful Web Service SDKの場合: WebApplicationContainerServer (バージョンXI R4.xに適用可能)

Central Management Console Webアプリケーションを使って次の項目を確認します。
- [サーバー]メニューで: 上記のサーバーが利用可能で正しく実行されていること
- [アプリケーション]メニューで: [RESTful Web Service]が利用可能であること。デフォルトではインストールされていないことがあります。

BusinessObjects BI Platform SDKはCORBAテクノロジーに基づいています。
CORBAネットワークレイヤーは、リモートサーバーへの接続時にサーバー名/アドレスの双方向解決を実行します。
したがって、指定されたサーバー名/アドレスがクライアント環境で確実に解決できるようになっていることが必要です。
クライアントとサーバーが同じエンタープライズネットワークに属していれば通常、名前解決は成功します。
ただし、クライアントネットワークから別のネットワーク(Amazon AWSなど)内のサーバーに接続する場合は、
ローカルホストファイル(C:\Windows\System32\drivers\etc\hosts)内でエントリーを設定する必要がある場合があります。例:
1.2.3.4 servername

よくある質問
該当なし

制限事項
現在判明している一般的な制限事項は、https://metaintegration.com/Products/MIMB/Help/#!Documents/mimbknownlimitations.htmlをご覧ください。

サポート
トラブルシューティングパッケージを次の項目と共に提供してください。
- デバッグログ(UIまたはconf/conf.propertiesでMIR_LOG_LEVEL=6を使って設定可能)
- 利用できる場合はメタデータバックアップ(技術的理由によりこの共通オプションが実装されていないブリッジがあるものの、Miscellaneousパラメーターで-backupオプションを使って設定可能)
Q: サポートチームが問題を再現できるよう、どのように情報を提供すればよいですか?
A: - BusinessObjects 11.xと12.x (XI)の場合は、BusinessObjects Import Wizardユーティリティ(ImportWiz.exe)を使用してBusiness Intelligence Archiveファイル(*.BIAR)を作成し、そこにドキュメントを含めます。
- BusinessObjects 14.x (XI R4)の場合: Lifecycle Management Consoleを使用して、必要なInfoObjectsが含まれているプロモーションジョブを作成します。ジョブをBIARファイルとしてエクスポートします。アウトラインは次のとおりです(詳細は「Lifecycle management console for SAP BusinessObjects Business Intelligence platform 4.0 User Guide」をご覧ください。):
1. ライフサイクル管理コンソールアプリケーションにログインします。デフォルトで、[プロモーションジョブ]ページが開きます。
2. 新規ジョブを選択します。
3. ジョブの名前、説明、キーワードを該当するフィールドに入力します。
4. [ジョブの保存先]フィールドで、ジョブを保存するリポジトリーフォルダーを参照して選択します。
5. [ソース]ドロップダウンリストから現在のシステムを選択します。
現在のシステム名がリストにない場合は、[新しいCMSにログイン]オプションを選択します。新しいウィンドウが開きます。現在のシステムの名前に加えて、ユーザー名とパスワードを入力します。
6. [宛先]ドロップダウンリストで、[LCMBIARファイルに出力]を選択します。
7. [作成]をクリックします。新しいジョブが作成され、現在のシステムのCMSリポジトリーに保管されます。
8. InfoObjectsをジョブに追加します(目的のユニバースと接続を含む)。[依存項目の管理]オプションを使えば、選択したInfoObjectsの依存項目を含めることもできます。
9. InfoObjectsをジョブに追加する処理を終えたら[プロモート]をクリックします。[Promote] (プロモート)ウィンドウが表示されます。
10. [Export] (エクスポート)をクリックします。You can choose to save the resulting BIAR file to a ファイル System or an FTP location.
BIARファイルをサポートチームに送信します。

Q: WebIntelligence RESTful Webサービスが正しく動作しているかどうかテストする方法はありますか?
A: 以下のURLに
アクセスすれば、BusinessObjects 14.x (XI R4) WebIntelligence RESTful Webサービスをテストできます。http://boserver:6405/biprws/logon/long
InfoStore API: http://boserver:6405/biprws/infostore/12345
APIについて: http://boserver:6405/biprws/raylight/v1/about

開発者ドキュメンテーションは次のサイトで利用できます:
http://help.sap.com/businessobject/product_guides/boexir4/en/xi4sp9_webi_restful_ws_en.pdf
Curlコマンドラインユーティリティでは、コマンドラインスクリプトのようなAPIコールを自動化できます:
http://curl.haxx.se/

ブリッジパラメーター

ブリッジのマッピング