Views

Difference between revisions of "Broadsoft DMS"

The Wiki of Unify contains information on clients and devices, communications systems and unified communications. - Unify GmbH & Co. KG is a Trademark Licensee of Siemens AG.

Jump to: navigation, search
(Replaced content with "please see Device Management System ")
 
(106 intermediate revisions by the same user not shown)
Line 1: Line 1:
== Introduction ==
+
please see [[Device_Management_System | Device Management System ]]
 
 
The Device Management System (DMS) is part of the Broadworks solution. It is an HTTPS server that delivers xml files for the OpenScape Desk Phone CP devices. The format and content is described in this document.
 
 
 
The xml file containing configuration and file deployment instructions is requested via a generic GET request. The server address and path can be configured on the phone. The file name is hardcoded and cannot be changed. It always is <MAC-address-of-device>_config.xml
 
 
 
The MAC address of the device is also send as header in the format: "macaddress: 0a1b2c3d4d5f"
 
 
 
The OpenScape Desk Phone CP devices support HTTP digest authentication, if username and password are properly configured
 
 
 
 
 
== Set DMS address via DHCP ==
 
 
 
When an IP phone is booting, it first obtains an IP address via DHCP. The DHCP server can provide the DMS address to the phone via Option 43 or Option 66.
 
The DMS address is mutually exclusive with a possibly provided DLS address. A phone can either connect to a DLS or DMS server.
 
 
 
 
 
=== Option 43 ===
 
 
 
DHCP vendor specific option 43 can specify a voice '''VLAN ID''' and URL of a Broadsoft DMS server. IP phones will recognize vendor specific options only, if vendor string (here: "Siemens") matches correctly. All values are given in '''hexadecimal numbering format'''. Here is a detailed description of all DHCP option 43 bytes:
 
 
 
'''Tag''' '''Len''' '''Content (Example)'''
 
01  07  '''5369656d656e73'''
 
02  04  000000'''65'''
 
03  1d  68747470733a2f2f3'''9'''3'''3'''2E3'''1'''3'''2'''3'''2'''2E3'''1'''3'''1'''3'''4'''2E3'''9'''3'''6'''3a3434332f646d73
 
ff
 
 
 
 
 
There are three '''Tags''', each with an explicit length value. List if tags is delimited by a ending '''ff'''
 
 
 
* Tag 01 specifies the vendor (here: ''Siemens'')
 
** Tag: '''01'''; Length: '''07'''; Value: '''Siemens'''
 
* Tag 02 specifies VLAN ID of Voice VLAN (here: ''101'')
 
** Tag: '''02'''; Length: '''04'''; Value: '''65''' (Hex)
 
* Tag 03 specifies IP address of Broadsoft DMS (here: ''93.122.114.96:443/dms'')
 
** Tag: '''03'''; Length: '''1d'''; Value: '''https://93.122.114.96:443/dms''' (Hex)
 
* End of record
 
** End: '''ff''' (Hex)
 
 
 
Providing a VLAN ID is optional and only mentioned for completeness. You can find details for configuration of a VLAN ID here: http://wiki.unify.com/wiki/VLAN_ID_Discovery_over_DHCP
 
 
 
 
 
=== Option 66 ===
 
 
 
The DHCP server needs to be configured to provide the DMS server URL via Option 66. Here is a detailed description of the Option 66 bytes
 
 
 
'''Option''' '''Len''' '''Content (Example)'''
 
42    1d  '''68747470733a2f2f39332e3132322e3131342e39363a3434332f646d73'''
 
 
 
Compared to Option 43, Option 66 does not have specific tags. It only has a length and content field. The above example provides the following URL in the content field
 
 
 
* DHCP option field: '''42'''(Hex); Length: '''1d'''; Content: '''https://93.122.114.96:443/dms''' (Hex)
 
 
 
 
 
== Set DMS address via menu ==
 
 
 
You can also set the URL to your DMS via the local phone menu (in case it cannot be provided via DHCP). A DHCP configured address cannot be overwritten manually.
 
The DMS address is mutually exclusive with a possibly configured DLS address. A phone can either connect to a DLS or DMS server.
 
 
 
=== Web based management ===
 
 
 
Open the web based management in a web browser window and login to the admin area of your Desk Phone CP device. Go to Network -> Update Service and provide the required URL, username and password.
 
 
 
=== Local phone menu ===
 
 
 
Press the main menu key and select Settings -> Administrator settings. Provide the admin password and afterwards select Network -> Update Service -> DMS -> Show details. Configure the required URL, username and password.
 
 
 
 
 
The update check interval defines when the device will contact the DMS server to check for updates.
 
 
 
In case the provided username and password are incorrect or missing, the phone will automatically prompt the user for a new username and password.
 
 
 
 
 
== Content of config.xml file ==
 
 
 
The content of the XML file provided by the DMS server has the following schema
 
 
 
  <?xml version="1.0" encoding="utf-8"?>
 
  <Message>
 
    <Action>WriteItems</Action>
 
    <ItemList>
 
      <Item name="ITEMNAME">VALUE</Item>
 
    </ItemList>
 
  </Message>
 
 
 
 
 
=== Generic Items ===
 
 
 
This section describes the items that can be configured on a CP device via a config.xml file.
 
 
 
 
 
==== Network related Items ====
 
 
 
{| {{DefaultTable}}
 
|-
 
! width="200" | Item name
 
! width="100" | Type
 
! width="400" | Details
 
! width="500" | Related WBM config item
 
|-
 
| ip-protocol-mode
 
| Enumeration
 
| 0=IPv4 only, 1=IPv6 only, 2=Dual stack mode IPv6_IPv4
 
| Admin -> Network -> General IP configuration -> Protocol mode
 
|-
 
| lldp-enabled
 
| Boolean
 
| LLDP-Med enabled. true or false
 
| Admin -> Network -> General IP configuration -> LLDP-MED enabled
 
|-
 
| dhcp
 
| Boolean
 
| DHCPv4 enabled. true or false
 
| Admin -> Network -> General IP configuration -> DHCP enabled
 
|-
 
| ipv6-dhcp-enabled
 
| Boolean
 
| DHCPv6 enabled. true or false
 
| Admin -> Network -> General IP configuration -> DHCPv6 enabled
 
|-
 
| vlan-method
 
| Enumeration
 
| Discover VLAN via: 2=LLDP-Med, 1=DHCP, 0=manual
 
| Admin -> Network -> General IP configuration -> VLAN discovery
 
|-
 
| vlan-id
 
| Integer
 
| only valid if vlan-method is set to manual
 
| Admin -> Network -> General IP configuration -> VLAN ID
 
|-
 
| dns-domain-name
 
| String
 
| DNS-domain name, if not provided by DHCP server
 
| Admin -> Network -> General IP configuration -> DNS domain
 
|-
 
| dns-server-addr
 
| String
 
| Primary DNS server, if not provided by DHCP server
 
| Admin -> Network -> General IP configuration -> Primary DNS
 
|-
 
| dns-server-addr2
 
| String
 
| Secondary DNS server, if not provided by DHCP server
 
| Admin -> Network -> General IP configuration -> Secondary DNS
 
|-
 
| dhcp-reuse
 
| Boolean
 
| DHCPv4 reuse. true or false
 
| Admin -> Network -> IPv4 configuration -> DHCP lease reuse
 
|-
 
| ipv6-dhcp-addr-reuse
 
| Boolean
 
| DHCPv6 reuse. true or false
 
| Admin -> Network -> IPv6 configuration -> DHCPv6 lease reuse
 
|-
 
| reg-port
 
| Integer
 
| SIP server port
 
| Admin -> Network -> Port configuration -> SIP server
 
|-
 
| registrar-port
 
| Integer
 
| SIP registrar port
 
| Admin -> Network -> Port configuration -> SIP registrar
 
|-
 
| sgnl-gateway-port-user
 
| Integer
 
| SIP gateway port
 
| Admin -> Network -> Port configuration -> SIP gateway
 
|-
 
| phone-port
 
| Integer
 
| SIP local phone port
 
| Admin -> Network -> Port configuration -> SIP local
 
|-
 
| rtp-base-port
 
| Integer
 
| RTP base port
 
| Admin -> Network -> Port configuration -> RTP base
 
|-
 
| port1
 
| Enumeration
 
| LAN port speed setting. 0=Auto, 1=10/Half, 2=10/Full, 3=100/Half, 4=100/Full, 5=1000/Full
 
| Admin -> Network -> Port configuration -> LAN port speed
 
|-
 
| port2
 
| Enumeration
 
| PC port speed setting. 0=Auto, 1=10/Half, 2=10/Full, 3=100/Half, 4=100/Full, 5=1000/Full
 
| Admin -> Network -> Port configuration -> PC port speed
 
|-
 
| port2-mode
 
| Enumeration
 
| PC port mode. 0=Disabled, 1=Enabled, 2=Mirror
 
| Admin -> Network -> Port configuration -> PC port mode
 
|-
 
| port2-auto-mdix-enabled
 
| Boolean
 
| Enable Auto-MDIX on PC port. true or false
 
| Admin -> Network -> Port configuration -> PC port autoMDIX
 
|}
 
 
 
 
 
==== System related Items ====
 
 
 
{| {{DefaultTable}}
 
|-
 
! width="200" | Item name
 
! width="100" | Type
 
! width="400" | Details
 
! width="500" | Related WBM config item
 
|-
 
| e164
 
| String
 
| E164 number of device
 
| Admin -> System -> System identity -> Terminal number
 
|-
 
| display-id-unicode
 
| String
 
| optional ID to display on main menu screen
 
| Admin -> System -> System identity -> Display identity
 
|-
 
| use-display-id
 
| Boolean
 
| Enable Display identity. true or false
 
| Admin -> System -> System identity -> Enable ID
 
|-
 
| hostname
 
| String
 
| Hostname of device (DDNS)
 
| Admin -> System -> System identity -> Terminal number
 
|-
 
| automatic-hostname-type
 
| Enumeration
 
| Hostname construction. 0=None, 1=Configured hostname, 2=only E164, 3=Prefix E164 with configured hostname, 4=MAC
 
| Admin -> System -> System identity -> DNS name construction
 
|-
 
| reg-addr
 
| String
 
| SIP server address
 
| Admin -> System -> Registration -> SIP server address
 
|-
 
| registrar-addr
 
| String
 
| SIP registrar address
 
| Admin -> System -> Registration -> SIP registrar address
 
|-
 
| sgnl-gateway-addr-user
 
| String
 
| SIP gateway address
 
| Admin -> System -> Registration -> SIP gateway address
 
|-
 
| session-timer
 
| Boolean
 
| Enable SIP session timer. true or false
 
| Admin -> System -> Registration -> Session timer enabled
 
|-
 
| session-duration
 
| Integer
 
| Session refresh after seconds. Depends on session timer
 
| Admin -> System -> Registration -> Session duration (seconds)
 
|-
 
| reg-ttl
 
| Integer
 
| Registration timer (seconds)
 
| Admin -> System -> Registration -> Registration timer (seconds)
 
|-
 
| server-type
 
| Enumeration
 
| SIP server type. 0=Other, 1=OpenScape Voice, 2=Broadsoft
 
| Admin -> System -> Registration -> Server type
 
|-
 
| realm
 
| String
 
| SIP realm for digest authentication
 
| Admin -> System -> Registration -> Realm
 
|-
 
| sip-uder-id
 
| String
 
| SIP username for digest authentication
 
| Admin -> System -> Registration -> User ID
 
|-
 
| sip-pwd
 
| String
 
| SIP password for digest authentication
 
| Admin -> System -> Registration -> Password
 
|-
 
| outbound-proxy-user
 
| Boolean
 
| Enable SIP gateway. true or false
 
| Admin -> System -> SIP interface -> Outbound proxy
 
|-
 
| sip-transport-user
 
| Enumeration
 
| SIP transport type. 0=UDP, 1=TCP, 2=TLS
 
| Admin -> System -> SIP interface -> SIP transport
 
|-
 
| transaction-timer
 
| Integer
 
| Transaction timer for call related SIP messages (milliseconds)
 
| Admin -> System -> SIP interface -> Call transaction response timer (ms)
 
|-
 
| transaction-timer-f
 
| Integer
 
| Transaction timer for non call related SIP messages (milliseconds)
 
| Admin -> System -> SIP interface -> NonCall transaction response timer (ms)
 
|-
 
| registration-backoff-timer
 
| Integer
 
| Backoff timer for Registration issues (seconds)
 
| Admin -> System -> SIP interface -> Reg. backoff (seconds)
 
|-
 
| voip-connectivity-check-interval
 
| Integer
 
| Connectivity check intervall (seconds )for TCP and TLS
 
| Admin -> System -> SIP interface -> Connectivity check timer (seconds)
 
|-
 
| media-negotiation-mode
 
| Enumeration
 
| Media negotiation. 0=Single IP, 1=ANAT, 2=ICE
 
| Admin -> System -> SIP interface -> Media negotiation
 
|-
 
| sip-media-IP-mode
 
| Enumeration
 
| SIP media IP mode. 0=IPv4, 1=IPv6, 2=IPv4_IPv6, 3=IPv6_IPv4
 
| Admin -> System -> SIP interface -> Media IP mode
 
|}
 
 
 
 
 
==== Feature related Items ====
 
 
 
{| {{DefaultTable}}
 
|-
 
! width="200" | Item name
 
! width="100" | Type
 
! width="400" | Details
 
! width="500" | Related WBM config item
 
|-
 
| emergency-e164
 
| String
 
| Emergency E164 number
 
| Admin -> System -> Features -> Configuration -> Emergency number
 
|-
 
| voice-mail-e164
 
| String
 
| Voicemail number
 
| Admin -> System -> Features -> Configuration -> Voice mail number
 
|-
 
| uaCSTA-enabled
 
| Boolean
 
| Enable uaCSTA. true or false
 
| Admin -> System -> Features -> Configuration -> Allow uaCSTA
 
|-
 
| server-based-features
 
| Boolean
 
| Enable server-based features. true or false
 
| Admin -> System -> Features -> Configuration -> Server features
 
|-
 
| enable-bluetooth-interface
 
| Boolean
 
| Enable Bluetooth interface on CP600. true or false
 
| Admin -> System -> Features -> Configuration -> Enable bluetooth interface
 
|-
 
| call-record-phone-number
 
| String
 
| Call recording number
 
| Admin -> System -> Features -> Configuration -> Recorder address
 
|-
 
| call-record-auto-start
 
| Boolean
 
| Automatically start recording. true or falls
 
| Admin -> System -> Features -> Configuration -> Recording mode
 
|-
 
| call-record-all-calls
 
| Boolean
 
| Record all calls. true or falls
 
| Admin -> System -> Features -> Configuration -> Recording mode
 
|-
 
| call-record-audible-indication
 
| Boolean
 
| Audible indication of recording. true or false
 
| Admin -> System -> Features -> Configuration -> Audible notification
 
|-
 
| call-record-audible-indication-continuous
 
| Boolean
 
| Repeat audible indication of recording. true or false
 
| Admin -> System -> Features -> Configuration -> Audible notification
 
|-
 
| mwi-e164
 
| String
 
| Message waiting server URI
 
| Admin -> System -> Features -> Addressing -> MW server URI
 
|-
 
| conference-factory-uri
 
| String
 
| Server based conference URI
 
| Admin -> System -> Features -> Addressing -> Conference
 
|}
 
 
 
=== Broadsoft Xtended Service Interface ===
 
 
 
The following section describes the settings for accessing the Broadsoft Xtended Service Interface (XSI)
 
 
 
  <Item name="bw-xsi-addr">https://xsp.iop1.broadworks.net</Item>
 
  <Item name="bw-xsi-sipauthentication">false</Item>
 
  <Item name="bw-xsi-username">username@broadworks.net</Item>
 
  <Item name="bw-xsi-password">123456</Item>
 
  <Item name="bw-ccl-enable">true</Item>
 
  <Item name="bw-cgdirectory-enable">true</Item>
 
  <Item name="bw-cgdirectory-name">Group Directory</Item>
 
  <Item name="bw-cedirectory-enable">true</Item>
 
  <Item name="bw-cedirectory-name">Enterprise Directory</Item>
 
  <Item name="bw-cgcdirectory-enable">true</Item>
 
  <Item name="bw-cgcdirectory-name">Group Common Directory</Item>
 
  <Item name="bw-cecdirectory-enable">true</Item>
 
  <Item name="bw-cecdirectory-name">Enterprise Common Directory</Item>
 
  <Item name="bw-cpdirectory-enable">true</Item>
 
  <Item name="bw-cpdirectory-name">Personal Directory</Item>
 
 
 
{| {{DefaultTable}}
 
|-
 
! width="200" | Item name
 
! width="100" | Type
 
! width="400" | Details
 
! width="500" | Related WBM config item
 
|-
 
| bw-xsi-addr
 
| String
 
| IP address or FQDN of XSI server
 
| Admin -> Local functions -> XSI access
 
|-
 
| bw-xsi-sipauthentication
 
| Boolean
 
| Enable SIP credentials based authentication. true or false
 
| Admin -> Local functions -> XSI access
 
|-
 
| bw-xsi-username
 
| String
 
| Username for XSI access
 
| Admin -> Local functions -> XSI access
 
|-
 
| bw-xsi-password
 
| String
 
| Password for XSI access. Required if bw-xsi-sipauthentication is set to false
 
| Admin -> Local functions -> XSI access
 
|-
 
| bw-ccl-enable
 
| Boolean
 
| Enable centralised call log. true or false
 
| Admin -> Local functions -> Call logging
 
|-
 
| bw-cgdirectory-enable
 
| Boolean
 
| Enable Group Directory via XSI. true or false
 
| Admin -> Local functions -> Network directories
 
|-
 
| bw-cgdirectory-name
 
| String
 
| Name for Group Directory to be used on the CP phone
 
| Admin -> Local functions -> Network directories
 
|-
 
| bw-cedirectory-enable
 
| Boolean
 
| Enable Enterprise Directory via XSI. true or false
 
| Admin -> Local functions -> Network directories
 
|-
 
| bw-cedirectory-name
 
| String
 
| Name for Enterprise Directory to be used on the CP phone
 
| Admin -> Local functions -> Network directories
 
|-
 
| bw-cgcdirectory-enable
 
| Boolean
 
| Enable Group Common Directory via XSI. true or false
 
| Admin -> Local functions -> Network directories
 
|-
 
| bw-cgcdirectory-name
 
| String
 
| Name for Group Common Directory to be used on the CP phone
 
| Admin -> Local functions -> Network directories
 
|-
 
| bw-cecdirectory-enable
 
| Boolean
 
| Enable Enterprise Common Directory via XSI. true or false
 
| Admin -> Local functions -> Network directories
 
|-
 
| bw-cecdirectory-name
 
| String
 
| Name for Enterprise Common Directory to be used on the CP phone
 
| Admin -> Local functions -> Network directories
 
|-
 
| bw-cpdirectory-enable
 
| Boolean
 
| Enable Personal Directory via XSI. true or false
 
| Admin -> Local functions -> Network directories
 
|-
 
| bw-cpdirectory-name
 
| String
 
| Name for Personal Directory to be used on the CP phone
 
| Admin -> Local functions -> Network directories
 
|}
 
 
 
=== Date&Time Settings ===
 
 
 
The following section describes the settings for Date&Time on the phone
 
 
 
  <Item name="sntp-addr">0.pool.ntp.org</Item>
 
  <Item name="sntp-tz-offset">60</Item>
 
  <Item name="daylight-save">true</Item>
 
  <Item name="daylight-save-minutes">60</Item>
 
  <Item name="auto-daylight-save">true</Item>
 
  <Item name="daylight-save-zone-id">9</Item>
 
 
 
{| {{DefaultTable}}
 
|-
 
! width="200" | Item name
 
! width="100" | Type
 
! width="400" | Details
 
! width="500" | Related WBM config item
 
|-
 
| sntp-addr
 
| String
 
| IP address or FQDN of NTP server
 
| Admin -> Date and Time -> SNTP primary
 
|-
 
| sntp-tz-offset
 
| Integer
 
| Offset in minutes of desired timezone
 
| Admin -> Date and Time -> Timezone offset
 
|-
 
| daylight-save
 
| Boolean
 
| Enable daylight saving. true or false
 
| Admin -> Date and Time -> Daylight saving
 
|-
 
| daylight-save-minutes
 
| Integer
 
| Offset in minutes when changing from/to daylight saving
 
| Admin -> Date and Time -> Difference
 
|-
 
| auto-daylight-save
 
| Boolean
 
| Automatically change from/to daylight saving. true or false
 
| Admin -> Date and Time -> Auto time change
 
|-
 
| daylight-save-zone-id
 
| Enumeration
 
| Daylight saving zone
 
| Admin -> Date and Time -> DST zone
 
|}
 
 
 
A list of possible values for Enumeration "daylight-save-zone-id"
 
* 0=Not set
 
* 1=Australia 2007 (ACT, South Australia, Tasmania, Victoria)
 
* 2=Australia 2007 (New South Wales)
 
* 3=Australia (Western Australia)
 
* 4=Australia 2008+ (ACT, New South Wales, South Australia, Tasmania, Victora)
 
* 5=Brazil
 
* 6=Canada
 
* 7=Canada (Newfoundland)
 
* 8=Europe (Portugal, United Kingdom)
 
* 9=Europe (Rest)
 
* 10=Europe (Finland)
 
* 11=Mexico
 
* 12=United States
 
* 13=New Zealand
 
* 14=New Zealand (Chatham)
 
 
 
=== Audio Codec Settings ===
 
 
 
Audio codecs require a special handling inside the config.xml file as they need to be send as a complete group. Example file below:
 
 
 
  <Item name="codec-type" index="1">0</Item>
 
  <Item name="codec-type" index="2">1</Item>
 
  <Item name="codec-type" index="3">2</Item>
 
  <Item name="codec-allowed" index="1">true</Item>
 
  <Item name="codec-allowed" index="2">true</Item>
 
  <Item name="codec-allowed" index="3">true</Item>
 
  <Item name="codec-packet-size" index="1">2</Item>
 
  <Item name="codec-packet-size" index="2">2</Item>
 
  <Item name="codec-packet-size" index="3">2</Item>
 
  <Item name="codec-rank" index="1">2</Item>
 
  <Item name="codec-rank" index="2">1</Item>
 
  <Item name="codec-rank" index="3">3</Item>
 
  <Item name="audio-silence-suppression">false</Item>
 
 
 
 
 
{| {{DefaultTable}}
 
|-
 
! width="200" | Item name
 
! width="100" | Item index
 
! width="100" | Type
 
! width="500" | Details
 
|-
 
| codec-type
 
| 1,2 or 3
 
| Enumeration
 
| 0=G.711, 1=G.722, 2=G.729
 
|-
 
| codec-allowed
 
| 1,2 or 3
 
| Boolean
 
| Enables codec referred to by index value. true or false
 
|-
 
| codec-packet-size
 
| 1,2 or 3
 
| Enumeration
 
| Packet size for codec referred to by index value. 0=10ms, 1=20ms, 2=Automatic, 3=30ms, 4=60ms, 5=40ms
 
|-
 
| codec-rank
 
| 1,2 or 3
 
| Enumeration
 
| Set codec rank in SDP negotiation. 1=1st preference, 2=2nd preference, 3=3rd preference
 
|-
 
| audio-silence-suppression
 
| no index
 
| Boolean
 
| Enables silence supression. true or false
 
|}
 
 
 
 
 
=== FPK programming ===
 
 
 
In order to program a free programmable key (FPK) via DMS, you need to take the phone type into account. The phone type defines the amount of keys you can program.
 
* 48 keys on CP600 (with 4 Key modules attached. 4 times 12 keys on the key modules)
 
* 48 keys on CP400 (with 2 Key modules attached. 16 keys on the base device, 2 times 16 keys on the key modules)
 
* 4 keys on CP200 (all on the base device)
 
 
 
First you need the key index where the functionality will be put on.
 
 
 
{| {{DefaultTable}}
 
|-
 
! width="100" | Phone type
 
! width="150" colspan="2" | Index base device (normal/shift)
 
! width="150" colspan="2" | Index Key module 1 (normal/shift)
 
! width="150" colspan="2" | Index Key module 2 (normal/shift)
 
! width="150" colspan="2" | Index Key module 3 (normal/shift)
 
! width="150" colspan="2" | Index Key module 4 (normal/shift)
 
|-
 
| CP600
 
| 301-312
 
| 1301-1312
 
| 301-312
 
| 1301-1312
 
| 401-512
 
| 1401-1412
 
| 701-712
 
| 1701-1712
 
| 801-812
 
| 1801-1812
 
|-
 
| CP400
 
| 1-16
 
| 1001-1016
 
| 301-316
 
| 1301-1316
 
| 401-416
 
| 1401-1416
 
| colspan="4"| not available
 
|-
 
| CP200
 
| 1-4
 
| 101-104
 
| colspan="8"| not available
 
|}
 
 
 
Remember the index number of the FPK, where you want to configure a function. We will use index "1" in the following examples.
 
 
 
==== Shared call appearance ====
 
 
 
  <Item name="function-key-def" index="1">31</Item>
 
  <Item name="key-label-unicode" index="1">Bob Smith</Item>
 
  <Item name="line-primary" index="1">true</Item>
 
  <Item name="line-shared-type" index="1">0</Item>
 
  <Item name="line-sip-uri" index="1">2405551111_1</Item>
 
  <Item name="line-sip-user-id" index="1">bobsmith</Item>
 
  <Item name="line-sip-pwd" index="1">bobs</Item>
 
  <Item name="line-sip-realm" index="1">realm</Item>
 
  <Item name="line-ring" index="1">true</Item>
 
  <Item name="line-ring-delay" index="1">0</Item>
 
 
 
{| {{DefaultTable}}
 
|-
 
! width="200" | Item name
 
! width="100" | Item index
 
! width="100" | Type
 
! width="500" | Details
 
|-
 
| function-key-def
 
| 1
 
| Enumeration
 
| 31=shared call appearance
 
|-
 
| key-label-unicode
 
| 1
 
| String
 
| Key label visible on phone
 
|-
 
| line-primary
 
| 1
 
| Boolean
 
| This line is the primary line (only required for own line). true or false
 
|-
 
| line-shared-type
 
| 1
 
| Enumeration
 
| 0=shared, 1=private
 
|-
 
| line-sip-uri
 
| 1
 
| String
 
| E164 number of this specific line
 
|-
 
| line-sip-user-id
 
| 1
 
| String
 
| SIP username for digest authentication
 
|-
 
| line-sip-pwd
 
| 1
 
| String
 
| SIP password for digest authentication
 
|-
 
| line-sip-realm
 
| 1
 
| String
 
| SIP realm for digest authentication
 
|-
 
| line-ring
 
| 1
 
| Boolean
 
| Enables ringing on this line. true or false
 
|-
 
| line-ring-delay
 
| 1
 
| Integer
 
| Make this line ring with delay of defined value in seconds
 
|}
 
 
 
 
 
=== Feature access settings ===
 
 
 
The phone allows to restrict access to specifc features for the user. This section will show the relevant Items to configure if you want the user to not have access to a specific functionality.
 
 
 
  <Item name="agent-feature-enabled">false</Item>
 
  <Item name="enable-bluetooth-interface">false</Item>
 
  <Item name="enable-WBM">false</Item>
 
  <Item name="pb-lookups-allowed">false</Item>
 
  <Item name="refuse-call">false</Item>
 
  <Item name="feature-availability" index="1">false</Item>
 
  <Item name="feature-availability" index="2">false</Item>
 
  <Item name="feature-availability" index="11">false</Item>
 
  <Item name="feature-availability" index="23">false</Item>
 
  <Item name="feature-availability" index="24">false</Item>
 
  <Item name="feature-availability" index="27">false</Item>
 
  <Item name="feature-availability" index="28">false</Item>
 
  <Item name="feature-availability" index="29">false</Item>
 
  <Item name="feature-availability" index="31">false</Item>
 
  <Item name="feature-availability" index="32">false</Item>
 
  <Item name="feature-availability" index="34">false</Item>
 
  <Item name="feature-availability" index="36">false</Item>
 
 
 
{| {{DefaultTable}}
 
|-
 
! width="200" | Item name
 
! width="100" | Item index
 
! width="100" | Type
 
! width="500" | Details
 
|-
 
| agent-feature-enabled
 
| no index
 
| Boolean
 
| Enables Broadworks Agent feature. true or false
 
|-
 
| enable-bluetooth-interface
 
| no index
 
| Boolean
 
| Enables Bluetooth interface on CP600. true or false
 
|-
 
| enable-WBM
 
| no index
 
| Boolean
 
| Enables Web based interface. true or false
 
|-
 
| pb-lookups-allowed
 
| no index
 
| Boolean
 
| Enables phone book lookups. true or false
 
|-
 
| refuse-call
 
| no index
 
| Boolean
 
| Enables selective call rejection. true or false
 
|-
 
| feature-availability
 
| 1
 
| Boolean
 
| Enables selective call deflection. true or false
 
|-
 
| feature-availability
 
| 2
 
| Boolean
 
| Enables call forwarding functionality. true or false
 
|-
 
| feature-availability
 
| 11
 
| Boolean
 
| Enables do not disturb functionality. true or false
 
|-
 
| feature-availability
 
| 23
 
| Boolean
 
| Enables call pickup functionality. true or false
 
|-
 
| feature-availability
 
| 24
 
| Boolean
 
| Enables call forwarding functionality. true or false
 
|-
 
| feature-availability
 
| 27
 
| Boolean
 
| Enables blind transfer functionality. true or false
 
|-
 
| feature-availability
 
| 28
 
| Boolean
 
| Enables repertory dial keys. true or false
 
|-
 
| feature-availability
 
| 29
 
| Boolean
 
| Enables BLF keys. true or false
 
|-
 
| feature-availability
 
| 31
 
| Boolean
 
| Enables feature toggle keys. true or false
 
|-
 
| feature-availability
 
| 32
 
| Boolean
 
| Enables CTI functionality. true or false
 
|-
 
| feature-availability
 
| 34
 
| Boolean
 
| Enables third callleg functionality. true or false
 
|-
 
| feature-availability
 
| 36
 
| Boolean
 
| Enables phone lock functionality. true or false
 
|}
 

Latest revision as of 11:42, 23 June 2020

please see Device Management System