Siebel CTI Administration Guide > Configuring Advanced Communications Features > Using Business Services with Siebel Communications Server >

Invoking a Business Service Method from a Command


You can create or modify a command and a corresponding command data definition in the communications configuration to specify a Siebel business service and method to be invoked. To do this, you do the following:

  • Use the command parameter ServiceMethod in a command to specify the name of the business service and method to invoke.
  • Use the command parameter ServiceParam in the associated command data definition to specify argument names and values to pass to the business service method.

For more information about using these command parameters, see Commands and Command Data.

In the example shown in Table 37 and Table 38, Communications Server invokes the method MyMakeCall of the business service MyMakeCallService and passes arguments to the service method. The value of the ServiceParam.PhoneNumber parameter is from the @Phone macro; the value of the ServiceParam.AgentID parameter is from the @AgentId macro.

At run time, commands that invoke business service methods are determined to be enabled or disabled by invoking from the applicable business service the method CanInvokeMethod("method_name"), where method_name is your business service method to be invoked. If True is returned, then you can invoke the method. If False is returned, then you cannot invoke the method and the command is disabled. No DeviceCommand parameter is included in this example, because the communications command is not designed to call a function on the external communications system.

Table 37. Command: MakeCallInService
Parameter Name
Parameter Value

Description

Make Call In My Service

ServiceMethod

MyMakeCallService.MyMakeCall

Hidden

True

Table 38 shows a command data definition for this command definition.

Table 38. Command Data: MakeCallInService
Parameter Name
Parameter Value

ServiceParam.PhoneNumber

{@Phone}

ServiceParam.AgentID

{@AgentId}

Communications Server can invoke the methods of any business service, not only those, like this example, that pertain to communications.

NOTE:  By default, several communications commands invoke business service methods. For examples, see the communications configuration data provided with Siebel Business Applications.

Siebel CTI Administration Guide Copyright © 2013, Oracle and/or its affiliates. All rights reserved. Legal Notices.