refreshSubtabByNameAndPrimaryTabId()

Refreshes a subtab with the last known URL with the specified name and primary tab ID. This method can't refresh a subtab If the last known URL is an external page or a Visualforce page. This method is only available in API version 22.0 or later.

Syntax

1sforce.console.refreshSubtabByNameAndPrimaryTabId(name:String, primaryTabId:String, active:Boolean, (optional)callback:Function)

Arguments

Name	Type	Description
name	string	Name of the subtab to refresh.
primaryTabId	string	ID of the primary tab in which the subtab opened.
active	boolean	If `true`, the refreshed subtab displays immediately. If `false`, the refreshed subtab displays in the background.
callback	function	JavaScript method that’s called upon completion of the method.

Sample Code–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 standardController="Case">
18
19     <A HREF="#" onClick="testRefreshSubtabByNameAndPrimaryTabId();return false">
20         Click here to refresh a subtab by name and primary tab ID</A> 
21
22    <apex:includeScript value="/support/console/22.0/integration.js"/>
23    <script type="text/javascript">
24        function testRefreshSubtabByNameAndPrimaryTabId() {
25            //Get the value for 'mySubtab' and 'scc-pt-0' from the openSubtab method
26            //These values are for example purposes only
27            var subtabName = 'mySubtab';
28            var primaryTabId = 'scc-pt-0';
29            sforce.console.refreshSubtabByNameAndPrimaryTabId(subtabName, primaryTabId, true, refreshSuccess);
30        }
31        
32        var refreshSuccess = function refreshSuccess(result) {
33            //Report whether refreshing the subtab was successful
34            if (result.success == true) {
35                alert('Subtab refreshed successfully');
36            } else {
37                alert('Subtab did not refresh');
38            }
39        };
40        
41  </script>
42
43</apex:page>

This example is set to run by clicking a custom link on a case. For more information, see “Defining Custom Buttons and Links” in the Salesforce online help.

Note

Response

This method is asynchronous, so it returns its response in an object in a callback method. The response object contains the following field:

Name	Type	Description
success	boolean	`true` if the subtab refreshed successfully; `false` if the subtab didn't refresh.

Salesforce Console Integration Toolkit Developer's Guide

refreshSubtabByNameAndPrimaryTabId()

Syntax

Arguments

Sample Code–Visualforce

Response