概要
Yellowfinには、1つのYellowfinインスタンス（たとえばQA環境）からすべての関連アイテムを含むコンテンツ定義をエクスポートして、別々のインスタンス（たとえば実装環境）にこれらをインポートするための機能があります。Yellowfinでは、ひとつのインスタンス（例、QA環境）から、関連するすべてのアイテムを含むコンテンツ定義をエクスポートし、別のインスタンス（例、本番環境）にインポートすることができます。
注意： 定義をエクスポートする際には制限事項があり、個別のユーザーや、グループ、ロールのみに関連するセキュリティ設定をエクスポートすることはできません。これらの項目は、新しいインスタンスにインポートをした際に、再設定しなくてはいけません。ソースフィルター情報は、スケジュール化されたSQLクエリ―である場合にのみエクスポートすることができます。手入力したレコードやデータファイルレコードは、エクスポートされません。これは、インスタンス間でユーザーは異なるが、グループや他の構造は同様であるとみなされているためです。
注意： Yellowfinのエクスポート機能には、制限事項として、個々のユーザー、グループ、またはロールに関連するセキュリティ設定をエクスポートすることはできません。エクスポートファイルをインポートしたとしても、これらは、Yellowfinの新しいインスタンスに再設定する必要があります。ソースフィルターの情報は計画されたSQLクエリーの場合のみエクスポートされます。また、手入力したレコード、データファイルをアップロードしたレコードはエクスポートすることはできません。これは、ユーザーはインスタンス間で異なっても、グループやその他の構造は同じであるという想定に基づいています。
また、異なるインスタンス間でエクスポートしたコンテンツをインポートする場合、それぞれのインスタンスのYellowfinのバージョンとビルドは必ず同じでなければなりません。Yellowfinのバージョンとビルドは、システム情報から確認することができます。
コンテンツの従属関係
...
コンテンツをエクスポートする場合、エクスポートしたいアイテムのみを選択するのではなく、メインコンテンツが機能するために従属している他のアイテムもすべてエクスポートすることが重要です。
...
例えば、レポートをエクスポートする場合、以下のいずれかが必要です。
...
- 使用しているすべてのイメージ、保存されているカテゴリーとサブカテゴリ―、基づいているビューとソース接続を含めるか、
...
Image Removed
| Column |
|---|
|
コンテンツをエクスポートするときは、エクスポートするアイテムを選択するだけでなく、メインコンテンツが機能するうえで従属する可能性があるその他のアイテムもすべて選択することが重要です。 Yellowfinのコンテンツ従属構造は左の図のとおりです。 たとえばレポートをエクスポートする場合は、次のいずれかを確認する必要があります。 - 使用するすべてのイメージ、格納されるカテゴリーとサブカテゴリー、および基になるビューおよびソース接続を含めてエクスポートするか、
- 上記のアイテムすべてが、インポート先のインスタンスですでに使用可能であることを確認します。
|
- 上記すべてのアイテムが、インポート先のインスタンスで既に利用可能であることを確認する。
Image Added
データベースの移行
Yellowfinを異なるプラットフォームに移行するためにエクスポート機能およびインポート機能を使用する場合、SQLのプラットフォームに依存する部分についての知識が必要になります。たとえば以下のようなケースです。エクスポートとインポート機能を使用して、Yellowfinを異なるプラットフォームに移行するためには、ハードコード化されたSQLに留意しなくてはいけません。例えば、以下のような場合です。
- ビュー内で作成されている仮想テーブルビュー内で作成された仮想テーブル
- ビュー内のフリーハンドSQLによる計算フィールド
- フリーハンドSQLによって作成されたレポートフリーハンドSQLレポート
- プラットフォーム固有のSQLを持つ、BIRTまたはJasperレポートプラットフォーム固有のSQLをもつBIRT、またはJasperレポート
Yellowfinはこれらに含まれるプラットフォームに依存するSQLをテストすることができません。管理者はシステムを実装環境に移行する前に、必ずテスト環境でプラットフォーム間のエクスポート、インポートのプロセスをテストしてください。Yellowfinは、これら例外的なSQLをテストすることができないので、本番環境に移行する前にテスト環境でプラットフォーム間のエクスポートとインポートプロセスをテストしてください。
エクスポートプロセス
| Section |
|---|
| Column |
|---|
| 1. Yellowfinから定義をエクスポートするには、メインのナビゲーションメニューで「 Yellowfinから定義をエクスポートするためには、メインのナビゲーションメニューで「管理 」>「 」＞「エクスポート 」をクリックします。」に移動します。 |
| Column |
|---|
|  Image Removed Image Added
|
|
| Section |
|---|
| Column |
|---|
| 2.エクスポートするエレメントを選びます。エクスポートするアイテムを選択します。 - ドロップダウンメニューから、アイテムタイプ（ソースシステム、カテゴリー、ビューその他）を選びます。ここで選択したタイプのアイテムがリストとなって表示されます。
- エクスポートするアイテムのチェックボックスをオンにして「追加」をクリックします。「次へ」をクリックして続行します。ドロップダウンメニューから、アイテムタイプ（ソースシステム、カテゴリー、ビュー、など）を選択します。選択したタイプに応じたアイテム一覧が表示されます。
- エクスポートしたいアイテムを選択し、「追加」ボタンをクリックして、エクスポートするアイテム一覧に追加します。「次へ」ボタンをクリックし、続行します。
|
| Column |
|---|
|  Image Removed Image Added
|
|
| Section |
|---|
| Column |
|---|
| 3.たとえばダッシュボードタブのように、他と従属関係にあるアイテムを選択した場合、Yellowfinは選択されたアイテムに従属するすべてのアイテムのリストを用意します。従属関係のあるアイテム（例、ダッシュボードタブ）を選択した場合、従属関係にあるすべてのアイテムの一覧が表示されます。 リストからエクスポートするアイテムを選択して「追加」をクリックします。エクスポートプロセスに含めたいアイテムを選択し、「追加」ボタンをクリックしてエクスポート一覧に追加します。 |
| Column |
|---|
|  Image Removed Image Added
|
|
| Section |
|---|
| Column |
|---|
| 4.準備が整ったら「エクスポート」をクリックします。準備が整ったら、「エクスポート」ボタンをクリックします。 |
| Column |
|---|
|  Image Removed Image Added
|
|
| Section |
|---|
| Column |
|---|
| 5. Yellowfinはエクスポートファイルの保存先を尋ねてきます。後で使用するために、ローカルファイルサーバーにファイルを保存してください。 アイテムがエクスポートされ、ローカルドライブへの保存を促されます。後ほど使用するために、ファイルをローカルファイルサーバに保存します。 |
| Column |
|---|
|  Image Removed Image Added
|
|
インポートプロセス
| Section |
|---|
| Column |
|---|
| 1. Yellowfinに定義をインポートするには、メインのナビゲーションメニューで「 Yellowfinに定義をインポートするためには、メインのナビゲーションメニューで「管理 」>「 」＞「インポート 」をクリックします。」に移動します。 |
| Column |
|---|
|  Image Removed Image Added
|
|
| Section |
|---|
| Column |
|---|
| 2. 「参照」ボタンをクリックして、ファイルサーバーからエクスポートされたXMLファイルを選びます。「次へ」をクリックして続行します。 「ファイルを選択」をクリックして、インポートするXMLファイルを選択します。「次へ」ボタンをクリックして、続行します。 |
| Column |
|---|
|  Image Removed Image Added
|
|
| Section |
|---|
| Column |
|---|
| 3.Yellowfinは、画面の右側にインポートファイルの各々のエレメントを、中央部にインポートオプションを表示します。インポートするファイルの各エレメントが、画面の右側に表示され、画面の中央にはインポートオプションが表示されます。 インポートファイルに含まれるすべてのアイテムについて、インポートするかスキップするかを選択することができます。レポートに従属するデータソースのような従属関係にあるアイテムがスキップされた場合には、それらに適当な代用アイテムを選ぶための手順がYellowfinから表示されます。インポートファイルのすべてのアイテムで、インポート、もしくはスキップを選択することができます。レポートのデータソースのように、従属関係にあるアイテムをスキップした場合、これらの代わりとなる適切なアイテムの選択を促されます。各アイテムにインポートオプションを指定したら、インポートを実行するために「次へ」をクリックしてください。 各アイテムでインポートオプションを選択し、サマリーが表示されるまですべてのアイテムで「次へ」ボタンをクリックします。 |
| Column |
|---|
|  Image Removed Image Added
|
|
| Section |
|---|
| Column |
|---|
| 4.すべてのアイテムに対して正しくオプションが指定されると、サマリーが表示され「インポート」をクリックできるようになります。すべてのアイテムでプロセスが適切に完了すると、サマリーページが表示されるので、「インポート」ボタンをクリックして、プロセスを終了します。 エラーが検出された場合は、問題箇所に関するエラーメッセージが表示されます。インポートを続行するか、または問題を修正してからプロセスを再開するかどうかを選択することができます。エラーが検出された場合は、問題箇所に関するエラーメッセージが表示されます。インポートを続行するか、問題を修正してからプロセスを再開するか選択することができます。 |
| Column |
|---|
|  Image Removed
|
|
 Image Added
|
|