CSVファイルを使用したデータ・セットの作成

BI PublisherではCSVファイル・データソースを使用して有効なXMLデータを返すデータ・セットをサポートしています。

次のトピックでは、CSVをデータソースとして使用するための要件および手順について説明します:

サポートされるCSVファイルについて

BI Publisherのデータ・セット・タイプとしてのCSVファイルのサポートは特定のガイドラインに従います。

CSVファイルは、管理者がデータソースとして設定したディレクトリに配置できます。詳細は、Oracle Business Intelligence Publisher管理者ガイドの「ファイル・データソース」への接続の設定を参照してください。

またはローカル・ディレクトリからファイルをアップロードできます。
CSVファイルのデリミタとしてサポートされるのは、カンマ、パイプ、セミコロンおよびタブです。
CSVファイルの中にヘッダーがある場合は、ヘッダーの名前がXMLタグ名として使用されます。XMLタグ名では、~、!、#、$、%、^、&、*、+、`、|、:、\"、\\、<、>、?、,、/はサポートされません。データソース・ファイルのヘッダー名にこれらの文字が含まれている場合は、データ・モデル・エディタの「構造」タブを使用してタグ名を編集してください。
CSVデータ・セットでは、データ・モデル・エディタによって割り当てられたデータ型の編集がサポートされます。詳細は、データ型の編集を参照してください。データ・セット内の要素のデータ型を更新する場合は、選択したデータ型にファイル内のデータが準拠していることを確認してください。
BI Publisherデータ・エンジンへの入力として使用されるCSVファイルは、UTF-8でエンコードされている必要があります。また、空の列ヘッダーが含まれていてはなりません。
グループのブレーク、データのリンク、式およびグループ・レベル関数はサポートされません。
CSVファイル内のデータ・フィールドの形式は、マッピングされる日付要素については標準ISOデータ書式(例: 2012-01-01T10:30:00-07:00)、マッピングされる数値要素については######.##であることが必要です。
CSVファイルに対するデータ検証は用意されていません。

集中格納されたCSVファイルからのデータ・セットの作成

ファイル・ディレクトリからCSVファイルを使用してデータ・セットを作成できます。

ファイル・ディレクトリ・データソースにあるCSVファイルを使用してデータ・セットを作成するには:

データ・モデル・エディタのツールバーの「新規データ・セット」をクリックし、「CSVファイル」を選択します。「新規データ・セット - CSVファイル」ダイアログが開きます。

図GUID-9DEA65CA-0574-4C41-85A6-C34E42FA96B6-default.gifの説明
このデータ・セットの名前を入力します。
「共有」をクリックして、「データソース」リストを有効にします。
「データソース」で、CSVファイルが存在するデータソースを選択します。このリストは、構成済のファイル・データソース接続から移入されます。
「参照」をクリックしてデータソースに接続し、使用可能なディレクトリを参照します。ファイルを選択します。
ファイルの最初の行に列名が格納されていることを指定するには、「最初の行は列ヘッダーです」を選択します。このオプションを選択しない場合は、列にはColumn1、Column2のような汎用名が割り当てられます。割り当てられたXMLタグ名および表示名は、データ・モデル・エディタの「構造」タブで編集できます。
「CSVデリミタ」で、ファイルで使用されているデリミタを選択します。デフォルトでは「カンマ(,)」が選択されます。
「OK」をクリックします。

ローカルに格納されたCSVファイルのアップロード

ローカル・ファイル・ディレクトリに格納されたCSVファイルを使用してデータ・セットを作成します。

ローカルに格納されたCSVファイルを使用してデータ・セットを作成するには:

ツールバーの「新規データ・セット」をクリックし、「CSVファイル」を選択します。次に示されているように、「新規データ・セット - CSVファイル」ダイアログが開きます。

図GUID-307810D6-ACD1-4ED6-8692-7511CCB3734B-default.gifの説明
このデータ・セットの名前を入力します。
「ローカル」を選択します。「アップロード」ボタンが有効になります。
「アップロード」をクリックし、ローカル・ディレクトリにあるCSVファイルを選択してアップロードします。このファイルがすでにデータ・モデルにアップロードされている場合は、「ファイル名」リストから選択できるようになっています。
(省略可能)ファイルの最初の行に列名が格納されていることを指定するには、「最初の行は列ヘッダーです」を選択します。このオプションを選択しない場合は、列にはColumn1、Column2のような汎用名が割り当てられます。割り当てられたXMLタグ名および表示名は、データ・モデル・エディタの「構造」タブで編集できます。
「CSVデリミタ」で、ファイルで使用されているデリミタを選択します。デフォルトでは「カンマ(,)」が選択されます。
「OK」をクリックします。

データ型の編集

CSVファイル・データ型のアップロード後、必要に応じて編集できます。

CSVファイル要素のデータ型を編集するには、データ型アイコンをクリックするか、要素の「プロパティ」ダイアログで更新します。

要素のデータは、割り当てられたデータ型に準拠している必要があります。ユーザー・インタフェースには、データ型を更新するときにデータを検証する機能はありません。データが一致しない場合(たとえば、整数として定義された要素に対して文字列値が存在する場合)は、レイアウト編集ツールで、または実行時にエラーが発生する可能性があります。

データ型を更新できるのは、データソースがCSVファイルの場合のみです。

アップロードしたCSVファイルのリフレッシュと削除

アップロードされたローカルのCSVファイルはリフレッシュおよび削除できます。

次に示されているように、ファイルをアップロードすると、そのファイルはデータ・モデルの「プロパティ」ペインにある「添付」リージョンに表示されます。

GUID-12A7C995-A0FD-4F69-87D0-4B1BE89A4029-default.gifの説明が続きます

図GUID-12A7C995-A0FD-4F69-87D0-4B1BE89A4029-default.gifの説明

「プロパティ」ペインの詳細は、データ・モデルのプロパティの設定を参照してください。

データ・モデル内のローカル・ファイルをリフレッシュするには:

コンポーネント・ペインの「データ・モデル」をクリックして「プロパティ」ページを表示します。
このページの「添付」リージョンで、「データ・ファイル」リストからファイルを見つけます。
「リフレッシュ」をクリックします。
「アップロード」ダイアログで、最新バージョンのファイルを参照してアップロードします。このファイルには同じ名前を付ける必要があります。別の名前を付けると古いバージョンは置き換えられません。
データ・モデルを保存します。

ローカル・ファイルを削除するには:

コンポーネント・ペインの「データ・モデル」をクリックして「プロパティ」ページを表示します。
このページの「添付」リージョンで、「データ・ファイル」リストからファイルを見つけます。
「削除」をクリックします。
「OK」をクリックして確定します。
データ・モデルを保存します。