MoveFile - ファイル移動

ファイル、フォルダーを移動します。

このコンポーネントでは、実際にはファイル名、フォルダー名の変更（リネーム）を行います。移動先に指定されたファイル、フォルダーが既に存在する場合や、異なるファイルシステムが移動先として指定された場合は、このコンポーネントの実行時にエラーが発生します。異なるファイルシステムへの移動には、CopyFileコンポーネントを使用します。

■ストリーム情報

入力	フォーマット	すべて
	接続数	1
	説明	すべてのストリームを入力できます。
出力	フォーマット	すべて
	説明	入力ストリームをそのまま出力します。

■コンポーネントプロパティ

名前	プロパティ型	マッピング	説明
移動元ファイルパス	remoteFile	入力＆出力	移動元のファイル、フォルダーのパスを指定します。 UNIXシステムの場合は、パス名は接頭辞が "/" の場合に絶対パスとみなします。Windowsシステムの場合は、パス名は接頭辞がドライブ指示子のあとに "\\" が続く場合、または接頭辞が "\\" の場合に絶対パスとみなします。 相対パスで指定した場合は、相対パスの起点 で指定したホームからの相対になります。 「*」と「?」の2つのワイルドカードを使用して1つ以上のファイル、フォルダーを指定することができます。 「*」は0個以上の任意の文字に、「?」は任意の1文字にマッチします。 ワイルドカードが指定された場合は、移動先ファイルパス の指定はフォルダー名として解釈されます。 フォルダーが指定された場合は、そのフォルダー内のファイル、フォルダーもすべてまとめて移動されます。
移動先ファイルパス	remoteFile	入力＆出力	移動先のファイル、フォルダーのパスを指定します。 相対パスで指定した場合は、相対パスの起点 で指定したホームからの相対になります。
ファイルパスの詳細設定	group	-	ファイルパスの詳細設定を行うプロパティ群です。
相対パスの起点	pathResolver	-	相対パス指定の場合にベースフォルダーを指定します。 プロジェクトフォルダー [Relative] プロジェクトファイルと同じフォルダーを起点にします。 ホームフォルダー [ProjectOwner] ユーザーのホームフォルダーを起点にします。 実行ユーザーのホームフォルダー [ExecuteUser] 実行ユーザーのホームフォルダーを起点にします。
絶対パスを許可	boolean	-	絶対パスを許可するかどうか選択します。
「..」を許可	boolean	-	上のフォルダへ移動する記述に「..」を許可するかどうか選択します。

■トランザクション処理

コミット	何もしません。
ロールバック	何もしません。

■エラー処理

タイプ	パラメーター	エラー処理フロー へのストリーム	エラー コード	説明
ファイルが存在しない	なし	コンポーネントの入力ストリーム	2	移動元ファイルパス で指定したファイルが見つからなかった場合
汎用	なし	コンポーネントの入力ストリーム	3	移動先に同名のファイル、フォルダーが既に存在していた場合
			4	移動先ファイルパス で指定したフォルダーが存在せず、作成もできなかった場合
			5	移動元と移動先のファイルシステムのドライブやデバイスが異なる場合 移動元ファイルパスにフォルダーを指定して、移動先ファイルパスに移動元ファイルパスに指定したフォルダーのサブフォルダーを指定した場合
			9	ファイルパスの指定が誤っている場合や、相対パスの起点 が「実行ユーザーのホームフォルダー」の場合に、実行ユーザーが存在しないため相対パスが解決できなかった場合
			10	その他のIOException ワイルドカードを使用して複数ファイルの移動を行っている場合は一部のファイルの移動のみに成功し、途中でエラーになることがあります。

■移動元、移動先の状況と動作の詳細

移動元ファイルパス でワイルドカードが使用されず、かつ移動先ファイルパス がパス区切り文字で終了していない場合の動作は、実行時の状況により異なります。
移動元ファイルパス移動先ファイルパス で指定したパスに対して、以下の3つのパターンが想定されます。

1. パスに該当するファイルが存在する
2. パスに該当するフォルダーが存在する
3. パスに該当するファイル、フォルダーが存在しない

それぞれのパターンの組み合わせと、このコンポーネントの動作の関係は以下の表のようになります。

移動元ファイルパス	移動先ファイルパス	動作
ファイル	ファイル	"エラーコード=3"のエラーが発生します。
ファイル	フォルダー	移動先ファイルパス で指定されたフォルダーの中に移動元ファイルパス で指定されたファイルをファイル名を変えずに移動します。 移動先ファイルパス で指定されたフォルダーの中に移動元ファイルパス で指定されたファイルと同名のファイル、フォルダーが既に存在する場合、"エラーコード=3"のエラーが発生します。
ファイル	存在しない	移動先ファイルパス で指定されたパスをファイル名として解釈し、移動元ファイルパス で指定されたファイルのファイル名を移動先ファイルパス で指定されたファイルのファイル名に変更して移動します。 移動先ファイルパス で指定されたパスに含まれる上位フォルダーが存在しない場合は、そのフォルダーを作成します。
フォルダー	ファイル	"エラーコード=3"のエラーが発生します。
フォルダー	フォルダー	移動先ファイルパス で指定されたフォルダーの中に移動元ファイルパス で指定されたフォルダーをフォルダー名を変えずに移動します。 移動先ファイルパス で指定されたフォルダーの中に移動元ファイルパス で指定されたフォルダーと同名のファイル、フォルダーが既に存在する場合、"エラーコード=4"のエラーが発生します。
フォルダー	存在しない	移動先ファイルパス で指定されたパスをフォルダー名として解釈し、移動元ファイルパス で指定されたフォルダーのフォルダー名を移動先ファイルパス で指定されたフォルダーのフォルダー名に変更して移動します。 移動先ファイルパス で指定されたパスに含まれる上位フォルダーが存在しない場合は、そのフォルダーを作成します。
存在しない	ファイル	"エラーコード=2"のファイルが存在しない が発生します。
	フォルダー
	存在しない

移動先ファイルパス がパス区切り文字（/や\）で終了している場合、あるいは移動元ファイルパス でワイルドカードが使用された場合は、実行時に移動元として複数のファイル、フォルダーがマッチしたかどうかにかかわらず、移動先ファイルパス の指定はフォルダー名として解釈され、以下のように動作します。

• 移動先ファイルパス で指定されたパスに含まれる上位フォルダーが存在しない場合は、それらのフォルダーを作成します。
• 移動先ファイルパス で指定されたフォルダーが存在しない場合、指定されたフォルダー名でフォルダーを作成します。
• 移動先ファイルパス で指定されたフォルダー下に、移動元ファイルパス で指定されたファイル、フォルダーがファイル名、フォルダー名を変えずに移動されます。
• 移動先ファイルパス で指定されたパスのファイルが存在する場合、"エラーコード=3"のエラーが発生します。
• 移動先ファイルパス で指定されたフォルダーの中に、移動するファイル、フォルダーと同名のファイル、フォルダーが存在する場合、"エラーコード=3"のエラーが発生します。

■CopyFileコンポーネントを使用してファイルを移動する場合との動作の違いについて

CopyFileコンポーネントでコピー元を削除を「はい」に指定すると、MoveFileコンポーネントと同等の処理を行うことができます。しかし、この2つのコンポーネントには次のような違いがあります。

• MoveFileファイルコンポーネントは、ファイルの移動をファイル名を変更することで実現しています。このため、ファイルデータのコピーが発生しないのでCopyFileコンポーネントより高速に処理することができます。
• 移動元ファイルパスと移動先ファイルパスのデバイスやドライブが異なる場合にはMoveFileコンポーネントは使用できません。
• 移動先に既に同名のファイルが存在する場合にはMoveFileコンポーネントは使用できません。例えば、フォルダーを移動する場合で、移動元ファイルパスと移動先ファイルパスの一部のファイルが重複しているようなケースでは、MoveFileコンポーネントを使用することはできませんがCopyFileコンポーネントは使用することができます。

必要に応じてどちらのコンポーネントを使用するかを選択してください。