SAP BusinessObjects Repository XI - インポート

ブリッジの仕様

ベンダー	SAP
ツール名	BusinessObjects (BO) Repository
ツールバージョン	11.x〜14.x
ツールのWebサイト	http://www.sap.com/solutions/sapbusinessobjects/large/intelligenceplatform/bi/information-infrastructure/enterprise (英語のみ)
サポートされている方法論	[ビジネスインテリジェンス] マルチモデル、メタデータリポジトリー、BIデザイン(RDBMSソース、ディメンショナルターゲット、変換来歴、式解析)、BIレポート(リレーショナルソース、ディメンショナルソース、式解析、レポートストラクチャー)、Java API経由のグラフィカルレイアウト
データプロファイリング
増分収集
マルチモデル収集
モデル選択のためのリモートリポジトリーの参照

仕様
ツール: Java API経由のSAP / BusinessObjects (BO) Repositoryバージョン11.x〜14.x
http://www.sap.com/solutions/sapbusinessobjects/large/intelligenceplatform/bi/information-infrastructure/enterpriseをご覧ください。
メタデータ: [ビジネスインテリジェンス] マルチモデル、メタデータリポジトリー、BIデザイン(RDBMSソース、ディメンショナルターゲット、変換来歴、式解析)、BIレポート(リレーショナルソース、ディメンショナルソース、式解析、レポートストラクチャー)、グラフィカルレイアウト
コンポーネント: BoRepository11バージョン11.2.0

概要
このインポートブリッジは、BusinessObjectsリポジトリーからファイルをすべて抽出し、各ファイルにある次のような詳細なメタデータ(来歴を含む)をインポートします:
- クラシックBusinessObjects Designerのuniverse.UNV、および新しいBusinessObjects Information Design ツール (IDT)のuniverse.UNXを含むBusinessObjectsユニバースの既知のデザインレイヤー。
- BusinessObjectsレポート(Crystalレポート、Web Intelligenceレポート、Desktop Intelligenceレポート、その他を含む)。

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

警告: このブリッジはWindowsベースのツールクライアントやSDKのCOM APIを使用します。このCOM APIは、(a) 正しくインストールされていること、(b) このツールを実行できるWindowsユーザーに代わってライセンスされていること、(c) ツールサーバーコンテンツにアクセスできることが必要です。追加事項:
(1) ツールベンダーによって推奨されているように、COM APIの場合も含めてリソース競合の恐れがあるため、ツールクライアント(およびブリッジ)がインストールまたは実行されているマシンにツールサーバーをインストールしたり共存させてはなりません。
(2) Windows COM APIベースのツールは度重なる失敗やシステムリソースの不足が発生すると不安定になるため、Windowsを再起動してツールのCOM APIを再び正しく動作させる必要があります。
(3) このブリッジがアプリケーションとして実行されている場合は、上記のWindowsユーザーと同じユーザーでログインする必要があります。
ブリッジがWindowsのサービスとして動作している場合は、WindowsのサービスマネージャーでMIMB Application Serverサービスを右クリックし、ログオンタブに移動して、サービスを実行するアカウントを名前で定義します。

Javaの要件:
BusinessObjectsはJava 8のみをサポートし、デフォルトのJREであるOpenJDKのどのバージョンとも互換性がありません。
インポートブリッジは、BusinessObjectsクライアントソフトウェアとバンドルされているJREを再利用しようとします。
JDBC接続に基づくUNXユニバースは、64ビットJVMでサポートされています。
XIバージョン4.2以前の場合、他のタイプの接続(ODBC、OLE DBなど)に基づくUNXユニバースは、32ビットJVMを使用している場合にのみサポートされます。

BusinessObjects SDKの要件:
インポートブリッジは、SAP BusinessObjects Universe Designer OLE/COM APIに依存してUniverseメタデータをインポートします。そのため、このインポートブリッジを実行するマシンにSAP BusinessObjects Universe Designerが正しくインストールされている必要があります。

インポートブリッジは、SAP BusinessObjects Desktop Intelligence COM/OLE APIに依存してレポートのメタデータをインポートします。そのため、このインポートブリッジを実行するマシンにはSAP BusinessObjects Desktop Intelligenceが正しくインストールされている必要があります。

インポートブリッジは、SAP BusinessObjects Web Intelligence SDKに依存してレポートメタデータをインポートします。
XIversion4.0 SP6以降の場合、WebIntelligenceインポートブリッジはWebIntelligence RESTful Web Service SDKを使います。
XIversion4.0〜SP5の場合、WebIntelligenceのインポートブリッジはメタデータが限定されている非推奨のWebIntelligence Report Engine (Rebean) SDKを使います
XIversion3.xまでの場合、WebIntelligenceインポートブリッジはWebIntelligence Report Engine (Rebean) SDKを使います。

インポートブリッジは、Semantic Layer Java SDKに依存してInformation Design ツール (IDT)ユニバースメタデータをインポートします。
XIバージョン4.1以降では、Semantic Layer Java SDKがサポートされています。
XIバージョン4.0以前では、Semantic Layer Java SDKがサポートされていません。

Semantic Layer Java SDKが正しくインストールされているかどうか不明な場合は、次の点を必ずご確認ください。
- インポートブリッジが動作するマシンでBusinessObjects Information Design ツールを起動できること。一般的に、BusinessObjectsのクライアントツールの一部としてインストールされます。
- Windowsの[コントロールパネル] > [プログラム] > [プログラムと機能]に[SAP BusinessObjects BI platform 4.1 Client ツールs]が表示されていること。
- BusinessObjectsクライアントツールのインストールディレクトリーにSL SDKというフォルダーがあります。例: C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\SL SDK

必要なSL SDKは、デフォルトではインストールされていません。SL SDKは追加コンポーネントとしてクライアントツールにインストールする必要があります。
クライアントインストールディレクトリーに[SL SDK]フォルダーがない場合:
- [SAP BusinessObjects BI platform 4.1 Client ツールs]の[アンインストール/変更]ボタンをクリックしてインストールウィザードを再実行します。
- [変更]オプションを選択し、[次へ]を2回クリックします。
- [機能の選択]画面で[開発者コンポーネント]までスクロールダウンし、[SAP BusinessObjects Semantic Layer Java SDK]をオンにします。
- 残りのステップに従ってSemantic Layer SDKリソースをマシンにインストールします。これでSL SDKフォルダーが利用可能になります。

SAP BusinessObjectsには、接続の問題の一部をテストできるツールがあります。[スタート] -> [すべてのプログラム] -> [Business Objects XI] -> [診断ツール]に移動します。インポートブリッジの場合と同じ認証情報でログインする必要があります。次に、[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

ネットワークおよび接続性に関するトラブルシューティングのアドバイスは、SAP Note 2151044をご覧ください
https://me.sap.com/notes/0002151044

よくある質問
Q: BOログインで入力すべきユーザー名とパスワードは?
A: DesignerやDesktop Intelligenceにログインする時と同じように、BOの有効なユーザー名とパスワードを入力してください。
例: 管理者
どのユーザー名とパスワードを使用すべきか不明な場合は、BOシステム管理者にお問い合わせください。
バージョン11.xおよび12.x (XI)の場合、ユーザーはBusinessObjectsグループのメンバーである必要があります。
- ユニバースを開くためには[Unverse Designerユーザー]グループのメンバーであることが必要です。
- お気に入りのフォルダーにアクセスするためには[管理者]であることが必要です。

Q: インポートブリッジが原因不明でUNVユニバースをインポートできなかった場合はどうすればよいですか?
A: BusinessObjects Designerインポートブリッジを実行してUNVユニバースをインポートし、[実行モード]パラメーターを[対話]に設定してください。
アプリケーションによってポップアップウィンドウにエラーが表示される場合があります。

Q: Crystal Report Application Server (RAS)の起動に失敗する原因は?
A: バージョン12.0 (XI 3.0)以降では、RASを次のように手動で設定する必要があります。
- CMS管理Webコンソールを使って[ゲスト]アカウントを有効にします。
バージョンXI 3.0の段階で、Guestアカウントはデフォルトで無効になっています。
- CMS管理Webコンソールを使って、-ipportパラメーターでRASスタートアップコマンドラインを設定し、空いていることがわかっているポート番号を指定します。たとえばipportスイッチでデフォルトのポート1566を指定するためには、-ipport "1566"とします。詳細は、BusinessObjects Enterprise Administrator's Guideをご覧ください。
旧バージョン11.xの場合も同様の推奨事項が適用されます。Guestアカウントを有効に設定する必要があり、RASサーバーが実行中で有効であることが必要です。Central Configuration Managerを使い、Report Application Server (RAS)のステータスをチェックします。

Q: このインポートブリッジがサポートしているレポートファイルの形式は?
A: このインポートブリッジは、SAP BusinessObjects Desktop Intelligenceによってサポートされている次のレポート形式を読み取ることができます。
- BusinessObjectsドキュメント(*.rep)
- BusinessObjects ドキュメントテンプレート(*.ret)
- BusinessQueryファイル(*.bqy)
- WebIntelligence 2.xドキュメント(*.wqy)
- バージョン11以降のCrystalレポート(*.rpt)

Q: サポートされていないレポートファイルの形式は?
A: BusinessObjects Desktop Intelligenceとこのインポートブリッジは、次の項目をサポートしていません。
- WebIntelligence 6.xドキュメント(*.wid)
- バージョン11.0より前のCrystalレポート(*.rpt)
- Crystal OLAP Analysisレポート(*.car)

Q: このインポートブリッジはアプリケーションサーバーからWindowsサービスとして実行できますか?
A: いいえ。BO DesignerはDesigner COM APIを実行するデスクトップアプリケーションであり、サービスとしてのこのインポートブリッジはサポートされていません。リモートのインポートブリッジサーバーから実行する場合は、サービスとしてではなく通常のデスクトップアプリケーションとして実行するよう設定されていることを確認してください。

Q: このインポートブリッジの実行で推奨されるファイアウォール設定は?
A: このインポートブリッジは、BusinessObjectsクライアントコンポーネントに依存してBOサーバーと通信します。
Designer、DesktopIntelligence、WebIntelligence、Crystalは、CMS でログオンし、ユニバースとドキュメントをダウンロードして開くことができる必要があります。ファイアウォールが適切に設定されていないと、インポートブリッジがいつまでもハングアップしたり、明確な説明がないまま失敗することがあります。ファイアウォール設定の詳細は、システム管理者に問い合わせるか、BusinessObjectsのドキュメントをご覧ください。または、ファイアウォールを無効にし、ファイアウォールなしでインポートブリッジが正しく動作するかどうかチェックすることもできます。

Q: ユニバースに依存するレポートドキュメントの一部が欠けているように見えるのはなぜですか?
A: ユニバースによるサブセット化機能は、ユニバースとレポートドキュメント間にある依存項目のBOリポジトリーメタデータキャッシュに依存するので、レポートがすべてアクティブに使用される本番環境では良好に機能します。ただし、開発環境とテスト環境のBOリポジトリーでは、ユニバースやレポートドキュメントの一部が再デザインまたは移動された可能性もあり、それによってBOリポジトリーのキャッシュに不正確な依存情報が残っていることがあります。そのような場合、ユニバースのどの依存レポートドキュメントも検出されない可能性があります。そのようなドキュメントを編集し、クエリーを更新し、BOサーバーに保存し直すことで、BO リポジトリーのキャッシュを更新できます。
特定のドキュメントがBOサーバーキャッシュ内のユニバースに正しくリンクされているかどうかを確認するためには、次の方法があります。
- (InfoViewではない) CMC管理Webコンソールを起動する
- パブリックフォルダーを参照し、目的のドキュメントを見つける
- ドキュメントのプロパティを表示させる
- [ユニバース] (バージョン11.xの場合)タブ、または[レポートユニバース] (バージョン12.xの場合)タブに、ユニバースの依存項目が表示されます。

Q: BOブリッジを適切に使用するためのBO要件は?
A: 以下の推奨事項がすべて満たされていることをご確認ください:
1. インポートブリッジは、SAP BusinessObjects クライアントがインストールされているマシンにのみインストールする必要があります。SAP BusinessObjectsサーバーを持つマシンにはインストールしないでください。
2. インポートブリッジは、Windowsサービスとしてではなくデスクトップアプリケーションとして実行する必要があります。
3. リモートアクセステクノロジー(Microsoft Netmeeting、SharedView、Office LiveMeeting など)は使用しないでください。COM ベースのリモートアクセステクノロジーはSAP BusinessObjects APIに干渉し、ブリッジのインポート機能を阻害することが知られています。
4. SAP BusinessObjects APIとサーバーへのアクセスに対し、ファイアウォールによる制限がないことをご確認ください。インポートブリッジが正しく接続できない場合は、ファイアウォールを一時的に無効にして、それが原因でないことを確認してください。
5. インポートブリッジが使用するAPIコールの大半は、Administratorユーザーとして接続した場合にのみ完全な情報を提供するため、このインポートブリッジを使用する場合は必ずSAP BusinessObjectsのAdministratorユーザーを使用してください。
6. 最新のSAP BusinessObjectsサービスパックがインストールされていること、およびそれらがサーバーとクライアントのマシンに一貫してインストールされていることを確認してください。
7. 古いファイルやロックされたファイルはユニバースのインポートを妨げるので、ユニバースのダウンロード一時ディレクトリーをクリーンアップしてください。このディレクトリーから一時ファイルをすべて削除します。このディレクトリーパスはDesignerの[ツール]メニュー -> [オプション] -> [保存] -> [デフォルトユニバースフォルダー]で設定します。このディレクトリーパスは、HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite XXXX\default\Shared\General\Directories\Universesのレジストリーに保存されます。
8. インポートブリッジを実行する前にシステムでdesigner.exeプロセスが実行されている場合は、タスクマネージャーを使って終了させます。

Q: インポートされたユニバースの一部が、インポートに指定されたフォルダーにはないのはなぜですか?
A: インポートブリッジは、BOオブジェクトの自己完結型セットを収集しようとします。インポートブリッジパラメーターが[依存オブジェクトの追加 = True]の場合、インポートブリッジは指定されたユニバースに依存しているレポートをすべてインポートします。そのようなレポートがその他のユニバースに依存する場合はそれらもインポートし、完全に定義されるようにする必要があります。

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

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

制限事項
現在判明している一般的な制限事項は、MIMB Known Limitationsか、バンドルされているDocumentation/ReadMe/MIMBKnownLimitations.htmlをご覧ください。

サポート
トラブルシューティングパッケージを次の項目と共に提供してください。
- デバッグログ(UIまたはconf/conf.propertiesでMIR_LOG_LEVEL=6を使って設定可能)
- 利用できる場合はメタデータバックアップ(技術的理由によりこの共通オプションが実装されていないブリッジがあるものの、Miscellaneousパラメーターで-backupオプションを使って設定可能)

Q: サポートチームが問題を再現できるよう、どのようにメタデータを提供すればよいですか?
A: 次のファイルを提供します:
- BusinessObjects 6.xの場合は、[すべてのユーザーに保存]チェックボックスをオンにして、ユニバースをUNVファイルとして、ドキュメントをREPファイルとしてそれぞれ保存します。

- Business Objectsバージョン11.xと12.x (XI)の場合:
中央管理サーバーの異なるリポジトリー間でメタデータをファイルとしてやりとりすることはできなくなりました。
2つのCMSリポジトリー間でユニバースとドキュメントを交換するためには、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] (エクスポート)をクリックします。[エクスポート]をクリックします。生成されるBIARファイルをファイルシステムまたはFTPロケーションに保存することもできます。
BIARファイルをサポートチームに送信します。

ブリッジパラメーター

ブリッジのマッピング