Specify how First Party Call Control functions for IBM®
Sametime® Connect clients by configuring managed settings
in the client installation package's
com.ibm.collaboration.realtime.telephony.sipphone plug-in.
About this task
Optionally configure managed settings to provide default values for the SIP
Phone preferences in the Sametime Connect
client; for example, the domain that your users call from and the telephone number format used by
the SIP PBX. Providing default settings reduces the chances of a user providing incorrect
information when attempting to make SIP calls.
Note: Even if you provide default settings for connecting to the third-party SIP server, users
typically provide their own credentials for that server in the Authorization
Name and Password fields of the SIP Phone
preferences because the Sametime credentials that are used
by default might not be correct for your company's phone system.
Procedure
-
Open the com.ibm.collaboration.realtime.telephony.sipphone for
editing.
-
Use the
sipProxy
setting to specify the fully qualified host name (or IP
address), port number for SIP calls, and transport protocol used by the third-party SIP
server.
The sipProxy
setting uses the following format:
sipProxy=host_or_IP:port;transport=transport_protocol
Where:
host_or_IP
specifies either the IP address or the fully
qualified host name of the SIP server.
port
specifies the port that the SIP server listens on for
SIP calls.
transport_protocol
specifies the transport protocol used by
the third-party SIP server for SIP calls; allowed values are TCP
,
TLS
, or UDP
.
For example, the following setting specifies "198.17.84.55" as the third-party SIP server's IP
address, "5000" as the port used for listening for SIP calls, and "TCP" as the transport
protocol.
sipProxy=198.17.84.55:5000;transport=TCP
-
Use the
sipDomain
setting to specify the domain where your users call from;
for example: sipDomain=ibm.com
.
-
Use the
phoneNumberTransform
settings to specify how telephone numbers in your
LDAP directory should be converted for registration with the SIP PBX.
The FPCC phone will dial phone numbers exactly as they are published in the LDAP directory;
however, the SIP PBX might require a different format for registering users (for example, a 5-digit
extension).
- Use the rightmost digits of the telephone number:
phoneNumberTransformRightmostDigits=nn
This is the simplest
transform; it uses the specified number of digits, counting from the rightmost digit, of the
telephone number. If your telephone numbers follow a standard format and you only need to use the
last few digits for SIP registration, use this setting to specify how many of the rightmost digits
to use. The following example uses the last 5 digits of a user's telephone
number:
phoneNumberTransformRightmostDigits=5
In this example, suppose
that a typical telephone number in the LDAP is formatted as +17206636623 and SIP PBX requires a
5-digit extension, so the transform extracts only those digits from each telehpone number in the
LDAP directory.
- Extract a subset of the telephone number:
phoneNumberTransformMatch={Java_regex}
This transform is more complicated, but
provides more flexibility for converting telephone numbers. This setting uses a Java™ regular expression to extract information from telephone numbers even when
they do not all conform to a standard format. This transform overrides the
phoneNumberTransformRightmostDigits
transform.
To use the
phoneNumberTransformMatch
transform, provide a Java regular expression that can be used to locate information within the telephone number and
then return the specified number of digits. The following example extracts the last 4 digits from a
telephone number.
phoneNumberTransformMatch=\\d{4}$
For additional
flexibility, combine this transform with the
phoneNumberTransformPattern={Java_regex}
setting, which allows you to apply a
particular pattern of digits to the result of the phoneNumberTransformMatch
setting; for example to add new numbers to the result. Specify the pattern to apply with a Java regular expression.
The following example uses the
phoneNumberTransformMatch
setting to retrieve the last 3 digits of a telephone
number and the phoneNumberTransformPattern
setting to prefix that number with a
9
:
phoneNumberTransformMatch=\\d{3}$
phoneNumberTransformPattern=9$1
-
Save and close the file.
-
Distribute the updates to users as explained in Distributing updates and optional features to clients