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

Open CTI 開発者ガイド

Clouds with binary code floating aboveCloud with binary code floating above

No Results

Search Tips:

  • Please consider misspellings
  • Try different search keywords
PDF

onFocus()

使用方法

ブラウザのフォーカスが変更されるとコールされる関数を登録します。Salesforce コンソールでは、主タブまたはナビゲーションタブでユーザが移動すると、ブラウザのフォーカスが変更されます。詳細は、Salesforce オンラインヘルプの「Salesforce コンソールの概要」を参照してください。

構文

1sforce.interaction.onFocus( listener:function );

引数

名前 型 説明
listener function ブラウザのフォーカスが変更されたときにコールされる JavaScript メソッド。

サンプルコード – JavaScript

1swfobject.registerObject("clippy.codeblock-1", "9");<html>
2<head>
3   <script type="text/javascript" src="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        };
10       //Invokes API method
11                sforce.interaction.onFocus(callback);
12</script>
13</head>
14</body>
15</html>

応答

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

名前 型 説明
result string フォーカスされているページの URL を JSON 文字列として返します。該当するオブジェクト ID、オブジェクト名、およびオブジェクト種別が含まれます。次に例を示します。 
1{"url":"http://salesforce.com/001x0000003DGQR",
2"objectId":"001x0000003DGQR","objectName":"Acme",
3"object":"Account"}

ページがオブジェクトにフォーカスしていない場合、オブジェクト ID、オブジェクト名、およびオブジェクトは空になります。

API バージョン 31.0 以降では、個人取引先オブジェクトで API メソッドを呼び出すと次の追加情報を返します。
  • AccountId または ContactId、関連する取引先または取引先責任者の ID
  • PersonAccount、オブジェクトが個人取引先の場合は true、それ以外の場合は false
次に例を示します。
1{"url":"http://na1.salesforce.com/001x0000003DGQR",
2"objectId":"001x0000003DGQR","objectName":"Acme Person Account",
3"object":"Account", "contactId":"003D000000QOMqg", "personAccount":true}
error string API コールが正常に行われた場合、この変数は未定義です。API コールが失敗した場合、この変数はエラーメッセージを返します。