Softkey Layout

Owned by HTEK_admin (Unlicensed)
Last updated: Jun 27, 2018

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

  • "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>

Configure the softkey layout URL


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.
  4. 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.
  3. IP Phone will get the softkey.xml file from the specified URL:
  4. Enter Setting->Softkey Layout, checking the softkey which you custom.

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