「FTP ファイルの削除 (FTP Delete File)」アクティビティーを使用して、実行時に特定のディレクトリーから特定のファイルを削除します。
一般に、「
FTP ファイルの削除 (FTP Delete File)」アクティビティーは、以下のオーケストレーションの例で示されている、「
FTP ファイルのリスト (FTP List Files)」アクティビティーとともに使用されます。
- 「ジョブのスケジュール」アクティビティーは、毎時にオーケストレーション・ジョブを作成します。
- 「FTP ファイルのリスト (FTP List Files)」アクティビティーは、FTP サーバーのルート・ディレクトリーにある ¥temp ディレクトリーにあるファイルのリストを生成し、結果をストリングで保管します。
- 「フラット・ファイルの読み取り」アクティビティーは、ファイルのリストを解析し、結果を反復 XML 構造に保管します。
- 「For Each」アクティビティーは、ファイルのリストを含む反復構造を繰り返します。
- ファイルの末尾が .tmp 拡張子の場合、「FTP ファイルの削除 (FTP Delete File)」アクティビティーは指定されたファイルを削除します。
「
FTP ファイルの削除 (FTP Delete File)」アクティビティーを使用する実例プロジェクトについては、『
ディレクトリー・リストの解析の例』を参照してください。
シンボリック・リンク
「
FTP ファイルの削除 (FTP Delete File)」アクティビティーは、以下の条件が当てはまる場合は、ディレクトリーへのシンボリック・リンクをサポートします。
- ディレクトリーへのシンボリック・リンクが、FTP サーバーをホストするオペレーティング・システムによりサポートされる。
- ディレクトリーへのシンボリック・リンクが FTP サーバーそのものによりサポートされる。
特定のオペレーティング・システムでの特定の FTP サーバーの特定のシンボリック・リンクのサポートを判断するには、オペレーティング・システムおよび FTP サーバーの資料を参照してください。
「FTP ファイルの削除 (FTP Delete File)」アクティビティーのオーケストレーションへの追加
- オーケストレーションを作成するか、または開きます。 オーケストレーションのグラフィカル表現が表示されます。
- 「アクティビティー」タブを選択し、FTP フォルダーを展開します。
- 「ファイルの削除」アクティビティーをオーケストレーション上にドラッグします。
- アクティビティーを選択します。 チェックリストが表示されます。
FTP エンドポイントの作成、選択、または編集
- 「チェックリスト」から「エンドポイントの選出」タスクをクリックし、次のいずれかのアクションを選択します。
- 既存のエンドポイントを選択します。
- 「参照」を選択します。 「プロジェクト・エクスプローラー」が表示されます。
重要: 元の FTP エンドポイントと異なるディレクトリー構造で新規 FTP エンドポイントを指定すると、
実行時にオーケストレーション・ジョブが失敗することがあります。 元の指定された FTP サーバーのディレクトリー構成に一致する新規 FTP サーバーを指定するか、「アクティビティーの構成」手順に記載されているように「参照」をクリックして「ディレクトリー」フィールドの構成ディレクトリーを変更することが必要です。
- 既存のエンドポイントを選択し、「OK」をクリックします。
『アクティビティーの構成』手順に進んでください。
- 既存のエンドポイントを選択し、そのエンドポイントを編集します。
- 「参照」を選択します。 「プロジェクト・エクスプローラー」が表示されます。
- 既存のエンドポイントを選択し、「OK」をクリックします。
重要: 元の FTP エンドポイントと異なるディレクトリー構造で新規 FTP エンドポイントを指定すると、
実行時にオーケストレーション・ジョブが失敗することがあります。 元の指定された FTP サーバーのディレクトリー構成に一致する新規 FTP サーバーを指定するか、「アクティビティーの構成」手順に記載されているように「参照」をクリックして「ディレクトリー」フィールドの構成ディレクトリーを変更することが必要です。
- 「編集」をクリックします。 「エンドポイントの編集」ペインが表示されます。
- 新しいエンドポイントを作成します。「新規作成」を選択します。 「エンドポイントの作成」ペインが表示されます。
- FTP エンドポイントを作成するか、または編集します。FTP エンドポイントの作成または編集
アクティビティーの構成
- 「チェックリスト」から、「構成」タスクを選択します。 「構成」ペインが表示されます。
- 以下の表で説明されているように、このペインにあるフィールドを構成します。
表 1. フィールド |
説明 |
検索対象 |
|
ファイル名 |
このフィールドはこのアクティビティーには使用されません。 「入力のマップ」タスクの filename 入力パラメーターを使用して、削除するファイルの名前を指定します。 |
ディレクトリー |
統合アプライアンスが指定されたファイルを削除する、FTP サーバーのディレクトリーを指定します。
以下のいずれかのオプションを使用して、ディレクトリーを指定できます。- フィールドをクリックして以下のディレクトリー・パスの 1 つをタイプすることにより、ディレクトリー・パスを直接入力します。
- 相対ディレクトリー・パス。例: /process
(FTP ホームは、FTP サーバーに接続するユーザー・アカウントに構成されていると見なします。 詳しくは、『注』を参照してください。)
- 完全ディレクトリー・パス。例えば UNIX マシンの場合: /home/user/process
- 「参照...」をクリックして、使用可能なディレクトリーのドロップダウン・リストを取り込みます。 ドロップダウン・リストから適切なディレクトリーを選択します。
実行時に、「構成」タスクの「ディレクトリー」フィールドに指定された値は、以下のいずれかのオプションを使用してオプションの directory 入力パラメーターに値が指定された場合は、上書きされます。 - directory 入力パラメーターは変数にマップされます。
- directory 入力パラメーターにデフォルト値が指定されます。
詳しくは、『アクティビティーの入力のマッピング』の手順を参照してください。注: UNIX: UNIX マシン上で FTP サーバーに接続するときに相対ディレクトリー・パスを指定する場合は、FTP サーバーに接続するユーザー・アカウントについて、FTP ホーム・ディレクトリーが /etc/password ファイルに正しく指定されていることを確認してください。
|
再試行オプションの指定
- 「チェックリスト」から、「再試行」タスクを選択します。 「再試行」ペインが表示されます。
- FTP サーバーに接続するための再試行オプションを構成します。 以下の表で、FTP サーバーに接続するための再試行オプションについて説明します。
表 2. フィールド |
説明 |
再試行 |
|
1) 再試行ごとに __ 秒待機します。 |
統合アプライアンスが FTP サーバーへの接続の確立を試行するまでに待機する秒数。 |
2) 失敗するまで __ 回の接続を試みます。 |
統合アプライアンスが FTP サーバーへの接続の確立を試行する最大回数を指定します。この回数を超えると、統合アプライアンスはエラーを発行して現行オーケストレーション・ジョブの処理を停止します。 「FTP ファイルの削除 (FTP Delete File)」アクティビティーが含まれているオーケストレーションがデプロイされる場合に、統合アプライアンスは指定の FTP サーバーに接続できないと、再試行回数値に達するまでシステム・ログおよびオーケストレーション・ログに接続エラーを警告として記録します。 再試行回数に達した場合、統合アプライアンスがシステムおよびオーケストレーションのログにエラーを記録し、
現在のオーケストレーション・ジョブの処理を停止します。
例えば、再試行回数を 3 に設定すると、
1 回目、2 回目、3 回目の接続エラーはシステム・ログに警告として表示されます。 統合アプライアンスは、第 4 の接続エラーをエラーとしてログに記録し、現行オーケストレーション・ジョブの処理を停止します。
|
アクティビティーの入力のマッピング
- 「チェックリスト」から、「入力のマップ」タスクを選択します。 「再試行」ペインが表示されます。 このアクティビティーの入力パラメーターが、
「アクティビティーへ」ペインに表示されます。
- filename 入力パラメーターに変数をマップする必要があります。 他の入力パラメーターはすべてオプションです。 filename パラメーターは、FTP サーバーから削除するファイルの名前を指定します。
次の表にリストされている入力パラメーターが「入力のマップ」ペインの「アクティビティーへ」ペインに表示されない場合は、ツールバー・メニューからを選択するか、または「アクティビティーへ」ペインで右クリックして「オプション・パラメーターの表示」オプションを選択します。
ツールバー・メニューでオプションを
選択できない場合は、「入力のマップ」ペイン内のノードをクリックして、このオプションをアクティブにします。
オプションで、次の表に定義されている入力パラメーターを使用して、
チェックリストの「構成」および「エンドポイントの選出」タスクで
指定した設定を実行時に動的に指定変更できます。
例えば、統合アプライアンスがファイルを削除する FTP サーバー上のディレクトリーは、「構成」タスクで process と呼ばれるディレクトリーに設定できます。 実行時に、directory 入力パラメーターを使用して、ディレクトリー名 processXML をアクティビティーに渡すことができます。 実行時に動的に指定されるディレクトリー名が、「構成」ペインで指定された元の設定を指定変更します。 この例では、ファイルは processXML ディレクトリーから削除されます。
表 3. 入力パラメーターの名前/ノード |
説明 |
タスクで設定を指定変更するかどうか |
directory |
統合アプライアンスがこのアクティビティーで生成されたファイルを置く、FTP サーバーのディレクトリーを指定します。 |
directory 入力パラメーターは、「構成」タスクの「ディレクトリー」フィールドを指定変更します。 |
接続/タイムアウト |
統合アプライアンスがエンドポイントへの接続の確立を試行してから、エンドポイントが接続要求に応答せずにタイムアウトになるまでの秒数を指定します。 「FTP ファイルの削除 (FTP Delete File)」アクティビティーの場合、統合アプライアンスがタイムアウトになる前に FTP サーバーへの接続の確立を試行していた時間です。 |
接続入力パラメーターのタイムアウト・ノードは、FTP エンドポイントの「接続タイムアウト - エンドポイントへの接続を確立しているとき、___ 秒後にタイムアウトになります」フィールドを指定変更します。 |
接続/ホスト |
FTP サーバーのホスト名または IP アドレスを指定します。 |
接続入力パラメーターのホスト・ノードは、FTP エンドポイントの「ホスト名」フィールドを指定変更します。 |
接続/ポート |
指定されたホスト名のポート番号を指定します。 FTP トラフィックの標準ポートは 21 です。 SFTP トラフィックのデフォルト・ポートは 22 です。 |
接続入力パラメーターのポート・ノードは、FTP エンドポイントの「ポート」フィールドを指定変更します。 |
接続/ユーザー名 |
FTP サーバーに接続するために使用するアカウントのユーザー名を指定します。 |
接続入力パラメーターのユーザー名ノードは、FTP エンドポイントの「ユーザー名」フィールドを指定変更します。 |
接続/パスワード |
FTP サーバーに接続するために使用するアカウントのパスワードを指定します。 |
接続入力パラメーターのパスワード・ノードは、FTP エンドポイントの「パスワード」フィールドを指定変更します。 |