Content
The SnomIPPhoneInput (or IPPhoneInput) tag displays an input field. The entered value can be put anywhere into the URL for the next XML file to process by a freely definable token. In combination with URI fragment commands the value can be used to set settings or variables.
See examples for this tag below.
SnomIPPhoneInput can contain any of the attributes from the Main Attributes list
SnomIPPhoneInput can contain any of the subtags from the Main Subtags list.
In addition, it contains the following subtags:
The URL that is fetched after the input has been finished with the OK (check-mark) button. All occurrences of the string defined in the InputToken element will be replaced by the entered value.
Valid Attributes:
Valid Subtags:
<Url>http://example.com/example.php?myvar=__X__</Url>[...] <InputToken>__X__</InputToken> <Url>http://example.com/example.php#var:foo=$$$BAR$$$</Url>[...]<InputToken>$$$BAR$$$</InputToken>
Required element to determine the input rule.
Valid Subtags:
InputFlags: Specifies the type of input field. If no input flag is defined the normal text input flag will be chosen. Valid values:
Input flag | Input flag description | Option to change input mode | Default input mode |
---|---|---|---|
a | normal text | All modes are selectable and working | lowercase |
t | telephone number | All modes are selectable but not working | number |
n | number | no mode available | number |
e | number with text | All modes are selectable and working | number |
u | uppercase text | number mode is show but can't be chosen | uppercase |
l | lowercase text | uppercase mode is show but can't be chosen | lowercase |
p | password | All modes are selectable and working | lowercase |
pn | numeric password | All modes are selectable and working | number |
InputModeFixed: locks the input mode and does not allow users to change it. You can use this flag by adding it to your <InputItem> like this:
<InputModeFixed>1</InputModeFixed>
Notes:
Avoid to input the following sequences:
XML code:
<?xml version="1.0" encoding="utf-8"?> <SnomIPPhoneInput> <Url>http://example.com/example.php?myvar=__X__</Url> <InputItem> <DisplayName>Title</DisplayName> <InputToken>__X__</InputToken> <DefaultValue>Input</DefaultValue> <InputFlags>a</InputFlags> </InputItem> </SnomIPPhoneInput>
Result:
XML code:
<?xml version="1.0" encoding="UTF-8"?> <SnomIPPhoneInput> <Url>snom://mb_nop#action_ifc:date_time=set,time=__Y__</Url> <InputItem> <DisplayName>Time:$(time)</DisplayName> <InputToken>__Y__</InputToken> <InputMask>99:99</InputMask> <InputFlags>a</InputFlags> <DefaultValue>00:00</DefaultValue> </InputItem> </SnomIPPhoneInput>
Result:
Further Information
Related articles