Siebel Object Interfaces Reference > Interfaces Reference > Business Object Methods >

GetBusComp Method

The GetBusComp method returns the specified business component.

Syntax

oBusObj.GetBusComp (BusCompName)

Returns

The requested business component

Usage

BusCompName is case-sensitive, and must match in case the form of the name as it appears in Siebel Tools. If an instance of BusCompName already exists, that instance is returned. The interpreter instantiates and returns a new instance of a business component using BusCompName if one does not already exist.

If you already have a BusComp but you want to create a new one (without getting any existing ones), use GetBusObject() first. This creates a new BusComp() that is not the same as the one already existing (for example in an applet.) Then use the new business object to do a GetBusComp() to create new business components. If you use the business object that already exists you pick up any child business components that already exist, even if you use GetBusComp() to get them.

The Nothing function should be used to destroy the instantiated business component when it is no longer necessary.

NOTE:  In Browser Script, the GetBusComp() method can only access business components in the current view; in Server Script, the GetBusComp() method can access every business component that has been instantiated in the active business object.

Used With

Browser Script, COM Data Control, COM Data Server, Java Data Bean, Server Script

Examples

The following examples are in Siebel eScript.

To access a business component in the UI context:

var ActiveBO = TheApplication().ActiveBusObject();
var ConBC = ActiveBO.GetBusComp("Contact");

To access a business component in the non-UI context:

var BO = TheApplication().GetBusObject("Account");
var ConBC = BO.GetBusComp("Contact");