30日間の無料評価版をお試しいただけます。

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin

Anchor
top
top

Table of Contents
classcontents

...

概要

Styleclass
ClasstopLink

...

top

Yellowfin provides you with the capacity to export all your content definitions including the related entities from one instance of Yellowfin (e.g. QA) and import these into a separate instance (e.g. Production).

Note: When exporting definitions from Yellowfin there are certain limitations. You cannot export security settings that relate to individual users, only group or roles. These will have to be reset when importing them into the new instance of Yellowfin. Source filter information will be exported but only if it is a scheduled SQL query. Manual records and data file records will not be exported. This is because it's assumed that users will differ between instances, but groups and other structures will be the same.

Content Dependencies

When exporting content, it's important to not only select the items you wish to export, but also all other items the main content may depend on to work.

Yellowfin's content dependency structure is illustrated below.
Image Removed

For example, if you are exporting a Report you will need to either:

  1. include all images it uses, the category and sub category it's stored in, and the view and source connection it's based on, or
  2. ensure all the items above are already available in the instance you plan on importing the item into

Database Independence

If you are using the export and import functions to migrate Yellowfin across platforms then you will have to be mindful of any hard coded SQL. Examples of this may be:

  1. Created Virtual Tables within the View
  2. Freehand SQL Calculated Fields in the View
  3. Freehand SQL Reports
  4. BIRT or Jasper reports with platform specific SQL

Yellowfin cannot test for these SQL anomalies and you should test your export and import processes across platforms in your test environment prior to migrating into production.

...

ページトップ

Yellowfinには、1つのYellowfinインスタンス(たとえばQA環境)からすべての関連アイテムを含むコンテンツ定義をエクスポートして、別々のインスタンス(たとえば実装環境)にこれらをインポートするための機能があります。

 

注意: Yellowfinのエクスポート機能には、制限事項として、個々のユーザー、グループ、またはロールに関連するセキュリティ設定をエクスポートすることはできません。エクスポートファイルをインポートしたとしても、これらは、Yellowfinの新しいインスタンスに再設定する必要があります。ソースフィルターの情報は計画されたSQLクエリーの場合のみエクスポートされます。また、手入力したレコード、データファイルをアップロードしたレコードはエクスポートすることはできません。これは、ユーザーはインスタンス間で異なっても、グループやその他の構造は同じであるという想定に基づいています。

異なるインスタンス間でエクスポートしたコンテンツをインポートする場合、それぞれのインスタンスのYellowfinのバージョンとビルドは必ず同じでなければなりません。Yellowfinのバージョンとビルドは、システム情報から確認することができます。

また、CSVインポートによって作成したコンテンツは、エクスポート・インポートに対応していませんので、コンテンツを再作成するようにしてください。

コンテンツの従属関係

Section
Column
width426px

Image Added

Column
width99%

コンテンツをエクスポートするときは、エクスポートするアイテムを選択するだけでなく、メインコンテンツが機能するうえで従属する可能性があるその他のアイテムもすべて選択することが重要です。

Yellowfinのコンテンツ従属構造は左の図のとおりです。

たとえばレポートをエクスポートする場合は、次のいずれかを確認する必要があります。

  1. 使用するすべてのイメージ、格納されるカテゴリーとサブカテゴリー、および基になるビューおよびソース接続を含めてエクスポートするか、
  2. 上記のアイテムすべてが、インポート先のインスタンスですでに使用可能であることを確認します。

 

 

データベースの移行

Yellowfinを異なるプラットフォームに移行するためにエクスポート機能およびインポート機能を使用する場合、SQLのプラットフォームに依存する部分についての知識が必要になります。たとえば以下のようなケースです。

  1. ビュー内で作成されている仮想テーブル
  2. ビュー内のフリーハンドSQLによる計算フィールド
  3. フリーハンドSQLによって作成されたレポート
  4. プラットフォーム固有のSQLを持つ、BIRTまたはJasperレポート

Yellowfinはこれらに含まれるプラットフォームに依存するSQLをテストすることができません。管理者はシステムを実装環境に移行する前に、必ずテスト環境でプラットフォーム間のエクスポート、インポートのプロセスをテストしてください。

エクスポートプロセス

Styleclass
ClasstopLink

...

ページトップ

Section
Column
width40%

1. To export definitions from Yellowfin click on Administration > Export in the main navigation menu. Yellowfinから定義をエクスポートするには、メインのナビゲーションメニューで「 管理 」>「 エクスポート 」をクリックします。

Column
width60%

Section
Column
width40%

2. Select the elements you wish to export.

  • From the drop down menu choose the item type (source system, categories, views etc). Based on your selection you will be presented with a list of items to choose from.

エクスポートするエレメントを選びます。

  • ドロップダウンメニューから、アイテムタイプ(ソースシステム、カテゴリー、ビューその他)を選びます。ここで選択したタイプのアイテムがリストとなって表示されます。
  • エクスポートするアイテムのチェックボックスをオンにして「追加」をクリックします。「次へ」をクリックして続行します。Select those items you wish to export and click the add button to add selected items to the list. Click next to continue.
Column
width60%

Section
Column
width40%

3. If you have chosen to export items which have dependencies (for example a dashboard tab) Yellowfin will present you with a list of all the dependent items which you may wish to export as well. たとえばダッシュボードタブのように、他と従属関係にあるアイテムを選択した場合、Yellowfinは選択されたアイテムに従属するすべてのアイテムのリストを用意します。

リストからエクスポートするアイテムを選択して「追加」をクリックします。Select those items you wish to include in the export process and click add to add them to the list.

Column
width60%

Section
Column
width40%

4.

When ready to export click the export link.

準備が整ったら「エクスポート」をクリックします。

Column
width60%

Section
Column
width40%

5. You will be prompted to save the file to your local drive. Save the file onto your local file server - for later use. Yellowfinはエクスポートファイルの保存先を尋ねてきます。後で使用するために、ローカルファイルサーバーにファイルを保存してください。

Column
width60%

...

インポートプロセス

Styleclass
ClasstopLink

...

top

ページトップ

Section
Column
width40%

1. Yellowfinに定義をインポートするには、メインのナビゲーションメニューで「 管理 」>「 インポート 」をクリックします。

Column
width60%

Image Added

Section
Column
width40%

2. 「参照」ボタンをクリックして、ファイルサーバーからエクスポートされたXMLファイルを選びます。「次へ」をクリックして続行します。

Column
width60%

Image Added

Section
Column
width40%

3.Yellowfinは、画面の右側にインポートファイルの各々のエレメントを、中央部にインポートオプションを表示します。

インポートファイルに含まれるすべてのアイテムについて、インポートするかスキップするかを選択することができます。レポートに従属するデータソースのような従属関係にあるアイテムがスキップされた場合には、それらに適当な代用アイテムを選ぶための手順がYellowfinから表示されます。

各アイテムにインポートオプションを指定したら、インポートを実行するために「次へ」をクリックしてください。

Column
width60%

Image Added

Section
Column
width40%

4.すべてのアイテムに対して正しくオプションが指定されると、サマリーが表示され「インポート」をクリックできるようになります。

エラーが検出された場合は、問題箇所に関するエラーメッセージが表示されます。インポートを続行するか、または問題を修正してからプロセスを再開するかどうかを選択することができます。

Column
width60%

Image Added

 

  1. To import definitions into Yellowfin click on Administration > Import in the main navigation menu.
    Image Removed
  2. Select the exported XML file from your file server by clicking the browse button and using the file upload form to select the appropriate file. Click next to continue.
    Image Removed
  3. Yellowfin will now display each element in the import file on the right hand side of your screen and provide you import options in the central form on your screen.
    You can choose to import or skip any item in the import file. If you skip dependent items such as a data source for a report then Yellowfin will prompt you to select the appropriate substitutes for those specific items.
    Choose your import options for each item and click next to navigate through all the items in the file until you reach the summary.
    Image Removed
  4. On the summary - if all items have been processed correctly - you can click Import to complete the process. If an error has been detected Yellowfin will display the error message for the problematic artefact. You can choose to continue to Import or fix the issue and begin the process again.
    Image Removed

horizontalrule
Styleclass
ClasstopLink

...

ページトップ