可変長書き込みウィザード

可変長書き込みウィザードとは

可変長書き込みウィザードとは、ドラッグ&ドロップ操作で入力データから可変長データを生成するために必要なフォーマット定義の作成を行うことができる機能です。
可変長ファイルについては、「可変長形式のテキストファイル」を参照してください。

可変長書き込みウィザードの起動

可変長書き込みウィザードの起動は、グローバルリソース「可変長書き込みフォーマット定義」の設定画面で[可変長書き込みウィザードの起動]を押下することで行います。

可変長書き込みウィザードの画面構成



画像内の番号 名称 説明 備考
(1) 列一覧 入力データの構造を定義します。
入力データの列数と同数のフィールドを追加し、各フィールドに対して構造(名前、型)を定義します。
  • 列一覧はテーブルモデル型と同様の構造です。
    テーブルモデル型については、「データモデル」を参照してください。
(2) 構造定義 出力データの構造を定義します。
構造定義ではグループ、レコードを定義し、そこに列一覧で定義したフィールドをドラッグ&ドロップで追加します。
 
(3) フィールド(列一覧)  
  • フィールドは黄色のアイコンで表現されます。
(4) グループ  
  • グループは青色のアイコンで表現されます。
(5) レコード  
  • レコードは緑色のアイコンで表現されます。
(6) 固定フィールド 構造定義に固定フィールドを追加することで、定数フィールドのような定義ができます。
  • 固定フィールドは黄色のアイコン(チェック付き)で表現されます。
(7) フィールド(構造定義)  
  • フィールドは黄色のアイコンで表現されます。

右クリックメニューからの設定

構造 右クリックメニュー 名称 説明 備考
[構造定義] 「構造定義」の右クリックメニュー グループの追加 [構造定義]ツリーにグループを追加します。  
レコードの追加 [構造定義]ツリーにレコードを追加します。  
「グループ」の右クリックメニュー レコードの追加 [構造定義]ツリーの選択された[グループ]にレコードを追加します。  
プロパティ [構造定義]ツリーの選択された[グループ]の定義画面を開きます。  
削除 [構造定義]ツリーの選択された[グループ]を削除します。  
「レコード」の右クリックメニュー フィールドの追加 [構造定義]ツリーの選択された[レコード]にフィールドを追加します。  
プロパティ [構造定義]ツリーの選択された[レコード]の定義画面を開きます。  
削除 [構造定義]ツリーの選択された[レコード]を削除します。  
「フィールド」の右クリックメニュー プロパティ [構造定義]ツリーで選択された[フィールド]の定義画面を開きます。  
削除 [構造定義]ツリーで選択された[フィールド]を削除します。  
[列一覧] 「フィールド」の右クリックメニュー プロパティ [列一覧]ツリーで選択された[フィールド]の定義画面を開きます。  
削除 [列一覧]ツリーで選択された[フィールド]を削除します。  

列一覧の設定

列一覧では、入力データのカラムをフィールドとして構造情報を定義し、可変長データの1レコードを定義します。

フィールドの設定

フィールドの設定は、以下の手順で行います。
  1. 列アイコンの右クリックメニュー[フィールドの追加]を選択する。
  2. 「フィールド定義」画面で各プロパティを設定します。
    項目名 必須/省略可 説明 備考
    フィールド名 必須 任意のフィールド名を入力します。  
    フィールド型 必須 フィールドの型を指定します。指定できる型は以下の型です。
    • [文字列]:(デフォルト)
    • [数値]
    • [日付]
    • [タグ]
     
    タグ 省略可 タグ(レコード識別コード)を入力します。
    • [フィールド型][タグ]を選択した場合、有効になります。
    日付フォーマット 省略可 日付のフォーマットを選択または入力します。
    年号 意味 表示
    y 数値 1996
    M テキストまたは数値 July&07
    d 数値 10
    h 時(1〜12) 数値 12
    H 時(0〜23) 数値 0
    m 数値 30
    s 数値 30
    S ミリ秒 数値 978
    • [フィールド型][日付]を選択した場合、有効になります。
    • デフォルトは「$yy$MM$dd」です。

  3. [完了]ボタンを押下し、列一覧にフィールドを追加します。

構造定義の設定

構造定義では、出力するデータの構造を定義します。

グループの設定

グループの設定は、以下の手順で行います。
  1. 構造定義アイコンの右クリックメニュー[グループの追加]を選択し、「グループ定義」画面を開きます。

  2. 「グループ定義」画面で各プロパティを設定します。
    基本設定
    項目名 必須/省略可 説明 備考
    グループ名 必須 任意のグループ名を入力します。  
    出現回数/無制限 省略可 書き込み処理では使用していません。  
    出現回数/回数 省略可 書き込み処理では使用していません。  
    省略可 省略可 書き込み処理では使用していません。  

  3. [完了]ボタンを押下し、構造定義にグループを追加します。

レコードの設定

レコードの設定は、以下の手順で行います。
  1. <構造定義アイコンまたはグループアイコンの右クリックメニュー[レコードの追加]を選択し、「レコード定義」画面を開きます。

  2. 「レコード定義」画面で各プロパティを設定します。
    レコードのプロパティ
    項目名 必須/省略可 説明 備考
    レコード名 必須 任意のレコード名を入力します。  
    出現回数/無制限 省略可 書き込み処理では使用していません。  
    出現回数/回数 省略可 書き込み処理では使用していません。  
    省略可 省略可 レコードに対応する入力データを、行ごとに必ず出力するかどうかを選択します。
    • [チェックあり]:
      • レコードに対応する入力データが1つ前の行と同じ場合、出力が省略されることがあります。
      • 出力が省略されるのは、以下の条件にすべて合致した場合になります。
        • 後続のレコードで、[省略可]が「チェックなし」に設定されているレコードが存在しない場合
        • 後続のレコードで、[省略可]が「チェックあり」に設定されているレコードが存在し、そのレコードに対応する入力データが1つ前の行と同じ場合
        • 後続のレコードで、1つ目のフィールドがタグのレコードが存在し、そのレコードに対応する入力データが1つ前の行と同じ場合
        • 入力データの最終行ではない場合
    • [チェックなし]:(デフォルト)
      • 行ごとに必ずレコードを出力します。
     

  3. [完了]ボタンを押下し、構造定義にレコードを追加します。

フィールドの設定

フィールドの設定は、以下の手順で行います。
  1. [列一覧]に定義したフィールドを選択し、[構造定義]に定義されているレコードにドラッグ&ドロップします。



  2. フィールドにリンクが張られ、構造定義のレコードにフィールドが追加されます。

固定フィールドの設定

固定フィールドの設定は、以下の手順で行います。
  1. レコードアイコンの右クリックメニュー[フィールドの追加]を選択し、「フィールド定義」画面を開きます。

  2. 「フィールド定義」画面で各プロパティを設定します。
    プロパティの詳細については、「フィールド定義(列一覧)」を参照してください。
    [フィールド名]に入力した値がそのまま出力されます。

  3. [完了]ボタンを押下し、構造定義に固定フィールドを追加します。

構造定義ファイルのエクスポート/インポート

可変長書き込みウィザードで定義した構造定義、列一覧をCSV形式のファイルに保存し、そのファイルから構造定義、列一覧を復元することができます。
構造定義ファイルは、読み取り処理、書き込み処理の両方で使用することができます。

構造定義ファイルの仕様

構造定義ファイルのエクスポート

以下の構造定義のエクスポートを行います。



  1. メニューの[構造定義ファイル]-[エクスポート]を選択します。

  2. エクスポート先のファイルを指定し、[完了]ボタンを押下します。
    ファイルパスはDataSpider Cloudファイルシステムの絶対パスで指定してください。
    パス区切り文字「/」以外のDataSpider Cloudファイルシステムの使用禁止文字は使用できません。
    [参照]ボタンを押下するとファイルチューザが起動し、ファイルの選択ができます。
    [プレビュー]を押下するとプレビューアを起動して、指定したファイルの内容を表示します。

  3. エクスポートに成功すると、「エクスポートの成功」ダイアログが表示されます。

  4. エクスポートされたファイルの内容は以下の通りです。
    GROUP,グループ,,false
    RECORD,レコード,,false
    FIELD,タグ,tag,HDR,true
    FIELD,文字列,string,,true
    FIELD,数値,numeric,,true
    FIELD,日付,date,$yyyy/$MM/$dd,true

構造定義ファイルのインポート

次の構造定義ファイルのインポートを行います。
GROUP,グループ,,false
RECORD,レコード,,false
FIELD,タグ,tag,HDR,true
FIELD,文字列,string,,true
FIELD,数値,numeric,,true
  1. メニューの[構造定義ファイル]-[インポート]を選択します。

  2. インポートするファイルを指定し、[完了]ボタンを押下します。
    ファイルパスはDataSpider Cloudファイルシステムの絶対パスで指定してください。
    パス区切り文字「/」以外のDataSpider Cloudファイルシステムの使用禁止文字は使用できません。
    [参照]ボタンを押下するとファイルチューザが起動し、ファイルの選択ができます。
    [プレビュー]を押下するとプレビューアを起動して、指定したファイルの内容を表示します。
    すでに構造定義が存在する場合は、「警告」ダイアログが表示され、構造定義を上書きするかどうか選択できます。

  3. インポートに成功すると可変長書き込みウィザードに構造定義が表示されます。



構造定義ファイルを編集する場合の注意点

仕様制限