Siebel Communications Server Administration Guide > Using Siebel Contact On Demand >

Telephony@Work Communications Driver Parameters


Table 70 describes the supported driver parameters specific to the TaW communications driver which enables you connect your Siebel Communications Server to Siebel Contact On Demand to use Siebel Contact On Demand's voice functionality.

You view and modify these driver parameters in the Communications Drivers and Profiles view, which is one of the views in the Administration - Communications screen.

Table 70. TaW Parameters
Parameter Name
Required
Default Value
Description

Driver:
AdminPassword

Y

 

Enter the password of the administrator for the Siebel Contact On Demand application.

Driver:
AdminUserName

Y

 

Enter the user name of the administrator for the Siebel Contact On Demand application.

Driver:
AutoProxyRefreshInterval

N

-1

Specify the interval in seconds before the TaW communications driver requests a refreshed list of proxy servers. You set a value for this parameter if Driver:ProxySupport is set to Auto or Script.

The default value is -1. When set to -1, the TaW communications driver retrieves the list of proxy servers once per TaW communications driver session.

The minimum value that you can specify as an interval is 60 seconds. If you specify a value less than 60 seconds, the TaW communications driver resets it to 60 seconds.

Driver:
CompanyName

Y

 

Enter the name of the company that has licensed the Siebel Contact On Demand application.

Driver:
CountryCodeDelimiter

 

.

Specify the delimiter to use between a country code and local area code if an agent enters a phone number a phone number in the communications toolbar. The default delimiter is ".".

Driver:
DefaultCountryCode

N

1

Specify the default country code if it is not specified by the agent.

Driver:
EnableSOAPTrace

N

false

Set this parameter to True to enable logging for communication using the SOAP protocol. If set to True, the TaW communications driver writes entries to the log file specified by Driver:LogSOAPFile.

Driver:
LogFile

N

tw.log

Specifies the file name of the log file for the TaW communications driver.

Driver:
LogSOAPFile

N

twsoap.log

Specifies the file name of the SOAP log file for the TaW communications driver. The Driver:EnableSOAPTrace parameter must be set to True before the TaW communications driver writes to this log file.

Driver:MaxMessageNumber

N

50

Specifies the maximum number of messages that the TaW communications driver retrieves with each call. /

Driver:
MessageInterval

N

1000

Specify the interval in milliseconds between each request by the TaW communications driver to retrieve messages.

Driver:
OnHookAtLogout

N

true

If true, set the teleset used by the agent to available once the agent logs out of the Siebel Contact On Demand application.

Driver:
ProxySupport

 

N

Disabled

Set a value for this parameter to specify the TaW communication driver's support for proxy servers.

Values can be one of the following:

  • Disabled

    If set to Disabled (default value), the communication driver does not support proxy servers.

  • Auto

    If set to Auto, the communications driver retrieves a list of proxy servers by executing a PAC file. The PAC file is executed by issuing a dynamic host configuration protocol (DHCP) request or by searching for a DNS address in the network.

  • Script

    If set to Script, the communications driver retrieves a list of proxy servers by executing a PAC file. You specify the location of the PAC file by entering a value for the Driver:ProxyScriptLocation parameter. To obtain the location of the PAC file, contact your network administrator.

When you set Driver:ProxySupport to Auto or Script, the communication driver uses the first proxy server in the list of proxy servers that it retrieves. If this proxy server fails to respond, the communication driver does not attempt to use the next working proxy server in the list. Instead, the communications driver retrieves the list of proxy servers again after the interval specified by the Driver:AutoProxyRefreshInterval parameter expires. The communications driver repeats this process until it retrieves a valid proxy server or until it makes the number of attempts specified by the Driver:SOAPRetry parameter.

Driver:
ProxyScriptLocation

N

 

 

You must specify a value for this parameter if you set the value of the Driver:ProxySupport parameter to Script. Otherwise, you do not need to specify a value for this parameter.

Specify a valid URL in unicode string format that points to the location of your network's proxy auto-configuration (PAC) file.

For example, the URL may be as follows:

http://wpad.yourcompany.com/wpad.dat or http://www.yourcompany.com/wpad.js

Contact your network administrator to obtain the location of the PAC file.

NOTE:  Oracle only supports ECMAScript-based PAC files.

Driver:
SOAPRetry

N

3

Enter the number of attempts that the TaW communications driver makes to retrieve a list of proxy servers.

Driver:
URL

Y

 

Enter the URL of the Siebel Contact On Demand application.

LogDebug

N

true

When set to true, the communications driver writes to the log file specified by the Driver:LogFile parameter and/or the Service:ServiceLogFile parameter.

If you specify this parameter prefixed with either Service: or Driver:, it applies to the applicable log file only.

MaxLogKB

N

90240

Specifies the maximum size of the log file, in kilobytes (KB).

This parameter is generic and applies to log files specified using Driver:DriverLogFile and using Service:ServiceLogFile.

If you specify this parameter prefixed with either Service: or Driver:, it will apply to the applicable log file only.

When the applicable log file is full, it is emptied completely, then logging begins again.

ReleaseLogHandle

N

TRUE

Indicates that the log file handle for each agent is released periodically, after logs have been generated.

The default setting of TRUE provides better performance.

When ReleaseLogHandle is FALSE, however, some log files may not be generated if the number of concurrent users exceeds the file-handle capacity provided by the operating system.

This parameter is generic and applies to log files specified using Driver:LogFile and using Service:LogFile.

If you specify this parameter prefixed with either Service: or Driver:, it will apply to the applicable log file only.

Service:
DNList

Y

{@DNList}

Uses the macro @DNList to obtain a list of DNs (standard extensions of type "S") associated with the current agent.

Service:
LogFile

N

tw_{@Username}.log

If a filename is specified using this parameter, Siebel Communications Server writes detailed information about activity for the active call, for each agent's session, into a log file. Data for Siebel Communications Server and Siebel CTI Connect activity is logged, including device events and event data fields.

Log files are created by default in the log subdirectory of the Siebel Server installation directory, depending on the client type and on your communications deployment.

For information about the @Username macro, see Macros for Parameter Values.

For more information, see the description for the Driver:DriverLogFile parameter.

Service:
SelectDN

N

{@SelectedDN}

Specifies a DN to be used to issue commands such as MakeCall, and so on.

Otherwise, the first DN in the list specified with the parameter Service:DNList is used.

Siebel Communications Server Administration Guide Copyright © 2006, Oracle. All rights reserved.