refreshSubtabByNameAndPrimaryTabName()

Usage

Refreshes a subtab with the last known URL with the specified name and primary tab name. 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.

Note that this method doesn't refresh sidebars or custom console components. For more information, see Custom Console Components Overview in the Salesforce online help.

Syntax

1sforce.console.refreshSubtabByNameAndPrimaryTabName(name:String, primaryTabName:String, active:Boolean, (optional)callback:Function)

Arguments

Name	Type	Description
name	string	Name of the subtab to refresh.
primaryTabName	string	Name 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 called upon completion of the method.

Sample Code–Visualforce

1swfobject.registerObject("clippy.codeblock-1", "9");<apex:page standardController="Case">
2
3     <A HREF="#" onClick="testRefreshSubtabByNameAndPrimaryTabName();return false">
4         Click here to refresh a subtab by name and primary tab name</A> 
5
6    <apex:includeScript value="/support/console/22.0/integration.js"/>
7    <script type="text/javascript">
8        function testRefreshSubtabByNameAndPrimaryTabName() {
9            //Get the value for 'mySubtab' and 'myPrimaryTab' from the openSubtab method
10            //These values are for example purposes only
11            var subtabName = 'mySubtab';
12            var primaryTabName = 'myPrimaryTab';
13            sforce.console.refreshSubtabByNameAndPrimaryTabName(subtabName, primaryTabName, true, refreshSuccess);
14        }
15        
16        var refreshSuccess = function refreshSuccess(result) {
17            //Report whether refreshing the subtab was successful
18            if (result.success == true) {
19                alert('Subtab successfully refreshed');
20            } else {
21                alert('Subtab did not refresh');
22            }
23        };
24        
25  </script>
26
27</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