ITK Switchboard の設定

概要

ITK Switchboard は、メッセージをルーティングする特殊な相互運用プロダクションです。次の図は、その基本的なアーキテクチャを示しています。

このプロダクションには、次の 2 種類のビジネス・ホストが含まれます。

• ITK リスナ。各リスナは、送信元のアプリケーションから SOAP メッセージを受信するビジネス・サービスです。通常、ITK Switchboard には 2 つのリスナが含まれています。1 つは、プロダクションの外部にあるアプリケーションを処理するもので、もう 1 つは、プロダクション内で生成されたメッセージを処理するものです。

  リスナごとに 1 つのポートが使用され、1 つのセキュリティ・ポリシーがあります。

• ITK コンシューマ。各コンシューマは、1 つの外部アプリケーションに SOAP メッセージを送信するビジネス・オペレーションです。

ITK Switchboard では、外部システムを表す総称としてシステムまたはアプリケーションという用語を使用します。ITK Switchboard を構成する際、Switchboard が使用するすべてのシステムを宣言します。システムの中には、Switchboard との間でメッセージの送信と受信の両方を行うことができるものもあります。つまり、一部のシステムについては、対応するリスナと対応するコンシューマの両方がプロダクションに含まれます。

ITK Switchboard プロダクションは、メッセージをルーティングするためのデータ駆動型の内部ロジックを提供します。このためにビジネス・ホストを使用しません。ルーティング・ロジックでは、Switchboard を構成する際に定義するサブスクリプション・ルールと配信ルールが使用されます。

リスナとコンシューマは、SOAP を介して次のように外部システムと通信します。

• SOAP メッセージは、Web Services-Addressing (WS-Addressing) 標準と Web Service-Security (WS-Security) 標準に従います。

  WS-Addressing ヘッダ要素は、メッセージの UUID、対応する SOAP アクション、メッセージの送信者、およびメッセージの指定受信者の確認を示します。

  WS-Security ヘッダ要素には、署名されたタイムスタンプ (有効期限付き) が含まれます。Switchboard は、送信元のアプリケーションの公開鍵を使用して、メッセージが本物であることを確認することができます。SOAP 本文全体に署名して暗号化することもできます。

  SSL/TLS も使用可能です。

• SOAP 本文には任意のコンテンツを含めることができます。コンテンツは、SOAP アクションと照合されます。

特定のコンテキストで特定の SOAP アクションを必要とするように Switchboard を構成します。Switchboard は、次のシステムを使用して、ルーティングするさまざまなメッセージを処理します。

• Switchboard は、UK NHS CfH ITK サービスと一致する一連のサービスを提供します。このドキュメントでは、これらを Web サービスやビジネス･サービスと区別するために、ITK サービスという語句を使用します。

  各 ITK サービスは SOAP アクションに対応します。

  各 ITK サービスには、Switchboard 内で使用される短いサービス名があります。また、受信要求に対する応答として必要とされる動作を示す動作タイプもあります。さらに、ITK サービスでは特定の要求メッセージ・クラスと応答メッセージ・クラスが使用されます。

• リスナを構成する際、各リスナが使用する ITK サービスを指定します。

• コンシューマを構成する際、各コンシューマが使用する ITK サービスを指定します。

• サブスクリプション・ルールと配信ルールを定義する際、各ルールで使用される ITK サービスを指定します。

その他の詳細は、クラス・リファレンスの EnsLib.ITK パッケージ内のクラスを参照してください。

はじめに

ITK Switchboard プロダクションの作成を開始する手順は次のとおりです。

1. 管理ポータルを使用して、新しい相互運用プロダクション対応ネームスペースを作成します。

2. 次の Web ページにアクセスします。

   http://localhost:port-number/csp/itk-namespace/EnsLib.ITK.Setup.UI.RegistryViewer.cls

   localhost は、ITK が実行されているサーバです。port-number は Web サーバ・ポートです。itk-namespace は、作成したネームスペースです。

   このページは、標準のプロダクション構成ページの特殊なバージョンです。上部にある 2 つのボタンを使用すると、送信者とコンシューマのどちらを表示するかを制御できます。

   ボタン	説明
   	システム、送信者、およびリスナを表示するには、このボタンをクリックします。
   	コンシューマ、サブスクリプション・ルール、および配信ルールを表示するには、このボタンをクリックします。

3. [新規作成] をクリックします。

4. 次の情報を指定します。

   • [パッケージ名] — プロダクション・クラスを格納するパッケージ。

   • [プロダクション名] — プロダクション・クラスの名前。

   • [プロダクションの説明] — プロダクションの説明 (オプション)。

5. [OK] をクリックします。

ITK サービスの定義

前述のように、Switchboard は、UK NHS CfH ITK サービスと一致する一連の ITK サービスを提供します。これらのサービスの構成データをインターシステムズのサポート窓口Opens in a new tabから入手し、指示に従ってロードします。

通常はこのデータを編集しませんが、編集した場合、ソリューションは ITK に準拠しなくなることがあります。このデータを編集する場合は、各 ITK サービスについて次の詳細を指定します。

システムの定義

各システムを定義するには、基本の Switchboard プロダクションを表示し、次の手順を実行します。

1. [送信者を表示] ボタン をクリックします。

2. [システム] の横にあるプラス記号 (+) をクリックします。

3. 以下の詳細を指定します。

   アプリケーション名

   必須項目。システムの一意の名前。

   システムごとに、関連するコンシューマ、リスナ、またはその両方を指定できます。これらの場合に適切な名前を選択する方法については、後述の説明を参照してください。

   アプリケーション・ルータ

   コンテンツベースのルーティングについてメッセージのコンテンツをコンシューマにマップするルールを含むビジネス・ルールの名前を指定します。

4. [OK] をクリックします。

リスナの定義

各リスナを定義するには、基本の Switchboard プロダクションを表示し、次の手順を実行します。

1. [送信者を表示] ボタン をクリックします。

2. [リスナ] の横にあるプラス記号 (+) をクリックします。

3. リスナの名前を指定します。これはビジネス・サービスです。

4. [OK] をクリックします。

5. このリスナに送信する送信者に対応する円をクリックします。

   左マウス・ボタンを押したまま、そこからリスナまで線をドラッグします。この操作によりダイアログ・ボックスが表示され、構成の詳細を指定できます。

6. この送信者からの必要な各サービスについて、次の手順を実行します。

   1. [ウェブサービス] ドロップダウン・リストからサービスを選択します。

   2. [呼び出しパターン] について次のいずれかの値を選択します。

      • 非同期

      • 同期

      • 導出

      このオプションは、サービスが要求/応答タイプである場合にのみ関係します。

   3. [ペイロードを検証] を無視します。

   4. [保存] をクリックします。

7. サービスの指定が完了したら、[OK] をクリックします。

コンシューマの定義

コンシューマを定義するには、基本の Switchboard プロダクションを表示し、次の手順を実行します。

1. [コンシューマを表示] ボタン をクリックします。

2. [コンシューマ] の横にあるプラス記号 (+) をクリックします。

3. [アプリケーション名] について、コンシューマ名を指定します。

4. [OK] をクリックします。

   新しいコンシューマが選択されていることを確認します。

5. [設定] タブで、[コンシューマ設定] セクションを展開します。

6. [サービス] の横にある検索ボタンをクリックします。

7. この送信者からの必要な各サービスについて、次の手順を実行します。

   1. [ウェブサービス] ドロップダウン・リストからサービスを選択します。

   2. [呼び出しパターン] について次のいずれかの値を選択します。

      • 非同期

      • 同期

      このオプションは、サービスが要求/応答タイプである場合にのみ関係します。

   3. [部分論理エンドポイント] について、このコンシューマで使用される Web サービスのベース・エンドポイントに追加する論理パスを指定します。ベース・エンドポイントは、ビジネス・オペレーションで (後ほど) 構成します。

   4. [部分物理エンドポイント] について、ビジネス・オペレーションで (後ほど) 構成するベース・エンドポイントに追加するオプションの物理パスを指定します。

   5. [保存] をクリックします。

8. サービスの指定が完了したら、[OK] をクリックします。

サブスクリプション・ルールの定義

サブスクリプション・ルールによって、指定されたサービスのすべてのメッセージが、指定された送信者から特定のコンシューマに送信されます。

サブスクリプション・ルールを定義するには、基本の Switchboard プロダクションを表示し、次の手順を実行します。

1. [コンシューマを表示] ボタン をクリックします。

2. このコンシューマに送信する送信者に対応する円をクリックします。

   左マウス・ボタンを押したまま、そこからコンシューマまで線をドラッグします。この操作によりダイアログ・ボックスが表示され、サブスクリプション・ルールの構成の詳細を指定できます。

3. サービスを選択し、[OK] をクリックします。

同じアプリケーションからの要求/応答サービスについて複数のサブスクライバを設定すると、エラーが発生します。

配信ルールの定義

配信ルールは、論理アドレスを指定できる配信エンベロープでラップされた要求に適用されます。 配信ルールには、アドレスによって指定されたシステムにペイロードをディスパッチする方法が記述されます。

配信ルールを定義するには、基本の Switchboard プロダクションを表示し、次の手順を実行します。

1. [コンシューマを表示] ボタン をクリックします。

2. コンシューマを選択します。

3. [設定] タブで、[コンシューマ設定] セクションを展開します。

4. [配信ルール] の横にある検索ボタンをクリックします。

5. このコンシューマの各配信ルールについて、次の手順を実行します。

   1. [ウェブサービス] ドロップダウン・リストからサービスを選択します。

   2. [配信モード] について次のいずれかの値を選択します。

      • 特権あり

      • 特権なし

      このオプションは、配信ルールを有効にするために必要なモードを表します。配信モードは、ビジネス・サービスによって設定されます。

      特権ありは、特権を保持して操作している場合にのみ、Switchboard がこのサービスをこのコンポーネントに提供するようにすることを意味します。これを検討する最適な方法は、データ・センタのエッジにある ITK Switchboard を考えることです。例えば、データ・センタの外にある外部システムと通信できるとします。ただし、内部システムのいずれかからのメッセージを処理する場合にのみ (これが特権を保持している状態です)、これらの外部システムと通信するようにします。

      一方、外部システムのいずれかからメッセージを受信する場合、その外部システムは他の外部システムと既に通信していると考えられます。このような場合は、メッセージを中継しないようにする必要があります (つまり、特権を保持しないで操作している場合は、これらのシステムにメッセージを送信しません)。

   3. [論理アドレス] について、SOAP メッセージの配信エンベロープ内のアドレスを指定します。

   4. [保存] をクリックします。

6. ルールの指定が完了したら、[OK] をクリックします。

ITK Switchboard プロダクションの調整

調整プロセスではルーティング・ルールが検証され、必要なビジネス･サービスとビジネス・オペレーションが作成されます。

プロダクションを調整するには、管理ポータルでプロダクション構成を表示し、[調整] ボタンをクリックします。

ITK Switchboard プロダクションの構成の完了

調整を実行したら、ビジネス･サービスとビジネス･オペレーションの設定を指定して構成を完了します。