Siebel Object Interfaces Reference > Interfaces Reference > Application Methods >

GotoView

GotoView activates the named view and its BusObject. As a side effect, this method activates the view's primary applet and its BusComp and activates the primary applet's first tab sequence control. Further, this method deactivates any BusObject, BusComp, applet, or control objects that were active prior to this method call.

Syntax

Application.GotoView(ViewName[, BusinessObjectName])

Argument
Description
ViewName
The name of the view for the Siebel application to display
BusinessObjectName
An optional parameter to specify the business object to use for displaying the view. You cannot specify the current active business object as an argument to GotoView. If this argument is not supplied, or is specified as Nothing, a new business object is loaded in the normal fashion.

Returns

Not applicable

Usage

If a business object has not been instantiated, BusinessObjectName should have the value Nothing.

NOTE:  The GotoView method is not supported in the Navigate and PreNavigate events.

An example use of the GotoView method is to programmatically navigate to the Opportunity List view.

theApplication.GotoView "Opportunity List View", Nothing

When this method is used from an external program, the usage is as follows:

ObjectReference.GotoView("Opportunity List View", Nothing, errCode)

Alternatively, if your application has already instantiated an Opportunity object with the object reference of objOppty, the appropriate usage in Siebel VB is:

theApplication.GotoView"Opportunity List View", objOppty

When this method is used from an external program, the usage is as follows:

ObjectReference.GotoView("Opportunity List View", OpptyObj, errCode)

NOTE:  When this method is used in a Siebel VB or eScript script, regardless of where it appears in the script, it is executed last. However, when GotoView is invoked from an external program, it is executed immediately. The GotoView method goes to a new screen, with the result that the screen in which the method is executing is destroyed, and the executing script along with it, causing a crash. To avoid this behavior, make the call to GotoView the last executable statement in the script.

Used With

Server Script


 Siebel Object Interfaces Reference 
 Published: 18 June 2003