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

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

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

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

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

  • 管理者がデータソースとして設定したディレクトリに配置されたCSVファイルを使用できます。

    ローカル・ディレクトリからファイルをアップロードできます。

  • CSVファイルのデリミタとしてサポートされるのは、カンマ、パイプ、セミコロンおよびタブです。

  • CSVファイルの中にヘッダーがある場合は、ヘッダーの名前がXMLタグ名として使用されます。XMLタグ名では、~、!、#、$、%、^、&、*、+、`、|、:、\"、\\、<、>、?、,、/はサポートされません。データソース・ファイルのヘッダー名にこれらの文字が含まれている場合は、データ・モデル・エディタの「構造」タブを使用してタグ名を編集してください。

  • CSVデータ・セットでは、データ・モデル・エディタによって割り当てられたデータ型の編集がサポートされます。データ型の編集を参照してください。データ・セット内の要素のデータ型を更新する場合は、選択したデータ型にファイル内のデータが準拠していることを確認してください。

  • Publisherデータ・エンジンへの入力として使用されるCSVファイルは、UTF-8でエンコードされている必要があり、空の列ヘッダーを含めることはできません。

  • グループ・ブレーク、データ・リンク、式およびグループ・レベルの関数はサポートされていません。

  • CSVファイル内のデータ・フィールドの形式は、マッピングされる日付要素については標準ISOデータ書式(例: 2012-01-01T10:30:00-07:00)を使用し、マッピングされる数値要素については######.##を使用する必要があります。

  • CSVファイルの検証は行われません。

一元的に格納されたCSVファイルからのデータ・セットの作成

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

  1. データ・モデル・エディタのツールバーの「新規データ・セット」をクリックし、「CSVファイル」を選択します。「新規データ・セット - CSVファイル」ダイアログが開きます。
  2. このデータ・セットの名前を入力します。
  3. 「共有」をクリックして、「データソース」リストを有効にします。
  4. 「データソース」で、CSVファイルが存在するデータソースを選択します。
    このリストは、構成済のファイル・データソース接続から移入されます。
  5. 「参照」をクリックしてデータソースに接続し、使用可能なディレクトリを参照し、ファイルを選択します。
  6. ファイルの最初の行に列名が格納されていることを指定するには、「最初の行は列ヘッダーです」を選択します。
    このオプションを選択しない場合は、列にはColumn1Column2のような汎用名が割り当てられます。XMLタグ名および表示名は、データ・モデル・エディタの「構造」タブで編集できます。
  7. 「CSVデリミタ」で、ファイルで使用されているデリミタを選択します。
    デフォルトでは「カンマ(,)」が選択されます。
  8. 「OK」をクリックします。

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

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

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

  1. ツールバーの「新規データ・セット」をクリックし、「CSVファイル」を選択します。次に示されているように、「新規データ・セット - CSVファイル」ダイアログが開きます。
  2. このデータ・セットの名前を入力します。
  3. 「ローカル」を選択します。「アップロード」ボタンが有効になります。
  4. 「アップロード」をクリックし、ローカル・ディレクトリにあるCSVファイルを選択してアップロードします。
  5. オプション:ファイルの最初の行に列名が格納されていることを指定するには、「最初の行は列ヘッダーです」を選択します。このオプションを選択しない場合、列には一般的な名前(Column1、Column2など)が割り当てられます。割り当てられたXMLタグ名および表示名は、データ・モデル・エディタの「構造」タブで編集できます。
  6. 「CSVデリミタ」で、ファイルで使用されているデリミタを選択します。デフォルトでは「カンマ(,)」が選択されます。
  7. 「OK」をクリックします。

データ型の編集

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

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

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

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

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

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

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

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

  1. コンポーネント・ペインの「データ・モデル」をクリックして「プロパティ」ページを表示します。

  2. このページの「添付」リージョンで、「データ・ファイル」リストからファイルを見つけます。

  3. 「リフレッシュ」をクリックします。

  4. 「アップロード」ダイアログで、最新バージョンのファイルを参照してアップロードします。ファイルの名前は同じである必要があり、そうでない場合は古いバージョンが置き換えられません。

  5. データ・モデルを保存します。

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

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