WebSphere® Service Registry and Repository (WSRR) に保持されているサービス・エンドポイント情報を検索するには、EndpointLookup ノードを使用します。指定した検索条件に一致するエンティティーがローカル環境に格納されます。ノード構成によっては、SOAP 要求ノードおよび HTTP 要求ノードが使用する、Web サービスの URL の宛先も設定できます。入力メッセージは変更されません。
EndpointLookup ノードは、WSDL によって記述された WSRR サービスに関連したサービス・エンドポイント情報を検索します。WSDL 定義は、指定されたポートで使用可能になっているインターフェース (portType とも呼ばれる) に関するサービスを定義します。WSDL ポートは、サービスにアクセスするために必要なエンドポイント情報を定義します。エンドポイントは、ノード・プロパティーによって定義されている検索条件に従って検索されます。また、オプションとして、実行時にローカル環境の定義によって補足または指定変更されます。詳細については、LocalEnvironment の指定変更を参照してください。
取得されたデータは、ローカル環境のツリーに配置され、後続のノードで使用可能となります。ノードが受信した入力メッセージは、変更されずに出力端末に伝搬されます。さらに、EndpointLookup ノードは、「マッチ・ポリシー」プロパティーの値に応じて、後続の SOAPRequest、SOAPAsyncRequest、または HTTPRequest ノードが使用する、宛先 URL を自動でセットアップできます。EndpointLookup ノードの処理を参照してください。これは、これらのノードが使用するローカル環境のオーバーライドを設定するノードによって実行されます。
EndpointLookup ノードは、メッセージ・フローのノード・パレットの「Web サービス」ドロワーにあり、WebSphere Message Broker Toolkit では、次のアイコンで表されます。

入力メッセージは、未変更のまま Out ターミナルに伝搬されます。ローカル環境ツリーは Out ターミナルに伝搬され、変換ノードによる次の処理で使用されます。ローカル環境の出力ツリーについて詳しくは、EndpointLookup ノード出力を参照してください。
サンプルに関する情報は、WebSphere Message Broker Toolkit に統合されているインフォメーション・センター、またはオンライン・インフォメーション・センターを使用する場合にのみ表示できます。サンプルは、WebSphere Message Broker Toolkit に統合されているインフォメーション・センターを使用する場合にのみ実行できます。
RegistryLookup ノードのプロパティーは、ローカル環境の設定を使って指定変更できます。検索条件の動的な定義を参照してください。
EndpointLookup ノードのインスタンスをメッセージ・フローに入れると、それを構成することができます。メッセージ・フロー・ノードの構成を参照してください。 ノードのプロパティーが、「プロパティー」ビューに表示されます。
EndpointLookup ノードのターミナルについては、次の表に説明されています。
| ターミナル | 説明 |
|---|---|
| In | ノードが処理するメッセージを受け入れる入力ターミナル。 |
| Failure | ノードの処理中にエラーが発生した時のメッセージのルーティング先となる出力ターミナル。 |
| Out | 一致したレジストリー・データを含む、未変更の入力メッセージおよび更新されたローカル環境の送信先となる出力ターミナル。 |
| NoMatch | 指定の検索条件に基づいて一致するエンティティーが見つからなかった場合の、入力メッセージの送信先となるターミナル。 |
以下の表は、ノード・プロパティーについて説明しています。 M の見出しの列は、プロパティーが必須 かどうかを示します (デフォルトが定義されていない場合に値を入力することが必要なら、アスタリスクのマークが付きます)。 C の見出しの列は、プロパティーが構成可能 (メッセージ・フローを BAR ファイルに追加してデプロイするとき、値を変更できる) かどうかを示します。
EndpointLookup ノードの「説明」プロパティーについては、次の表に説明されています。
| プロパティー | M | C | デフォルト | 説明 |
|---|---|---|---|---|
| ノード名 | いいえ | いいえ | ノード・タイプ: EndpointLookup | ノードの名前。 |
| 簡略説明 | いいえ | いいえ | なし | ノードの簡単な説明 |
| 詳細説明 | いいえ | いいえ | なし | メッセージ・フロー内のノードの目的を説明するテキスト |
EndpointLookup ノードの「基本」プロパティーについては、次の表に説明されています。
| プロパティー | M | C | デフォルト | 説明 | mqsiapplybaroverride コマンド・プロパティー |
|---|---|---|---|---|---|
| PortType 名 | いいえ | はい | なし | WebSphere Service Registry and Repository 定義の WSDL サービスの portType を固有に識別する名前タプル。 少なくとも 1 つのプロパティーが必要です。 3 つのプロパティー値をすべてブランクにすると、保存しようとしたときにエラー・メッセージが 表示されます。 | name |
| PortType ネーム・スペース | いいえ | はい | なし | namespace | |
| PortType バージョン | いいえ | はい | なし | portVersion | |
| ユーザー・プロパティー | いいえ | いいえ | なし | ユーザー定義プロパティーを照会で指定することができます。「追加」をクリックして、ユーザー・プロパティーを追加します。
ユーザー・プロパティーとは、WSRR 内のエンティティーをカタログするために使用される追加プロパティーのことです。「プロパティー名」 (大/小文字の区別があり、WSRR 内の追加プロパティーと一致します)、「プロパティー・タイプ」、および「プロパティー値」の各値を入力します。「プロパティー・タイプ」は、次の値のいずれかです。
これらの「ユーザー・プロパティー」および「種別」の各プロパティーは照会で使用し、WSDL のサービス・ポートを一意的に識別します。 |
|
| 種別 | いいえ | いいえ | なし | Web オントロジー言語 (OWL) 種別システム・プロパティー。各種別子が、OWL 内のクラスとなり、URI (Uniform Resource Identifier) を持ちます。 レジストリーで種別を使用すれば、オブジェクトの検索が容易になり、特定のシステムに固有のカスタム・オブジェクトを分かりやすくすることができます。 「追加」をクリックし、OWL 種別の完全修飾 OWL URI を完全に入力して、「種別」を追加します。例えば、特定のサービス・エンドポイントのライフ・サイクルの状態を定義できます。 これらの「ユーザー・プロパティー」および「種別」の各プロパティーは照会で使用し、WSDL のサービス・ポートを一意的に識別します。 |
|
| マッチ・ポリシー | はい | いいえ | 1 | 前述のプロパティーで指定した検索条件に一致するエンティティーが WSRR に複数含まれる場合があります。
「マッチ・ポリシー」が「1」に設定されている場合は、一致するエンティティーが最大で 1 つ返されます。「マッチ・ポリシー」が「すべて」に設定されている場合は、一致するエンティティーすべてが返されます。EndpointLookup ノード出力を参照してください。 「マッチ・ポリシー」を「1」に設定し、一致するエンティティーを 1 つ要求すると、取得されるエンドポイントの値は、SOAPRequest、SOAPAsyncRequest、または HTTPRequest の各ノードが使用する宛先 URL に対し、ローカル環境のオーバーライドとして設定されます。 |
| プロパティー | M | C | デフォルト | 説明 |
|---|---|---|---|---|
| イベント | なし | なし | なし | ノードに対して定義したイベントが、このタブに表示されます。デフォルトでは、メッセージ・フローのどのノードに対してもモニター・イベントは定義されません。ノードのモニター・イベントを作成、変更、または削除するには、「追加」、「編集」、および「削除」を使用します。詳しくは、モニター・プロパティーを使用したモニター・イベント・ソースの構成を参照してください。 「使用可能」チェック・ボックスを選択またはクリアすることによって、ここに表示されているイベントを使用可能および使用不可に設定できます。 |