FTPUpload - FTPでファイル・フォルダーをアップロード

ファイルをFTPサーバーにアップロードします。
フォルダーを指定してフォルダーの中のファイルをまとめてアップロードすることもできます。
アップロードするファイルと同じ名前のファイルがすでに存在していた場合は上書きされます。
転送モードはバイナリモードで転送されます。
ファイルを直接アップロードしますので、FTPPutコンポーネントよりもメモリの使用量が少なくなります。

■ストリーム情報

入力	フォーマット	すべて
	接続数	1
	説明	入力ストリームは使用せず、すべて無視します。
出力	フォーマット	すべて
	説明	入力をそのまま出力プロパティが「はい」である場合は入力ストリームをそのまま出力します。 「いいえ」である場合は、アップロードしたローカルファイルの情報を次のようなフィールド定義のレコードとして出力します。 フィールド名 データ型 説明 FileName String ファイル名 FilePath String ファイルのフルパス FileDate DateTime ファイルの更新日時 FileSize Integer ファイルサイズ

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

名前	プロパティ型	マッピング	説明
コネクションを使用	boolean	-	接続先にコネクション名 に指定されたコネクションを使用するかどうか選択します。 はい [true] - コネクション名 で指定されたFTP接続名の接続設定を使ってFTPまたはSFTPによる接続を行います。 いいえ [false] - コネクション情報 以下の値を使ってFTPまたはSFTPによる接続を行います。
コネクション名	connection	-	コネクションを使用 が「はい」の場合に接続先のFTPサーバーを指定します。 コネクションペインまたは管理コンソールにて作成したFTP接続名を選択します。 各コネクションの詳細については、「はじめに」-「詳細なトピック」-「フローの構成要素」-「コネクションプロパティ」を参照してください。
コネクション情報	group	-	コネクションを使用 が「いいえ」の場合に使用されるプロパティ群です。
プロトコル	choice	入力＆出力	接続先がFTPサーバーであるかSFTPサーバーであるかを指定します。 コネクションを使用 が「いいえ」の場合、この設定を参照します。 ftp - 接続先がFTPサーバーの場合 sftp - 接続先がSFTPサーバーの場合
サーバー名	string	入力＆出力	接続先のFTPまたはSFTPサーバー名を指定します。 コネクションを使用 が「いいえ」の場合、この設定を参照します。
ポート番号	int	入力＆出力	接続先のFTPまたはSFTPサーバーのポート番号を指定します。 コネクションを使用 が「いいえ」の場合、この設定を参照します。
パッシブモード	boolean	入力＆出力	FTP接続のモードでパッシブモードを使うかどうかを指定します。 接続先がSFTPサーバーの場合、この設定は参照されません。 コネクションを使用 が「いいえ」の場合、この設定を参照します。 はい [true] - パッシブモードを使用します。 いいえ [false] - パッシブモードを使用しません。
ファイル名のエンコーディング	choice	入力＆出力	転送されるファイルのファイル名のエンコーディングを指定します。 日本語のファイル名を使わない場合（US-ASCII文字のみの場合）にはどれを指定しても構いません。 接続先がSFTPサーバーの場合、この設定は参照されません。 コネクションを使用 が「いいえ」の場合、この設定を参照します。
タイムアウト（秒）	int	入力＆出力	接続時のタイムアウト時間（秒）を設定します。初期値は60です。0を指定すると無制限になります。接続後のアイドルタイムアウト指定はなく無制限です。 コネクションを使用 が「いいえ」の場合、この設定を参照します。
プロキシサーバー	choice	入力＆出力	管理コンソールで設定したプロキシ設定を使用するかどうかを指定します。 コネクションを使用が「いいえ」の場合にこの設定が参照されます。 使用する [true] - プロキシ設定を使用します。 使用しない [false] - プロキシ設定を使用しません。
ユーザー名	string	入力＆出力	FTPまたはSFTPサーバーへのログイン名を指定します。 コネクションを使用 が「いいえ」の場合、この設定を参照します。
パスワード	password	入力＆出力	上記ログイン名に対応するパスワードを指定します。 接続先がSFTPサーバーで、公開鍵認証のキーファイル が指定されている場合、この設定は参照されません。 コネクションを使用 が「いいえ」の場合、この設定を参照します。
公開鍵認証のキーファイル	string	入力＆出力	SFTPサーバーが公開鍵認証である場合に、認証で使用する秘密鍵のファイル名を絶対パスで指定します。 接続先がFTPサーバーの場合、この設定は参照されません。 コネクションを使用 が「いいえ」の場合、この設定を参照します。
キーファイルのパスフレーズ	password	入力＆出力	公開鍵認証のキーファイル で指定した秘密鍵がパスフレーズで保護されている場合には、そのパスフレーズを指定します。 接続先がFTPサーバーの場合、この設定は参照されません。 コネクションを使用 が「いいえ」の場合、この設定を参照します。
アップロードファイルパス	remoteFile	入力＆出力	アップロードするファイルのフォルダーパスまたはファイルパスを指定します。 区切り文字「\」と「/」は区別されません。 「**」と「*」と「?」の3つのワイルドカードが使用できます。「**」は0個以上の任意のパスセグメントに、「*」は0個以上の任意の文字に、「?」は任意の1文字にマッチします。 例： directory/file.txt C:\directory\file.txt \\server\share\file.txt **/*.txt - 相対パスの起点 以下のすべての「*.txt」ファイル C:\directory\*.txt - C:\directory直下の「*.txt」ファイル フォルダーが指定された場合は、そのフォルダーの中のすべてのファイル、フォルダーをアップロードします。
ファイルパスの詳細設定	group	-	ファイルパスの詳細設定を行うプロパティ群です。
相対パスの起点	pathResolver	-	相対パス指定の場合にベースフォルダーを指定します。 プロジェクトフォルダー [Relative] プロジェクトファイルと同じフォルダーを起点にします。 ホームフォルダー [ProjectOwner] ユーザーのホームフォルダーを起点にします。 実行ユーザーのホームフォルダー [ExecuteUser] 実行ユーザーのホームフォルダーを起点にします。
絶対パスを許可	boolean	-	絶対パスを許可するかどうか選択します。
「..」を許可	boolean	-	上のフォルダへ移動する記述に「..」を許可するかどうか選択します。
保存先ファイルパス	string	入力＆出力	アップロードするファイルの送り先のサーバーでのフォルダーパスおよびファイルパスを相対パスで指定します。絶対パスでの指定はできません。
コミット時の処理	choice	-	コミット時に、アップロードしたローカルファイルを削除するかどうかを指定します。 ファイルを削除 [true] - 削除します。 何もしない [false] - 削除しません。
入力をそのまま出力	streamPassThrough	-	コンポーネントの入力ストリームをそのまま出力ストリームにするかどうかを指定します。 「はい」を選択すると、そのまま出力することを示すアイコンに切り替わります。 はい [true] - 入力ストリームがそのまま出力ストリームになります。 いいえ [false] - FTPサーバーへアップロードしたファイルの情報をレコード形式で出力します。

■ループ処理

なし。

■トランザクション処理

コミット	コミット時の処理が「ファイルを削除」の場合、アップロードしたローカルファイルを削除します。
ロールバック	何もしません。

■エラー処理

タイプ	パラメーター	エラー処理フロー へのストリーム	エラー コード	説明
ファイルが存在しない	なし	コンポーネントの入力ストリーム	1	アップロードファイルパスまたは保存先ファイルパスで指定したファイルが見つからなかった場合
			2	保存先ファイルパスで指定したフォルダーが見つからなかった場合
			5	コミット時の処理が「ファイルを削除」であり、アップロードファイルパスに空の値が指定された場合。 ※プロジェクトフォルダーやホームフォルダ配下が全て削除されてしまうため
汎用	なし	コンポーネントの入力ストリーム	3	アップロードファイルパスで指定したパスにワイルドカードが含まれていた場合に、アップロードするファイルの一覧が取得できなかった場合
			4	コミット時の処理が「ファイルを削除」の場合に、ファイルが削除できなかった場合
			10	コネクション名 に指定したコネクションが見つからない場合
			11	FTPサーバーに接続できない場合
			12	FTPサーバーがエラーを返した場合

■フローの強制終了

フローを強制終了すると、通常は実行中のコンポーネントの処理が終了してから次のコンポーネントに制御が遷移する時点でフローがアボートしますが、本コンポーネントでは実行中の処理を強制的に終了してフローがアボートします。強制終了された場合、トランザクションをロールバックします。

■制限事項

LISTコマンドの結果が、Windows, Unixスタイルのファイルリストのみ対応しています。それ以外の場合にはエラーとなることがあります。

■アップロード元、アップロード先の状況と動作の詳細

アップロードファイルパスでワイルドカードが使用されていない場合の動作は、実行時の状況により異なります。
アップロードファイルパス、保存先ファイルパスで指定したパスに対して、以下の3つのパターンが想定されます。

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

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

アップロードファイルパス	保存先ファイルパス	動作
ファイル	ファイル	保存先ファイルパスで指定されたファイルを上書きしてアップロードします。
ファイル	フォルダー	保存先ファイルパスで指定されたフォルダーの中にアップロードファイルパスで指定されたファイルをアップロードします。 保存先ファイルパスで指定されたフォルダーの中にアップロードファイルパスで指定されたファイルと同名のファイルが既に存在する場合は、上書きされます。 保存先ファイルパスで指定されたフォルダーの中にアップロードファイルパスで指定されたファイルと同名のフォルダーが既に存在する場合は、"エラーコード=12"のエラーが発生します｡
ファイル	存在しない	保存先ファイルパスで指定されたパスをファイル名として解釈し、アップロードファイルパスで指定されたファイルのファイル名を保存先ファイルパスで指定されたファイルのファイル名に変更してアップロードします。 保存先ファイルパスで指定されたパスに含まれる上位フォルダーが存在しない場合は、そのフォルダーを作成します。
フォルダー	ファイル	"エラーコード=12"のエラーが発生します。
フォルダー	フォルダー	保存先ファイルパスで指定されたフォルダーの中に、アップロードファイルパスで指定されたフォルダーをアップロードします。
フォルダー	存在しない	保存先ファイルパスで指定されたパスをフォルダー名として解釈し、フォルダーを作成します。この時、上位フォルダーが存在しない場合は、上位フォルダーも作成します。そして、作成したフォルダーの中に保存先ファイルパスで指定されたフォルダーをアップロードします。
存在しない	ファイル	"エラーコード=1"または"エラーコード=2"のファイルが存在しないが発生します。
	フォルダー
	存在しない

アップロードファイルパスでワイルドカードが使用された場合は、アップロード対象のファイル、フォルダーが複数であるかどうかにかかわらず、保存先ファイルパスの指定はフォルダー名として解釈され、以下のように動作します。

• 保存先ファイルパスで指定されたフォルダーが存在しない場合、指定されたフォルダー名でフォルダーを作成します。この時、上位フォルダーが存在しない場合は、上位フォルダーも作成します。
• 保存先ファイルパスで指定されたフォルダーの中に、アップロードファイルパスで指定されたファイル、フォルダーをファイル名、フォルダー名を変えずにアップロードします。
• 保存先ファイルパスで指定されたパスのファイルが存在する場合、"エラーコード=12"のエラーが発生します｡