ESB ToolkitのHello World

ESB Toolkitとは何であり、何が面白いか

ESB ToolkitはBizTalkサーバー用のツールキットであり、統合アプリケーションの開発を簡素化します。

これは本格的な製品を作成できる強力なツールであるという事実にもかかわらず、最初に魅了されるのは、BizTalkの開発トピックを入力するための低い「しきい値」です。 オーケストレーションでは解決が困難な多くのタスクは、ESB Toolkitを使用して簡単に解決できます。

Microsoftは、多くの一般的なタスクの例を提供する優れたドキュメントを作成しました。 しかし、私の例では、このツールを使用するという一般的なアイデアが浮かんだときに、このドキュメントが役立つことに気付きました。 どうやら、怠zyなプログラマーの条件反射がトリガーされます-少なくとも何かが機能するか、多くの時間が無駄になるまで、ドキュメントを読まないでください。

実際、この投稿の主な目標は、簡単なアプリケーションを作成して、ESB Toolkitに「触れる」ことができるようにすることです。 BizTalkに精通している人は、SendPortのフィルターを使用して、あるフォルダーから別のフォルダーにファイルを転送する例をおそらく読んでいるでしょう。 この投稿では、ESB Toolkitの静的ルーティングを使用して例を繰り返しています。

前提条件

開発には、BizTalk Server 2010とVisual Studio 2010が使用されます。

開発の前に、Visual Studio用のESB Toolkitとそのコンポーネントをインストールする必要があります。 インストールはMicrosoftのWebサイトで説明されています。リンクは投稿の最後にあります。

準備する

最初に、開発で使用する新しいアプリケーションを準備します。





アプリケーションにEsbToolkitTestという名前を付けましょう。





Referencesで、Microsoft.Practices.ESBアプリケーションへのリンクを追加する必要があります。





作成したアプリケーションで、受信ポートを作成し、受信場所を追加します。









フォルダーからファイルを収集するように受信場所を構成します。 たとえば、C：\ ESB \ input。





BizTalkユーザーには、このフォルダーに対する読み取りおよび書き込み権限が必要であることを忘れないでください。 または、[認証]タブで別のユーザーに代わってアクセスを構成します。



動的なSendPortを作成することも必要です。







送信ポートフィルタで次のパラメータを設定します。





これらのパラメーターにより、ポートは旅程からメッセージを受信できます。 ここでServiceNameはオプションであることに注意してください。

これで準備は完了です。旅程表を作成できます。

旅程を作成する

ルート（旅程）は、ESB Toolkitの主要コンポーネントです。 彼らの助けにより、私たちはメッセージに何が起こるかを決定します。 コンポーネントをインストールした後、多くのタイプのプロジェクトでルートを作成できます。 この例では、旅程プロジェクトにルートを作成します。

そのため、Visual Studioで新しいプロジェクトを作成します。 [BizTalkプロジェクト]タブで、BizTalk ESB Itinerary Designerプロジェクトが利用可能になります。 ルートにTestItineraryという名前を付けましょう。





そのようなプロジェクトテンプレートがない場合は、ESB Toolkitを使用してフォルダーからインストールする必要があります。 私のテンプレートはフォルダーC：\ Program Files \ Microsoft BizTalk ESB Toolkit 2.1 \ Tools \ Itinerary Designerにあります。 テンプレートは、Microsoft.Practices.Services.Itinerary.DslPackage.vsixファイルを実行してインストールされ、その後Visual Studioに表示されます。



作成されたプロジェクトでは、TestItinerary.ititneraryルートが既に追加されているはずです。 ダブルクリックして旅程デザイナを開きます。 当然のことながら、現在コンポーネントは存在せず、空のグラデーションで満足しています。

左側のツールボックスに、使用可能なコンポーネントのリストが表示されます。





この例では、OnRamp、OffRamp、Itinerary Service、そしてもちろんConnectorが役立ちます。

On-Rampは、データソースおよびサービスコンテナーです。

旅程サービス-ここにルーティングロジックがあります。

オフランプは伝送コンポーネントです。 送信ポートにバインドする必要があります。 注意してください-ポートは動的でなければなりません 実際の住所はルート内で解決されます。



したがって、図に示すように、1つのオンランプ、2つの旅程サービス、1つのオフランプを旅程デザイナーエリアに転送し、コネクタで接続します。





2つのコンポーネントをコネクタで接続するには、まずツールボックスでコネクタをクリックし、最初のコンポーネントをクリックしてから2番目のコンポーネントをクリックする必要があります。 グラフィックエディターのアクティブユーザーには時々問題があります。 最初のコンポーネントから2番目のコンポーネントにコネクタを「プル」しようとします。 些細なことですが、不快な数分を配信できます。



次に、各コンポーネントと旅程自体を設定する必要があります。 OnRamp1コンポーネントを選択し、次のプロパティを処方します。





つまり データを受信するアプリケーションの受信ポートを指定し、コンポーネントの名前をTestOnRampに変更して、Extenderを指定します。 オンランプにエクステンダーを選択するたびに、「オンランプESBエクステンダー」が1つしか使用できない場合、それは明らかではありません。 どうやら、状況によっては他のオプションがあるかもしれませんが、私はこれに遭遇していません。



Extenderを選択するまで、一部のプロパティは表示されないことに注意してください。

コンポーネントのプロパティの設定に関するアドバイス-現在表示されているプロパティを示します。一部のプロパティはまだ利用できないという事実に注意を払わないでください-それらは充填プロセス中に表示されます。 これは、プロパティでは多くの場合コンポーネントのタイプを指定する必要があり、タイプごとにプロパティのセットが異なるためです。



On-Rampの後、ItineraryService1に移動します。 次のプロパティを設定します。





つまり オンランプがこのサービスのコンテナになり、エクステンダーがメッセージングエクステンダーになります。 [サービス名]で、Microsoft.Practices.ESB.Services.Routingを指定します-このサービスはルーティングを担当します。 コンポーネントの名前を「Routing」に変更します。



プロパティの定義に加えて、ルーティングサービスにリゾルバーを追加する必要があります。 私たちの場合、アドレスを解決します。 リゾルバーを静的にします-そのプロパティは厳密に登録され、動的に変更されません。

したがって、ルーティングサービスを右クリックして、[追加]-> [リゾルバー]を選択します。





コンポーネント全体ではなく、その特定のリゾルバーのコンテキストメニューを呼び出すと、次のメニューが表示されます。





ここで強調表示されている項目は前の項目と似ており、違いはありません。

リゾルバに「staticResolver」という名前を付け、次のプロパティを設定します。





BizTalkユーザーには、トランスポートの場所で指定されたフォルダーへの書き込みアクセス許可が必要であることを思い出します。 静的リゾルバーを使用すると、SendPortプロパティをある程度詳細に設定できますが、たとえば、トランスポートタイプと宛先アドレスで十分です。

確認したルーティングサービスのすべてのプロパティ。 オフランプコンポーネントに移動します。 ItineraryService2コンポーネントは現在スキップしています。

オフランプコンポーネントの場合、次のプロパティを設定します。





つまり オフランプを以前に作成した送信ポートに結び付けました。 オフランプでは、より調和のとれた名前「TestOffRamp」も付けました。

それでは、ItineraryService2コンポーネントに移りましょう。 このコンポーネントは、オフランプサービスの役割を果たします。 次のプロパティを設定します。





つまり これはTestOffRampのオフランプサービスであることを示し、名前を変更しました。

これですべて、構成したすべてのコンポーネント、およびItinirary Designerは次のようになります。





旅程自体のプロパティを設定するために残っています。 これを行うには、コンポーネントのない場所をクリックしてF4を押します。 次のプロパティを設定します。





変更したプロパティをさらに詳しく調べてみましょう。

1. Model Exporter-Database Itinerary Exporter、つまり ルートはXMLにエクスポートされませんが、すぐにデータベースにエクスポートされ、そこからBizTalkが取得します。

2.暗号化証明書が必要-偽。 今は必要ありません。

3.旅程ステータス-配備済み。 公開されたルートを離れると、データベース内に存在しますが、利用できなくなります。 つまり BizTalkは呼び出すことができません。

また、Nameプロパティに注意する必要があります。これは、検索するルートの名前です。 それをクリップボードにコピーします-これは私たちにとって今役に立つでしょう。

作成したルートを保存し、コンポーネントのない場所を右クリックして、「モデルのエクスポート」アイテムを選択します。 これで、ルートがデータベースにエクスポートされ、BizTalkから呼び出すことができます。

受信ポートを構成する

もう一度、BizTalk Server管理コンソールに移動し、作成した受信場所のプロパティを開きます。 パイプラインは変更せず、PassThruReceiveのままでした。 それを変更し、旅程の選択をカスタマイズします。

パイプラインItinerarySelectReceivePassthroughを選択し、そのプロパティを開きます。

「ステージ1：デコード-コンポーネント：ESB旅程セレクター」セクションで、旅程を選択するためのプロパティを指定する必要があります。

ItineraryFactKeyでResolver.Itineraryを指定し、ResolverConnectionString-ITINERARYで指定します。\\ name = TestItinerary;





Nameパラメーターは、ルートの名前を設定します。 静的ルート選択を使用しましたが、たとえばビジネスルールに基づいて動的ルートを選択することもできます。

開始、終了、結論

BizTalk Server管理コンソールでアプリケーションを起動します。

C：\ ESBフォルダーにテストドキュメントを作成します。 たとえば、これ：

<?xml version="1.0" encoding="utf-8"?>

Hello world









ドキュメントをフォルダーC：\ ESB \ inputにコピーし、フォルダーC：\ ESB \ outputに表示される様子を確認します。

すべて、私たちのアプリケーションは機能しました、あなたは喜ぶことができます。

この例を請う最初の結論-ESB Toolkit-は面倒なものであり、同じ結果をはるかに簡単に達成できます。 ただし、ここで考慮する必要があるのは、ここで静的に設定したすべてのものを動的に決定できることです。 つまり タスクを少し複雑にするだけで、動的なコンテンツベースのルーティングと変換が可能になります。 また、ルート自体の選択も動的になる可能性があります。 このトピックが興味深い場合は、次の投稿でビジネスルールに基づいた動的なソリューションの例を示します。

最も重要なリンク

「便利なリンク」と呼びたかったのですが、役に立つのは1つだけだとわかりました。

MicrosoftのESBツールキット

すべての最も重要なESBツールキットが含まれており、それが何であるかが書かれており、ドキュメントへのリンクとツールキットのダウンロードが提供されています。 ところで、私はポスターをダウンロードすることをお勧めします-非常に便利で視覚的なものです。 英語のリソース。 残念ながら、ロシアのアナログは見つかりませんでした。