FTP アダプターの構成

2025-06-05

開始する前に

FTP アダプターは、セキュリティで保護された FTP サーバーからのデータの読み取りと書き込みをサポートします。このアダプターは、SECURE Sockets Layer (SSL)/トランスポートレベルセキュリティ (TLS) 経由の FTP サーバーからのファイル転送をサポートします。
FTP アダプターは、読み取り専用ファイルの場所からのファイルのダウンロードをサポートしています。
FTP アダプターでは、ASCII モードのアトミックファイル転送もサポートされています。

FTP アダプターのベストプラクティスと推奨事項を参照してください。

受信場所を構成する

FTP 受信場所アダプターのプロパティは、BizTalk Server 管理コンソールで設定できます。受信場所にプロパティが設定されていない場合は、BizTalk Server 管理コンソールの既定の受信ハンドラー値が使用されます。

注

次の手順を完了する前に、受信ポートを既に追加しておく必要があります。受信ポートを作成する方法を参照してください。

BizTalk Server 管理コンソールで、 BizTalk Server 管理を展開し、 BizTalk グループを展開し、 アプリケーションを展開し、受信場所を作成するアプリケーションを展開します。

左側のウィンドウで、[ 受信ポート ] ノードをクリックします。右側のウィンドウで、既存の受信場所に関連付けられている受信ポート、または新しい受信場所に関連付ける受信ポートを右クリックし、[ プロパティ] をクリックします。
[ 受信ポートのプロパティ ] ダイアログボックスの左側のウィンドウで、[ 受信場所] を選択します。右側のウィンドウで、既存の受信場所をダブルクリックするか、[ 新規 ] をクリックして新しい受信場所を作成します。
[受信場所のプロパティ] ダイアログボックスの [種類] の横にある [トランスポート] セクションで、ドロップダウンリストから [FTP] を選択し、[構成] をクリックします。

FTP トランスポートのプロパティで、次の操作を行います。

バッチ

これを使用する	目的
最大ファイル数	BizTalk Server バッチあたりのファイルの最大数を指定します。ゼロ (0) は制限がないことを示します。既定値: 0
最大サイズ	BizTalk Server バッチあたりの最大バイト数を指定します。ゼロ (0) は制限がないことを示します。既定値: 0

ファイアウォール

これを使用する	目的
住所	ファイアウォールのアドレス (DNS 名または IP アドレス) を指定します。
モード	アダプターが FTP サーバーに接続するモードを指定します。有効な値: パッシブとアクティブアクティブモードでは、FTP サーバーは FTP アダプターによって開かれたポートに接続します。パッシブモードでは、FTP アダプターは FTP サーバーによって開かれたポートに接続します。内部 IP を使用し、外部 IP に接続すると、アクティブモードが機能しない可能性があります。この場合は、FTP をサポートするアプリケーション層ゲートウェイ (ALG) でパッシブモードまたはアクティブモードを使用する必要があります。既定値：能動
パスワード	ファイアウォールのパスワードを指定します。
ポート	ファイアウォールのポートを指定します。有効な値: 1 ~ 65535 (両端を含む) 既定値: 21
タイプ	デプロイするファイアウォールの種類を指定します。有効な値: なし、ソックス 4、およびソックス 5 既定値：何一つ
利用者	ファイアウォールのユーザー名を指定します。

FTP

これを使用する	目的
アカウント	FTP サーバーのアカウント名を指定します。このオプションは非推奨であり、このプロパティの使用はお勧めしません。
取得後	ファイル GET の後に実行する FTP コマンドを指定します。コマンドはセミコロン (;)で区切ります。
取得する前に	ファイル GET の前に実行する FTP コマンドを指定します。コマンドはセミコロン (;)で区切ります。手記： QUIT コマンドは、ファイル GET の前にはサポートされていません。
エラーしきい値	場所が無効になる前に BizTalk Server で発生する可能性があるエラーの数を指定します。既定値: 10
ファイルマスク	ファイルを送信するときに使用するファイルマスクフィルターを指定します。
フォルダー	FTP サーバー上のポーリング場所を指定します。
FTP サーバーの種類	BizTalk Server 2016 以降の新機能。 SYST コマンドを必要としない FTP サーバーを選択するには、このプロパティーを使用します。オプションは None、AIX、Detect、GXS、MVS、OS400、およびその他です。 None に設定すると、SYST コマンドが使用されます。その他は、OS の種類が指定されたカテゴリのいずれにも適合しない場合に使用されます。既定値：何一つ
ログ	出力するログファイルのファイル名を含む完全なパスを指定します。 FTP 経由でファイルを送受信するときのエラー状態を診断するには、このファイルを使用します。
最大ファイルサイズ	ダウンロード可能な最大ファイルサイズをメガバイト単位で指定します。ゼロ (0) は、ファイルサイズに制限がないことを示します。既定値: 100
パスワード	FTP サーバーにログオンするユーザーパスワードを指定します。
ポート	この FTP サーバーのポートアドレスを指定します。既定値: 21
代表	FTP がデータを受信する方法を選択します。有効な値: バイナリまたは ASCII 既定値: binary
サーバー	FTP サーバーのサーバー名または IP アドレスを指定します。手記：送信ポートまたは受信場所の URI は 256 文字を超えることはできません。
SSO アフィリエイト	Enterprise Single Sign-On 関連アプリケーションを指定します。
名前リスト (NLST) を使用する	アダプターがファイルを一覧表示する方法を指定します。システム定義ファイルの一覧ではなくファイル名を表示するには、この値を [はい] に設定します。既定値：いいえ
ユーザー名	FTP サーバーにログオンするユーザー名を指定します。

ポーリング

これを使用する	目的
ダウンロード後に削除する	ダウンロード後に、アダプターが FTP サーバーからファイルを削除するかどうかを指定します。既定値：はい注:
タイムスタンプ比較を有効にする	変更されたタイムスタンプに基づいて、アダプターがファイルをもう一度ダウンロードするかどうかを指定します。アダプターに FTP サーバーに対する削除権限がない場合、MDTM (変更時刻) コマンドを使用すると、前回のダウンロード以降にファイルが変更されたかどうかをアダプターが認識できます。このプロパティの値に基づいて、ファイルが再度ダウンロードされます。既定値：注: FTP サーバーが MDTM をサポートしていない場合は、Redownload Interval プロパティを設定します。手記：このプロパティは、[ ダウンロード後の削除] が [いいえ] に設定されている場合にのみ適用されます。
インターバル	この場所をポーリングする間隔番号を指定します。継続的にポーリングするには、この値を 0 (0) に設定します。既定値: 60
再ダウンロード間隔	アダプターがファイルを再度ダウンロードするまでの間隔を指定します。このプロパティは、ダウンロード後の削除とタイムスタンプ比較の有効化の両方が [いいえ] に設定されている場合にのみ適用されます。既定値: -1 -1 は、アダプターがファイルを再度ダウンロードしないことを示します。 0 は、アダプターが各ポーリングサイクルでファイルをダウンロードすることを示します。
単位	Interval プロパティと Redownload Interval プロパティの単位の種類を指定します。有効な値: 秒、分、時間、および日既定値：秒

SSL

これを使用する	目的
クライアント証明書ハッシュ	Secure Sockets Layer (SSL) ネゴシエーションで使用する必要があるクライアント証明書の SHA1 ハッシュを指定します。このハッシュに基づいて、クライアント証明書は、BizTalk ホストインスタンスが実行されているユーザーアカウントの個人用ストアから取得されます。
FTPS 接続モード	FTPS サーバーに対して行われる SSL 接続のモードを指定します。有効な値: 暗黙的または明示的既定値：明示적
データ保護の使用	FTPS サーバーからデータファイルを送受信するときに、アダプターが SSL 暗号化を使用する必要がある場合は、[はい] として指定します。データファイルをプレーンテキストとして送受信するアダプターの場合は、これを [いいえ] に指定します。手記：このプロパティは、[ SSL を使用 ] プロパティが [はい] に設定されている場合にのみ適用されます。有効な値: イエスかノーか答えてください既定値：はい
SSL を使用する	FTP アダプターが SSL を使用して FTPS サーバーと通信する必要があるかどうかを指定します。有効な値: イエスかノーか答えてください既定値：いいえ

チューニングパラメーター

これを使用する	目的
データの受信タイムアウト	受信呼び出しが中止されるまでの時間をミリ秒単位で指定します。このプロパティを使用すると、サーバーの速度が低下して受信場所の応答が停止するのを防ぐことができます。既定値: 90000
一時フォルダー	一時フォルダーの場所を指定します。この場所を使用して、転送エラーからの復旧を保証します。

[OK] をクリックして設定を保存します。
[ 受信場所のプロパティ ] ダイアログボックスで、適切な値を入力して受信場所の構成を完了し、[ OK] をクリックして設定を保存します。 [ 受信場所のプロパティ ] ダイアログボックスの詳細については、「受信場所を作成する方法」を参照してください。

注

同じ FTP URL をポーリングするように複数の FTP 受信場所を構成しないでください。複数の FTP 受信場所が同じ URL を同時にポーリングしている場合、各受信場所はファイルのコピーを受信できるため、データの重複が発生する可能性があります。この動作は、FTP プロトコルがターゲット URL からファイルを読み取るときに、ファイルをロックするためのプロビジョニングがないために発生します。

FTP 受信アダプターの高可用性を提供するには、クラスター化された BizTalk ホストインスタンスで実行するように FTP 受信アダプターを構成する必要があります。クラスター化ホスト内でのアダプターハンドラーの実行に関する考慮事項を参照してください。

送信ポートを構成する

FTP 送信ポートアダプターのプロパティは、BizTalk Server 管理コンソールで設定できます。送信ポートのプロパティが設定されていない場合は、BizTalk Server 管理コンソールの既定の送信ハンドラーの値が使用されます。

BizTalk Server 管理コンソールで、新しい送信ポートを作成するか、既存の送信ポートをダブルクリックして変更します。送信ポートを作成する方法を参照してください。すべての送信ポートオプションを構成し、[全般] ページの [トランスポート] セクションで[種類] オプションに FTP を指定します。
[全般] ページの [トランスポート] セクションで、[種類] の横にある [構成] ボタンをクリックします。

FTP トランスポートのプロパティで、次の操作を行います。

ファイアウォール

これを使用する	目的
住所	ファイアウォールのアドレス (DNS 名または IP アドレス) を指定します。
モード	アダプターが FTP サーバーに接続するモードを選択します。有効な値: パッシブとアクティブアクティブモードでは、FTP サーバーは FTP アダプターによって開かれたポートに接続します。パッシブモードでは、FTP アダプターは FTP サーバーによって開かれたポートに接続します。内部 IP を使用し、外部 IP に接続すると、アクティブモードが機能しない可能性があります。この場合は、FTP をサポートするアプリケーション層ゲートウェイ (ALG) でパッシブモードまたはアクティブモードを使用する必要があります。既定値：能動
パスワード	ファイアウォールのパスワードを指定します。
ポート	ファイアウォールのポートを指定します。有効な値: 1 ~ 65535 (両端を含む) 既定値: 21
タイプ	デプロイされるファイアウォールの種類を選択します。有効な値: ソックス 4、ソックス 5、なし既定値：何一つ
利用者	ファイアウォールのユーザー名を指定します。

FTP

これを使用する	目的
アカウント	任意。 FTP サーバーのアカウント名を指定します。このオプションとこのプロパティの使用は推奨されません。
プットの後	ファイル PUT の後に実行する FTP コマンドを指定します。コマンドはセミコロン (;)で区切ります。
記憶域の割り当て	レガシホストシステムに記憶域を割り当てるかどうかを指定します。このオプションは、下位互換性のために提供されます。有効な値: [いいえ] と [はい] 既定値：いいえ
配置前	ファイル PUT の前に実行する FTP コマンド (FTP サーバーの既定値を変更するコマンドなど) を指定します。コマンドはセミコロン (;)で区切ります。 open コマンドは必要ありません。手記： QUIT コマンドは、ファイル PUT の前にはサポートされていません。
フォルダー	FTP サーバー上のファイルを移動する場所を指定します。
FTP サーバーの種類	BizTalk Server 2016 以降の新機能。 SYST コマンドを必要としない FTP サーバーを選択するには、このプロパティーを使用します。オプションは None、AIX、Detect、GXS、MVS、OS400、およびその他です。 None に設定すると、SYST コマンドが使用されます。その他は、OS の種類が指定されたカテゴリのいずれにも適合しない場合に使用されます。既定値：何一つ
ログ	出力するログファイルのファイル名を含む完全なパスを指定します。 FTP アダプターを使用してファイルを送受信するときのエラー状態を診断するには、このファイルを使用します。
パスワード	FTP サーバーにログオンするパスワードを指定します。
ポート	FTP サーバーのポートアドレスを指定します。既定値: 21
代表	FTP アダプターがデータをバイナリまたは ASCII として送信する方法を選択します。有効な値: バイナリまたは ASCII 既定値: binary
サーバー	FTP サーバーのサーバー名または IP アドレスを指定します。
SSO アフィリエイト	Enterprise Single Sign-On 関連アプリケーションを指定します。
ターゲットファイル名	ファイルの代替名を指定します。既定の名前を保持すると、送信されるメッセージごとに一意のメッセージ名が保証されます。既定値: %MessageID%.xml
ユーザー名	FTP サーバーにログオンするユーザー名を指定します。

SSL

これを使用する	目的
クライアント証明書ハッシュ	Secure Sockets Layer (SSL) ネゴシエーションで使用する必要があるクライアント証明書の SHA1 ハッシュを指定します。このハッシュに基づいて、クライアント証明書は、BizTalk ホストインスタンスが実行されているユーザーアカウントの個人用ストアから取得されます。
FTPS 接続モード	FTPS サーバーに対して行われる SSL 接続のモードを指定します。有効な値: 暗黙的または明示的既定値：明示的
データ保護の使用	FTPS サーバーからデータファイルを送受信するときに、アダプターが SSL 暗号化を使用する必要がある場合は、[はい] として指定します。データファイルをプレーンテキストとして送受信するアダプターの場合は、これを [いいえ] に指定します。手記：このプロパティは、[ SSL を使用 ] プロパティが [はい] に設定されている場合にのみ適用されます。有効な値: イエスかノーか答えてください既定値：はい
SSL を使用する	FTP アダプターが SSL を使用して FTPS サーバーと通信する必要があるかどうかを指定します。有効な値: イエスかノーか答えてください既定値：いいえ

チューニングパラメーター

これを使用する	目的
接続の制限	サーバーに対して開くことができる同時 FTP 接続の最大数を指定します。値 0 は、制限がないことを意味します。既定値: 0 注: このプロパティは、以前のバージョンの BizTalk Server で接続制限を管理するために使用されたレジストリエントリを置き換えます。 BizTalk Server は、接続制限の制御に使用されるレジストリエントリを無視します。
一時フォルダー	FTP サーバー上の一時フォルダーの場所を指定します。ファイルは最初にここにアップロードされ、次に移動先の FTP フォルダーに移動されます。転送エラーが発生した場合、アダプターは転送の ASCII モードでファイルのアップロードを再開し、転送のバイナリモードで再開します。手記：ファイル転送が一時的な場所と FTP サーバー上の関連する場所の間でアトミックである場合、ファイルのアップロードもアトミックです。

これを使用する

目的

接続の制限

サーバーに対して開くことができる同時 FTP 接続の最大数を指定します。値 0 は、制限がないことを意味します。

既定値: 0 注: このプロパティは、以前のバージョンの BizTalk Server で接続制限を管理するために使用されたレジストリエントリを置き換えます。 BizTalk Server は、接続制限の制御に使用されるレジストリエントリを無視します。

一時フォルダー

FTP サーバー上の一時フォルダーの場所を指定します。ファイルは最初にここにアップロードされ、次に移動先の FTP フォルダーに移動されます。転送エラーが発生した場合、アダプターは転送の ASCII モードでファイルのアップロードを再開し、転送のバイナリモードで再開します。 手記： ファイル転送が一時的な場所と FTP サーバー上の関連する場所の間でアトミックである場合、ファイルのアップロードもアトミックです。

[ OK] を クリックし、もう一度 [OK] を クリックして設定を保存します。

FTP アダプターに必要な FTP コマンド

FTP アダプターは FTP プロトコルの制限の対象であり、特定の FTP コマンドがソースまたは宛先 FTP サーバーで使用できる必要があります。

FTP アダプターは FTP クライアントとして動作し、FTP サーバーで次のコマンドを正しく機能させる必要がある場合があります。

コマンド	Receive で必須	Send によって必須となっている
SYST	✔ BizTalk Server 2016 以降のオプション	✔ BizTalk Server 2016 以降のオプション
店舗		✔
RETR	✔
利用者	✔	✔
通る	✔	✔
CWD	✔	✔
辞める	✔	✔
ポート	✔	✔
PASV	✔	✔
ABOR	✔	✔
タイプ	✔	✔
RNFR	✔	✔
RNTO	✔	✔
DELEスペイン語検定 (Diploma de Español como Lengua Extranjera)	✔	✔
PWD	✔	✔
リスト	✔	✔
NLST	✔	✔
NOOP	✔	✔
APPE		✔
ALLO	✔	✔
MDTM	✔
AUTH TLS (認証して TLS を用いる)	✔	✔
PBSZ	✔	✔
PROT	✔	✔

これらの FTP コマンドの詳細については、以下を参照してください。

レガシホストを操作するための FTP アダプターの構成

このセクションでは、FTP アダプターとメインフレームコンピューター間の通信を容易にするために知っておくべきことを説明します。

注

MVS または AS400 ホストにファイルを送信するときに、一時フォルダー機能を使用することはできません。このフィールドへの入力はサポートされておらず、エラーが発生します。

Von Bedeutung

次の情報はガイドとして提供されており、AS400 または IBM のドキュメントに記載されている情報に置き換えてはいけません。

MVS

メインフレーム上の FTP サーバーにファイルを送信するには、メインフレームが IBM Generation Data Group (GDG) をサポートしている必要があります。名前フィールドでは、各ファイル名に (+1) が追加され、その結果、引用符で囲まれた完全なパスとしてコピー先のファイル名が形成されます。

AS400

AS400 システムとの間でファイルを転送する場合、ファイルに名前を付け、パスを定義するには、次の 3 つの方法があります。

[ファイル名] フィールド: FTP サーバーにファイルを送信する場合は、[ ファイル名 ] フィールドにファイル名を入力します。ファイルはライブラリファイルシステムに格納されるため、ファイル名は AS400 システムのファイル名前付け規則に準拠している必要があります。
Quote コマンド: Quote コマンドを使用して、リモートコンピューターでスクリプトを実行します。いずれかのエンドポイントの Before GET、 Before PUT、 After GET、After PUT フィールドに Quote コマンドを入力します。 Quote コマンドを次の形式で入力します。
```
QUOTE RCMD <command to be run on the remote system>.
```
統合ファイルシステム (IFS): IFS は、PC ベースのファイルの保存を可能にする AS400 システム上の領域であるため、PC と同じ名前付け規則です。既定のライブラリファイルシステムの代わりに IFS を使用するには、最初に入力するコマンドが quote site namefmt 1。このコマンドは、AS400 システムに IFS 名前付け規則を使用するように指示します。