可変長ウィザード

可変長ウィザードとは

可変長ウィザードとは、ドラッグ&ドロップ操作で可変長読み取りフォーマット定義の作成を行うことができる機能です。
可変長ファイルについては、「可変長形式のテキストファイル」を参照してください。

可変長ウィザードの起動

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

可変長ウィザードの画面構成



画像内の番号 名称 説明 備考
(1) 構造定義 読み取りを行う可変長ファイルの構造を定義します。
可変長アダプタはこの定義にそってファイルを読み取ります。
  • 構造定義は、構造定義アイコンを親としてツリー構造で表現します。
(2) 列一覧 出力データの構造を設定します。
この設定により必要な情報だけを取り出すことが可能です。
  • 列一覧には、構造定義で設定した要素を登録することができます。

  • 列一覧はテーブルモデル型と同様の構造です。
    テーブルモデル型については、「データモデル」を参照してください。
(3) グループ  
  • グループは青色のアイコンで表現されます。
(4) レコード  
  • レコードは緑色のアイコンで表現されます。
(5) フィールド  
  • フィールドは黄色のアイコンで表現されます。
(6) 削除(構造定義) [構造定義]ツリーで選択された要素を削除します。
  • 要素の右クリックメニュー[削除]からも同様の操作が可能です。
(7) 編集 [構造定義]ツリーで選択された要素の定義画面を開きます。
  • 要素の右クリックメニュー[プロパティ]からも同様の操作が可能です。
(8) 追加 [構造定義]ツリーで選択された要素を、[列一覧]に追加します。  
(9) 削除(列一覧) [列一覧]ツリーで選択された要素を削除します。
  • 要素の右クリックメニュー[削除]からも同様の操作が可能です。
(10) 上へ [列一覧]ツリーで選択された要素の読み込み順序を一つ上へ上げます。  
(11) 下へ [列一覧]ツリーで選択された要素の読み込み順序を一つ下へ下げます。  

構造定義の設定

構造定義では、可変長ファイルを読み込む際のデータ形式を定義します。

グループの設定

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

  2. 「グループ定義」画面で各プロパティを設定します。
    基本設定
    項目名 必須/省略可 説明 備考
    グループ名 必須 任意のグループ名を入力します。  
    出現回数 省略可 グループの出現回数を入力します。
    • [無制限]のチェックを外すことで、入力できるようになります。
    省略可 省略可 [出現回数]を省略するかどうかを選択します。
    • [チェックあり]:(デフォルト)
      [出現回数]を省略します。
    • [チェックなし]:
      [出現回数]を入力します。
     
    無制限 省略可 [出現回数]を無制限にするかどうかを選択します。
    • [チェックあり]:(デフォルト)
      [出現回数]を無制限にします。
    • [チェックなし]:
      [出現回数]を制限します。
     

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

レコードの設定

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

  2. 「レコード定義」画面で各プロパティを設定します。
    基本設定
    項目名 必須/省略可 説明 備考
    レコード名 必須 任意のレコード名を入力します。  
    出現回数 省略可 グループの出現回数を入力します。
    • [無制限]のチェックを入れないことで、入力できるようになります。
    省略可 省略可 [出現回数]を省略するかどうかを選択します。
    • [チェックあり]:(デフォルト)
      [出現回数]を省略します。
    • [チェックなし]:
      [出現回数]を入力します。
     
    無制限 省略可 [出現回数]を無制限にするかどうかを選択します。
    • [チェックあり]:(デフォルト)
      [出現回数]を無制限にします。
    • [チェックなし]:
      [出現回数]を制限します。
     

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

フィールドの設定

フィールドの設定は、以下の手順で行います。
  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. [完了]ボタンを押下し、構造定義にフィールドを追加します。

列一覧の設定

列一覧では、構造定義で読み込んだデータの出力形式を定義します。

要素の追加

[構造定義]ツリーの追加したい要素を選択し、[追加]ボタンを押下することで、[列一覧]に要素を追加することができます。
追加される要素はフィールドのみです。
フィールドを選択状態で追加をすると[列一覧]の先頭に選択したフィールドが追加されます。
グループとレコードを選択状態で追加をすると含まれるフィールドのみ追加されます。
以下の場合、列一覧に追加されたフィールドの順番は保証されません。

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

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

構造定義ファイルの仕様

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

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



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

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

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

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



    <= 列一覧に出力されるフィールド
    <= 列一覧に出力されるフィールド

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

以下の構造定義ファイルのインポートを行います。
GROUP,グループ,,false
RECORD,レコード,,false
FIELD,タグ,tag,HDR,false
FIELD,文字列,string,,true
FIELD,数値,numeric,,true



<= 列一覧に出力されるフィールド
<= 列一覧に出力されるフィールド

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

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

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



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

仕様制限