|
|
メッセージ フローは、プロキシ サービスの実装を定義します。
[メッセージ フローの編集] アイコンをクリックします。 
[プロキシ サービス] アイコン) が表示されます。これが、プロキシ サービスの開始ノードです。このアイコンをクリックして、メッセージ フローの作成を開始します。
このページで、メッセージ フローを作成するために実行できる作業の詳細については、「[メッセージ フローの編集] ページ」を参照してください。
[メッセージ フローの編集] ページを使用して、プロキシ サービスのメッセージ フローを作成します。
[メッセージ フローの編集] ページの左側のナビゲーション ペインに、メッセージ フロー内のノードとオブジェクトのツリー ビューが表示されます。オブジェクトの詳細が別のページで定義されている場合は、オブジェクトの名前をクリックして、関連付けられているページを表示できます。
右側のペインには、メッセージ フローを作成するためのフィールドが表示されます。メッセージ フローがまだ定義されていない場合、ペインには、サービスの開始ノードを示す 1 つの [プロキシ サービス] アイコンが含まれます。アイコンをクリックして、サービスのパイプライン ペア ノード、ルート ノード、条件付きブランチ、オペレーション ブランチ、およびエラー処理を追加します。
ページにオブジェクトを追加すると、そのオブジェクトを示すアイコンがページに表示されます。オブジェクト間の関係は、線と境界を示す四角形で示されます。[メッセージ フローの編集] ページのアイコンをクリックすると、そのオブジェクトで実行できるアクションのメニューが表示されます。メニューに含まれるオプションは、コンテキストに応じて異なります。アイコンとオプションの完全なリストについては、表 18-1 を参照してください。
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
[ステージ コンフィグレーションの編集] ページを使用して、メッセージ フローのパイプライン ステージ、エラー ハンドラ ステージ、およびルート ノードにアクションを追加します。
ステージに追加できるすべての種類のアクションの操作手順については、「メッセージ フローでのアクションの追加と編集」を参照してください。
メッセージ フローには、パイプライン ペア ノード (プロキシ サービス、またはサービスの処理用の要求パイプラインと応答パイプライン) と、ステージ、パイプライン、およびプロキシ サービスに対して定義できるエラー ハンドラをゼロ個以上入れることができます。パイプラインは、1 つまたは複数のステージを持つことができ、ステージはアクションを持ちます。
以下の手順は、「メッセージ フローの作成、編集、および表示」の説明に従って、[メッセージ フローの編集] ページで、すでにメッセージ フローを編集していることを前提としています。
メッセージ フローにパイプライン ペア ノードを追加するには
[プロキシ サービス] アイコンをクリックしてから、[パイプライン ペアの追加] をクリックします。
[パイプライン ペア ノード] アイコンをクリックし、[名前とコメントの編集] をクリックします。| 注意 : | パイプライン名やルート ノード名を変更すると、パイプライン カウンタがゼロにリセットされるので、[モニタ] モジュールの [ダッシュボード] ページに表示されるメッセージの数と他のコンポーネントのメッセージ数との相関関係がなくなる可能性があります。これは、Oracle Service Bus では、いったん削除して再作成するアクションとして名前の変更を処理しているためです。これらのメッセージ数は、サービスのモニタ間隔と同じ時間が経過した後に再び関連付ける必要があります。 |
ブランチ ノードを使用すると、可能ないくつかのパスのうちの 1 つに限定して処理を進めることができます。分岐は、XPath ベースの切り替えテーブルに基づいて実行されます。表の各ブランチは、条件 (たとえば、<500) を指定し、これが単一の XPath 式 (たとえば、$body の /ns: PurchaseOrder/ns:totalCost) に対してメッセージ フローの降順に評価されます。最初に満たされた条件によって、進むべきブランチが決定されます。満たされる分岐条件がない場合は、デフォルトのブランチに進みます。ブランチ ノードでは、メッセージ フロー内にいくつかの子孫を持つことができます (デフォルトのブランチを含め各ブランチに 1 つずつ)。
プロキシ サービスが WSDL に基づいておらず、複数のドキュメント タイプを入力として受信する場合は、条件付きブランチ ノードを使用することを検討してください。
条件付きブランチ処理は、単純でありながらユニークな文字列値のタグが付いたブランチをまとめたルックアップ テーブルを基準に行われます。メッセージ コンテキストの変数をそのノードのルックアップ変数として指定し、実行時に、この値を使用してどのブランチに進むかが判断されます。ルックアップ変数に一致するブランチがない場合は、デフォルトのブランチに進みます。ブランチ ノードに到達する前にルックアップ変数の値を設定するように、プロキシ サービスを設定する必要があります。
以下の手順は、「メッセージ フローの作成、編集、および表示」の説明に従って、[メッセージ フローの編集] ページで、すでにメッセージ フローを編集していることを前提としています。
[パイプライン ペア ノード] アイコンまたは 
[ブランチ ノード] アイコンをクリックして、[条件付きブランチ ノードの作成] をクリックします。条件付きブランチ ノードが追加され、挿入したブランチ ノードの後の既存のノードが、新しい条件付きブランチ ノードのデフォルト ブランチに移動します。
[条件付きブランチ] アイコンをクリックし、[ブランチの編集] をクリックします。[ブランチ ノードの編集] ページが表示されます。
メッセージ フローで Web Services Description Language (WSDL) ベースのプロキシ サービスを定義する場合、オペレーション固有の処理が必要になります。Oracle Service Bus では、オペレーションに基づくブランチ ノードを手動でコンフィグレーションする代わりに、オペレーションに基づいて自動的に分岐するようにコンフィグレーションされた、最小限のブランチ ノードが用意されています。つまり、オペレーション ブランチ ノードをメッセージ フローに作成すると、Oracle Service Bus Console では、WSDL に定義されたオペレーションがブランチ ノード コンフィグレーション ページに表示されるため、これらのオペレーションに基づいて分岐ロジックをすばやく構築できます。
ブランチ ノードを使用すると、可能ないくつかのパスのうちの 1 つに限定して処理を進めることができます。分岐は、XPath ベースの切り替えテーブルに基づいて実行されます。表の各ブランチは、条件 (たとえば、<500) を指定し、これが単一の XPath 式 (たとえば、$body の /ns: PurchaseOrder/ns:totalCost) に対してメッセージ フローの降順に評価されます。最初に満たされた条件によって、進むべきブランチが決定されます。満たされる分岐条件がない場合は、デフォルトのブランチに進みます。ブランチ ノードでは、メッセージ フロー内にいくつかの子孫を持つことができます (デフォルトのブランチを含め各ブランチに 1 つずつ)。
以下の手順は、「メッセージ フローの作成、編集、および表示」の説明に従って、[メッセージ フローの編集] ページで、すでにメッセージ フローを編集していることを前提としています。
[パイプライン ペア ノード] アイコンまたは [ブランチ ノード] アイコンをクリックして、[オペレーション ブランチ ノードの作成] をクリックします。オペレーション ブランチ ノードが追加され、挿入したブランチ ノードの後の既存のノードが、新しいオペレーション ブランチ ノードのデフォルト ブランチに移動します。
[オペレーション ブランチ] アイコンをクリックし、[ブランチの編集] をクリックします。[ブランチ ノードの編集] ページが表示されます。
以下の手順は、「メッセージ フローの作成、編集、および表示」の説明に従って、[メッセージ フローの編集] ページで、すでにメッセージ フローを編集していることを前提としています。
[パイプライン ペア ノード] アイコンの左側にあるプラス記号クリックしてパイプライン ペア ノードを展開します。パイプライン ペアには、
[要求パイプライン] および 
[応答パイプライン] が含まれています。
[ステージ」 アイコンをクリックし、[ステージの編集] をクリックします。「メッセージ フローでのアクションの追加と編集」を参照してください。 [ステージ] アイコンをクリックし、[ステージへのエラー ハンドラの追加] をクリックします。「ステージへのエラー ハンドラの追加」を参照してください。[メッセージ フローの編集] ページが表示されます。
以下の手順は、「メッセージ フローの作成、編集、および表示」の説明に従って、[メッセージ フローの編集] ページで、すでにメッセージ フローを編集していることを前提としています。
[パイプライン ペア ノード] アイコンをクリックして、[ルートの追加] をクリックします。
[ルート ノード] アイコンをクリックして、[名前とコメントの編集] をクリックします。必要に応じて名前と説明を変更し、[保存] をクリックします。 | 注意 : | パイプライン名やルート ノード名を変更すると、パイプライン カウンタがゼロにリセットされるので、[モニタ] モジュールの [ダッシュボード] ページに表示されるメッセージの数と他のコンポーネントのメッセージ数との相関関係がなくなる可能性があります。これは、Oracle Service Bus では、いったん削除して再作成するアクションとして名前の変更を処理しているためです。これらのメッセージ数は、サービスのモニタ間隔と同じ時間が経過した後に再び関連付ける必要があります。 |
[ルート ノード] アイコンをクリックし、[ルートの編集] をクリックします。[メッセージ フローの編集] ページが表示されます。ルート ノードに追加できるアクションの詳細については、以下のセクションを参照してください。
ステージおよびルート ノードの切り取り、コピー、貼り付けが行えます。
  
|
[アクションの追加] アイコンのみです。アイコンをクリックして作業を開始します。