メディエーション・ポリシーの管理ウィジェットを使用して、
既存のメディエーション・ポリシー をサービス・エンドポイントに関連付けます。メディエーション・ポリシーを使用することにより、コンテキスト情報を使用してサービス対話を制御できます。
始める前に
- IBM Integration Designer を使用して、ポリシー解決メディエーション・プリミティブが含まれるモジュールを作成します。
- モジュールを WebSphere® Enterprise
Service Bus (WebSphere ESB)
または IBM Business Process Manager にデプロイします。
- WebSphere ESB
または IBM Business Process Manager
に、使用する WSRR の定義があることを確認します。
- WSRR に、モジュールが格納されているエンタープライズ・アーカイブ (EAR) ファイル
をロードします。また、メディエーション・ポリシーを関連付けるサービスの WSDL 文書も
ロードします。
- サービス・ブラウザー・ウィジェット、メディエーション・ポリシーの管理ウィジェットなどの必要な管理ウィジェットを含むビジネス・スペースを作成します。
このタスクについて
サービス要求を動的に制御できます。そのためには、
メディエーション・ポリシーを使用して、実行時にモジュール・プロパティーをオーバーライドします。このような
メディエーション・ポリシーは WSRR に格納されます。モジュールで使用するサービスのために 1 つ以上の
メディエーション・ポリシーを定義でき、各メディエーション・ポリシーは 1 つ以上の
モジュール・プロパティーをオーバーライドできます。必要に応じて、各ポリシー・アタッチメントに対して 1 つ以上のゲート条件を作成できます。
サービス要求
の処理時には、ゲート条件がメッセージ内の条件値と比較されます。関連付けられたメディエーション・ポリシーを使用するには、すべてのゲート条件を満たす必要があります。
手順
- ビジネス・スペースにログオンし、サービスを管理するために作成したスペースに
ナビゲートします。
- サービス・ブラウザー・ウィジェットで、
正しい WSRR 定義が表示されない場合は、正しい WSRR 定義を
選択します。 WSRR の複数のインスタンス用の定義がアプリケーション・サーバーにある場合は、
各 WSRR で定義されているサービスを表示できます。 サービスのリストが
最新表示されます。
- メディエーション・ポリシーを関連付けるレベルを
選択します。 メディエーション・ポリシーは、サービス、エンドポイント、または操作のレベルで
関連付けることができます。 メディエーション・ポリシーの管理ウィジェットが最新表示されます。以下の
情報が表示されます。
- 選択したサービス、エンドポイント、または操作の名前。
- 選択した WSRR 定義。
- 選択したサービス、エンドポイント、または操作に対して存在する
すべてのポリシー・アタッチメント。
- 「新規ポリシー・アタッチメント」の名前を入力します。 ポリシー・アタッチメントは、メディエーション・ポリシーをターゲット・サービスに
関連付けます。WSRR では、メディエーション・ポリシーとポリシー・アタッチメントは
別個のオブジェクトです。
- 「作成」をクリックします。 メディエーション・ポリシーの管理ウィジェットが最新表示されます。ここで、
処理するプロパティーのグループと、そのグループ用の既存のメディエーション・ポリシーの名前を
指定できます。
- 「グループ名」を選択します。 各グループには、
モジュール・プロパティーが含まれています。プロパティー値をオーバーライドするグループを
選択します。
- 「既存の使用」をクリックします。
- 「ポリシーの選択」メニューからメディエーション・ポリシーを選択します。 表示されるメディエーション・ポリシーは、選択したグループに応じて
決まります。ターゲット・サービスは様々なモジュールから呼び出される可能性がある
ので、必ずしもターゲット・サービスに関連付けられているメディエーション・ポリシーが
サービス要求に影響を与えるとは限りません。メディエーション・ポリシーが
サービス要求に影響を与えるのは、選択したサービス、エンドポイント、または操作が
適切なモジュールによって呼び出された場合のみです。
適切なモジュールとは、メディエーション・ポリシーによってオーバーライドできる
プロパティーを持っているモジュールのことです。
- 「次へ」をクリックします。 メディエーション・ポリシーの管理ウィジェットが最新表示されます。これでゲート条件を追加することができます。
注: メディエーション・ポリシー
を作成した後にメディエーション・ポリシー・アサーションをビジネス・スペースで編集することはできません。ただし、
ゲート条件はメディエーション・ポリシー・アタッチメントに存在するので、新規ポリシー・アタッチメントを
作成するときにゲート条件を追加できます。
- オプション: 1 つ以上のゲート条件を定義します。 ポリシーを使用するには、ゲート条件を満たす必要があります。WSRR では、ゲート条件はポリシー・アタッチメント・オブジェクトのユーザー・プロパティーです。
- 「ゲート条件名 (Gate condition name)」フィールドにゲート条件名を入力します。 ゲート条件の名前の前には、必ずストリング medGate_ が付きます。
- 「値」フィールドにゲート条件値を入力します。 ゲート条件値は、policy
condition name、operation、gate
value の 3 つの部分で構成されます。
- 入力する policy condition name は、モジュールのポリシー条件名にマップされている必要があります。
- operation には、=、!=、>、<、<=、または >= を指定できます。
- gate value は、比較対象の値です。(例えば、country = France)。
- 「ゲート条件の追加」をクリックします。
- 「保存」をクリックします。
タスクの結果
WSRR では、選択されたメディエーション・ポリシーを選択されたサービス、エンドポイント、または操作に関連付ける
ポリシー・アタッチメントが作成されます。
メディエーション・ポリシーの管理ウィジェットが最新表示されて、新規ポリシー・アタッチメントがポリシー・アタッチメントの
リストに追加されます。