Web サービス・エンドポイント・アドレスは、クライアント・アプリケーションが Web サービス API にアクセスするために
指定する必要のある URL です。エンドポイント・アドレスは、クライアント・アプリケーション用の
プロキシー・クライアントを生成するためにエクスポートする WSDL ファイルに
書き込まれます。
このタスクを実行する理由と実行時期
使用する Web サービス・エンドポイント・アドレスは
、WebSphere® サーバーの構成によって
異なります。
- シナリオ 1. WebSphere サーバーが 1 台だけの場合。指定する WebSphere エンドポイント・
アドレスは、サーバーのホスト名とポート番号です (例: host1:9080)。
- シナリオ 2. 複数のサーバーで構成される WebSphere クラスターの場合。
指定する WebSphere エンドポイント・
アドレスは、Web サービス API をホスティングするサーバーのホスト名とポートです (例: host2:9081)。
- シナリオ 3. Web サーバーをフロントエンドとして使用する場合。指定する WebSphere エンドポイント・
アドレスは、Web サーバーのホスト名とポートです (例: host:80)。
デフォルトでは、Web サービス・エンドポイント・アドレスの形式は protocol://host:port/context_root/fixed_path です。
各部の意味は、次のとおりです。
- protocol。クライアント・アプリケーションと
WebSphere サーバー間で使用される通信プロトコル。デフォルト・プロトコルは HTTP です。代わりに、もっと安全な HTTPS (HTTP over SSL) プロトコルを使用することもできます。HTTPS を使用することをお勧めします。
- host:port。Web サービス API をホスティングするマシンへのアクセスに使用する
ホスト名とポート番号。この値は、クライアント・アプリケーションが
アプリケーションに直接アクセスするか、Web サーバー・フロントエンド経由でアクセスするかなど、WebSphere サーバー構成によって異なります。
- context_root。コンテキスト・ルートには、任意の値を
選択できます。ただし、選択する値は個々の WebSphere セル内で固有でなければなりません。
デフォルト値は、「node_server/cluster」サフィックスを使用して、
ネーミング競合のリスクを回避しています。
- fixed_path は、/sca/com/ibm/bpe/api/BFMWS (Business Flow Manager API の場合) または /sca/com/ibm/task/api/HTMWS (Human Task Manager API の場合) のどちらかで、変更することはできません。
Web サービス・エンドポイント・アドレスは、最初は、ビジネス・プロセス・コンテナーまたはヒューマン・タスク・コンテナーの構成時に指定されます。
このタスクのステップ
- 管理者権限のあるユーザー ID で、管理コンソールにログオンします。
- を選択します。
注: を選択して、使用可能なすべてのエンタープライズ・アプリケーションのリストを表示することもできます。
- SCA モジュールまたはアプリケーションのリストから、
「BPEContainer」(ビジネス・プロセス・コンテナーの場合) または「TaskContainer」(ヒューマン・タスク・
コンテナーの場合) を選択します。
- 「追加プロパティー」リストから、
「HTTP エンドポイント URL 情報を提供 (Provide HTTP endpoint URL information)」を選択します。
- リストからデフォルトのプレフィックスのいずれか 1 つを選択するか、カスタム・プレフィックスを
入力します。 クライアント・アプリケーションを、Web サービス API をホスティングする
アプリケーション・サーバーに直接接続する場合は、デフォルト・プレフィックス・リストの
プレフィックスを使用します。そうでない場合は、カスタム・プレフィックスを指定します。
- 「適用」をクリックして、選択したプレフィックスを
SCA モジュールにコピーします。
- 「OK」をクリックします。 URL 情報が
ワークスペースに保管されます。
結果
管理コンソールで現在の値を
表示できます (例えばビジネス・プロセス・コンテナーの場合は、
)。
エクスポートされた WSDL ファイルでは、soap:address エレメントの location 属性に、
指定した Web サービス・エンドポイント・アドレスが含まれています。以下に例を示します。
<wsdl:service name="BFMWSService">
<wsdl:port name="BFMWSPort" binding="this:BFMWSBinding">
<soap:address location=
"https://myserver:9080/WebServicesAPIs/sca/com/ibm/bpe/api/BFMWS"/>