Versions Compared

Version Old Version 3 New Version 4
Changes made by

HTEK_admin (Unlicensed)

HTEK_admin (Unlicensed)

Saved on

Key

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

Image RemovedImage Removed

Table of Contentsanchor
maxLevel_Toc5126029393_Toc512602939
How to Customize the Softkey Layout
Anchor_Toc512602940_Toc512602940on 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

...

indent20px

Introduction


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.

...

Compatibility


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

...

...

Softkey layout list


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

 

 

 

 

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

...

...

Edit the softkey layout file


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

...


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>

...

...

Configure the softkey layout URL


anchor
_Toc512602946_Toc512602946IP phone support 3 ways to configure the 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 Modified
Image Modified

  1. Click the SaveSet button to save the configuration

...

Verify the softkey Layout feature

  1. Login the IP Phone's webpage->Management->Auto Provision
  2. Click the "Autoprovision Now" button.
    Image Modified
  3. IP Phone will get the softkey.xml file from the specified URL:
    Image Modified
  4. Enter Setting->Softkey Layout, checking the softkey which you custom.
    Image Modified

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