Versions Compared

Version Old Version 7 New Version Current
Changes made by

HTEK_admin (Unlicensed)

HTEK_admin (Unlicensed)

Saved on

Key

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

...

 

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

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_Toc512602946
IP 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

...

  1. Image Modified
  2. 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.