メディエーション・ポリシーの管理ウィジェットを使用して、
メディエーション・ポリシー およびポリシー・アタッチメントを WebSphere® Service Registry
and Repository (WSRR) に作成します。メディエーション・ポリシーを使用することにより、コンテキスト情報を使用してサービス対話を制御できます。
始める前に
- IBM Integration Designer を使用して、ポリシー解決メディエーション・プリミティブが含まれるモジュールを作成します。
- モジュールを WebSphere Enterprise
Service Bus (WebSphere ESB)
または IBM Business Process Manager にデプロイします。
- WebSphere ESB
または IBM Business Process Manager
に、使用する WSRR の定義があることを確認します。
- モジュールが格納されているエンタープライズ・アーカイブ (EAR) ファイルを WSRR にロードします。
- モジュール・ブラウザー・ウィジェットおよび
メディエーション・ポリシーの管理ウィジェットを含むビジネス・スペースを作成します。
このタスクについて
サービス要求を動的に制御できます。そのためには、
メディエーション・ポリシーを使用して、実行時にモジュール・プロパティーをオーバーライドします。このような
メディエーション・ポリシーは WSRR に格納されます。モジュールには 1 つ以上のメディエーション・ポリシーを定義でき、各メディエーション・ポリシーは 1 つ以上のモジュール・プロパティーをオーバーライドできます。必要に応じて、各ポリシー・アタッチメントに対して 1 つ以上のゲート条件を作成できます。サービス要求
の処理時には、ゲート条件がメッセージ内の条件値と比較されます。関連付けられたメディエーション・ポリシーを使用するには、すべてのゲート条件を満たす必要があります。
手順
- ビジネス・スペースにログオンし、モジュールに関連付けられているメディエーション・ポリシーを管理するために作成したスペースに
ナビゲートします。
- モジュール・ブラウザー・ウィジェットで、「メディエーション・ポリシー」を選択します。 メディエーション・ポリシーの管理ウィジェットが最新表示されます。既存のポリシー・アタッチメントがある場合は、それらが表示されます。
- 複数の WSRR 定義がある場合は、モジュールが使用する定義を選択します。
- 「新規ポリシー・アタッチメント」の名前を入力します。 メディエーション・ポリシー・アタッチメントは、メディエーション・ポリシーをモジュールに
関連付けます。WSRR では、メディエーション・ポリシーとポリシー・アタッチメントは
別個のオブジェクトです。
- 「作成」をクリックします。 メディエーション・ポリシーの管理ウィジェットが最新表示されます。ここで、
処理するプロパティーのグループと、新規メディエーション・ポリシーの名前を
指定できます。
- 「グループ名」を選択します。 各グループには、
モジュール・プロパティーが含まれています。プロパティー値をオーバーライドするグループを
選択します。
- 「新規ポリシー」フィールドに名前を入力します。 これは、作成してモジュールに関連付けるメディエーション・ポリシーの名前です。
- 「次へ」をクリックします。 メディエーション・ポリシーの管理ウィジェットが最新表示されます。これでアサーションおよびゲート条件を追加することができます。
注: ビジネス・スペースでメディエーション・ポリシー
を作成した後にアサーションを編集することはできません。したがって、
メディエーション・ポリシーを保存する前に、必要なアサーションをすべて
追加する必要があります。
- 1 つ以上のアサーションを作成します。 アサーションは、ポリシーがオーバーライドできるモジュール・プロパティーです。WSRR では、オーバーライド対象のモジュール・プロパティーはポリシー・アサーションとして表示されます。
注: ウィジェットでは、ポリシー・アタッチメントごとに少なくとも 1 つのアサーションが必要です。
- 「プロパティー名」を選択します。 この名前は、
プロパティーの別名です。別名は、メディエーション・フロー内でプロパティーを識別します。
- 「値」フィールドに適切な値を入力します。例えば、All、10、/body/input/address などです。 値が有効な場合は、実行時にこのポリシー値が優先されます。ポリシーが見つからない場合や不適切な場合は、プロモートされたプロパティー値がランタイム環境によって使用されます。
- 「アサーションの追加 (Add Assertion)」をクリックします。
- オプション: 1 つ以上のゲート条件を作成します。 ポリシーを使用するには、ゲート条件を満たす必要があります。WSRR では、ゲート条件はポリシー・アタッチメント・オブジェクトのユーザー・プロパティーです。
- 「ゲート条件名 (Gate condition name)」フィールドにゲート条件名を入力します。 ゲート条件の名前の前には、必ずストリング medGate_ が付きます。
- 「値」フィールドにゲート条件値を入力します。 ゲート条件値は、policy
condition name、operation、gate
value の 3 つの部分で構成されます。
- 入力する policy condition name は、モジュールのポリシー条件名にマップされている必要があります。
- operation には、=、!=、>、<、<=、または >= を指定できます。
- gate value は、比較対象の値です。(例えば、country = France)。
- 「ゲート条件の追加」をクリックします。
- オプション: アサーションまたはゲート条件を削除する場合は、該当するアサーションまたはゲート条件の削除アイコンをクリックします。 アサーションまたはゲート条件にカーソルを移動すると、行の末尾に十字型の削除アイコンが表示されます。
- 「保存」をクリックします。
タスクの結果
WSRR で、メディエーション・ポリシーとポリシー・アタッチメントが作成されます。
ポリシー・アタッチメントは、メディエーション・ポリシーをモジュールに結び付けます。
ゲート条件を追加した場合、WSRR はポリシー・アタッチメントにユーザー・プロパティーを作成します。このユーザー・プロパティーが条件を表します。