Atrium.launchItem( itemId, closable, callback )

This function launches a given navigation item as a tab in the portal. The item will launch using the settings that have been configured for it in the Add/Update navigation item form.

Parameters:

itemId - a numeric value that represents the unique identifier for the item – this value is displayed on the add/update navigation item form.
closable - a Boolean value that indicates if the tab should contain a close button. Pass true for a tab with a close button, or false for a tab without a close button. This value defaults to true, if not specified.
callback - a function that will be called after the tab has been created. The callback contains two parameters as well, success and tab.
- Success - a Boolean that represents if the tab was created properly. The value will be true for success, false if an error occurred.
- Tab - a reference to the tab object being launched.

Example:

The following expression launches a closable tab with the id of 330. It also passes a callback function that will close the new tab in 5 seconds, using the Atrium.closeTab() API.

Atrium.launchItem(330, true, function(success, tab) {
  if (success === true){
	setTimeout(function(){
	  Atrium.closeTab(tab);
	}, 5000);
  }
});

If this is being used within Atrium (i.e. under the /extension/atrium directory), Atrium.api.launchItem() should be used instead.