Configuring managed settings for FPCC

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