可変長ファイル書き込み処理

オペレーション名

可変長ファイル書き込み

機能概要

入力データを用いて可変長形式のテキストファイルを生成します。

データモデル

本コンポーネントのデータモデルはテーブルモデル型です。

プロパティ

基本設定

項目名	必須/省略可	変数の使用	説明	備考
名前	必須	使用不可	スクリプトキャンバス上での名前を入力します。
入力データ	必須	使用不可	スクリプトキャンバス上にあるコンポーネントを選択します。

必須設定

項目名	必須/省略可	変数の使用	説明	備考
ファイル	必須	使用可	書き込みを行う可変長ファイルパスを入力します。 [参照]ボタンを押下するとファイルチューザが起動し、ファイルの選択ができます。	ファイルパスはDataSpiderファイルシステムの絶対パスで指定してください。パス区切り文字「/」以外のDataSpiderファイルシステムの使用禁止文字は使用できません。
デリミタモード	必須	使用不可	デリミタの指定方法を選択します。 [一覧から選択]:(デフォルト) 一覧からデリミタ文字を選択します。 [直接入力]: フィールドに直接デリミタ文字を入力します。 [文字コード入力]: フィールドに文字コードでデリミタ文字を入力します。	選択した指定方法により、対応した入力フィールド([デリミタ文字リスト]/[デリミタ文字])に切り替わります。
デリミタ文字リスト	省略可	使用不可	デリミタ文字を選択します。 [半角スペース]:(デフォルト) [タブ]: [半角カンマ]: [半角セミコロン]: [半角スラッシュ]: [改行]:	[デリミタモード]に[一覧から選択]を選択した場合、有効になります。
デリミタ文字	省略可	使用可	デリミタ文字を入力します。 [直接入力]の場合キーボードから直接入力します。 [文字コード入力]の場合 [エンコード]で指定したエンコーディングによるバイト列を指定します。 8進(接頭辞「0」<数字のゼロ>)、10進(接頭辞なし)、16進(接頭辞「0x」<数字のゼロとアルファベットのエックス>もしくは「#」)による入力が可能です。パディングが複数のバイト列になる場合には、カンマで区切って入力します。例:0x10,0x13	[デリミタモード]に[直接入力]または[文字コード入力]を選択した場合、有効になります。
ダブルクォートエスケープ	必須	使用不可	ダブルクォートエスケープを行うかどうかを選択します。 [無効]:(デフォルト) ダブルクォートエスケープを行いません。単純なデリミタ区切りです。フィールドの値としてデリミタを持つことはできません。 [有効]: ダブルクォートエスケープを行います。フィールド値にデリミタ、もしくはダブルクォーテーションが含まれている場合、フィールド値をダブルクォーテーションで囲みます。フィールド値としてダブルクォーテーションが含まれる場合、ダブルクォーテーション1文字をダブルクォーテーション2文字で表現します。	フィールドの両端にダブルクォートがあり、そのフィールド内にエスケープしたいデリミタもしくはダブルクォーテーションがない場合はエラーになります。
フォーマット	必須	使用不可	グローバルリソースに登録されている可変長ファイルフォーマット定義を選択します。設定方法については、「可変長書き込みウィザード」を参照してください。 [追加]: 新規にグローバルリソースを追加します。 [編集]: 「リソース一覧の編集」画面にて、グローバルリソースの設定を編集することができます。

プロパティアクション

項目名	説明	備考
プレビュー	プレビューアを起動して、[ファイル]で指定したファイルの内容を表示します。	指定したファイルが存在しない場合、または[ファイル]に変数が設定されている場合は無効になります。 [エンコード]で指定したエンコードで表示されます。ファイル内容の編集はできません。プレビューアで表示できるファイルのサイズは最大1MBです。ファイルサイズが1MBを超える場合、ファイルの先頭から1MB分が表示されます。

書き込み設定

項目名

必須/省略可

変数の使用

説明

備考

エンコード

必須

使用可

読み取るファイルのエンコードを選択または入力します。

入力する場合は、Java SE Runtime Environment 7でサポートされているエンコードを指定します。

詳細については、「Supported Encodings」(http://docs.oracle.com/javase/7/docs/technotes/guides/intl/encoding.doc.html)を参照してください。

デフォルト値については、「デフォルトで選択されるエンコード」を参照してください。

改行コード

必須

使用不可

改行コードを選択します。

[AUTO]:(デフォルト)
処理系依存
[CR]:
主にMac OS(バージョン9まで)
[LF]:
主にUNIX/Linux
[CR+LF]:
主にMicrosoft Windows

改行コードは[エンコード]で指定したエンコードでエンコーディングされるため、バイト値はエンコードによって異なります。

エンコード	バイト値
UTF-8	0x0a
Shift_JIS	0x0a
Windows-31J	0x0a
EUC-JP	0x0a
ISO-8859-1	0x0a
ISO-2022-JP	0x0a
US-ASCII	0x0a
UTF-16	0xfe,0xff,0x00,0x0a
UTF-16BE	0x00,0x0a
UTF-16LE	0x0a,0x00
Cp930 (EBCDIC)	0x15

エンコード	バイト値
UTF-8	0x0d
Shift_JIS	0x0d
Windows-31J	0x0d
EUC-JP	0x0d
ISO-8859-1	0x0d
ISO-2022-JP	0x0d
US-ASCII	0x0d
UTF-16	0xfe,0xff,0x00,0x0d
UTF-16BE	0x00,0x0d
UTF-16LE	0x0d,0x00
Cp930 (EBCDIC)	0x0d

CRLF

エンコード	バイト値
UTF-8	0x0d,0x0a
Shift_JIS	0x0d,0x0a
Windows-31J	0x0d,0x0a
EUC-JP	0x0d,0x0a
ISO-8859-1	0x0d,0x0a
ISO-2022-JP	0x0d,0x0a
US-ASCII	0x0d,0x0a
UTF-16	0xfe,0xff,0x00,0x0d,0x00,0x0a
UTF-16BE	0x00,0x0d,0x00,0x0a
UTF-16LE	0x0d,0x00,0x0a,0x00
Cp930 (EBCDIC)	0x0d,0x15

上書き

省略可

使用不可

指定したファイルが存在する場合、上書きするかどうかを選択します。

[チェックあり]:(デフォルト)
上書きします。
[チェックなし]:
上書きしません。すでにファイルが存在した場合はエラーとなります。

追加書き込み

省略可

使用不可

指定したファイルが存在する場合、ファイルの末尾に追加するまたは上書きするかを選択します。

[チェックあり]:
ファイルの末尾に追加します。
[チェックなし]:(デフォルト)
上書きします。

[上書き]にチェックを入れた場合のみ有効になります。

トランザクション

項目名	必須/省略可	変数の使用	説明	備考
トランザクション処理を行う	必須	使用不可	トランザクション処理を行うかどうかを選択します。 [チェックあり]: トランザクション処理を行います。 [チェックなし]:(デフォルト) トランザクション処理を行いません。詳細については、「ファイル系アダプタのトランザクション」を参照してください。

項目名	必須/省略可	変数の使用	説明	備考
コメント	省略可	使用不可	このアダプタの簡単な説明を記述することができます。説明を記述すると、仕様書に反映させることができます。

スキーマ

入力スキーマ

[フォーマット]の設定により、カラム数が異なります。

スキーマ構造については、「テーブルモデル型のスキーマ」を参照してください。

出力スキーマ

ありません。

Mapperでのスキーマ読み込み

スキーマは自動で読み込まれます。

詳細については、「スキーマ編集」を参照してください。

トランザクション

トランザクションをサポートしています。

[トランザクション]の[トランザクション処理を行う]にチェックを入れた場合のみトランザクションは有効になります。

PSPでの使用について

PSPで使用できます。

PSPについては、「パラレルストリーミング処理」を参照してください。

使用できるコンポーネント変数

コンポーネント変数名	説明	備考
count	書き込んだデータの件数が格納されます。	デフォルト値はnullです。
message_category	エラー発生時、発生したエラーに対応するメッセージコードのカテゴリが格納されます。	デフォルト値はnullです。
message_code	エラー発生時、発生したエラーに対応するメッセージコードのコードが格納されます。	デフォルト値はnullです。
message_level	エラー発生時、発生したエラーに対応するメッセージコードの重要度が格納されます。	デフォルト値はnullです。
error_type	エラー発生時、発生したエラーの種類が格納されます。	デフォルト値はnullです。エラーの種類は、以下のような形式となります。例:「java.io.FileNotFoundException」 DataSpider Servistaのバージョンにより、格納される内容が変わる可能性があります。
error_message	エラー発生時、発生したエラーのメッセージが格納されます。	デフォルト値はnullです。 DataSpider Servistaのバージョンにより、格納される内容が変わる可能性があります。
error_trace	エラー発生時、発生したエラーのトレース情報が格納されます。	デフォルト値はnullです。 DataSpider Servistaのバージョンや実行するクライアントアプリケーションにより、格納される内容が変わる可能性があります。

仕様制限

外字は扱えません。

BOM(Byte Order Mark)の読み取りはできません。

列一覧で定義したフィールド数が入力元のXMLデータのカラム数より少ない場合、列一覧で定義したフィールド数のデータしか書き込まれません。

列一覧で定義したフィールド数が入力元のXMLデータのカラム数より多い場合、エラーが発生し書き込むことができません。

nullが入力された場合は、空文字として書き込みます。

構造定義ツリーのノード値は、ダブルクリックで編集を行うことができます。

フィールド名は、スキーマの種類でCOLUMN_NAMEを指定した場合、編集することができます。

構造定義ツリーで、ノードの追加、削除、コピーはできません。

リポジトリDBを使用した環境ではDataSpiderファイルシステムのルートの直下にファイルを出力することができません。

実行ログに出力される「トランザクション」とは、グループの構造をまとめるために暗黙的に定義されたものであり、出現回数は無制限となります。

同じ親要素を持つ要素同士で同じ名前のものが存在する場合、正常に書き込むことはできません。
具体的には以下の要素同士が該当します。
- グループ
- 構造定義アイコン直下のレコード
- 同一グループ内のレコード
- 同一レコード内のフィールド

主な例外

例外名	原因	対策
InputDataNotFoundException	[入力データ]が指定されていません。	[入力データ]を指定する、またはデータフローを引いてください。
ResourceNotFoundException リソース定義が見つかりませんでした。名前:[]	[フォーマット]が指定されていません。	[フォーマット]を指定してください。
ResourceNotFoundException リソース定義が見つかりませんでした。名前:[<グローバルリソース名>]	[フォーマット]で選択されたリソース定義が見つかりません。	[フォーマット]で指定したグローバルリソースを確認してください。
InvalidPropertyConfigurationException <プロパティ名>が指定されていません。	[<プロパティ名>]が指定されていません。	[<プロパティ名>]を指定してください。
FileIsDirectoryException	[ファイル]に入力されたパスがディレクトリです。	[ファイル]にはファイルパスを入力してください。
FileAlreadyExistedException	[ファイル]に指定されたファイルが既に存在します。	[ファイル]のファイル名を変更する、または[書き込み設定]の[上書き]にチェックを入れてください。
FileIsLockedException	[ファイル]に指定されたファイルがロックされています。	エクスプローラやCLIからロックの解除を行ってください。
ArrayIndexOutOfBoundsException	[フォーマット]で指定した列一覧のフィールド数が、入力元XMLデータのカラム数より大きい可能性があります。	[フォーマット]で指定した列一覧のフィールド数または、入力元XMLデータのカラム数を確認してください。
java.io.UnsupportedEncodingException	[エンコード]にサポートされていないエンコードが指定されています。	Java SE Runtime Environment 7でサポートされているエンコードを指定してください。詳細については、「Supported Encodings」(http://docs.oracle.com/javase/7/docs/technotes/guides/intl/encoding.doc.html)を参照してください。
java.io.FileNotFoundException 別のプロセスが使用中です。	[ファイル]に指定されたファイルが別のプロセスによって使用されています。	別のプロセスで使用されていないかを確認してください。

注意事項

繰り返し処理中に配置する場合は繰り返し処理(データ件数)の注意事項を参照してください。

Migration Kitの機能

本機能は、Migration Kitを適用した場合のみ有効になります。

プロパティ

互換性

項目名	必須/省略可	変数の使用	説明	備考
1.5形式のデータを使用	省略可	使用不可	結果データのスキーマの形式を選択します。 [チェックあり]: DataSpider 1.5形式のスキーマで結果データを作成します。出力スキーマについては、「1.5形式のスキーマ」を参照してください。 [チェックなし]:(デフォルト) DataSpider Servista 2.0以降のスキーマで結果データを作成します。
スキーマの種類	省略可	使用不可	スキーマの種類を選択します。 [DEFAULT]:(デフォルト) 通常のスキーマを使用します。 [COLUMN_NAME]: 要素名の定義が可能となります。	[1.5形式のデータを使用]にチェックを入れた場合、有効になります。

プロパティアクション

項目名	説明	備考
構造定義ファイルのインポート	CSV形式で定義された可変長データ構造をインポートします。構造定義については、「1.5形式の構造定義」を参照してください。

1.5形式のスキーマ

<?xml version="1.0" encoding="UTF-8"?>
<structuredtext>
 <data>
  <transaction name="">
   <group name="">
    <record name="">
     <fieldvalue/>
    </record>
   </group>
  </transaction>
 </data>
</structuredtext>

1.5形式の構造定義ファイル

可変長データの構造(フィールド・レコード・グループ・トランザクション)をCSV形式で定義します。

構造設定ファイルの仕様

構造設定ファイルの各レコードの先頭列(1列目)は、[フィールド]・[レコード]・[グループ]・[トランザクション]のいずれかでなければ無視されます。
例:

レコード,住所
フィールド,都道府県,文字列
フィールド,市区,文字列
グループ,住所録,,,住所

[レコード]・[グループ]・[トランザクション]が定義されているレコードの出現順序は規定いたしません。但し、[フィールド]の定義は、必ずその[フィールド]が属する[レコード]に続いて定義しない場合、無視されます。
例:

フィールド,xxxxxxxxxxx
レコード,xxxxxxxx
フィールド,xxxxxxx
フィールド, xxxxxxx

<= 無視

<= 有効(レコード名の1番目に現れるフィールド)
<= 有効(レコード名の2番目に現れるフィールド)

構造設定ファイルの書式

レコードを定義する場合
以下のフォーマットで、各レコードを定義します。

レコード,<レコード名>,<出現回数>

各列の項目とプロパティの構造定義ツリーのノードの関係は、以下のとおりです。

各列の項目	構造定義ツリーのノード	備考
レコード名	プロパティの構造定義ツリー「レコード」のノード値に設定されます。
出現回数	プロパティの構造定義ツリー「出現回数」のノード値に設定されます。

例:以下の条件であるレコード定義する場合

レコード名	ヘッダ
出現回数	5

レコード,ヘッダ,5

フィールドを定義する場合
以下のフォーマットで、各フィールドを定義します。

フィールド,<フィールド名>,<フィールド型(文字列/数値/日付/タグ)>,<日付フォーマット/タグ文字列>

各列の項目とプロパティの構造定義ツリーのノードの関係は、以下のとおりです。

各列の項目	構造定義ツリーのノード	備考
フィールド名	プロパティの構造定義ツリー「フィールド」のノード値に設定されます。
フィールド型	プロパティの構造定義ツリー「型」のノード値に設定されます。
日付フォーマット/タグ文字列	プロパティの構造定義ツリー「日付フォーマット」または「タグ文字列」のノード値に設定されます。	日付フォーマットは[フィールド型]に「日付」を設定した場合に、型の子ノードとして表示されます。タグ文字列は[フィールド型]に「タグ」を設定した場合に、型の子ノードとして表示されます。

例:以下の条件であるフィールドを定義する場合

フィールド名	受注日付
フィールド型	日付
日付フォーマット	西暦四桁/月二桁/日二桁で設定する例:2003/06/18

フィールド,受注日付,日付,$yyyy/$MM/$dd

グループを定義する場合
以下のフォーマットで、各グループを定義します。

グループ,<グループ名>,<最小繰り返し回数>,<最大繰り返し回数>,<レコード名1>,<レコード名2>,...

各列の項目とプロパティの構造定義ツリーのノードの関係は、以下のとおりです。

各列の項目	構造定義ツリーのノード	備考
グループ名	プロパティの構造定義ツリー「グループ」のノード値に設定されます。
最小繰り返し回数	プロパティの構造定義ツリー「最小ループ回数」のノード値に設定されます。
最大繰り返し回数	プロパティの構造定義ツリー「最大ループ回数」のノード値に設定されます。
レコード名N	グループの子ノードに入るレコード名を指定します。

例:以下の条件であるグループ定義する場合

グループ名	ヘッダグループ
最小繰り返し回数	1
最大繰り返し回数	(null値:無制限)
レコード名1	ヘッダ

グループ,ヘッダグループ,1,,ヘッダ

トランザクションを定義する場合
以下のフォーマットで、各トランザクションを定義します。br>

トランザクション,<トランザクション名>,<出現回数>,<グループ名1>,<グループ名2>,...

各列の項目とプロパティの構造定義ツリーのノードの関係は、以下のとおりです。

各列の項目	構造定義ツリーのノード	備考
トランザクション名	プロパティの構造定義ツリー「トランザクション」のノード値に設定されます。
出現回数	プロパティの構造定義ツリー「出現回数」のノード値に設定されます。
グループN	トランザクションの子ノードに入るグループ名を指定します。

例:以下の条件であるトランザクション定義する場合

トランザクション名	ヘッダトランザクション
出現回数	(null値:無制限)
グループ名1	ヘッダグループ

トランザクション,ヘッダトランザクション,,ヘッダグループ

可変長ファイル書き込み処理

オペレーション名

機能概要

データモデル

プロパティ

基本設定

必須設定

プロパティアクション

書き込み設定

トランザクション

コメント

スキーマ

入力スキーマ

出力スキーマ

Mapperでのスキーマ読み込み

トランザクション

PSPでの使用について

使用できるコンポーネント変数

仕様制限

主な例外

注意事項

Migration Kitの機能

プロパティ

互換性

プロパティアクション

1.5形式のスキーマ

1.5形式の構造定義ファイル