HelloWorld (BizTalk Server サンプル)

[アーティクル]
07/21/2023

HelloWorld サンプルは、BizTalk オーケストレーションを使用して、XML メッセージ (注文書) を関連する別の種類のメッセージ (請求書) に変換する方法を示すものです。

このサンプルの処理

このサンプルでは、受信場所として In フォルダーを構成します。サンプル ファイルSamplePOInput.xmlなどのファイルをこのフォルダーに配置すると、次の手順BizTalk Server使用してメッセージが処理されます。

受信場所フォルダから XML 注文書メッセージを取得します。
オーケストレーションで、マップファイルを使用して XML 注文書から XML 請求書を作成します。
BizTalk Server、結果の XML 請求書メッセージを送信アダプターの Out フォルダーに配置します。

このサンプルのデザイン方法とその理由

企業間のメッセージ交換シナリオでは、取引先から受信した受信メッセージを内部アプリケーションが認識できる形式に変換する作業が必要になる場合があります。このサンプルでは、 Receive 図形、 Transform 図形、 Send 図形を 使用して、この結果を実現します。 Transform 図形は、メッセージ形式の変換が行われる場所であるため、このサンプルでは重要な役割を果たします。変換図形をオーケストレーションにドラッグし、ソースメッセージ、マップ名、および送信先メッセージを構成します。実行中、指定したマップによって送信元メッセージが送信先メッセージにマップされます。

変換図形の詳細については、「変換図形を構成する方法」を参照してください。マップの構築の詳細については、「 BizTalk マッパーを使用したマップの作成」を参照してください。

このサンプルの場所

<サンプルパス>\Orchestrations\HelloWorld\

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

ファイル	説明
Cleanup.bat	アセンブリの展開を解除し、グローバルアセンブリキャッシュからアセンブリを削除するために使用されます。送信ポートと受信ポートが削除されます。必要に応じて、Microsoft インターネットインフォメーションサービス (IIS) の仮想ディレクトリが削除されます。
HelloOrchestration.odx	注文書から請求書への変換を行うオーケストレーションです。
HelloWorld.btproj、HelloWorld.sln	このサンプルのプロジェクトファイルとソリューションファイルです。
HelloWorldBinding.xml	ポートバインドなどの自動セットアップに使用されます。
InvoiceSchema.xsd、POSchema.xsd	それぞれ、請求書メッセージと注文書メッセージのスキーマです。
POToInvoice.btm	注文書を請求書に変換するためのマップです。
SamplePOInput.xml	サンプル入力ファイルです。
Setup.bat	このサンプルをビルドおよび初期化するために使用されます。

このサンプルのビルドと初期化

HelloWorld サンプルをビルドおよび初期化するには

コマンドウィンドウで、次のフォルダーに移動します。

<サンプルパス>\Orchestrations\HelloWorld
ファイル Setup.bat を実行すると、次のアクションが実行されます。
- 次のフォルダに、このサンプルの入力 (In) フォルダと出力 (Out) フォルダを作成します。
  
  <サンプルパス>\Orchestrations\HelloWorld
- このサンプルの Visual Studio プロジェクトをコンパイルします。
- BizTalk Server 受信場所と、オーケストレーションの送信および受信ポートを作成しバインドします。
- 受信場所を有効にし、送信ポートを開始します。オーケストレーションを参加させ、開始します。

Note

このサンプルを実行する前に、ビルドと初期化のプロセス中に BizTalk Server でエラーが報告されていないことを確認する必要があります。これはイベントログで確認できます。

このサンプルの実行

HelloWorld サンプルを実行するには

SamplePOInput.xml ファイルのコピーを In フォルダーに貼り付けます。
Out フォルダーに作成された .xml ファイルを確認します。このファイルには、入力ファイル SamplePOInput.xml から作成された XML 請求書が格納されます。このファイルの名前の形式は <MessageID>.xml で <、MessageID> はメッセージを一意に識別するために生成される GUID です。

このサンプルのアンインストール

HelloWorld サンプルをアンインストールするには

コマンドウィンドウで、次のフォルダーに移動します。

<サンプルパス>\Orchestrations\HelloWorld\
Cleanup.bat を実行します。

参照

オーケストレーション (BizTalk Server サンプルフォルダー)

次の方法で共有