「FTP ファイルの書き込み (FTP Put File)」アクティビティー
実行時に、「FTP ファイルの書き込み (FTP Put File)」アクティビティーはオーケストレーションの変数からデータを受け取り、そのデータをファイルに入れ、FTP サーバーに接続して、そのファイルを指定したディレクトリー・ロケーションに置きます。
「FTP ファイルの書き込み (FTP Put File)」アクティビティーの使用例については、 「Getting Started Guide」を参照してください。
転送の中断
「FTP ファイルの書き込み (FTP Put File)」アクティビティーで実行時に行うファイル転送は非トランザクションであり、したがって保証がありません。 例えば、「FTP ファイルの書き込み (FTP Put File)」アクティビティーが統合アプライアンスから FTP サーバーにファイルを転送し、そのファイル転送が統合アプライアンスのリブートのために中断された場合には、ファイル全体の転送が保証されません。シンボリック・リンク
「FTP ファイルの書き込み (FTP Put File)」アクティビティーは、 ディレクトリーへのシンボリック・リンクをサポートしています (FTP サーバーをホストするオペレーティング・システムがディレクトリーへのシンボリック・リンクをサポートし、FTP サーバー自体がディレクトリーへのシンボリック・リンクをサポートしている場合)。 特定のオペレーティング・システムでの特定の FTP サーバーの特定のシンボリック・リンクのサポートを判断するには、オペレーティング・システムおよび FTP サーバーの資料を参照してください。「FTP ファイルの書き込み (FTP Put File)」アクティビティーのオーケストレーションへの追加
- オーケストレーションを作成するか、または開きます。 オーケストレーションのグラフィカル表現が表示されます。
- 「アクティビティー」タブを選択し、FTP フォルダーを展開します。
- 「ファイルの書き込み」アクティビティーをオーケストレーション上にドラッグします。
- アクティビティーを選択します。 チェックリストが表示されます。
FTP エンドポイントの作成、選択、または編集
- 「チェックリスト」から「エンドポイントの選出」タスクをクリックし、次のいずれかのアクションを選択します。
- 既存のエンドポイントを選択します。
- 「参照」を選択します。 「プロジェクト・エクスプローラー」が表示されます。重要: 元の FTP エンドポイントと異なるディレクトリー構造で新規 FTP エンドポイントを指定すると、 実行時にオーケストレーション・ジョブが失敗することがあります。 最初に指定された FTP サーバーのディレクトリー構成に一致する新規 FTP サーバーを指定するか、『アクティビティーの構成』手順に記載されているように「参照」をクリックして「ディレクトリー」フィールドの構成ディレクトリーを変更する必要があります。
- 既存のエンドポイントを選択し、「OK」をクリックします。 『アクティビティーの構成』手順までスキップします。
- 「参照」を選択します。 「プロジェクト・エクスプローラー」が表示されます。
- 既存のエンドポイントを選択し、そのエンドポイントを編集します。
- 「参照」を選択します。 「プロジェクト・エクスプローラー」が表示されます。
- 既存のエンドポイントを選択し、「OK」をクリックします。
重要: 元の FTP エンドポイントと異なるディレクトリー構造で新規 FTP エンドポイントを指定すると、 実行時にオーケストレーション・ジョブが失敗することがあります。 元の指定された FTP サーバーのディレクトリー構成に一致する新規 FTP サーバーを指定するか、「アクティビティーの構成」手順に記載されているように「参照」をクリックして「ディレクトリー」フィールドの構成ディレクトリーを変更することが必要です。
- 「編集」をクリックします。 「エンドポイントの編集」ペインが表示されます。
- 新しいエンドポイントを作成します。「新規作成」を選択します。 「エンドポイントの作成」ペインが表示されます。
- 既存のエンドポイントを選択します。
- FTP エンドポイントを作成するか、または編集します。FTP エンドポイントの作成または編集
配信ルールの指定
- 「チェックリスト」から、「配信ルール」タスクを選択します。 「配信ルール」ペインが表示されます。 FTP エンドポイントでセキュリティーが有効になっていない場合は、 「テキストとして転送 (ASCII)」オプションと「バイナリーとして転送 (BINARY)」オプションが使用可能になっています。 FTP エンドポイントでセキュリティーが有効になっている場合は、 ファイル転送のタイプは常にバイナリーです。
- 統合アプライアンスと FTP サーバー間のファイル転送のタイプを、次のオプションから 1 つ選択します。
- テキストとして転送 (ASCII) - このオプションは、HTML、XML、その他のテキスト・ファイルなどのファイルの転送に使用します。 行の末尾は必要に応じて変換され、その他のテキスト・ファイル規則が適用されます。注意:バイナリー・ファイルでこのオプションを使用すると、データが失われることがあります。
- バイナリーとして転送 (BINARY) - このオプションは、バイナリー・ファイルの転送に使用します。 このオプションを使用すると、統合アプライアンスはデータを変換しないで転送します。
注: Cast Iron FTP コネクターの SFTP エンドポイントは、クライアント・サイド SFTP プロトコル・バージョン 3 のみをサポートします。 したがって、SFTP プロトコルは、ASCII/テキスト・モードでのファイル転送をサポートしていません。 で、「ファイル転送タイプ」を必ず「バイナリーとして転送 (BINARY)」に設定してください。 - テキストとして転送 (ASCII) - このオプションは、HTML、XML、その他のテキスト・ファイルなどのファイルの転送に使用します。 行の末尾は必要に応じて変換され、その他のテキスト・ファイル規則が適用されます。
アクティビティーの構成
- 「チェックリスト」から、「構成」タスクを選択します。 「構成」ペインが表示されます。
- 以下の表で説明されているように、このペインにあるフィールドを構成します。
表 1. フィールド 説明 保存 ファイル名 このフィールドはこのアクティビティーには使用されません。 出力ファイルの名前は、「入力のマップ」タスクの filename 入力パラメーターで指定します。 ディレクトリー 統合アプライアンスがこのアクティビティーで生成されたファイルを置く、FTP サーバーのディレクトリーを指定します。 以下のいずれかのオプションを使用して、ディレクトリーを指定できます。 - フィールドをクリックして以下のディレクトリー・パスの 1 つをタイプすることにより、ディレクトリー・パスを直接入力します。
- 相対ディレクトリー・パス。例: /output (FTP ホームは、FTP サーバーに接続するユーザー・アカウントに構成されていると見なします。 詳しくは、『注』を参照してください。)
- 完全ディレクトリー・パス。例えば UNIX マシンの場合: /home/user/output
- 「参照...」をクリックして、使用可能なディレクトリーのドロップダウン・リストを取り込みます。 ドロップダウン・リストから適切なディレクトリーを選択します。
注: UNIX: UNIX マシン上で FTP サーバーに接続するときに相対ディレクトリー・パスを指定する場合は、FTP サーバーに接続するユーザー・アカウントについて、FTP ホーム・ディレクトリーが /etc/password ファイルに正しく指定されていることを確認してください。タイプ ファイル内容の読み取り方法 (バイナリー・データまたはエンコード済みテキスト) を指定します。 「テキスト」オプションを選択した場合は、以下のオプションのいずれかを選択してエンコード・タイプを設定します。 - 「エンコード方式」ドロップダウン・リストから、デフォルト・エンコード・タイプを 1 つ選択します。
- 「エンコード方式」フィールドをクリックしてエンコード・タイプを入力することにより、エンコード・タイプを直接入力します。
注: 一部の 2 バイト文字は、SHIFT-JIS エンコードで変換されません。 詳しくは、『シフト JIS エンコードの使用』を参照してください。重要: FTP エンドポイントとの間でデータを ASCII モードで転送中に、テキスト・データを操作するエンドポイントの FTP サーバーでテキスト・ファイルを取得および配置する場合は、FTP アクティビティーに「テキストとして転送 (ASCII)」オプションを指定する必要があります。 例えば、メインフレームと DOS の FTP エンドポイントでは、データを ASCII モードで渡す際に ASCII データを操作します。例えば、ご使用のオーケストレーションが「FTP ディレクトリーのポーリング (FTP Poll Directory)」アクティビティーを使用して ASCII ファイルを取得し、「FTP ファイルの書き込み (FTP Put File)」アクティビティーを使用して ASCII ファイルをメインフレーム FTP サーバーに置く場合は、Studio の以下のタスクでオプションを指定する必要があります。- 「FTP ポーリング・ディレクトリー」アクティビティーの「構成」タスクでは、 「タイプ」フィールドで「テキスト」オプションを選択します。
- 「FTP ポーリング・ディレクトリー」アクティビティーの「配信ルール」タスクでは、 「ファイル転送タイプ」フィールドで「テキストとして転送 (ASCII)」オプションを選択します。
- 「FTP ファイルの書き込み (FTP Put File)」アクティビティーの「構成」タスクでは、 「タイプ」フィールドで「テキスト」オプションを選択します。
- 「FTP ファイルの書き込み (FTP Put File)」アクティビティーの「配信ルール」タスクでは、 「ファイル転送タイプ」フィールドで「テキストとして転送 (ASCII)」オプションを選択します。
オプション - 指定した出力ディレクトリーに同じ名前のファイルが既に存在する場合の動作を定義するには、以下のオプションのいずれかを選択します。 重複する名前が見つかった場合は既存のファイルを上書きします ファイルが既に存在する場合にこのオプションを指定すると、元のファイルの内容が破棄され、アクティビティーから返される新しいデータで置き換えられます。 既存のファイルに追加します ファイルが既に存在する場合にこのオプションを指定すると、ファイルの元データを保持したまま、新しいデータ (アクティビティーから返されるデータ) をファイルの末尾に追加します。 重複する名前を持つファイルが見つかった場合はエラーにします ファイルが既に存在する場合にこのオプションを指定すると、ファイルの元データを保持してエラーをスローし、アクティビティーから返される新しいデータに対しては何も実行しません。 注: このオプションを選択すると、「FTP ファイルの書き込み (FTP Put File)」アクティビティーは、ファイルをアップロードする前にサーバー上にファイルが存在するかどうかを検査します。 ユーザーは、特定の FTP サーバーに対して、アップロードする前にファイルが存在するかどうかを検査する許可を持っていないことがあります。 これをブラインド FTP と呼ぶこともあります。 このような場合は、「重複する名前を持つファイルが見つかった場合はエラーにします」オプションを選択していても、ファイルが上書きされます。 - フィールドをクリックして以下のディレクトリー・パスの 1 つをタイプすることにより、ディレクトリー・パスを直接入力します。
再試行オプションの指定
- 「チェックリスト」から、「再試行」タスクを選択します。 「再試行」ペインが表示されます。
- FTP サーバーに接続するための再試行オプションを構成します。 以下の表で、FTP サーバーに接続するための再試行オプションについて説明します。
表 2. フィールド 説明 再試行 1) 再試行ごとに __ 秒待機します。 統合アプライアンスが FTP サーバーへの接続の確立を試行するまでに待機する秒数。 2) 失敗するまで __ 回の接続を試みます。 再試行回数を指定します。 つまり、統合アプライアンスが FTP サーバーへの接続の確立を試行する最大回数を指定します。 この回数を超えると、統合アプライアンスはエラーを発行して現行オーケストレーション・ジョブの処理を停止します。 「FTP ファイルの書き込み (FTP Put File)」アクティビティーが含まれているオーケストレーションがデプロイされる場合に、統合アプライアンスは指定の FTP サーバーに接続できないと、再試行回数値に達するまで、システム・ログおよびオーケストレーション・ログに接続エラーを警告として記録します。 再試行回数に達した場合、統合アプライアンスがシステムおよびオーケストレーションのログにエラーを記録し、 現在のオーケストレーション・ジョブの処理を停止します。
例えば、再試行回数を 3 に設定したとします。そうすると、第 1、第 2、第 3 の接続エラーはシステム・ログに警告として表示されます。統合アプライアンスは、第 4 の接続エラーを「エラー」としてログに記録し、現行オーケストレーション・ジョブの処理を停止します。
アクティビティーの入力のマッピング
- 「チェックリスト」から、「入力のマップ」タスクを選択します。 「再試行」ペインが表示されます。 このアクティビティーの入力パラメーターが、 「アクティビティーへ」ペインに表示されます。
- アクティビティーの入力パラメーターをすべてマップする必要はありません。
必須なのは以下のパラメーターです。
- filename
- データ
次の表にリストされている入力パラメーターが「入力のマップ」ペインの「アクティビティーへ」ペインに表示されない場合は、ツールバー・メニューからオプション・パラメーターの表示」オプションを選択します。 ツールバー・メニューで オプションを 選択できない場合は、「入力のマップ」ペイン内のノードをクリックして、このオプションをアクティブにします。
を選択するか、または「アクティビティーへ」ペインで右クリックして「オプションで、次の表に定義されている入力パラメーターを使用して、 チェックリストの「構成」および「エンドポイントの選出」タスクで 指定した設定を実行時に動的に指定変更できます。
例えば、 統合アプライアンスがこのアクティビティーで生成されたファイルを置く FTP サーバー上のディレクトリーは、「構成」タスクで output というディレクトリーに設定できます。 実行時に、directory 入力パラメーターを使用してディレクトリー名 outputXML をアクティビティーに渡すことができます。 実行時に動的に指定されるディレクトリー名が、「構成」ペインで指定された元の設定を指定変更します。 この例では、ファイルは outputXML ディレクトリーに入れられます。
入力パラメーターの名前/ノード | 説明 | タスクで設定を指定変更するかどうか |
---|---|---|
directory | 統合アプライアンスがこのアクティビティーで生成されたファイルを置く、FTP サーバーのディレクトリーを指定します。 | directory 入力パラメーターは、「構成」タスクの「ディレクトリー」フィールドを指定変更します。 |
encoding | 出力データをファイルに書き出す方法を指定します。
|
encoding 入力パラメーターは、 「構成」タスクの「タイプ」フィールドで指定したエンコードをオーバーライドしますが、 「構成」タスクの「タイプ」フィールドで「バイナリー」オプションが選択されていると、encoding 入力パラメーターで指定したエンコードは無視されます。 |
overwrite | 指定した出力ディレクトリーに同じ名前のファイルが既に存在する場合の動作を指定します。
次のいずれかの値を指定します。
|
overwrite 入力パラメーターは、「構成」タスクの「オプション」フィールドを指定変更します。 |
connection/timeout | 接続タイムアウトは、統合アプライアンスがエンドポイントへの接続の確立を試行してから、エンドポイントが接続要求に応答するまでに要する時間で、タイムアウトが発生するまでの秒数を指定します。 「FTP ファイルの書き込み (FTP Put File)」アクティビティーの場合、統合アプライアンスがタイムアウトになる前に FTP サーバーへの接続の確立を試行していた時間です。 | connection 入力パラメーターの timeout ノードは、FTP エンドポイントの「接続タイムアウト - エン ドポイントへの接続を確立しているとき、___ 秒後にタイムアウト」フィールドを指定変更します。 |
connection/host | FTP サーバーのホスト名または IP アドレスを指定します。 | connection 入力パラメーターの host ノードは、FTP エンドポイントの「ホスト名 」フ ィールドを指定変更します。 |
connection/port | 指定されたホスト名のポート番号を指定します。 FTP トラフィックの標準ポートは 21 です。 SFTP トラフィックのデフォルト・ポートは 22 です。 | connection 入力パラメーターの port ノードは、FTP エンドポイントの「ポート」フ ィールドを指定変更します。 |
connection/username | FTP サーバーに接続するために使用するアカウントのユーザー名を指定します。 | connection 入力パラメーターの username ノードは、FTP エンドポイントの「ユーザー名 」フィールドを指定変更します。 |
connection/password | FTP サーバーに接続するために使用するアカウントのパスワードを指定します。 | connection 入力パラメーターの password ノードは、FTP エンドポイントの「パスワード」フィールドを指定変更します。 |