列の要素

この要素には、変数定義を含めます。たとえば、<COLUMN name="Title">のように記述します。

変数のSASデータ型(文字または数値)を指定します。SASシステムは、このデータ型を使用して変数のデータを保存します。たとえば、<TYPE> numeric </TYPE>は、変数のSASデータ型が数値であると指定します。

<DATATYPE> float </DATATYPE>
<TYPE> numeric </TYPE>

XMLドキュメントから変数にデータを読み込む際に使用するデータ型を指定します。たとえば、<DATATYPE> string </DATATYPE>は、データがアルファベット文字を含むことを指定します。

オプション要素であり、変数に割り当てる欠損値のデフォルト値を指定します。 欠損データに非欠損値を割り当てるには、DEFAULT要素を使用します。 たとえば、<DEFAULT> single </DEFAULT>は、欠損値が発生した場合に、値singleを割り当てます。

オプション要素であり、変数で使用できる有効な値のリストを指定します。ENUM要素には、値をリストする1つ以上のVALUE要素を含めることができます。ENUM要素を使用すると、XMLドキュメント内の値の有効性が値リストに照らして検証されます。値が有効でない場合、その値はMISSINGに設定される(デフォルト)か、またはDEFAULT要素で指定された値に設定されます。DEFAULT要素で指定された値が有効となるためには、その値がENUM値の1つとして指定されていなければならないことに注意してください。

<COLUMN name="filing_status">
.
.
.
<DEFAULT> single </DEFAULT>
.
.
.
<ENUM>
<VALUE> single </VALUE>
<VALUE> married filing joint return </VALUE>
<VALUE> married filing separate return </VALUE>
<VALUE> head of household </VALUE>
<VALUE> qualifying widow(er) </VALUE>
</ENUM>
</COLUMN>

オプション要素であり、変数に割り当てるSAS出力形式を指定します。出力形式名の長さは、文字出力形式の場合は最大31文字まで、数値出力形式の場合は最大32文字までとなります。SAS出力形式とは、SASシステムが値の書き出しの際に使用する命令のことです。出力形式を使うと、値が出力される見かけを制御できます。 出力形式名の一部にピリオド(.)を含めることはできません。幅および長さは、出力形式名の一部としてではなく、属性として指定します。

<FORMAT> E8601DA </FORMAT>
<FORMAT width="8"> best </FORMAT>
<FORMAT width="8" ndec="2"> dollar </FORMAT>

オプション要素であり、変数に割り当てるSAS入力形式を指定します。入力形式名の長さは、文字入力形式の場合は最大30文字まで、数値入力形式の場合は最大31文字までとなります。SAS入力形式とは、SASシステムが値を変数に読み込む(すなわち値を変数に保存する)際に使用する命令のことです。 入力形式名の一部にピリオド(.)を含めることはできません。幅および長さは、入力形式名の一部としてではなく、属性として指定します。

<INFORMAT> E8601DA </INFORMAT>
<INFORMAT width="8"> best </INFORMAT>
<INFORMAT width="8" ndec="2"> dollar </INFORMAT>

オプションの要素であり、変数の説明を最大256文字で指定します。説明を変数ラベルとして割り当てる例を次に示します。

<DESCRIPTION> Story link </DESCRIPTION>

XMLデータの文字変数の最大格納フィールド長を指定します。この値は、SASデータセット内の各変数の値を格納する場合に使用されるバイト数を意味します。この属性値の範囲は、1～32,767になります。インポート処理時に、この属性に指定した最大長の文字列がXMLドキュメントから読み込まれた後、オブザベーションバッファに転送されます。たとえば、<LENGTH> 200 </LENGTH>のように記述します。

場所パスを指定します。場所パスとは、現在の変数の値を取り出すには、XMLドキュメント内のどの位置を検索し、特定のタグにアクセスする必要があるかをXML Engineに伝えるものです。また、場所パスは、場所パス形式により指定される機能を実行して変数の値を取り出すようXML Engineに伝えます。サポートされているXPath形式を指定すると、生成されるSASデータセットに要素や属性を個別に含めることができます。

<PATH> /LEVEL/ITEM </PATH>
<PATH> /LEVEL/ITEM[@attr="value"] </PATH>
<PATH> /LEVEL/ITEM[position()=n]|[n] </PATH>

<PATH> /LEVEL/ITEM/@attr </PATH>
<PATH> /LEVEL/ITEM/@attr[attr2="value"] </PATH

COLUMN要素のclass="ORDINAL属性を指定した場合に確立される、カウンタ変数用の場所パスを指定します。この場所パスは、入力データ内のどの箇所で、カウンタ変数の累積値を1インクリメントするかをXML Engineに伝えます。

COLUMN要素のclass="ORDINAL属性を指定した場合に確立される、カウンタ変数用の場所パスを指定します。この場所パスは、XMLドキュメント内のどの箇所で、カウンタ変数の累積値をゼロにリセットするかをXML Engineに伝えます。

COLUMN要素のclass="ORDINAL属性を指定した場合に確立される、カウンタ変数用の場所パスを指定します。この場所パスは、入力データ内のどの箇所で、カウンタ変数の累積値を1デクリメントするかをXML Engineに伝えます。