onToolbarAgentCommandメソッド

このメソッドは、リスナーをサービスに登録して、エージェントに制御機能を提供します。このメソッドは、初期化中に1回のみ呼び出されます。

このメソッドのパラメータを次に示します:

パラメータ	説明
チャネル	メソッドがコールされるチャネルの名前。
channelType	メソッドがコールされるチャネルのタイプ。たとえば、チャネルがPHONEで、channelTypeが指定されていない場合、デフォルト値はORA_SVC_PHONEに設定されます。詳細は、チャネル・タイプ・データを参照してください。
エグゼクティブ	agentCommandPrototypeオブジェクトで使用されるツールバーによって実装される関数。

agentCommandPrototypeオブジェクトには次の属性があります:

属性	説明
eventId	サーバー側のメソッドのステータスを表します。値は成功およびエラーです。
コマンド	エラー・メッセージが含まれています。エラーがない場合、値は未定義です。エラー・メッセージ・コードの詳細は、エラー・メッセージを参照してください。次のコマンドを使用できます: getCurrentAgentState getActiveEngagements: outDataには、activeCount番号とエンゲージメント配列値が含まれている必要があります。次に例を示します : { activeCount:1, engagements:[ {eventId:"1234"} ] }. アクティブなエンゲージメントがない場合、エンゲージメント・パラメータは空の配列である必要があります。 makeAvailable makeUnavailable
チャネル	チャネル名。
チャネル・タイプ	チャネルのタイプ。
inData	コマンド・パラメータの名前と値のペアを含むオブジェクト。
result	コマンド・プロセスが正常に完了すると、ツールバーによって移入されます。失敗した場合は、理由が表示されます。
resultDisplayString	エラーがユーザーに表示され、ツールバーによって入力されました。
アウト・データ	コマンドで出力データが必要な場合は、ツールバーによって入力されます。
sendResponse	コマンド処理の完了時に使用されるコールバック関数。 sendResponseメソッドは、結果が移入された状態でコマンド・オブジェクトに渡される必要があります。また、outDataおよびresultDisplayString属性は、必要に応じて移入する必要があります。

メソッドを呼び出すサンプル・コードを次に示します:

<html>
<head>
<script type="text/javascript" src="http://domain:port/ora_support/js/mcaInteractionV1.js">
</script>
<script type="text/javascript">
   function agentCommandExecutor(command) {
       var cmd = command.command;
       switch(cmd) {
          case "getCurrentAgentState":
             command.outData = {
                'channel':command.channel,
                'channelType':command.channelType,
                'isAvailable':true,
                'isLoggedIn':true,
                'state':"AVAILABLE",
                'stateDisplayString':"Available",
                'reason':null,
                'reasonDisplayString':null};
             break;
          case "getActiveEngagements":
             command.outData = {'activeCount':1,'engagements' : [ {eventId:"1234"} ] };
             break;
          case "makeAvailable":
             alert("makeAvailable command invoked");
             break;
          case "makeUnavailable":
             alert("makeUnavailable command invoked");
       }
       command.result = 'success';
       command.sendResponse(command);
   }

   function registerAgentCommandListener() {
      svcMcaTlb.api.onToolbarAgentCommand("PHONE", "ORA_SVC_PHONE", agentCommandExecutor);
   }
</script>
<body>
   <input type="button" value="Register interaction command listener" onclick="registerAgentCommandListener()"/>
</body>
</html>