| Anchor | ||||
|---|---|---|---|---|
|
| Table of Contents | ||
|---|---|---|
|
概要
YellowfinのCSV機能を使用して、既存のスプレッドシートをレポートに変換することができます。つまり、ドリルダウンやデータの分類を含め、スプレッドシートのデータに対してYellowfinのすべてのレポート作成機能を素早く適用することができます。YellowfinのCSV機能は、既存のスプレッドシートのデータをレポートに変換することができます。これはつまり、ドリルダウンやデータのカテゴライズなど、Yellowfinのレポート作成機能のすべてを、素早くスプレッドシートのコンテンツに反映することができます。
Yellowfinでは、（CSVとして格納された）スプレッドシートデータを指定されたデータソースにインポートしてレポート作成に使用することができます。レポート作成に使用するCSVデータをインポートする方法は2つあります。Yellowfinはスプレッドシートのデータ（CSV形式）を、指定したデータソースにインポートし、レポート作成に使用することができます。レポート作成に使用するCSVデータのインポート方法は、以下の2通りがあります。
...
1．レポートビルダーのプロセスを使用して、新しいCSVファイルをインポートする。
...
2．ビュービルダーのプロセスを使用して、新しいCSVファイルをインポートする。
| Wiki Markup |
|---|
{html}<iframe width="700" height="394" src="//www.youtube.com/embed/NkBXxgTJ1Ps?color=white" frameborder="0" allowfullscreen></iframe>{html} |
インポート方法
レポートで使用するためにCSVファイルをインポートするときは、データの用途、およびその用途に最適なインポート方法を考慮することが重要です。レポート作成に使用するCSVファイルをインポートする際には、どのデータを使用するのか、データに最適なインポート方法はどれか、を考慮することが重要です。
レポートビルダーによるインポート
CSVがスタンドアロン用途に作成されている場合、またはCSVデータをその他のレポートデータとは別のデータソースに格納する必要がある場合、高度なサブクエリー機能を使用して目的のレポート結果を簡単に得られる場合は、レポートビルダーによるインポート方法を使用してください。レポート作成に使用するCSVファイルをインポートする際には、どのデータを使用するのか、データに最適なインポート方法はどれか、を考慮することが重要です。
レポートビルダーによるインポートプロセスを使用する場合は、次のように操作します：レポートビルダーによるインポートプロセスは、以下の通りです。
...
1．データに適用する計算式、コンバーターを定義して、最終的にテーブルに追加するフィールドを作成します。
...
2．ドリルダウンのような、すべてのデフォルト書式や、フィールド間の関係性を、CSVステップで定義します。これらの設定は、このCSVがレポート作成に選択された際には、常に使用されることになります。
...
3．他のレポート作成者による再利用のために、上記すべてのフィールド、書式、関係性を使用してビューを作成します。このビューは、レポート作成プロセスで利用することができ、定義済みのデフォルト設定を調整するため、権限を持つユーザーが編集することができます。
ビュービルダーによるインポート
CSVデータをレポート作成のデータソースにあるテーブルと一緒に使用する場合は、ビュービルダーによるインポート方法を使用してください。このオプションでは、複数のレポート間だけでなく、複数のビュー間でインポートを使用できます。CSVデータをレポート作成用データソースのテーブルと組み合わせて使用する場合は、ビュービルダーによるインポートを使用します。このオプションは、複数のレポートだけでなく、複数のビューに渡ってインポートしたCSVを使用することができます。
ビュービルダーによるインポートプロセスを使用する場合は、次のように操作します：ビュービルダーによるインポートプロセスは、以下の通りです。
...
1．データに適用するすべてのコンバーターを定義して、最終的にテーブルに追加するフィールドを作成します。
...
2．Yellowfinは、ビュービルダーに表示するテーブルを作成し、選択されたソース接続から他のテーブルを選択する場合と同様に、ユーザーがこのテーブルも選択できるようにします。このテーブルは、書き込み可能なソース接続を使用した、すべてのビュー構築に利用することができるようになります。
...
3．ユーザーは、他のテーブル間で行うように、CSVテーブルを選択して、ビューに追加することで、他のテーブルと結合することができます。
...
4．ドリルダウンのような、すべてのデフォルト書式、フィールド間の関係性を、CSVステップではなく、標準的なビュービルダーステップを通して定義します。
設定
書き込み可能なデータソース
CSVファイルの内容をデータベースのテーブルに書き込むために、データソース接続を書き込み可能として定義する必要があります。書き込み可能な接続は、CSVのインポートやビューのキャッシュのためだけに作成される空のデータベースをポイントすることがあります。これは、インポートをメインのデータソースと分離したままにするためです。Yellowfinは、データベース内のテーブルにCSVファイルのコンテンツを書き込むために、データソース接続を書き込み可能として定義する必要があります。通常、書き込み可能な接続は、CSVインポートやビューのキャッシュのためだけに作成された空のデータベースを指します。これは、インポートされたすべてのデータを、メインのデータソースから隔離するためです。
| Expand | ||
|---|---|---|
| ||
書き込み可能な接続を定義するには、次の手順を実行します。 「1．「管理 」>「」＞「管理コンソール」に移動します。 「管理コンソール」のメインパネルにある「2．管理コンソールのメインパネルで、「データソース 」セクションを展開します。」項目を展開します。 書き込み可能に設定する接続が既に定義されている場合は、接続名をクリックします。そうでない場合は、「3．既に書き込み可能に設定する接続が定義されている場合は、その接続名をクリックします。新しく作成する場合は、「追加 」ボタンをクリックして、新しい接続を作成します。接続設定の「データソース詳細」セクションで、「」ボタンをクリックします。 4．接続設定の「パラメーター」項目で、「書き込み可」オプションを「 Yes」に設定します。有効」にします。 
5．ユーザーにCSVインポート権限はあるが、高度なオプションへのアクセス権が無い場合は、書き込み可能なソース接続を「CSVデフォルト 」に設定された書き込み可能なソース接続が存在する必要があります。このようなユーザーがシステムにいる場合は、「」に設定することで、Yellowfinにどの接続を選択すればよいのか伝えることができます。このようなユーザーがシステムにいる場合は、「CSVデフォルト」を「 Yes」に設定します。有効」にします。 
6．「保存 」ボタンをクリックして、プロセスを完了します。」ボタンをクリックして、設定を完了します。 |
書き込み可能なHSQLデータソース
...
Yellowfinの開発、QA、本番インスタンス外部での作業が多い場合は、一時的または試行的にCSVファイルをインポートしなくてはいけない場合があります。例えば、一時的な設定でCSVファイル形式を試行したり、POC用にサンプルコンテンツを作成したりする場合です。このような場合、CSVデータの格納のために、定常的なデータベース設定が必要ないかもしれません。一時的なソリューションとしては、Yellowfinをインストールできるデータベースと同様の、書き込み可能なHSQLデータベースを作成することです。作成手順は、以下の通りです。
注意：
...
HSQLデータベースは安定していないため、長期的なソリューションに使用してはいけません。
| Expand | ||
|---|---|---|
| ||
| HSQLデータベースを格納するためのディレクトリをYellowfinインストールディレクトリ内に作成します。例： 1．HSQLデータベースを格納するディレクトリを、Yellowfinインストールディレクトリ内に作成します。 C例：C:\Yellowfin\HSQLdatabase Yellowfinで、「2．「管理 」>「」＞「管理コンソール」に移動します。 「管理コンソール」のメインパネルにある「3．管理コンソールのメインパネルで、「データソース 」セクションを展開します。」項目を展開します。 「4．「追加」ボタンをクリックします。 データソースの「5．作成するデータベースの「名前 」および「」、「説明」を入力し、「書き込み可 」オプションを「Yes」に設定します。また、「CSVデフォルト」を設定することもできます（オプション）。 接続の詳細を指定します： 」を「有効」にします。「CSVデフォルト」を有効にすることもできますが、この設定はオプションです。 6．接続詳細を設定します。
接続方法：JDBC 認証アダプター：Standard Authentication データベースタイプ：HSQLDB Server データベースモード：組み込みモード データベース名：C:\Yellowfin\HSQLdatabase\CSVdata ここでは、ステップ1で作成したHSQLデータベースを格納するディレクトリに続けてデータベースの名前を入力します（この名前でYellowfinがデータベースを作成します）。この例では、こちらに設定する値は、手順1で作成したHSQLデータベースを格納するディレクトリと、データベース名です（Yellowfinは、指定された名前でデータベースを作成します）。今回の例では、データベース名を「CSVdata を名前として使用しています。」とします。  |
ロール権限
YellowfinでCSVをインポートするには、ユーザーに適切なロール権限が定義されている必要があります。CSVをインポートする方法は2つあるため、使用可能なロール権限も2つあります。
レポートビルダー
...
ユーザー名：空欄のままにする パスワード：空欄のままにする スキーマ：なし 分離レベル：READ UNCOMMITTED 8. 「テスト接続」をクリックして、実際に接続できるかを確認をします。
9．「保存」ボタンをクリックして、設定を完了します。 |
ロール権限
YellowfinにCSVをインポートするためには、ユーザーに適切なロール権限が定義されていなくてはいけません。CSVインポート方法が2通りあるため、利用可能なロール権限設定も2つあります。
レポートビルダー
CSVファイルをインポートするための権限を、レポートビルダーから設定することができます。こちらは、2つある方法のうち、簡単な方法です。ユーザーがレポートビルダーからCSVデータをインポートする場合は、以下のロール権限が必要です。
| Expand | ||
|---|---|---|
| ||
| 「 1．「管理 」>「」＞「管理コンソール 」に移動します。」へ移動する。 「2．「ロール 」セクションを開き、CSVアクセスを有効にするロールをクリックします。」項目をクリックし、CSVアクセスを有効にするロールを選択する。 次のオプションを有効にします：3．以下の設定を有効にする。 a．SQLレポート・Jasperレポート作成権 - 高度なレポート作成オプション（「CSVからインポート」など）にアクセスできます。CSVインポートのような、高度なレポート作成オプションにアクセスすることができます。
b. CSVレポート作成権 - レポートビルダーの初期設定ステップの「CSVファイルをロード」にアクセスできます。レポートビルダーの初期設定ステップで、CSVファイルを読み込むオプションにアクセスすることができます。 
c. 高度なCSV機能使用権 - デフォルトオプションを利用せずに、高度なオプション（書き込み可能なデータソースの使用など）を選択できます。デフォルトオプションではなく、どの書き込み可能なデータソースを使用するのか選択できる高度なオプションを使用することができます。
注意： これはオプションのロール権限です。ロールを保存します。この設定はオプションです。 4．「保存」ボタンをクリックします。 |
ビュービルダー
...
CSVファイルをインポートするための権限を、ビュービルダーから設定することができます。これらの権限は通常、既存のロールの一部として、標準的なYellowfinビューをメンテナンスするユーザーにのみ設定されます。これらのユーザーには、どちらの方法も使用できるように、レポートビルダーを使用したインポート権限も付与されていることがあります。ビュービルダーを使用してCSVデータをインポートする場合は、以下のロール権限が必要です。
| Expand | ||
|---|---|---|
| ||
| 「 1．「管理 」>「」＞「管理コンソール 」に移動します。」に移動する。 「2．「ロール 」セクションを開き、CSVアクセスを有効にするロールをクリックします。」項目をクリックし、CSVアクセスを有効にするロールを選択する。 次のオプションを有効にします：3．以下の設定を有効にする。 データベースビューa．データベースビュー作成権- 標準のビュービルダーにアクセスできます。標準的なビュービルダーへアクセスすることができます。  b．CSVテーブル作成権 - ビュービルダー内の「CSVからインポート」機能を有効にします。ビュービルダー内のCSVインポート機能を有効にします。 
4．「保存」ボタンをクリックします。 |
CSVファイルの準備
...
インポートプロセスを始める前に、CSVファイルを入手、または作成しなくてはいけません。互換性のあるファイルを使用するために、以下のガイドラインをご参照ください。
...
互換性のあるファイル形式
1．カラム（列）ベース
...
-
...
CSVファイル内のデータをカラム（列）として格納します。ファイルの先頭に空のカラム（列）やロウ（行）を含めてはいけません（スプレッドシートツールを使用して検査する場合）。
...
2．日付書式 - Yellowfinが認識する日付書式は、yyyy/MM/
...
ddです。例：2014/08/
...
互換性のないファイル形式
...
31。日付データがこの書式で格納されているか、確認しましょう。インポートプロセスで書式を変換することもできますが、余計な作業を省くために、インポートを始める前に適切な書式で格納されているか、確認しましょう。
3．合計欄を含めない - CSVファイルのカラム（列）やロウ（行）には、合計を適用してはいけません。また、計算式や書式はインポート中に失われる可能性や、値を取り違う（合計ではなく）可能性があるため含めてはいけません。
4．カラム（列）ごとに一貫性のあるデータ- カラム（列）のデータが、ファイル全体を通して同一のデータ型になっているか確認しましょう。これにより、Yellowfinはデータを適切に識別し、各カラム（列）にフィールドタイプを割り当てることができます。例えば、日付カラム（列）があり、データが「N/A」のレコードが数行ある以外、すべてのデータが日付である場合は、テキストが削除され空欄のままになります。これによりYellowfinは、フィールドをテキストではなく日付として認識します。
5．ファイル書式- YellowfinにインポートできるのはCSVファイルのみであり、XLSやXLSX、他の形式のファイルはインポートすることができません。
互換性のないファイル形式
1．クロス集計/ピボット- クロス集計/ピボット形式のデータをインポートしてはいけません。Yellowfinは、データがカラム（列）形式であることを前提にファイルを検査するため、意図しない、使用不可能な構造でデータが保存されます。
2．合計欄- フィールドに合計を適用してはいけません。Yellowfinは、合計を他のデータと区別しません。
3．XLS形式 - データをXLS、またはXLSX形式で保存してはいけません。Yellowfinが読み込めるのは、CSV形式のファイルのみです。