FilePut - ファイルへの出力
ファイルシステムにストリームをファイルとして書き出します。
■ストリーム情報
| 入力 | フォーマット | すべて |
|---|---|---|
| 接続数 | 1 | |
| 説明 | すべてのストリームを入力できます。 | |
| 出力 | フォーマット | すべて |
| 説明 | 入力ストリームをそのまま出力します。 |
■コンポーネントプロパティ
| 名前 | プロパティ型 | マッピング | 説明 | ||||||
|---|---|---|---|---|---|---|---|---|---|
| ファイルパス | remoteFile | 入力＆出力 |
書き込むファイルのパスを指定します。区切り文字「\」と「/」は区別されません。
相対パスの場合は相対パスの起点 の指定に基づいて解釈されます。 例： directory/file.txt C:\directory\file.txt \\server\share\file.txt |
||||||
| ファイルパスの詳細設定 | group | - | ファイルパスの詳細設定を行うプロパティ群です。 | ||||||
| 相対パスの起点 | pathResolver | - |
相対パス指定の場合にベースフォルダーを指定します。
|
||||||
| 絶対パスを許可 | boolean | - | 絶対パスを許可するかどうか選択します。 | ||||||
| 「..」を許可 | boolean | - | 上のフォルダへ移動する記述に「..」を許可するかどうか選択します。 | ||||||
| 書込み処理 | choice | - | ファイルパス で指定されたファイルが既に存在していた場合の書き込みを選択します。
|
||||||
| 上書きを許可 | boolean | - | ファイルパス で指定したファイル名のファイルが既に存在する場合の動作を指定します。
|
||||||
| ロールバック時の処理 | choice | - |
ロールバック時に書き込んだファイルを削除するかどうか選択します。
|
■トランザクション処理
| コミット | 書込み処理 が「追加」の場合、ファイルをクローズします。 |
|---|---|
| ロールバック | ロールバック時の処理 が「ファイルを削除」の場合、ファイルを削除します。
書込み処理 が「追加」の場合、ファイルをクローズします。 |
■エラー処理
| タイプ | パラメーター | エラー処理フロー
へのストリーム | エラー
コード | 説明 |
|---|---|---|---|---|
| 汎用 | 「汎用のパラメーター
」
を参照してください。 | コンポーネントの入力ストリーム | なし | ファイルパス で指定されたファイルに書き込めなかった場合 |
| なし | 相対パスの起点 が「実行ユーザーのホームフォルダー」の場合に実行ユーザーが存在しないため相対パスが解決できなかった場合 | |||
| ファイルが存在する | 「ファイルが存在するのパラメーター
」
を参照してください。 | コンポーネントの入力ストリーム | 4 | ファイルパス で指定したファイルが既に存在している場合
(書込み処理 が「追加」の場合、および上書きを許可 が「はい」の場合は発生しません。) |
■「汎用」のパラメーター
| No. | 名前 | 説明 |
|---|---|---|
| 1 | FilePath | エラー発生時のファイルパス の値 |
■「ファイルが存在する」のパラメーター
| No. | 名前 | 説明 |
|---|---|---|
| 1 | FilePath | エラー発生時のファイルパス の値 |
■コンポーネントの操作について
- コンポーネントアイコンをダブルクリックすると、ファイルパス に指定したファイルを拡張子に関連付けられたアプリケーションで開きます。アイコンを右クリックして表示されるメニューの「ファイルの編集」でも同様にできます。
- ツリーペインからファイルのアイテムをドラッグしてコンポーネントアイコンの上でドロップすると、ファイルパス にファイルパスが自動入力されます。
■ファイルのクローズとフローのトランザクション化
書込み処理 が「新規」の場合、コンポーネントの終了時にファイルがクローズされます。
書込み処理 が「追加」の場合、以下のような動作になります。
- フローがトランザクション化されていない場合、コンポーネントの終了時にファイルがクローズされます。
- フローがトランザクション化されている場合、トランザクションの完了時、あるいはマッパーによってファイルパス が変更された時に、ファイルがクローズされます。
親フローがトランザクション化されている場合、サブフロー内で本コンポーネントが書き出したファイルは、親フローのトランザクションが完了するまでクローズされません。
※フローのトランザクション化は、StartまたはHttpStartコンポーネントの「トランザクション化」プロパティで指定します。
パフォーマンス
書込み処理 が「追加」の場合でループ処理などで繰り返し追加処理を行うとき、フローをトランザクション化しないと、処理のたびにファイルのオープン、クローズが行われてパフォーマンスが劣化する可能性があります。このような場合、フローをトランザクション化するようにしてください。
DeleteFileコンポーネントでのファイルの削除
DeleteFileコンポーネントでファイルを削除するとき、対象ファイルはクローズされている必要があります。 そのため、本コンポーネントの書込み処理 が「追加」で出力したファイルは、トランザクション化した同一フロー内でDeleteFileコンポーネントを使って削除することはできません。
MoveFileコンポーネントでのファイルの移動
MoveFileコンポーネントでファイルを移動するとき、対象ファイルはクローズされている必要があります。 そのため、本コンポーネントの書込み処理 が「追加」で出力したファイルは、トランザクション化した同一フロー内でMoveFileコンポーネントを使って移動することはできません。