・BizTalk Server 2013 R2 CU2
     ダウンロードセンター  https://www.microsoft.com/en-us/download/details.aspx?id=50417
     技術情報  https://support.microsoft.com/en-us/kb/3119352

・BizTalk Server 2013 CU3
     ダウンロードセンター  https://www.microsoft.com/en-us/download/details.aspx?id=49190
     技術情報  https://support.microsoft.com/en-us/kb/3088676

***

さて、今回の CU2 に限った事象という訳ではないのですが、Adapter Pack を導入している環境では、CU のインストール中に Adapter Pack のディスクが求められることがあります。

BizTalk Server 2010 以降では Adapter Pack は BizTalk Server と統合されていますので、ここでは BizTalk Server 2013 R2 などのインストールディスクを挿入して [OK] で続行すれば、インストールが継続されます。

ファイルを直接指定したいときは、[Browse..] をクリックしてメディア内の BizTalk Server > AdapterPack_x86 フォルダーの AdapterSetup.msi (または AdapterPack_x64 配下の AdapterSetup64.msi) を選んでください。

インストールが完了すると以下の画面が表示されて、必要に応じて再起動が求められます。

コントロール パネルの [インストールされた更新プログラム] の一覧で、インストールされた CU を確認できます。

ただし更新プログラム一覧に表示される CU のバージョン番号は、日本語ローカライズ版ではダウンロードセンターに記載のバージョン番号とは異なっています。

CU が正常に適用されたことを確認するには、技術情報 (KB) のリストに記載があるモジュール (dll) を探して、プロパティのファイル バージョンで判断することが確実な方法となります。

今日は WCF-SQL Adapter で生成されたスキーマで起こる問題について、ご説明します。

この問題は、ずばり、BizTalk Server 2013 R2 で以下のように定義されているテーブルを用い、WCF-SQL Adapter でスキーマを生成すると・・・

↓

↓

このように、カラムの順序が異なってしまうという現象です。

以下の技術情報にあるように、SQL Server 2014 をご利用いただいている環境下で Consume Adapter Service を使用してスキーマを生成すると、WCF-SQL Adapter で生成されるクエリのカラムが order by で指定されず、順序が保障されなくなってしまうことが原因となります。

※SQL Server 2012 では発生しません

FIX: The element orders in the schema generated by WCF-SQL adapter are different for SQL Server 2012 and SQL Server 2014

https://support.microsoft.com/en-us/kb/3067999

この問題は、BizTalk Server 2013 R2 の CU1 で修正されています。

CU1 の適用後、再度スキーマを生成すると、以下の通り正しいカラムの順序で生成できていることがわかります。

同様の現象が発生した場合には、こちらから CU1 をダウンロードして適用してください。

以上となります。

今年は本ブログの立ち上げの年となりましたが、ご覧いただきましてありがとうございました。

来年も日本のユーザー様のお役に立てるような記事を投稿していきたいと思いますので、よろしくお願いいたします。

それでは、来年も 弊社製品をご愛顧くださいますよう、お願いいたします。

BizTalk Server 運用時のベストプラクティスのひとつに、専用ホスト作成 (ホスト分割) が挙げられます。

標準では BizTalkServerApplication という単一ホストの中で、送受信アダプター・オーケストレーション・追跡データなどなど、すべて稼働させていることも多いと思います。

しかしこのように多くの処理を同じホストで実行しているとスレッドが不足したり、コンテキスト スイッチの切り替えが頻繁に起きたりして、パフォーマンス低下が起こることがあります。また、ある特定の処理が異常終了してしまった際に、同じホストインスタンス内で動作しているすべての処理が影響を受けるリスクもあります。このような問題を解消するために、複数のホストに分割するメリットがあります。

あまり細かくホストを分割しすぎると、逆に管理が煩雑となったり、逆にシステムのリソースが多く消費されるなどのデメリットもありますので、設定の際は十分なテストが必要になります。

以下、簡単な手順です。

BizTalk Server 管理コンソール から、[ホスト] を選択します。

[新規作成] –> [ホスト] を選択します。

[名前] に任意のホスト名を入力し、[Windows グループ] に “BizTalk Application Users” と入力します。

これで新規ホストの作成は完了です。次に、作成したホストに紐づくホストインスタンスを作成します。

BizTalk Server 管理コンソール から、[ホスト インスタンス] を選択し、[新規作成] –> [ホスト インスタンス] を選択します。

[ホスト名] で、先ほど作成したホストを選択します。

[構成] ボタンより、ログオン資格情報を入力します。

これでホストインスタンスの作成完了です。

ホストとホストインスタンスは、一意に紐づけられる必要があります。既に他のホストインスタンスに紐づいたホストを選択した場合は、以下のエラーが出ますのでご注意ください。

では、作成したホストを実際にアダプターに割り当ててみましょう。今回は FILE の送信アダプターに割り当てます。

[アダプター] –> [FILE] を選択し、対象のアダプターをダブルクリックします。

作成したホストをプルダウンから選択します。

[OK] を押すと、以下のメッセージが表示されますので、[OK] を押してホストインスタンスを再起動します。

ホスト名が “TEST” になっていることが確認できます。

ホスト分割の手順は以上です。

ポイントは、ホストを作成したらそれに紐づくホストインスタンスを必ず作成することです。ホストインスタンスを作成しないと、メッセージを投入した際にサービスインスタンスが “実行準備完了” となり正常にメッセージを送受信することができません。

複数ホストが実行中の場合、起動しているホストインスタンスの数だけプロセスが起動していることがわかります。

今回は、作成したホストをアダプターに割り当てる手順を紹介しましたが、作成したホストをどこにも割り当てず、”追跡専用ホスト” として利用することも可能です。

このように追跡専用ホストを作成したら、オプションの [ホストの追跡を許可する] にチェックを入れます。

なおかつ、同じ BizTalk  グループのほかのすべてのホストでは、[ホストの追跡を許可する] のチェックを外します。

これで追跡専用ホストが構成されました。

追跡専用ホストを構成して、ホストインスタンスを開始しておくことで、他のホストインスタンスが停止した場合でもメッセージボックスデータベースにデータが蓄積され続けることを防ぐことができます。

また、同じホストで実行されているアプリケーションのパフォーマンス低下を防ぐためにも、ホストの追跡を許可するためだけの専用ホストを作成することをお勧め致します。

是非ご検討ください！

  BizTalk Server 2010 Cumulative Update 8
  https://www.microsoft.com/en-us/download/details.aspx?id=48592

上記ダウンロードサイトの、[Select Language] は "English" のままで、ダウンロードボタンを押してください。
BiztalkServer2010-RTM-KB3081737-JPN.exe にチェックを入れると日本語版を入手することが可能です。 

先日 BizTalk Server 2009 および 2010 向けの CU7（Cumulative Update）をご案内しましたが、
この度の CU8 には CU7 適用後に BAM トラッキングで発生する、KB3047071 の問題への対応も含まれます。

CU8 に含まれている修正の一覧は、以下のサポート技術情報でご確認いただけます。

  Cumulative update package 8 for BizTalk Server 2010
  https://support.microsoft.com/en-us/kb/3081737

CU 適用時の注意点は、<a href="http://blogs.msdn.com/controlpanel/blogs/posteditor.aspx/のブログ">前回のブログ もご覧ください。

BizTalk Adapter Pack には Oracle や SAP、Siebel、Microsoft SQL Server などのシステム連携を可能にするアダプターが含まれています。
BizTalk Server 2009 までは Adapter Pack 2.0 として BizTalk Server とは独立して提供されていました。BizTalk Server 2010 以降からは BizTalk Server と Adapter Pack は統合されて、BizTalk Server のライセンスがあれば、追加費用なしで導入できるようになりました。

特に BizTalk Server 2013 からは、今までのネイティブ SQL アダプターの代わりに Adapter Pack の WCF-SQL アダプターが推奨となった (※) ことで、初めて Adapter Pack の導入を検討されている方もいらっしゃるかも知れません。以下に BizTalk Adapter Pack のインストール方法をご紹介します。(BizTalk Server 2013 R2 の例です)

BizTalk Adapter Pack のインストール方法

1) インストールメディアから [BizTalk Server] フォルダ内の Setup.exe を起動します。

2) 「Microsoft BizTalk アダプターをインストールします」を選択します。

3)  Adapter Pack のインストール画面が開きます。Step 1 から順にインストールしていきます。

4) WCF LOB Adapter SDK のインストールでは [Custom] を選択します。
Visual Studio で Adapter pack を使用した BizTalk プロジェクトを開発する場合は [Tools] のインストールが必要です。BizTalk Server 環境上で Adapter Pack を動作させるには [Addin] も忘れずに選択します。

5) 続いて Step 2～3 の「Install Adapter Pack」と「Install Adapter Pack (x64)」をインストールします。

6) 最後に Step 4 では Enterprise Application 用のアダプターを必要に応じてインストールします。以下のアダプターが選択可能です。

• J.D. Edwards EnterpriseOne®
• J.D. Edwards OneWorld®
• PeopleSoft Enterprise®
• TIBCO® Enterprise®
• TIBCO® Rendezvous®

7) すべてインストールした場合の例です。

 

WCF-SQL Adapter を利用する場合はここまでの手順で完了となりますが、Oracle Adapter や SAP Adapter 等を利用するためには、追加で各社から提供されている専用ドライバやクライアント ソフトウェアのインストールも必要です。詳細は上記のインストール画面から参照できる Adapter Pack Installation Guide を参照ください。

今回インストールした Adapter Pack に含まれる WCF-SQL アダプターを使った開発例などは、またの機会にご紹介します。
それでは。

！概要と注意点！
PSSDiagForBizTalk は、複数のログやトレースの中から取得したいものを設定して、ツールを開始したあと、問題の発生する瞬間を捉えるようにして情報の採取を行います。
たとえばメッセージの受信時にエラーが発生するようなときは、エラーの発生するメッセージをBizTalk に投入して現象を確認したあと、ツールを停止する (& 取れたログをサポートに送る) という使い方をします。
もちろん BizTalk システムの構成情報だけを取りたいようなときは、ツールを開始してすぐ停止するだけで良いこともありますが、多くの場合は、問題が発生するタイミングを狙ってツールを仕掛けておくことが必要になります。

このような取り方であるため、採取するログの構成や取得期間によっては大きなログサイズになったり、システムへの負荷が高くなる場合があります。一例ですが、数十秒の取得であっても、取得されるログサイズが数 100 MB 以上になり、取得したログが書き出されるまでに 10～20 分程度を要することもあります。どうしても業務中の本番環境に仕掛けるしかないこともありますが、可能な限りはツールの影響を気にしなくても良いテスト環境で実施いただくことをお勧めしています。

～使い方～
PSSDiagForBizTalk は BizTalk Server 2013/2013 R2 のインストールディレクトリに含まれています。
　　c:\Program Files (x86)\Microsoft BizTalk Server 2013\SDK\Utilities\Support Tools\PSSDiagForBizTalk

1) 管理者でコマンドプロンプトを起動し、PSSDiagForBizTalk の格納フォルダに移動します。

2) 以下のコマンドを実行します。(初めて利用する場合は License Agreement が表示されます)
 > initialize.exe

 3) 設定画面が開きますので、これから取得する情報をセットアップします。
画像は既定の画面です。

Host Instances To Track: 情報取得する対象のホストインスタンスを指定します。問題が発生するホストインスタンスが決まっている場合や、ハングダンプや WCF トレースを取りたい場合には、個別のインスタンス名を選びます。

Take BizTalk ETW trace: BizTalk の内部処理についてのデバッグ情報を記録するログです。オプションは既定のまま取ることがほとんどです。

Take a MsgBoxViewer Trace: MBVと略されます。BizTalk Server の構成情報を取ります。自動的にレポート形式に出力されるので、何か問題がないかを確認するのにも利用できます。

Take a performance counter log: パフォーマンスログとカウンタの取得間隔です。BizTalk Server 関連のカウンターが自動的に指定されます。

Capture message content and message context: 完了していないメッセージの本文やコンテキスト情報を取得します。

Take hang dump: ハングダンプです。ただハングしていると分かっている場合には、ダンプ取得用の専用ツールを使うことも多いです。

Take WCF and/or System.Net traces: WCF や .NET Framework のSystem.Net クラスのログ情報を取得できます。これも個別に設定できるので、あまり取得する機会はないです。

Take a newtork monitor trace: 通信内容を確認するためのネットワークキャプチャを取得します。本ツール単独では動作しません (汗)。Netowrk Monitor がシステムにインストールされていれば、トレースと合わせて採取してくれます。

Stop tracing when disk space is less than [] GBs: ディスクの空き容量が指定した GB 以下になったらトレースを停止します。

5) [Save and Close] ボタンで設定を保存してダイアログを閉じます。設定を変えたい場合は、再び initialize コマンドを実行すれば OK です。

※注意※
MBVSettings.xml の以下のプロパティをご利用環境にあわせて変更する必要がありますので、ご注意ください・・・
誤: <GlobalProperty ID="MGMTDBSERVER" Value="9XUEHONGG" />
正: <GlobalProperty ID="MGMTDBSERVER" Value="<SQL SERVER名>" />

誤: <GlobalProperty ID="MGMTDBNAME" Value="BizTalkMgmtDbx" />
正: <GlobalProperty ID="MGMTDBNAME" Value="BizTalkMgmtDb" />

たとえば、SQL SERVER 名が "BTS2013R2" なら、以下のようになります。 

6) 設定が完了したら、その内容でトレース取得を開始します。次のコマンドを実行します。 
> pssdiag.exe /G

7) 次のメッセージが表示されてログの取得が開始されます。
> PSSDIAG Collection started. Press Ctrl+C to stop.

8) 問題が再現する操作を行って、事象を再現させたあと、Ctrl+C を押して PSSDiag を停止させます。
  停止後は取得した情報の後処理が実行されます。これには数分から数 10 分程度掛かる可能性があります。正常終了すると、次のメッセージが表示されます。

> PSSDIAG Ending data collection. Please wait while the process shuts down and files are
compressed (this may take several minutes)
> (中略)
> PSSDIAG Collection complete. Collector exiting

9) 実行フォルダに output フォルダが作成され、その中に取得したトレースやログ一式が保存されます。弊社サポートで取得を依頼させていただいている場合などは、output フォルダを ZIP 形式等で圧縮してご提供ください。

HelloWorld オーケストレーションサンプルの解説 2 回目は、実際に HelloWorld サンプルをインストールして動かしてみたいと思います。

(※BizTalk Server が正しくインストールされていることが前提となりますので、セットアップは完了させておいてください)

HelloWorld アプリケーションの中身の解説は、前回のコチラをご覧ください。⇒　HelloWorld オーケストレーション (開発編)

◆HelloWorld サンプルのインストール

HelloWold サンプルは、In フォルダに置かれたファイル (PO) を BizTalk が自動的に取り込んで、オーケストレーションで Invoice の形式へと変換したあと、Out フォルダに Invoice 形式のファイルを出力するという流れになります。

管理者権限のコマンドプロンプトで、サンプルの格納場所にある setup.bat を実行するとインストールが開始します。

 
  
プロジェクトのビルドとデプロイ、ファイルの送受信場所の作成、ポートのバインドの構成が自動的に行われます。

コマンドが成功したことを確認します。

黄色のホストインスタンスの再起動の警告が出ると思いますが、初回デプロイであれば特に再起動は必要ありません。

インストールはこれだけで完了です。続いて動作確認を行います。

◆HelloWorld サンプルの動作確認

インストールが完了すると、サンプルの HelloWorld フォルダには In と Out の 2 つのフォルダが作成されます。フォルダ内の SamplePOInput.xml がテスト用の入力データです。このファイルを In フォルダにコピーします。

しばらくして、In フォルダにコピーしたファイルが消えて、Out フォルダにファイルが作成されれば動作確認は成功です。

入力ファイルの SamplePOInput.xml をメモ帳などで編集して、データを変更してから受信フォルダに投入した場合でも、出力先の Invoice ファイルに結果が正しく反映されることを確認してください。

◆グループハブを使用した追跡データの表示

動作確認としては以上で完了なのですが、もう少し範囲を広げて、処理が行われたことを後から確認するための「追跡」の構成をご紹介します。

HelloWorld オーケストレーションのプロパティ画面の「追跡」は既定で無効になっていますので、「イベントの追跡」すべてにチェックをいれます。

オーケストレーションの追跡を構成する方法

https://msdn.microsoft.com/ja-jp/library/aa561347.aspx

これでオーケストレーションのイベント履歴が追跡データベース (BizTalkDTADb) に保存されるようになり、処理結果を後から参照できるようになります。

追跡を有効にしてから、もう一度メッセージを投入してください。

次に BizTalk 管理コンソールの BizTalk Group を選択して「グループの概要」画面の「完成したインスタンス」をクリックします。

すると [完了]　タブが開き、クエリ結果に完了したオーケストレーションが表示されるはずです。

さらに、クエリ結果に表示されている項目で右クリック - [オーケストレーションデバッガー] で、実行されたオーケストレーション処理を確認できます。

(ここで気づいたのですが、SDK の HelloWorld サンプルのオーケストレーション名が HelloSchedule になっているのは単に誤植と思われます。気にしないでください。。)

「グループの概要」画面は、正常終了している場合だけでなく、問題発生時のトラブルシューティングにも役立ちます。オーケストレーションの途中で処理が止まっていたり、発生しているエラーを把握するうえで大変役に立つ機能ですので、ぜひ活用ください。

◆BizTalk 管理コンソールでの構成確認

最後に BizTalk 管理コンソールを起動して、HelloWorld アプリケーションの構成を確認していきます。既定では BizTalk Application 1 の配下のオーケストレーション内に、サンプルの HelloWorld オーケストレーションが配置されています。

HelloWorld オーケストレーションをダブルクリックしてプロパティを開き、バインド情報を確認してみます。

ホストには BizTalkServerApplication が指定され、受信ポート・送信ポートがそれぞれオーケストレーションにバインドされていることが分かります。「論理ポート」はこのオーケストレーション内で定義されているポート名をあらわします。その隣にある受信ポート・送信ポートが、それらに対応する実体の受信ポート・送信ポートをあらわしています。

続けてポートの実体である、受信ポート HelloWorldReceivePort と送信ポート HelloWorldSendPort をみていきます。

BizTalk 管理コンソール左ツリーの送信ポートには、HelloWorldSendPort が作成されているはずです。

さらに HelloWorldSendPort のプロパティを開いてみると、この送信ポートはファイルアダプターを使用して、HelloWorld ディレクトリ内の Out フォルダを送信先に指定していることが確認できます。

送信ファイル名の「%MessageID%.xml」は定義済みマクロを使用したもので、BizTalk Server が内部でメッセージを処理するときに割り当てる固有のメッセージ ID をファイル名にしています。他に %SourceFileName% や %time% なども指定することができます。

  ファイル名でのマクロの使用に関する制限事項

  https://msdn.microsoft.com/ja-jp/library/aa578022.aspx

受信ポートについても同様に確認していきます。送信ポートとは異なり、受信ポートには「受信場所」という概念があります。アダプターの種類や受信フォルダの指定などは、受信ポートではなく、受信場所で構成しています。

送信ポートとは異なり、1 つの受信ポートに対して、メッセージを受信する箇所 (つまり受信場所) は複数持つことができるため、このような管理方法となっています。余裕があれば、サンプルに In2 フォルダのような別の受信場所を新規作成して、動作確認してみてください。(新しく受信場所を作成したあとは、手動で「有効」にする必要があるのでお忘れなく)

最後に [プラットフォームの設定] > [ホスト インスタンス] を確認します。これは BizTalk アプリケーションが動作しているインスタンスをあらわします。

既定では BizTalkServerApplication ホストインスタンスの中で、オーケストレーションや受信・送信アダプターなどが共通して動作します。

ホストインスタンスの実体は Windows 上のサービスです。 BTSSvc$BizTalkServerApplication  のようなサービス名で、BTSNTSvc.exe プロセス上で動作していることが、タスクマネージャーで確認できます。

(※上記例では Orch ホストというホストを独自に作成している環境のため、2 つの BTSNTSvc.exe が起動しています)

今回のまとめです。

・BizTalk 管理コンソールでは送信ポート・受信ポート (受信場所) を構成できる。

・送信ポートはひとつの送信先を、受信ポートは複数の受信場所を持つことができる。

・ホストインスタンスはサービスとして起動していて、BTSNTSvc.exe
プロセスとして動作する。

・実行した処理は追跡データで確認できる。

以上でサンプルの動作確認は一通り終わりです。他にも SDK には多数のサンプルが含まれています。ぜひ確認してみてください。

BizTalk Server の SDK には、多くのサンプルが含まれていることをご存じでしょうか。今回はBizTalk アプリケーションにはじめて触れる方を対象に、HelloWorld オーケストレーションサンプルを解説します。

(※BizTalk Server が正しくインストールされていることが前提となりますので、あらかじめセットアップは完了させておいてください)

MSDN にも、同じ SDK サンプルの利用方法のドキュメントがありますので、あわせて目を通してみてください。

https://msdn.microsoft.com/ja-jp/library/aa559831.aspx

とりあえず動かしてみたいという方はコチラを先にご覧ください ⇒　HelloWorldオーケストレーション (動作確認編)

◆プロジェクトを Visual Studio で開いてみる

HelloWorld サンプルは、受信したメッセージをオーケストレーション内で別のメッセージに変換してから、送信するという単純な内容となっています。

以下の手順で HelloWorld プロジェクトを Visual Studio で開いて内容を確認してみます。念のためHelloWorld フォルダはバックアップを取っておいてください。

SDK\Samples\Orchestrations\HelloWorld フォルダ内のHelloWorld.sln を開きます。

Visual Studio のソリューションエクスプローラーに表示されているのが、本サンプルに含まれるリソースです。

• HelloOrchestation.odx -- オーケス トレーション
• InvoiceSchema.xsd / POSchema.xsd  --スキーマ
• POToInvoice.btm -- マップ
• HelloWorld.snk -- キーファイル (厳密名の署名に使われています)

 
  
  
 ◆スキーマ (xsd)

このオーケストレーションでは PO と Invoice という 2 種類のメッセージを扱いますので、メッセージ形式を定義するスキーマも 2 つあります。

これらの xsd ファイルを開いてみるとスキーマエディタが起動して、メッセージのデータ構造とそれに対応する XML 記述を確認できます。XML を直接編集しなくとも、左側ツリーの操作で新しいフィールド要素を追加したり、プロパティウィンドウでデータ型などを設定できます。

◆オーケストレーション (odx)

HelloOrchestration.odx を開いてみます。オーケストレーションデザイナーが起動して、HelloOrchestration の実装が表示されます。

ReceivePOPort からReceivePO 受信図形への線がメッセージの受信を、SendInvoice 図形から SendInvoicePort への線がメッセージの送信をあらわします。

真ん中にあるConstructInvoice 図形がこのオーケストレーションのポイントとなる [変換] 図形を使用したメッセージの変換・構築となっています。

サンプルではすでに接続状態になっていますが、ポートと受信 (送信) 図形を結びつける操作を確認してみます。ReceivePOPort から伸びる線を Delete キーで消したあと、もう一度引き直してみてください。ポート図形にある緑の矢印、または受信図形のコネクタをマウスでドラッグして目的のところまで引っ張っていきます。

続いて、受信図形 ReceivePO のプロパティを確認してみると「アクティブ化」が True になっていることが分かります。

オーケストレーションは「アクティブ化」が指定されたメッセージの受信を契機として開始します。もし「アクティブ化」が指定されている受信図形がひとつも含まれていないと、そのオーケストレーションは開始するきっかけがありません。

受信メッセージをきっかけに処理を開始するオーケストレーションは、常にアクティブ化が True の受信図形で始まることを覚えておいてください。(他の開始パターンもあるのですが、それは別の機会にご紹介します)

また、プロパティ中の「メッセージ」の項目では、この受信図形はPOMessage メッセージに対応していることが分かります (送信は InvoiceMessage )。

送受信図形は、このように BizTalk プロジェクト内で定義されている「メッセージ」を参照することも必要になります。

続いてメッセージの定義をみていきます。ソリューションエクスプローラーの表示を下のタブから切り替えて  [オーケストレーションの種類] を選択すると、プロジェクトに含まれているメッセージを確認できます。

メッセージ「InvoiceMessage」のプロパティを表示すると、[メッセージの種類] に Microsoft.Samples.BizTalk.HelloWorld.InvoiceMessageType が選択されていることが分かります。

Microsoft.Samples.BizTalk.HelloWorld.InvoiceMessageType というのは、スキーマ  InvoiceSchema.xsd で定義されたメッセージ形式であるということです。

メッセージの種類のプルダウンを展開すると、同じプロジェクトに含まれているスキーマが一覧から選択できることが分かります。

つまり「スキーマ」でデータの構造を定義して、そのスキーマに従った「メッセージ」をプロジェクト内に作成して、「送受信図形」のプロパティにメッセージを設定する、という関係になっています。

◆マッパー (btm)

再びオーケストレーションに戻って、中央の ConstructInvoice 図形をみてみます。

[メッセージの構築] 図形の中には、[変換] 図形が含まれています。[変換] 図形では受信したメッセージ (PO) から送信メッセージ (Invoice) を作成する処理が実装されています。[変換] 図形の POToInvoiceTransform をダブルクリックして処理内容を確認します。

「変換の構成」ウィンドウが開いて、送信元が POMessage、送信先が InvoiceMessage になっていることが確認できます。

「Biztalk マッパーを起動する」のチェックをいれて [OK] で起動します。またはソリューションエクスプローラーの POToInvoice.btm ファイルを直接開くこともできます。

次のように BizTalk マッパー編集画面が起動して、受信した PO メッセージに含まれるデータを Invoice に対応させていることが分かります。

(とはいえ、このサンプルでは PO と Invoice が全く同じ形式ですので、フィールド名が違うだけで、単にデータを 1 対 1 で対応させているだけです)

ちなみにマッパーでは、単にデータ同士を結ぶだけでなく、ツールボックスから functoid と呼ばれる図形を追加して、数値演算や文字列処理なども可能です。現実の業務データを扱うときは、マップが非常に複雑になってくることは容易に想像できることと思います。

◆ポートとバインド

最後にポートの構成を確認してみます。オーケストレーションに戻って、[ReceivePOPort]ポート図形をダブルクリックすると、[ポート構成ウィザード] が立ち上がります。

[ポートのプロパティ] > [ポートの種類の選択] > [ポートのバインド] の順に進めて、サンプルに設定されている内容を確認してみてください。

ポートでは通信方式 (一方向 or 要求/応答) と通信方向 (送信 or 受信)、どの場所 (URI) から、どのような方法で (トランスポート) メッセージが送受信されるのかを決定します。

そのうち「場所と方法」を決めている情報を「バインド」情報と呼びます。バインド情報はアプリケーションから完全に独立させることができ、プロジェクト内のポートの設定では指定せず、今回の HelloWorld サンプルのようにあとから BizTalk 管理コンソール上で指定することができます。

つまりアプリケーション内では、あらかじめ通信方式と方向さえ決めておけば、あとはどのようにメッセージを送受信するのかは意識しなくても良いということになります。

例えばファイルシステムの共有フォルダや FTP からメッセージを取り込んでも良いですし、そのあと作成したメッセージを HTTP やメールの SMTP で送信することもできます。SQL Server データベースや、SAP や Oracle などの外部基幹システムと接続できるアダプターを通じて、メッセージを送受信することも可能です。

なお、今回の HelloWorld サンプルで「後で指定する」となっているバインド情報は、サンプルと同梱の HelloWorldBinding.xml ファイルで別で定義されていて、受信・送信ともにローカルのフォルダが構成されています。

以上で一通り、BizTalk アプリケーションの構成と、ポイントになる要素を確認しました。

今回のまとめです。

・BizTalk プロジェクトで取り扱うメッセージは、スキーマ (xsd) で定義される

・オーケストレーション odx にアプリケーションの実装ロジックが含まれる

・オーケストレーションを開始するための受信図形には「アクティブ化」を設定する。

・マッパー (btm) ではメッセージの変換ができる。

・ポートのバインド情報はプロジェクトに含めずに、後から指定することもできる。

次回は実際にサンプルの動作確認を行ってみます。

ではまた。