この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

onCustomEvent()

チャット中にカスタムイベントが実行されるとコールされる関数を登録します。API バージョン 29.0 以降で使用できます。

構文

1sforce.console.chat.onCustomEvent(chatKey:String, type:String, callback:Function)

引数

名前 説明
chatKey String カスタムイベントが実行されると関数をコールするチャットに関連付けられた chatKey
type String リスンするカスタムイベントの名前。これは、チャットウィンドウから送信されたカスタムイベントの名前と一致します。
callback function メソッドの完了時にコールされる JavaScript メソッド。

サンプルコード – Visualforce

1swfobject.registerObject("clippy.codeblock-1", "9");
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17<apex:page >
18    <apex:includeScript value="/support/console/29.0/integration.js"/>
19    <script type="text/javascript">
20        var eventHandler = function (result) {
21            alert('A new custom event has been received of type ' + result.type + ' and with data: ' + result.data );
22        }
23        //Get the value for 'myChatKey' from the sforce.console.chat.getDetailsByPrimaryTabId() or other chat methods. 
24        //These values are for example purposes only
25        var chatKey = 'myChatKey';
26        var type = 'myCustomEventType';
27        sforce.console.chat.onCustomEvent(chatKey, type, eventHandler);
28    </script>
29</apex:page>

応答

このメソッドは非同期であるため、コールバックメソッドのオブジェクトで応答を返します。応答オブジェクトには次のプロパティが含まれます。

名前 説明
type String このチャットに送信されたカスタムイベントのタイプ。チャットウィンドウからこのイベントを送信するために使用された liveagent.chasitor.sendCustomEvent() メソッドの type 引数に対応します。
data String このチャットに送信されたカスタムイベントのデータ。チャットウィンドウからこのイベントを送信するために使用された liveagent.chasitor.sendCustomEvent() メソッドの data 引数に対応します。
source String このチャットに送信されたカスタムイベントのソース。カスタムイベントをトリガしたエージェントまたはチャット訪問者に対応します。
timestamp Date/Time イベントの受信日時。
success Boolean イベントが正常に起動された場合は true、イベントが正常に起動されなかった場合は false