Tarantella Administration Guide > Applets > launchByObjectName (webtop script and webtop tray applets)

launchByObjectName (webtop script and webtop tray applets)

Syntax

String launchByObjectName(String ObjectTFNName)

Description

Activates the specified object, just as if a user had clicked its link on their webtop.

ObjectTFNName specifies the TFN name of the object to activate.

Note You can only use this method to activate the objects that appear on a user's webtop -- the links that the webtop tray applet is currently displaying.

This method returns OK if Tarantella successfully launches the application (or displays the document) represented by the link, and Error otherwise.

This method can be used with either the webtop script applet or the webtop tray applet.

Examples

<SCRIPT LANGUAGE="JavaScript">

function startApplication() {
   app_tfn_name = ".../_ens/o=Indigo Insurance/ou=Finance/cn=XClaim";
   document.applets["Tarantella Webtop"].launchByObjectName(app_tfn_name);
}

</SCRIPT>
 
<FORM>
   <INPUT TYPE=button VALUE="Start XClaim" onclick="startApplication()">
</FORM>

This example adds a button beneath the links on users' webtops. When a user clicks this button, Tarantella activates the XClaim object on their webtop.

Add the code to the HTML document containing the webtop tray applet (left.html, in the sco/tta/standard webtop theme), after the TTAAPPLET declaration.

Note This example assumes you are using the sco/tta/standard webtop theme. If you're using another theme, with different frame names and layouts, or different applet names, you'll need to modify the line that invokes the launchByObjectName method to access the webtop tray applet used by your new theme. You'll also need to modify it to launch a valid object name.