カラム定義ファイルとは，DBアダプタの検索結果のPosition()[変換元列番号]とXMLスキーマの変換先要素名を関連づけるCSV形式のファイルです。

(a)　形式

カラム定義ファイルの形式を次に示します。

 
変換元列番号，変換先要素名[改行]
　　：
 

カラム定義ファイルの構文を次に示します。

表J-1　カラム定義ファイルの構文

(b)　定義例

「付録I.1　例題」のデータベースの内容を例に，次のテーブル構成のデータをDBアダプタで取得する場合の，カラム定義ファイルの定義例について説明します。

表J-2　テーブル構成（先頭行は列名を表す）

このテーブル構成のデータは，DBアダプタから次のように取得されます。

表J-3　DBアダプタから取得したデータ（先頭行はデータの取得順（列番号）を表す）

このように，DBアダプタから取得したデータは，列名をキーにして値を参照できないため，列名が要素名となるフォーマットに変換する必要があります。

そのため，カラム定義ファイルを使用して，DBアダプタから取得されたデータのどの列番号をどの要素名にマッピングするのかを定義します。

カラム定義ファイルの定義例

 
1,受注番号
2,得意先コード
3,商品コード
4,受注個数
 

このカラム定義ファイルの1行目は，DBアダプタが1列目のデータを［受注番号］にマッピングすることを表します。

このカラム定義ファイルを使用して自動マッピングすることで，DBアダプタから取得されたデータは次のように変換され，要素名（列名）をキーにして値を参照できるようになります。

表J-4　テーブル構成（先頭行は列名を表す）

(c)　注意事項

カラム定義ファイルを作成するときの留意点について説明します。

• ファイル名および拡張子は任意です。
• 使用できる文字コードはMS932です。
• 変換先要素名は大文字・小文字が区別されます。
• 変換元列番号，変換先要素名，または両方を省略した場合，その行の定義は無視され，警告メッセージが出力されます。
• 変換元列番号の文字列の長さは最大1,024文字です。
• 同一の変換先要素名を重複して定義した場合，先に定義した要素は無視されます。このとき警告メッセージが出力されます。
• カラム定義ファイルを利用した自動マッピングでは，カラム定義ファイルの変換先要素名だけで評価され，名前空間は区別されません。
  例えば，カラム定義ファイルに次のように定義した場合，要素名が「Home:Tel1」「Mobile:Tel1」と重複しているスキーマにマッピングすると，図のように両方の要素にマッピングされます。
  カラム定義ファイルの内容
  

  1,Name_Kanji 2,Name_Kana 3,Address 4,Tel1

  図J-1　名前空間が異なる同一要素名がある場合のマッピングの例

  

列名が要素名となるフォーマットに自動でマッピングするには，データ変換定義を使用します。

データ変換定義画面の変換元スキーマツリービューアにDBアダプタで取得したデータ，変換先スキーマツリービューアに変換後のフォーマットのXMLスキーマを設定してください。

マッピングの方法を次に示します。

1. 変換先のマッピング対象とする要素の親要素（複合内容要素）を選択します。
2. 親要素を選択した状態で，右クリックします。
   ポップアップメニューが表示されます。
   

   

3. ポップアップメニューから［特殊マッピング］−［DBアダプタ］を選択します。
   DBアダプタマッピング設定ダイアログが表示されます。
   

   

4. マッピング元を選択し，カラム定義ファイルを指定します。
   

   

5. ［終了］ボタンをクリックします。
   自動でマッピングされます。
   

   

   ポップアップメニューで［DBアダプタ］を選択したノード配下の要素名とカラム定義ファイルの変換先要素名が一致しない，または一致する要素がマッピング対象でない場合，警告メッセージが出力されます。
   
6. 変換元要素から変換先要素にくり返しファンクションをマッピングします。
   くり返しファンクションを定義する方法については，「6.5.16　くり返しを対応づける」を参照してください。