refreshPrimaryTabByName()
Refreshes a primary tab specified by name,
including its subtabs. This method can't refresh subtabs with URLs to external pages or
Visualforce pages. This
method is only available in API version 22.0 or later.
Syntax
sforce.console.refreshPrimaryTabByName(name:String, active:Boolean, (optional)callback:Function), (optional)fullRefresh:Boolean)
Arguments
Name | Type | Description |
---|---|---|
name | string | Name of the primary tab to refresh. |
active | boolean | If true, the refreshed primary tab displays immediately. If false, the refreshed primary tab displays in the background. |
callback | function | JavaScript method that’s called upon completion of the method. |
fullRefresh | boolean | Enables a full refresh of the entire case feed. |
Sample Code–Visualforce
<apex:page standardController="Case">
<A HREF="#" onClick="testRefreshPrimaryTabByName();return false">
Click here to refresh a primary tab by name</A>
<apex:includeScript value="/support/console/64.0/integration.js"/>
<script type="text/javascript">
function testRefreshPrimaryTabByName() {
//Set the name of the tab by using the openPrimaryTab method
//This value is for example purposes only
var primaryTabName = 'myPrimaryTab';
sforce.console.refreshPrimaryTabByName(primaryTabName, true, refreshSuccess);
}
var refreshSuccess = function refreshSuccess(result) {
//Report whether refreshing the primary tab was successful
if (result.success == true) {
alert('Primary tab refreshed successfully');
} else {
alert('Primary tab did not refresh');
}
};
</script>
</apex:page>
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 primary tab refreshed successfully; false if the primary tab didn't refresh. |