AddSoftkeyItem

Metreos.Native.CiscoIpPhone.AddSoftKeyItem

Summary

AddSoftKeyItem adds a softkey item with any already-initialized XML object except the Status or Execute type.

Usage

AddSoftKeyItem adds a softkey to an XML object, giving the user a button at the bottom of the display on the Cisco IP Phone.

Remarks

This action does not communicate with a Cisco IP Phone; it only formats XML specific to the schema defined by the Cisco IP Phones that support Cisco IP Phone XML Services. Later in the script the XML object stored in a variable can be sent to the phone with either SendResponse or SendExecute.

Action Parameters
Parameter Name.NET TypeDefaultDescription
NameSystem.StringThe display name of the softkey item.
PositionSystem.Int16The 1-indexed position of the softkey item.
URLSystem.StringThe URL that the phone will request if this softkey item is selected.
Format URLSystem.BooleantrueIndicates that URL format validation should be performed on the URL specified. This may involve modifications being made to the URL. Does not apply to 'URLDown' parameter.
URLDownSystem.StringThe command that the phone should execute when the softkey button is depressed.
Result Data
Parameter Name.NET TypeDescription
ResultDataMetreos.Types.CiscoIpPhone.CiscoIPPhoneSoftKeyTypeOne must always save this result data into one of the following: a Text, Menu, Directory, Image, Input, ImageFile, IconMenu, IconFileMenu, GraphicMenu, or GraphicFileMenu XML type variable.

Branch Conditions 

Success

No description.

Failure

No description.