generateConsoleUrl()
Salesforce コンソールのタブ、または関連タブのグループへの URL を生成します。外部 URL を含むタブがある場合、正しく表示できるようにコンソールのホワイトリストにその外部 URL を追加します。詳細は、オンラインヘルプの「Salesforce コンソールのホワイトリストのドメイン」を参照してください。このメソッドは、API バージョン 28.0 以降でのみ使用できます。
構文
1sforce.console.generateConsoleUrl(urls:String, (optional)callback:Function)引数
| 名前 | 型 | 説明 |
|---|---|---|
| urls | string | URL の配列。最初の URL が主タブで、それに続く URL がサブタブです。最後の URL は、コンソールがフォーカスされるサブタブです。これらの URL は、標準 Salesforce URL にすることも、相対 URL にすることもできます。 |
| 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/28.0/integration.js"/>
19 <A HREF="#" onClick="testGenerateConsoleURL();return false">
20 Click here to generate a console URL</A>
21
22 <script type="text/javascript">
23 function showConsoleUrl(result) {
24 alert(result.consoleUrl);
25 }
26 function testGenerateConsoleURL() {
27 sforce.console.generateConsoleUrl([/apex/pagename, /entityId, www.externalUrl.com, Standard Salesforce Url/entityId], showConsoleUrl); }
28 </script>
29</apex:page>応答
このメソッドは非同期であるため、コールバックメソッドのオブジェクトで応答を返します。応答オブジェクトには次の項目が含まれます。
| 名前 | 型 | 説明 |
|---|---|---|
| consoleUrl | string | Salesforce に渡される URL の配列を示すコンソール URL。 |
| success | boolean | URL が正常に生成された場合は true、それ以外の場合は false。 |
| callback | function | メソッドの完了時にコールされる JavaScript メソッド。 |