Versions Compared

Version Old Version 1 New Version 2
Changes made by

HTEK_admin (Unlicensed)

HTEK_admin (Unlicensed)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Image AddedImage Added






Anchor
_Toc512602939
_Toc512602939
How to Customize the Softkey Layout
Anchor
_Toc512602940
_Toc512602940
on Htek IP Phones


























Version 2.0.4.4.39
Apr. 2018
Table of Contents
Introduction
Compatibility
Softkey layout list
Edit the softkey layout file
Configure the softkey layout URL
Verify the softkey Layout feature

Anchor
_Toc512602941
_Toc512602941
Anchor
_Toc512603082
_Toc512603082
Introduction

Image Added
Softkey layout is used to customize the soft keys at the bottom of the LCD screen to best meet users' requirements. It can be configured based on call states. In addition to specifying which soft keys to display, you can determine their display order. You can create a template about the softkey layout for the different call states.

Anchor
_Toc512602942
_Toc512602942
Anchor
_Toc512603083
_Toc512603083
Compatibility

Image Added
Custom softkey layout feature is only supported on x.0.4.2 version and above.

Anchor
_Toc512602943
_Toc512602943
Anchor
_Toc512603084
_Toc512603084
Softkey layout list

Anchor
OLE_LINK5
OLE_LINK5
Anchor
OLE_LINK6
OLE_LINK6
Image Added
Anchor
OLE_LINK7
OLE_LINK7
Anchor
OLE_LINK8
OLE_LINK8
The following table lists the soft keys available for IP phones in different states:

Call States

 

 

 

Selected Soft keys(Enable)

 

Unselected Soft keys(Disable)

Dialing

 

 

 

Send
IME
Delete
EndCall

 

Empty
Call Switch
Directory
DPickup
Line
GPickup

Connecting

 

 

Connecting

Empty
Empty
Empty
EndCall

 

Empty
Call Switch

 

 

 

SemiAttendTrans

Transfer
Empty
Empty
EndCall

 

Empty
Call Switch

Ring Back

 

Ring Back

 

Empty
Empty
Empty
EndCall

 

Empty
Call Switch
Callback

 

 

SemiAttendTransBack

 

Transfer
Empty
Empty
EndCall

 

Empty
Call Switch

Call Failed

 

 

 

NewCall
Empty
Empty
EndCall

 

Empty
Call Switch

Call In

 

 

 

Answer
Forward
Silence
Reject

 

Empty
Call Switch

Talking

Talk

 

 

 

Transfer
Hold
Conference
EndCall
Security

Empty
SWAP
Mute
Call Switch
NewCall
Recording

 

Hold

 

 

 

Transfer
Resume
NewCall
EndCall

Empty
Call Switch
Conference

 

Held

 

 

 

Empty
Hold
Empty
EndCall

Empty
Call Switch
NewCall

 

Pretrans

 

 

 

Transfer
Send
Delete
EndCall

Empty
Call Switch
Directory
IME

 

Conferenced

 

 

 

Empty
Hold
Split
EndCall

Empty
Call Switch
Mute

Call Waiting

 

 

 

Transfer
Answer
Reject
EndCall
NewCall

 

Empty

Anchor
_Toc512602944
_Toc512602944
Anchor
_Toc512603085
_Toc512603085
Edit the softkey layout file

Image Added
The file's encode is UTF-8;
You can edit softkey in different states.
But you need to know the meaning of Labels

  • "Enable" is selected softkey
  • "Disable" is unselected softkey
  • "Default" is default softkey (if you want to use the default softkey, you can reset to factory or press the "Reset to default" from IP Phone's webapage->Setting->Softkey Layout)


Softkey layout content as following:
<?xml version="1.0" ?>
<Softkey>
<Dialing>
<Disable>
<Key Type="Empty" />
<Key Type="Call Switch" />
<Key Type="Directory" />
<Key Type="Direct Pickup" />
<Key Type="Line Selection" />
<Key Type="Group Pickup" />
</Disable>
<Enable>
<Key Type="Send" />
<Key Type="IME" />
<Key Type="Delete" />
<Key Type="Cancel" />
</Enable>
<Default>
<Key Type="Send" />
<Key Type="IME" />
<Key Type="Delete" />
<Key Type="Cancel" />
</Default>
</Dialing>
<Connecting>
<Disable>
<Key Type="Empty" />
<Key Type="Call Switch" />
</Disable>
<Enable>
<Key Type="Empty" />
<Key Type="Empty" />
<Key Type="Empty" />
<Key Type="Cancel" />
</Enable>
<Default>
<Key Type="Empty" />
<Key Type="Empty" />
<Key Type="Empty" />
<Key Type="Cancel" />
</Default>
</Connecting>
<SemiAttendTrans>
<Disable>
<Key Type="Empty" />
<Key Type="Call Switch" />
</Disable>
<Enable>
<Key Type="Transfer" />
<Key Type="Empty" />
<Key Type="Empty" />
<Key Type="Cancel" />
</Enable>
<Default>
<Key Type="Transfer" />
<Key Type="Empty" />
<Key Type="Empty" />
<Key Type="Cancel" />
</Default>
</SemiAttendTrans>
<RingBack>
<Disable>
<Key Type="Empty" />
<Key Type="Call Switch" />
<Key Type="Callback" />
</Disable>
<Enable>
<Key Type="Empty" />
<Key Type="Empty" />
<Key Type="Empty" />
<Key Type="Cancel" />
</Enable>
<Default>
<Key Type="Empty" />
<Key Type="Empty" />
<Key Type="Empty" />
<Key Type="Cancel" />
</Default>
</RingBack>
<SemiAttendTransBack>
<Disable>
<Key Type="Empty" />
<Key Type="Call Switch" />
</Disable>
<Enable>
<Key Type="Transfer" />
<Key Type="Empty" />
<Key Type="Empty" />
<Key Type="Cancel" />
</Enable>
<Default>
<Key Type="Transfer" />
<Key Type="Empty" />
<Key Type="Empty" />
<Key Type="Cancel" />
</Default>
</SemiAttendTransBack>
<CallFailed>
<Disable>
<Key Type="Empty" />
<Key Type="Call Switch" />
</Disable>
<Enable>
<Key Type="NewCall" />
<Key Type="Empty" />
<Key Type="Empty" />
<Key Type="Cancel" />
</Enable>
<Default>
<Key Type="NewCall" />
<Key Type="Empty" />
<Key Type="Empty" />
<Key Type="Cancel" />
</Default>
</CallFailed>
<CallIn>
<Disable>
<Key Type="Empty" />
<Key Type="Call Switch" />
</Disable>
<Enable>
<Key Type="Answer" />
<Key Type="Forward" />
<Key Type="Silence" />
<Key Type="Reject" />
</Enable>
<Default>
<Key Type="Answer" />
<Key Type="Forward" />
<Key Type="Silence" />
<Key Type="Reject" />
</Default>
</CallIn>
<Talk>
<Disable>
<Key Type="Empty" />
<Key Type="SWAP" />
<Key Type="Mute" />
<Key Type="Call Switch" />
<Key Type="NewCall" />
<Key Type="Recording" />
</Disable>
<Enable>
<Key Type="Transfer" />
<Key Type="Hold" />
<Key Type="Conference" />
<Key Type="Cancel" />
<Key Type="Security" />
</Enable>
<Default>
<Key Type="Transfer" />
<Key Type="Hold" />
<Key Type="Conference" />
<Key Type="Cancel" />
<Key Type="Security" />
</Default>
</Talk>
<Hold>
<Disable>
<Key Type="Empty" />
<Key Type="Call Switch" />
<Key Type="Conference" />
</Disable>
<Enable>
<Key Type="Transfer" />
<Key Type="Resume" />
<Key Type="NewCall" />
<Key Type="Cancel" />
</Enable>
<Default>
<Key Type="Transfer" />
<Key Type="Resume" />
<Key Type="NewCall" />
<Key Type="Cancel" />
</Default>
</Hold>
<Held>
<Disable>
<Key Type="Empty" />
<Key Type="Call Switch" />
<Key Type="NewCall" />
</Disable>
<Enable>
<Key Type="Empty" />
<Key Type="Hold" />
<Key Type="Empty" />
<Key Type="Cancel" />
</Enable>
<Default>
<Key Type="Empty" />
<Key Type="Hold" />
<Key Type="Empty" />
<Key Type="Cancel" />
</Default>
</Held>
<PreTrans>
<Disable>
<Key Type="Empty" />
<Key Type="Call Switch" />
<Key Type="IME" />
<Key Type="Directory" />
</Disable>
<Enable>
<Key Type="Transfer" />
<Key Type="Send" />
<Key Type="Delete" />
<Key Type="Cancel" />
</Enable>
<Default>
<Key Type="Transfer" />
<Key Type="Send" />
<Key Type="Delete" />
<Key Type="Cancel" />
</Default>
</PreTrans>
<Conferenced>
<Disable>
<Key Type="Empty" />
<Key Type="Call Switch" />
<Key Type="Mute" />
</Disable>
<Enable>
<Key Type="Empty" />
<Key Type="Hold" />
<Key Type="Split" />
<Key Type="Cancel" />
</Enable>
<Default>
<Key Type="Empty" />
<Key Type="Hold" />
<Key Type="Split" />
<Key Type="Cancel" />
</Default>
</Conferenced>
<Callwaiting>
<Disable>
<Key Type="Empty" />
</Disable>
<Enable>
<Key Type="Transfer" />
<Key Type="Answer" />
<Key Type="Reject" />
<Key Type="Cancel" />
<Key Type="NewCall" />
</Enable>
<Default>
<Key Type="Transfer" />
<Key Type="Answer" />
<Key Type="Reject" />
<Key Type="Cancel" />
<Key Type="NewCall" />
</Default>
</Callwaiting>
</Softkey>

Anchor
OLE_LINK1
OLE_LINK1
Anchor
OLE_LINK2
OLE_LINK2
Anchor
OLE_LINK13
OLE_LINK13
Anchor
OLE_LINK14
OLE_LINK14
Anchor
_Toc512602945
_Toc512602945
Anchor
_Toc512603086
_Toc512603086
Configure the softkey layout URL

Anchor
OLE_LINK283
OLE_LINK283
Anchor
OLE_LINK284
OLE_LINK284
Image Added
Anchor
_Toc512602946
_Toc512602946
IP phone support 3 ways to configure the
Anchor
OLE_LINK281
OLE_LINK281
Anchor
OLE_LINK282
OLE_LINK282
softkey layout URL:

Configuration file

 

P20995
(e.g:

http://test:123456@192.168.0.18:8088/softkey.xml

)

Web Interface

 

Management->Auto Provision->Softkey Layout URL
(e.g:

http://test:123456@192.168.0.18:8088/softkey.xml

)

Phone Interface

 

N/A


To configure the softkey layout URL via web interface:

  1. Login the IP Phone's webpage(admin/admin)
  2. Management->Auto Provision
  3. Enter the URL in the Softkey Layout URL field.

Image Added
Image Added

  1. Click the SaveSet button to save the configuration

Anchor
_Toc512602947
_Toc512602947
Anchor
_Toc512603087
_Toc512603087
Verify the softkey Layout feature

Image Added

  1. Login the IP Phone's webpage->Management->Auto Provision
  2. Click the "Autoprovision Now" button.

Image Added

  1. IP Phone will get the softkey.xml file from the specified URL:

Image Added

  1. Enter Setting->Softkey Layout, checking the softkey which you custom.

Image Added
Note:
If you disable the Custom softkey, IP Phone will not get the softkey.xml.