Open CTI 開発者ガイド
jSalesforce Classic の onFocus()
使用方法
ブラウザのフォーカスが変更されるとコールされる関数を登録します。Salesforce コンソールでは、主タブまたはナビゲーションタブでユーザが移動すると、ブラウザのフォーカスが変更されます。
構文
1sforce.interaction.onFocus( listener:function );引数
| 名前 | 型 | 説明 |
|---|---|---|
| listener | function | ブラウザのフォーカスが変更されたときにコールされる JavaScript メソッド。 |
サンプルコード – JavaScript
1<head>
2 <script type="text/javascript"
3src="http//domain:port/support/api/25.0/interaction.js"></script>
4 <script type="text/javascript">
5 var callback = function (response) {
6 if (response.result) {
7 alert(response.result);
8} };
9 function onFocus() {
10 //Invokes API method
11 sforce.interaction.onFocus(callback);
12 }
13</script>
14</head>
15<body>
16 <button onclick="onFocus();">onFocus</button>
17</body>応答
このメソッドは非同期です。応答は、コールバックメソッドに渡されたオブジェクトで返されます。応答オブジェクトには次の項目が含まれます。
| 名前 | 型 | 説明 |
|---|---|---|
| result | string | フォーカスされているページの URL を JSON 文字列として返します。該当するオブジェクト ID、オブジェクト名、オブジェクト種別、および API バージョン 33.0 以降の場合はオブジェクトタブ名が含まれます。次に例を示します。ページがオブジェクトにフォーカスしていない場合、オブジェクト ID、オブジェクト名、およびオブジェクトは空になります。 API バージョン 31.0 以降では、個人取引先オブジェクトで API メソッドを呼び出すと次の追加情報を返します。
|
| error | string | API コールが正常に行われた場合、この変数は未定義です。API コールが失敗した場合、この変数はエラーメッセージを返します。 |