次の方法で共有

FTP アダプタの構成

  • [アーティクル]

開始する前に

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

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

受信場所を構成する

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

Note

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

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

  1. 左側のウィンドウで、[ 受信ポート ] ノードをクリックします。 右側のウィンドウで、既存の受信場所に関連付けられている受信ポート、または新しい受信場所に関連付ける受信ポートを右クリックし、[ プロパティ] をクリックします。

  2. [ 受信ポートのプロパティ ] ダイアログ ボックスの左側のウィンドウで、[ 受信場所] を選択します。 右側のウィンドウで、既存の受信場所をダブルクリックするか、[ 新規 ] をクリックして新しい受信場所を作成します。

  3. [受信場所のプロパティ] ダイアログ ボックスの [種類] の横にある [トランスポート] セクションで、ドロップダウン リストから [FTP] を選択し、[構成] をクリックします。

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

    Batch

    プロパティ 目的
    最大ファイル数 BizTalk Server のバッチごとの最大ファイル数を指定します。

    ゼロ (0) は制限がないことを示します。

    既定値: 0
    最大サイズ BizTalk Server のバッチごとの最大バイト数を指定します。

    ゼロ (0) は制限がないことを示します。

    既定値: 0

    ファイアウォール

    プロパティ 目的
    アドレス ファイアウォールのアドレスとして、DNS 名または IP アドレスを指定します。
    モード アダプタから FTP サーバーへの接続モードを指定します。

    有効な値: パッシブとアクティブ

    アクティブ モードでは、FTP アダプターによって開かれたポートに FTP サーバーが接続します。 パッシブ モードでは、FTP サーバーによって開かれたポートに FTP アダプターが接続します。 内部 IP を使用し、外部 IP に接続すると、アクティブ モードが機能しない可能性があります。 この場合は、FTP をサポートするアプリケーション層ゲートウェイ (ALG) でパッシブ モードまたはアクティブ モードを使用する必要があります。

    既定値: アクティブ
    パスワード ファイアウォールのパスワードを指定します。
    ポート ファイアウォールのポートを指定します。

    有効な値: 1 ~ 65535

    既定値: 21
    Type 展開するファイアウォールの種類を指定します。

    有効な値: なし、ソックス 4、ソックス 5

    既定値: なし
    User ファイアウォールのユーザー名を指定します。

    FTP

    プロパティ 目的
    アカウント FTP サーバーのアカウント名を指定します。 このオプションは非推奨であり、このプロパティの使用はお勧めしません。
    GET コマンドの後 ファイル GET の後に実行する FTP コマンドを指定します。 コマンドの区切りにはセミコロン (;) を使用します。
    [GET コマンドの前] ファイル GET の前に実行する FTP コマンドを指定します。 コマンドの区切りにはセミコロン (;) を使用します。 メモ： QUIT コマンドは、ファイル GET の前にはサポートされていません。
    エラーのしきい値 場所を無効にする前BizTalk Server発生する可能性があるエラーの数を指定します。

    既定値: 10
    ファイル マスク ファイルの送信時に使用するファイル マスクのフィルタを指定します。
    フォルダー FTP サーバーのポーリング場所を指定します。
    FTP サーバーの種類 BizTalk Server 2016 以降の新機能。

    SYST コマンドを必要としない FTP サーバーを選択するには、このプロパティーを使用します。 オプションは None、AIX、Detect、GXS、MVS、OS400、およびその他です。

    None に設定すると、SYST コマンドが使用されます。 その他 は、OS の種類が指定したカテゴリのいずれにも適合しない場合に使用されます。

    既定値: なし
    Log 出力するログ ファイルのファイル名を含む完全パスを指定します。 このファイルを使用して、FTP 経由でファイルを送受信するときのエラー状態を診断します。
    最大ファイル サイズ ダウンロード可能なファイル サイズの最大値を、MB (メガバイト) 単位で指定します。

    ゼロ (0) はファイル サイズに制限がないことを示します。

    既定値: 100
    パスワード FTP サーバーにログオンするユーザー パスワードを指定します。
    ポート この FTP サーバーのポート アドレスを指定します。

    既定値: 21
    表現 FTP でのデータの受信形式を選択します。

    有効な値: バイナリまたは ASCII

    既定値: binary
    サーバー FTP サーバーの名前または IP アドレスを指定します。 メモ： 送信ポートまたは受信場所の URI は 256 文字を超えることはできません。
    [SSO 関連] エンタープライズ シングル サインオンの関連アプリケーションを指定します。
    名前リスト (NLST) の使用 アダプターがファイルの一覧を作成する方法を指定します。 システムによって定義されたファイルの一覧の代わりにファイル名を表示するには、この値を Yes に設定します。

    既定値: いいえ
    ユーザー名 FTP サーバーにログオンするユーザー名を指定します。

    ポーリング

    プロパティ 目的
    ダウンロード後に削除 ファイルのダウンロード後に、アダプターが FTP サーバーからファイルを削除するかどうかを指定します。

    既定値: はい 注:
    タイムスタンプ比較の有効化 修正後のタイムスタンプを基にアダプターがファイルをもう一度ダウンロードするかどうかを指定します。 アダプターが FTP サーバーでの削除アクセス許可を持っていない場合、MDTM (更新時刻) コマンドにより、アダプターは、最後のダウンロード以降にファイルが変更されたかどうかを判断できます。 このプロパティの値に基づいて、ファイルは再度ダウンロードされます。

    既定値:注: FTP サーバーが MDTM をサポートしていない場合は、Redownload Interval プロパティを設定します。 メモ： このプロパティは、[ ダウンロード後に削除] が [いいえ] に設定されている場合にのみ適用されます。
    間隔 この場所のポーリングを行う間隔を示す数値を指定します。 継続してポーリングを行うには、この値をゼロ (0) に設定します。

    既定値: 60
    再ダウンロード間隔 アダプターがファイルを再度ダウンロードするまでの間隔を指定します。 このプロパティは、[ ダウンロード後に削除] と [タイムスタンプ比較を有効にする] の両方が [いいえ] に設定されている場合にのみ適用されます。

    既定値: -1

    -1 は、アダプターがファイルを再度ダウンロードしないことを示します。

    0 は、ポーリング周期ごとにアダプターがファイルをダウンロードします。
    単位 Interval プロパティと Redownload Interval プロパティの単位の種類を指定します。

    有効な値: 秒、分、時間、日

    既定値: 秒

    SSL

    プロパティ 目的
    クライアント証明書ハッシュ Secure Sockets Layer (SSL) のネゴシエーションでの使用を要求するクライアント証明書の SHA1 ハッシュを指定します。

    このハッシュに基づいて、BizTalk ホスト インスタンスを実行しているユーザー アカウントの個人ストアからクライアント証明書が取得されます。
    FTPS 接続モード FTPS サーバーに対して行う SSL 接続のモードを指定します。

    有効な値: 暗黙的または明示的

    既定値: 明示的
    データ保護の使用 アダプターが FTPS サーバーとの間でデータ ファイルを送受信するときに、SSL 暗号化を使用する必要がある場合は、[はい] を指定します。 アダプターがデータ ファイルをテキスト形式で送受信する場合は、[いいえ] を指定します。 メモ： このプロパティは、[ SSL の使用 ] プロパティが [はい] に設定されている場合にのみ適用されます。

    有効な値: イエスかノーか答えてください

    既定値: はい
    SSL の使用 FTP アダプターが FTPS サーバーとの通信に SSL を使用する必要があるかどうかを指定します。

    有効な値: イエスかノーか答えてください

    既定値: いいえ

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

    プロパティ 目的
    受信データ タイムアウト 受信呼び出しを中止するまでの時間をミリ秒単位で指定します。 このプロパティを使用すると、低速のサーバーによって受信場所が応答を停止するのを防ぐことができます。

    既定値: 90000
    一時フォルダー 一時フォルダの場所を指定します。 この場所は、転送エラーの修復に使用されます。

  5. [OK] をクリックして設定を保存します。

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

Note

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

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

送信ポートを構成する

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

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

  2. [ 全般 ] ページの [ トランスポート ] セクションで、[種類] の横にある [構成 ] ボタンをクリック します。

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

    ファイアウォール

    プロパティ 目的
    アドレス ファイアウォールのアドレスとして、DNS 名または IP アドレスを指定します。
    モード アダプタから FTP サーバーへの接続モードを選択します。

    有効な値: パッシブとアクティブ

    アクティブ モードでは、FTP アダプターによって開かれたポートに FTP サーバーが接続します。 パッシブ モードでは、FTP サーバーによって開かれたポートに FTP アダプターが接続します。 内部 IP を使用し、外部 IP に接続すると、アクティブ モードが機能しない可能性があります。 この場合は、FTP をサポートするアプリケーション層ゲートウェイ (ALG) でパッシブ モードまたはアクティブ モードを使用する必要があります。

    既定値: アクティブ
    パスワード ファイアウォールのパスワードを指定します。
    ポート ファイアウォールのポートを指定します。

    有効な値: 1 から 65535 まで

    既定値: 21
    Type 展開するファイアウォールの種類を選択します。

    有効な値: ソックス 4、ソックス 5、なし

    既定値: なし
    User ファイアウォールのユーザー名を指定します。

    FTP

    プロパティ 目的
    アカウント 省略可能。 FTP サーバーのアカウント名を指定します。 このオプションは推奨されていません。このプロパティは使用しないでください。
    PUT コマンドの後 PUT コマンドの後に実行する FTP コマンドを指定します。 コマンドの区切りにはセミコロン (;) を使用します。
    記憶域の割り当て レガシ ホスト システムに記憶域を割り当てるかどうかを指定します。 このオプションは下位互換用に使用します。

    有効な値: いいえとはい

    既定値: いいえ
    PUT コマンドの前 ファイルの PUT コマンドの前に実行する FTP コマンドを指定します。たとえば、FTP サーバーの既定値を変更するコマンドなどを指定します。 コマンドの区切りにはセミコロン (;) を使用します。 ファイルを開くコマンドは必要ありません。 メモ： QUIT コマンドは、ファイル PUT の前にはサポートされていません。
    フォルダー FTP サーバー上のファイルの移動先を指定します。
    FTP サーバーの種類 BizTalk Server 2016 以降の新機能。

    SYST コマンドを必要としない FTP サーバーを選択するには、このプロパティーを使用します。 オプションは None、AIX、Detect、GXS、MVS、OS400、およびその他です。

    None に設定すると、SYST コマンドが使用されます。 その他 は、OS の種類が指定したカテゴリのいずれにも適合しない場合に使用されます。

    既定値: なし
    Log 出力するログ ファイルのファイル名を含む完全パスを指定します。 このファイルは、FTP アダプター経由でファイルを送受信する際のエラー状況を診断するために使用できます。
    パスワード FTP サーバーにログオンするためのパスワードを指定します。
    ポート FTP サーバーのポート アドレスを指定します。

    既定値: 21
    表現 FTP アダプターから送信するデータの形式を、バイナリまたは ASCII から選択します。

    有効な値: バイナリまたは ASCII

    既定値: binary
    サーバー FTP サーバーの名前または IP アドレスを指定します。
    [SSO 関連] エンタープライズ シングル サインオンの関連アプリケーションを指定します。
    ターゲット ファイル名 ファイルの代替名を指定します。 既定の名前を保持すると、送信されるメッセージごとに一意のメッセージ名が保証されます。

    既定値: %MessageID%.xml
    ユーザー名 FTP サーバーにログオンするユーザー名を指定します。

    SSL

    プロパティ 目的
    クライアント証明書ハッシュ Secure Sockets Layer (SSL) のネゴシエーションでの使用を要求するクライアント証明書の SHA1 ハッシュを指定します。

    このハッシュに基づいて、BizTalk ホスト インスタンスを実行しているユーザー アカウントの個人ストアからクライアント証明書が取得されます。
    FTPS 接続モード FTPS サーバーに対して行う SSL 接続のモードを指定します。

    有効な値: 暗黙的または明示的

    既定値: 明示的
    データ保護の使用 アダプターが FTPS サーバーとの間でデータ ファイルを送受信するときに、SSL 暗号化を使用する必要がある場合は、[はい] を指定します。 アダプターがデータ ファイルをテキスト形式で送受信する場合は、[いいえ] を指定します。 メモ： このプロパティは、[ SSL の使用 ] プロパティが [はい] に設定されている場合にのみ適用されます。

    有効な値: イエスかノーか答えてください

    既定値: はい
    SSL の使用 FTP アダプターが FTPS サーバーとの通信に SSL を使用する必要があるかどうかを指定します。

    有効な値: イエスかノーか答えてください

    既定値: いいえ

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

    プロパティ 目的
    Connection Limit (接続の制限) サーバーに対して開くことができる FTP の同時接続の最大数を指定します。 値 0 を指定した場合、接続は制限されません。

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

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

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

FTP アダプタは、FTP プロトコルによる制限を受けます。送信元または送信先 FTP サーバーでは、特定の FTP コマンドを使用できる必要があります。

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

コマンド Receive で必須 Send で必須
SYST ✔

BizTalk Server 2016 以降の省略可能		 ✔

BizTalk Server 2016 以降の省略可能
保存 ✔
RETR ✔
User ✔ ✔
PASS ✔ ✔
CWD ✔ ✔
QUIT ✔ ✔
ポート ✔ ✔
PASV ✔ ✔
ABOR ✔ ✔
TYPE ✔ ✔
RNFR ✔ ✔
RNTO ✔ ✔
DELE ✔ ✔
PWD ✔ ✔
リスト ✔ ✔
NLST ✔ ✔
NOOP ✔ ✔
APPE ✔
ALLO ✔ ✔
MDTM ✔
AUTH TLS ✔ ✔
PBSZ ✔ ✔
PROT ✔ ✔

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

レガシ ホストで動作するように FTP アダプターを構成する

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

Note

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

重要

次の情報は参考用です。AS400 または IBM のドキュメントに記載されている情報に代わるものではありません。

MVS

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

AS400

AS400 システムとの間でファイルをやり取りするとき、ファイル名の指定とパスの定義の方法は 3 つあります。

  • [ファイル名] フィールド: FTP サーバーにファイルを送信する場合は、[ ファイル名 ] フィールドにファイル名を入力します。 ファイルは Library File System に保存されるので、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 名前付け規則を使用するよう命令します。

関連トピック

FTP アダプター プロパティ スキーマおよびプロパティ

FTP アダプターのベスト プラクティスと推奨事項

FTP アダプタ