次の方法で共有

AS2 Over File (BizTalk Server サンプル)

  • [アーティクル]

AS2 Over File サンプルでは、FILE 受信場所経由で AS2 メッセージを受信する方法を示します。 これにより、通常使用される HTTP アダプタではなく、FILE アダプタを使用して AS2 メッセージを受信できます。 そのために、このソリューションは、AS2 デコーダーの要求に応じて、AS2 メッセージの HTTP ヘッダーを InboundHTTPHeaders コンテキスト プロパティに書き込みます。

このサンプルの処理

このサンプルでは、HTTP アダプタを使用せずに AS2 メッセージの HTTP ヘッダーを処理する方法を示します。 具体的には、このサンプルは以下の処理を行います。

  1. テスト メッセージを入力フォルダにドロップすると、FILE 受信場所がそのメッセージを取得します。

  2. カスタム AS2 受信パイプラインのカスタム パイプライン コンポーネントはメッセージを処理し、HTTP ヘッダーを InboundHTTPHeaders コンテキスト プロパティに書き込みます。

    Note

    メッセージの処理がカスタム パイプライン コンポーネントのダウンストリームに失敗した場合、メッセージが既に XML エンコードに変換されているため、メッセージの処理の再開が困難になる可能性があります。

  3. カスタム受信パイプラインの AS2 デコーダはメッセージを処理し、InboundHTTPHeaders コンテキスト プロパティのプロパティを読み取り、その処理を行います。

  4. 送信ポートは受信パイプラインによって生成された XML メッセージをサブスクライブし、パススルー送信パイプラインを通じて渡した後、出力フォルダにドロップします。

このサンプルの場所

このサンプルは、BizTalk Server インストール フォルダーにあります: \Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\Samples\AS2\AS2 Over File。

次の表は、このサンプルのファイルとその目的を示しています。

ファイル 説明
AS2OverFile.csproj カスタム パイプライン コンポーネント コードを含むプロジェクトです。
AS2OverFile.sln AS2OverFile.btproj プロジェクトを含むソリューションです。
Program.cs ヘッダー データを表すクラスが含まれています。
SampleMessage.txt HTTP ヘッダーを含むサンプル メッセージです。

このサンプルの実装と実行

AS2 Over File サンプルを実装するには、次の操作を行う必要があります。

  • このサンプルの BizTalk プロジェクトをビルドして展開し、カスタム パイプライン コンポーネントを作成します。

  • カスタム パイプライン コンポーネントを使用してカスタム パイプラインを作成し、そのカスタム パイプラインを使用してプロジェクトをビルドおよび展開します。

  • 入力ファイル フォルダと出力ファイル フォルダを作成します。

  • 受信ポートと受信場所を構成し、受信場所を有効にします。

  • 送信ポートを構成して開始します。

  • サンプル メッセージを送信するパーティを作成します。

AS2 Over File エミュレータ パイプライン コンポーネントを使用してカスタム パイプラインを構築するには

  1. Visual Studio で、\Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\Samples\AS2\AS2 Over File フォルダーで AS2OverFile プロジェクトを開きます。

  2. 厳密な名前キー ファイルを作成し、AS2OverFile プロジェクトの [プロパティ] ダイアログ ボックスを開き、キー ファイルをプロジェクトに割り当てます。

  3. プロジェクトをビルドします。

  4. Visual Studio で、AS2OverFile_Pipeline という名前の新しい BizTalk プロジェクトを作成します。

  5. AS2OverFile_Pipeline プロジェクトを右クリックし、[ 追加] をポイントして、[ 新しい項目] をクリックします。

  6. [ 新しい項目の追加 ] ダイアログ ボックスで、左側のウィンドウで [ パイプライン ファイル ] を選択し、右側のウィンドウで [ 受信パイプライン ] を選択し、パイプラインに AS2OverFile_Receive.btp という名前を付けて、[ 追加] をクリックします。

  7. メニュー バーの [ 表示 ] をクリックし、[ ツールボックス ] をクリックしてツールボックスを表示します。

  8. ツールボックスで、[ BizTalk パイプライン コンポーネント] を右クリックし、[項目の 選択] をクリックします。

  9. [ ツールボックス項目の選択 ] ダイアログ ボックスで、[ BizTalk パイプライン コンポーネント ] タブをクリックします。[ AS2 Over File Emulator] をクリックし、[OK] をクリック します。

  10. AS2OverFile.dll ファイルをグローバル アセンブリ キャッシュに追加するには、Visual Studio コマンド プロンプトを開き、\AS2 Over File\obj\Debug フォルダーの Microsoft.BizTalk.Sdk.Components.AS2OverFile.dll でコマンド gacutil /if "<file name and path>" を実行します。

  11. Visual Studio で、AS2 Over File Emulator パイプライン コンポーネントをツールボックスからカスタム パイプラインの Decode ステージにドラッグします。

  12. AS2 デコーダー コンポーネントを、AS2 Over File コンポーネントの後のカスタム パイプラインの Decode ステージにドラッグします。

    Note

    MDN を生成する場合は、AS2 逆アセンブラをカスタム パイプラインの逆アセンブル ステージに追加します。 MDN を返さない場合、AS2 逆アセンブラは不要です。

  13. 厳密な名前キー ファイルを作成し、AS2OverFile_Pipeline プロジェクトの [プロパティ] ダイアログ ボックスを開き、キー ファイルをプロジェクトに割り当てます。

  14. カスタム パイプラインをビルドして配置します。

  15. BizTalk Server管理コンソールで、[パイプライン] ノードをクリックし、[更新] をクリックして、カスタム パイプラインを [パイプライン] ノードに追加します。

このサンプルのソリューションを実装するには

  1. Windows エクスプローラーの \Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\Samples\AS2\AS2 Over File フォルダーで、入力フォルダーと出力出力フォルダーを作成します。

  2. BizTalk Server管理コンソールで、AS2OverFile_Receive という名前の一方向の受信ポートを作成します。 作成した受信ポートで、次のプロパティを使用して受信場所を作成します。

    プロパティ 設定
    名前 AS2OverFile_Receive
    Type ファイル
    受信フォルダ \Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\Samples\AS2\AS2 Over File/In
    ファイル マスク *.txt
    受信パイプライン。 AS2OverFile

  3. [受信場所] ノードで、受信場所AS2OverFile_Receive右クリックし、[ 有効] をクリックします。

  4. [送信ポート] ノードで、次のプロパティを使用して静的な一方向の送信ポートを作成します。

    プロパティ 設定
    名前 AS2OverFile_Send
    Type ファイル
    受信フォルダ \Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\Samples\AS2\AS2 Over File/Out
    ファイル マスク %MessageID%.xml
    [送信パイプライン] パラメーターを
    フィルター BTS.REceivePortName == AS2OverFile_Receive

  5. [送信ポート] ノードで、AS2OverFile_Send送信ポートを右クリックし、[ 開始] をクリックします。

  6. [パーティ] ノードで、"Partner" という名前のパーティを作成します。 [エイリアス] ボックスの一覧に、EDIINT-AS2 From Value という名前のエイリアス、AS2-From の修飾子、および Partner の値を含むエイリアスを追加します。

    BizTalk Serverは、このサンプルを操作する準備ができました。

このサンプルの実行

次の手順を使用して、AS2 Over File サンプルを実行します。

このサンプルを実行するには

  1. \Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\Samples\AS2\AS2 Over File フォルダーから \AS2 Over File\In フォルダーに、SampleMessage.txt ファイルをコピーします。

  2. 出力 XML メッセージが \AS2 Over File\Out 出力フォルダーにドロップされることを確認します。

  3. テキスト エディターで入力メッセージ SampleMessage.txt を開き、テキスト エディターで出力メッセージ <GUID>.xml を開きます。 SampleMessage.txt 入力メッセージに HTTP (および AS2) ヘッダーがあり、出力メッセージに HTTP ヘッダーがないことを確認します。

このサンプルで使用されるクラスまたはメソッド

なし

参照

EDI および AS2 (BizTalk Server Samples フォルダー)
FILE 送信ポートを使用した AS2 メッセージの送信