📄 rfc3149.txt
字号:
| | | the specified name. This |
| | | variable is used in the |
| | | <option> tag to specify the |
| | | index of an item that is |
| | | selected. The value of this |
| | | attribute is available to any |
| | | Action string in the card by |
| | | using the %iname variable. The|
| | | value of the index variable is|
| | | available by using the |
| | | %<string value> variable. |
| | | See examples below. |
|_______________|_____________________|_______________________________|
5.5.5 Option Tag
When used in conjunction with the <select> tag, the <option> tag
specifies an individual item that may be selected from a list.
Srinath, et al. Informational [Page 19]
RFC 3149 MGCP Business Phone Packages September 2001
This tag has the following attributes:
_______________ _____________________ _______________________________
|Attribute Name | Values | Usage |
|_______________|_____________________|_______________________________|
| value | String | Defines the value of the item.|
| | | This is used when reporting an|
| | | event to the Call Agent. The |
| | | value of this attribute is |
| | | available to any Action string|
| | | in the card by using the |
| | | %value variable. |
|_______________|_____________________|_______________________________|
| onpick | Action | Defines the string to be sent |
| | | to the Call Agent when the |
| | | item is selected. |
|_______________|_____________________|_______________________________|
5.5.6 Input Tag
The <input> tag specifies that user input is required.
This tag has the following attributes:
_______________ _____________________ _______________________________
|Attribute Name | Values | Usage |
|_______________|_____________________|_______________________________|
| name | String | Specifies the name of the |
| | | input tag. The value of this |
| | | attribute is available to any |
| | | Action string in the card by |
| | | using the %name variable. |
|_______________|_____________________|_______________________________|
| type | Enum: password/text | Specifies whether the input |
| | (text) | box is in password mode |
| | | (password) or normal mode |
| | | (text). When in password mode,|
| | | user input should be masked. |
|_______________|_____________________|_______________________________|
5.5.7 Echo Tag
The <echo> tag indicates that user input is required. Any keypad
activity is reported to the XML layer but not consumed when this tag
is used.
Srinath, et al. Informational [Page 20]
RFC 3149 MGCP Business Phone Packages September 2001
This tag has the following attributes:
_______________ _____________________ _______________________________
|Attribute Name | Values (default) | Usage |
|_______________|_____________________|_______________________________|
| mode | Enum: on/off (on) | Specifies whether the echo box|
| | | is in password mode (off) or |
| | | normal mode (on). When in |
| | | password mode, user input |
| | | should be masked. |
|_______________|_____________________|_______________________________|
| align | Align | Specifies the alignment of the|
| | | echo tag. |
|_______________|_____________________|_______________________________|
5.5.8 Calltimer Tag
The <calltimer> tag is used to indicate that an incrementing timer is
to be displayed.
This tag has the following attributes:
_______________ _____________________ _______________________________
|Attribute Name | Values | Usage |
|_______________|_____________________|_______________________________|
| value | Time | Specifies the initial value of|
| | | the call timer. |
|_______________|_____________________|_______________________________|
| align |Align | Specifies the alignment of the|
| | | call timer. |
|_______________|_____________________|_______________________________|
5.5.9 Time Tag
The <time> tag is used to display the current time on the phone.
This tag has the following attributes:
_______________ _____________________ _______________________________
|Attribute Name | Values | Usage |
|_______________|_____________________|_______________________________|
| align | Align | Specifies the alignment of the|
| | | time. |
|_______________|_____________________|_______________________________|
5.5.10 Timer Tag
The <timer> tag is used to define a timeout for the card. When the
timeout occurs, the XML Layer looks for the appropriate <do> tag to
take appropriate action.
Srinath, et al. Informational [Page 21]
RFC 3149 MGCP Business Phone Packages September 2001
This tag has the following attributes:
_______________ _____________________ _______________________________
|Attribute Name | Values | Usage |
|_______________|_____________________|_______________________________|
| Value | Time | Specifies the initial value of|
| | | the timer. The timer will |
| | | decrement the time until it |
| | | reaches zero at which point |
| | | the <do> tag is consulted. |
|_______________|_____________________|_______________________________|
5.5.11 Do Tag
The <do> tag indicates an action to be performed when the specified
event occurs.
Currently, the <do> tag can process three events: prev, ontimer and
accept. The prev event indicates that the user has requested to
cancel the current card.
The ontimer event indicates that the timer defined using the <timer>
tag has expired.
The accept event indicates that the user has completed inputting from
the keypad.
This tag has the following attributes:
_______________ _____________________ _______________________________
|Attribute Name | Values (default) | Usage |
|_______________|_____________________|_______________________________|
|Type | Enum: | Indicates the event on which |
| | prev/ontimer/accept | the tag operates. |
|_______________|_____________________|_______________________________|
5.5.12 Go Tag
The <go> tag is used in conjunction with the <do> tag to specify a
URL to be loaded when the event occurs.
This tag has the following attributes:
_______________ _____________________ _______________________________
|Attribute Name | Values (default) | Usage |
|_______________|_____________________|_______________________________|
| href | URL | Defines the URL of the next |
| | | XML page. |
|_______________|_____________________|_______________________________|
Srinath, et al. Informational [Page 22]
RFC 3149 MGCP Business Phone Packages September 2001
5.5.13 Prev Tag
The <prev> tag is used in conjunction with the <do> tag to indicate
that the previous page in the display history should be rendered.
This tag has no attributes.
6. Security Considerations
This extension introduces no new security considerations beyond those
discussed in RFC 2705 [1].
7. Acknowledgements
Thanks to the following companies and individuals for contributing
their experience and thoughts for inclusion in this document.
Arnie Chencinski, Sylantro Systems
Bill Foster, Cisco Systems
Howard Holgate, Cisco Systems
John Weald, Sylantro Systems
Michael Chack, Sylantro Systems
Naga Surendran, Sylantro Systems
Sunil Veluvali, Sylantro Systems
8. References
[1] Arango, M., Dugan A., Elliot, I., Huitema, C. and S. Pickett,
"Media Gateway Control Protocol (MGCP)" RFC 2705, October 1999.
[2] Bray, T., Paoli, J. and C. Sperberg-McQueen, "Extensible Markup
Language (XML) 1.0", W3C Proposed Recommendation, February 10,
1998.
[3] "Wireless Application Protocol Wireless Markup Language
Specification Version 1.2", WAP Forum, November 1999.
Srinath, et al. Informational [Page 23]
RFC 3149 MGCP Business Phone Packages September 2001
9. Authors' Addresses
Ashok Srinath
Sylantro Systems
910 E. Hamilton Avenue
Campbell, Ca. 95008
EMail: Ashok.Srinath@sylantro.com
Gil Levendel
Sylantro Systems
910 E. Hamilton Avenue
Campbell, Ca. 95008
EMail: Gil.Levendel@sylantro.com
Kent Fritz
Sylantro Systems
910 E. Hamilton Avenue
Campbell, Ca. 95008
EMail: Kent.Fritz@sylantro.com
Raghuraman Kalyanaram
Wipro Systems
Keonics Electronic City
Hosur Road, Bangalore-561 229, India
EMail: Raghuraman.Kal@wipro.com
Srinath, et al. Informational [Page 24]
RFC 3149 MGCP Business Phone Packages September 2001
Appendix A: BNF description of XML grammar
The parser is case sensitive. In this section we will use the
following conventions:
1. Small letters means terminals.
2. Capital strings are non-terminals.
3. [A | B] means either A or B must appear in this place.
4. \t, \n, \r, blank space are separators.
______________ _ ____________________________________________________
|ACTION |:|<go href="HREFSTRING"/> | <prev/> |
|______________|_|____________________________________________________|
|ALIGN |:|Align=["left" | "right" ] |
|______________|_|____________________________________________________|
|CALLTIMER |:|<calltimer CALLTIMERATTRS/> |
|______________|_|____________________________________________________|
|CALLTIMERATTRS|:|CALLTIMERATTR | CALLTIMERATTR CALLTIMERATTRS |
|______________|_|____________________________________________________|
|CALLTIMERATTR |:|value=STRING | ALIGN |
|______________|_|____________________________________________________|
|CARDS |:|CARD | CARD CARDS |
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -