Siebel Object Interfaces Reference > Interfaces Reference > Application Methods >

GetService

The GetService method returns a specified service. If the service is not already running, it is constructed.

Syntax

Application.GetService(serviceName)

Parameter
Description
serviceName
The name of the service to start

Returns

A reference to the requested business service

Usage

This method finds the business service indicated by serviceName; it constructs the service if it is not already running. It first searches through the built-in services that are stored in the repository. If the service is not found, GetService searches through services defined in the run-time Business Services table.

A business service is normally deleted from memory as soon as every reference to it, such as local or global variables, are cleared by setting them to another value. However, if the Cache flag on the business service is set, the service remains in memory as long as the Siebel application is running.

To invoke a business service using the Web Client Automation Server and Browser Script, the business service must first be registered in the application configuration file (such as uagent.cfg, sfs.cfg, and so on). This prevents Service Not Found errors. To register a business service in the application configuration file, navigate to the [SWE] section, and add entries like the following examples.

ClientBusinessService0 = "XML Converter"
ClientBusinessService1 = "Siebel Account"

ClientBusinessService entries must be sequential, starting at 0 and incrementing by 1.

Used With

Browser Script, COM Data Control, COM Data Server, CORBA Object Manager, Java Data Bean, Mobile/Dedicated Web Client Automation Server, Server Script, Web Client Automation Server

Example

For an example, read SetProperty.


 Siebel Object Interfaces Reference 
 Published: 18 June 2003