通信アダプタ用 Java CAPS プロジェクトコンポーネントの構成

転送前 (BatchSFTP の接続マップ)

「転送前」プロパティーでは、保護/バックアップ/復旧の動作をカスタマイズできます。ここでは、実際のファイル転送の前にリモートまたはローカルで実行される処理について説明します。

BatchSFTP の接続マッププロパティーの「転送前」セクションには、次の表に示す最上位パラメータが含まれています。

表 1–35 接続マップ - BatchSFTP - 転送前

名前 

説明 

必要な値 

リモートディレクトリ名

ファイルのリネームまたはコピーの実行場所となる、リモート外部システム上のディレクトリの名前 (パス) を指定します。これは、「リモート転送前コマンド」が「リネーム」または「コピー」の場合にのみ使用されます。値としては、リテラル、正規表現 (ソースの場合)、またはパターン名 (宛先の場合) を指定できます。

アウトバウンド (宛先) の場合、ディレクトリがまだ存在していなければ、ディレクトリが作成されます。 

特殊文字を使用できます。このパラメータが使用されるたびに、 

あらゆる特殊文字の展開 

が実行されます。たとえば、パターン %f は元の作業ディレクトリ名を意味します。

リモートディレクトリ名がパターン」プロパティーを参照してください。

ディレクトリ名。 

リモートディレクトリ名がパターン

次のように、リモートディレクトリ名がリテラルを表すのか、あるいは正規表現または名前パターンを表すのかを指定します。

  • はい: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

  • いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。パターンマッチングや名前の展開は実行されません。

    リモートディレクトリ名」プロパティーを参照してください。

はい」または「いいえ」を選択します。

デフォルト設定は「はい」です。

リモートファイル名

ファイルのリネーム先またはコピー先となる、外部システム上のファイルの名前を指定します。この設定は、「転送前コマンド」パラメータが「リネーム」または「コピー」処理の場合にのみ使用されます。値としては、リテラル、正規表現 (受信時)、またはパターン名 (送信時) を指定できます。

特殊文字を使用できます。たとえば、パターン %f は元の作業ファイル名を示します。このパラメータが使用されるたびに、あらゆる特殊文字の展開が実行されます。

リモートファイル名がパターン」プロパティーを参照してください。

ファイル名。 

リモートファイル名がパターン

次のように、リモートファイル名がリテラルを表すのか、あるいは正規表現または名前パターンを表すのかを指定します。

  • はい: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

  • いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。パターンマッチングや名前の展開は実行されません。

    リモートファイル名」プロパティーを参照してください。

はい」または「いいえ」を選択します。

デフォルト設定は「はい」です。

リモート転送前コマンド

実際のファイル転送の直前に必要なアクションを実行できるようにします。インバウンド転送の場合、同じディレクトリおよびファイルのパターンまたは名前を使ってターゲットシステムに対するポーリングを行うほかのクライアントがそのファイルを使用するのを禁止できます。アウトバウンド転送の場合、既存のファイルを自動的にバックアップ/クリーンアップできます。オプションは次のとおりです。

  • リネーム: 保護または復旧のためにターゲットファイルの名前を変更します。

  • コピー: バックアップまたは復旧のためにターゲットファイルをコピーします。

  • なし: 何も行いません。

    適切な保護、バックアップ、または復旧を実現するには、目的に合った適切な設定を選択する必要があります。たとえば、アウトバウンド追加転送時の障害から復旧するには、「コピー」設定を使用します。


    注 –

    リネーム」使用時にリネーム後のファイルが存在している場合の動作は、FTP サーバーごとに異なる可能性があります。たとえば、一部の UNIX FTP サーバーでは、ユーザーへの確認なしに宛先のファイルが上書きされます。つまり、エラーまたは警告メッセージが表示されません。ほかの FTP サーバー、たとえば Windows XP サーバーでは、システムによってエラーが生成され、その結果、呼び出された OTD メソッド内で例外がスローされます。対応する FTP サーバーに固有の動作を必ず熟知しておいてください。自信がない場合は、コマンド行からアクションを実行してみてください。アクション実行時にエラーメッセージが表示される場合、そのアクションによっておそらく、コラボレーション内で例外がスローされます。


リネーム」、「コピー」、または「なし」を選択します。

デフォルト設定は「なし」です。


注 –

コピー」オプションを使用すると、コピーするファイルのサイズが大きい場合は特に、システムのパフォーマンスが低下する可能性があります。


ローカルディレクトリ名

リネーム」または「コピー」で使用されるローカルディレクトリ名 (パス) を指定します。値としては、リテラル、正規表現 (ソースの場合)、またはパターン名 (宛先の場合) を指定できます。

特殊文字を使用できます。このパラメータが使用されるたびに、あらゆる特殊文字の展開が実行されます。 

ローカルディレクトリ名がパターン」プロパティーを参照してください。


注 –

パス区切り文字を入力する際には、バックスラッシュ「\」の代わりにスラッシュ「/」を使用してください。アダプタは、バックスラッシュを特殊文字として解釈します。たとえば、c:/temp/dir を使用します。


ディレクトリ名。 

ローカルディレクトリ名がパターン

次のように、ローカルディレクトリ名がリテラルを表すのか、あるいは正規表現または名前パターンを表すのかを指定します。

  • はい: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

  • いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。

    ローカルディレクトリ名」プロパティーを参照してください。

はい」または「いいえ」を選択します。

デフォルト設定は「いいえ」です。

ローカルファイル名

リネーム」または「コピー」で使用されるローカルファイル名を指定します。値としては、リテラル、正規表現 (受信時)、またはパターン名 (送信時) を指定できます。

特殊文字を使用できます。このパラメータが使用されるたびに、あらゆる特殊文字の展開が実行されます。 

ローカルファイル名がパターン」プロパティーを参照してください。

ファイル名。 

ローカルファイル名がパターン

次のように、ローカルファイル名が

リテラルを表すか、あるいは正規表現または名前パターンを表すかを指定します。 

  • はい: ユーザーが入力する名前の値が名前パターンまたは正規表現とみなされることを示します。

  • いいえ: 入力される名前の値がリテラル、つまり正確に一致すべき対象であることを示します。パターンマッチングや名前の展開は実行されません。

    ローカルファイル名」プロパティーを参照してください。

はい」または「いいえ」を選択します。

デフォルト設定は「いいえ」です。

ローカル転送前コマンド

実際のファイル転送の直前に必要なアクションを実行できるようにします。インバウンド転送の場合、同じディレクトリおよびファイルのパターンまたは名前を使ってターゲットシステムに対するポーリングを行うほかのクライアントがそのファイルを使用するのを禁止できます。アウトバウンド転送の場合、既存のファイルを自動的にバックアップできます。オプションは次のとおりです。

  • リネーム: 保護または復旧のためにターゲットファイルの名前を変更します。

  • コピー: バックアップまたは復旧のためにターゲットファイルをコピーします。

  • なし: 何も行いません。

    適切な保護、バックアップ、または復旧を実現するには、目的に合った適切な設定を選択する必要があります。たとえば、アウトバウンド追加転送時の障害から復旧するには、「コピー」設定を使用します。


    注 –

    「ローカルディレクトリ名」および「ローカルファイル名」プロパティーで指定されるファイルが存在している場合、「リネーム」および「コピー」はそのファイルを上書きします。


    名前パターンの使用」を参照してください。

リネーム」、「コピー」、または「なし」を選択します。

デフォルト設定は「なし」です。


注 –

コピー」オプションを使用すると、コピーするファイルのサイズが大きい場合は特に、システムのパフォーマンスが低下する可能性があります。