Cisco WebDialer ガイド Version 1.0(3) Cisco CallManager Release 3.3(3)

デスクトップベースのクライアント アプリケーション コール フロー

図 3-1は、Microsoft Outlook プラグインなどのクライアント アプリケーションから WebDialer Servlet に対する発信コールのコール フローを示しています。 ユーザはクライアント アプリケーションのアドレス帳で、 ダイヤル または 電話をかける 操作を行います。 ユーザが初めて電話をかける場合、アプリケーションにはそのユーザに関する認証情報も設定情報もありません。

図 3-1 クライアントベース アプリケーションの場合の Cisco WebDialer コール フロー

ユーザが初めて電話をかける場合は、次のようなフローになります。

1. クライアントは設定された WebDialer Servlet に makeCallSoap 要求を送信します。

2. WebDialer Servlet はユーザの認証を試みます。図 3-1 では、認証情報が不完全であるかまたは存在しないために、認証に失敗したことが示されています。

3. WebDialer Servlet は認証失敗応答をクライアント アプリケーションに送信します。

4. クライアント アプリケーションは、ユーザ ID とパスワードの入力を求めるダイアログボックスをユーザのコンピュータ画面に表示します。 ユーザはこの情報を入力して［ サブミット］ ボタンをクリックします。 この時点で、今後アプリケーションが呼び出される場合に備えて、ユーザ ID とパスワードが保存されます。

5. アプリケーションは再送 SOAP 要求を WebDialer Servlet に送信します。 要求にはユーザに関する資格情報が含まれます。

6. WebDialer Servlet がユーザを認証します。

7. WebDialer Servlet は要求内に不足している設定情報を読み取ります。

8. WebDialer Servlet はクライアント アプリケーションに設定エラー メッセージを返します。

9. クライアント アプリケーションは getConfigSoap 要求を WebDialer Servlet に送信します。

10. WebDialer Servlet は電話帳に保管されたユーザの設定情報を使用して応答します。

11. クライアント アプリケーションは、ユーザに設定の選択またはアップデートを求める 設定ダイアログボックスをユーザのコンピュータ場面に表示します。 ユーザはこの情報を入力して［ サブミット］ ボタンをクリックします。 今後アプリケーションが呼び出される場合に備えて、ユーザの設定情報が保存されました。

12. クライアントは makeCallSoap 要求を WebDialer Servlet に再送信します。 この要求にはユーザの設定情報が含まれます。

13. WebDialer Servlet はユーザを認証し、makeCallSoap 要求に含まれる情報を使用して電話番号をダイヤルします。 クライアントに成功または失敗のメッセージを返します。

（注） 次の場合、コール フローは直接、12. に進みます。

• アプリケーションのインストール時に、資格情報および設定情報がすでに保存されている場合

• ユーザによる後続の要求すべて

ブラウザベースのアプリケーション コール フロー

図 3-2 は、HTTP ベースのブラウザ アプリケーションを使用した場合のコール フローを示しています。このようなアプリケーションには、ディレクトリ検索ページ、個人用アドレス帳、または Cisco CallManager に組み込まれた Cisco CallManager ディレクトリ検索ページ（directory.asp）などがあります。

ユーザはクライアント アプリケーションのアドレス帳で、 ダイヤル または 電話をかける 操作を行います。 ユーザが初めて電話をかける場合、アプリケーションにはそのユーザに関する認証情報も設定情報もありません。

ユーザが初めて電話をかける場合は、次のようなフローになります。

1. クライアントは設定された WebDialer Servlet に makeCall HTTP 要求を送信します。 クエリー文字列には通話先の番号が含まれます。

2. WebDialer Servlet がユーザを認証します。 認証情報が不完全であるかまたは存在しないため、認証は失敗します。

（注） ユーザの資格情報が要求と共に送信される場合、認証は成功し、コール フローは直接 7. に進みます。

3. WebDialer Servlet は、ユーザ認証のための認証ダイアログをクライアント ブラウザに送信します。

4. ユーザはユーザ ID とパスワードを入力して［ サブミット］ ボタンをクリックします。

5. クライアントはユーザの資格情報を含む makeCallHTTP 要求を WebDialer Servlet に送信します。

6. WebDialer Servlet がユーザを認証します。

7. WebDialer Servlet は要求と共に送信された Cookie 内の設定情報を読み取ります。

8. 要求が初めて行われた場合、Servlet は応答に Cookie を含めてクライアントのブラウザに送信します。 クライアントの資格情報を含んだ Cookie はクライアントのブラウザに保存されます。 クライアントの資格情報は、ユーザ ID、IP アドレス、および要求時刻です。

9. ユーザは設定ダイアログボックスにアップデート内容を入力して［ サブミット］ ボタンをクリックします。

10. クライアントのブラウザは WebDialer Servlet に makeCall HTTP 要求を送信します。 要求には、資格情報および設定情報がパラメータ形式で入っている Cookie が含まれます。

11. WebDialer Servlet は資格情報を使用してユーザを認証し、設定情報をメモリに保存します。

12. WebDialer Servlet は makeCall 確認ダイアログを Cookie に保存された設定情報と共にクライアントのブラウザに送信します。 Cookie は今後呼び出される場合に備えて、クライアントのブラウザに保存されます。

13. ユーザのコンピュータ画面に［コールの開始］ ダイアログボックスが表示されます。 ユーザは、別の makeCall HTTP 要求を WebDialer Servlet に送信する［ ダイヤル］ ボタンをクリックします。

14. WebDialer Servlet は Cookie 内の資格情報を使用してユーザを認証し、Cookie から設定情報を取得して電話をかけます。

15. Servlet は、通話を終了するために endCall 確認ダイアログをユーザに送信して応答します。 End Call ダイアログボックスがユーザのコンピュータ画面に表示され、サービス パラメータに設定した時間だけ表示され続けます。

後続の要求のコール フローはすべて 12. で始まり、15. で終わります。

図 3-2 ブラウザベース アプリケーションの場合の Cisco WebDialer コール フロー

SOAP over HTTP インターフェイス

Cisco WebDialer の SOAP インターフェイスにアクセスするには、「Cisco WebDialer WSDL」の Cisco WebDialer Web Service Definition Language（WSDL）を使用します。

makeCallSoap

makeCallSoap インターフェイスは、サービス名 WebdialerSoap について、URL http://ipaddress/wdsoap/servlet/rpcrouter への SOAP 要求を開始することによってアクセスします。 この URL で、ipaddress は Cisco CallManager サーバの IP アドレスです。 この SOAP インターフェイスは Microsoft Outlook プラグインなどのプラグイン クライアントに使用されます。

パラメータ

結果

戻り値とそのデータ型については、「Cisco WebDialer WSDL」を参照してください。

endCallSoap

endCallSoap インターフェイスは、サービス名 WebdialerSoap について、
URL http://ipaddress/wdsoap/servlet/rpcrouter への SOAP 要求を開始することによってアクセスします。 この URL で、ipaddress は Cisco WebDialer を設定した Cisco CallManager サーバの IP アドレスです。

この SOAP インターフェイスは Microsoft Outlook アドインなどのプラグイン ベースのクライアントに使用されます。

パラメータ

結果

戻り値とそのデータ型については、「Cisco WebDialer WSDL」を参照してください。

getProfileSoap

getProfileSoap インターフェイスは、サービス名 WebdialerSoap について、
URL http://ipaddress/wdsoap/servlet/rpcrouter への SOAP 要求を開始することによってアクセスします。 この URL で、ipaddress は Cisco WebDialer を設定した Cisco CallManager サーバの IP アドレスです。

この SOAP インターフェイスは Microsoft Outlook アドインなどのプラグイン ベースのクライアントに使用されます。

パラメータ

結果

戻り値とそのデータ型については、「Cisco WebDialer WSDL」を参照してください。

isClusterUserSoap

isClusterUserSoap インターフェイスは、サービス名 WebdialerSoap について、
URL http://ipaddress/wdsoap/servlet/rpcrouter への SOAP 要求を開始することによってアクセスします。 この URL で、ipaddress は Cisco WebDialer を設定した Cisco CallManager サーバの IP アドレスです。

この SOAP インターフェイスは Microsoft Outlook アドインなどのプラグイン ベースのクライアントに使用されます。Cisco WebDialer がネットワーク上にインストールされているさまざまな場所に通話をリダイレクトする、Redirector Servlet と同様の機能性が必要なマルチクラスタ アプリケーションに使用されます。 アプリケーションはこのインターフェイスを使用してユーザにサービスを提供している Cisco WebDialer の場所を見つけて確認します。この後に、その Cisco WebDialer に対する makeCall、endCall または getProfile 要求が続きます。

パラメータ

結果

戻り値とそのデータ型については、「Cisco WebDialer WSDL」を参照してください。

HTML over HTTP インターフェイス

この項では、HTML over HTTP インターフェイスについて説明します。

makeCall

makeCall インターフェイスは、カスタマイズされた電話帳検索アプリケーションで使用されます。 また、Cisco CallManager に組み込まれているディレクトリ検索ページ（directory.asp）でも使用されます。 makeCall インターフェイスは、URL http://ipaddress/webdialer/Webdialer への HTTP 要求を開始することによってアクセスします。 この URL で、ipaddress は Cisco WebDialer を設定した Cisco CallManager サーバの IP アドレスです。

このインターフェイスは、ブラウザが Cookie を受け入れるブラウザベースのアプリケーションで使用されます。 ブラウザで Cookie を使用できない場合、ユーザ プロファイルはそのセッションの間だけ存在します。 ディレクトリ検索ページの有効化に使用するスクリプトの例は、「JavaScript の例」を参照してください。

パラメータ

結果

makeCallProxy

makeCallProxy インターフェイスは、URL http://ipaddress/webdialer/Webdialer?cmd=doMakeCallProxy への HTTP 要求を開始することによってアクセスします。 このインターフェイスは、ブラウザが Cookie を受け入れるブラウザベースのアプリケーションで使用されます。 ブラウザで Cookie を使用できない場合、ユーザ プロファイルはそのセッションの間だけ存在します。

makeCallProxy インターフェイスは個人用アドレス帳などのアプリケーションで使用され、http://cmserver/CCMUser の CCMUser ページ内で定義されます。 アプリケーションの資格情報を使用し、プロキシとしてユーザに代わって通話を開始します。 これらのユーザは、CCMUser ページにアクセスする前に自身を認証しているため、ユーザ ID とパスワードの再入力は求められません。 アプリケーションは、プロキシ ユーザのユーザ ID とパスワードを要求内でクエリー文字列形式で送信するか、または POST メッセージ本文内のパラメータとして送信します。

ディレクトリ検索ページの有効化に使用するスクリプトの例は、「JavaScript の例」を参照してください。

パラメータ

結果