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