Jabber/XMPP中文翻译计划 - 用户贡献 [zh-cn]

XEP-0054

2012-09-29T08:17:03Z

Zoey1990:

[[Category:XMPP扩展]]
[[Category:已翻译]]

'''本文的英文原文来自[http://www.xmpp.org/extensions/xep-0054.html XEP-0054]'''

'''XEP-0054:电子名片'''

摘要: 本文档提供了目前在Jabber社区中使用的vCard-XML格式的典型文档.

作者: Peter Saint-Andre

版权: ? 1999 - 2010 XMPP标准化基金会(XSF). 参见[[XEP-0054#附录C:法律通告|法律通告]].

状态: 活跃的

类型: 历史的

版本: 1.2

最后更新日期: 2008-07-16

注意: 这个历史性的标准提供了目前在Jabber/XMPP社区中使用的一个协议.本文不是XMPP标准化基金会标准跟踪过程中的标准跟踪协议,无论如何,将来它可能被转化为标准跟踪,也可能被一个更新的协议取代.

==绪论==

这份vCard-XML格式的说明文档在Jabber社区内正被使用。未来的说明文档将会推荐一个标准协议来取代这份文档。

对于用户来说，基础的功能是存储和获取用户的电子身份，该信息是用XML表示的，数据的存储取决于所有现存的Jabber服务器的实现。这可以通过发送类型为“set”(存储)或者“get”(获取)的<iq/>到Jabber服务器来完成，该<iq/>节点包含了<vCard/>子节点并用“vcard-temp”命名空间限定，<vCard/>包含实际的vCard-XML格式的元素，这在vCard-XML DTD中定义。然后其他用户就可以查看某人的vcard信息了。

==历史==

vCard是一种现存的、广泛使用的，用户个人信息存储的标准，有点像是电子名片。vCard的格式在[http://tools.ietf.org/html/rfc2426 RFC 2426] [[XEP-0054#附录G:备注|1]]中定义。

在1998年和1999年，Frank Dawson提交了4个修订的Internet草案描述了用XML表示的vCard格式。起初，当Jabberd开源项目在寻找一种存储个人信息的方法时，jabberd开发者最近一次修订版本是draft-dawson-vcard-xml-dtd-01 [[XEP-0054#附录G:备注|2]]。他也在1998年11月15日提交了第二次修订版 [[XEP-0054#附录G:备注|3]] 和在1999年6月22提交了第三次修订版 [[XEP-0054#附录G:备注|4]]。

不幸的是，Dawson的建议没有被提交到IETF的标准进程。但是因为某些原因被遗忘和丢失了，Jabber项目继续使用draft-dawson-vcard-xml-dtd-01 的DTD，为了使它适合在Jabber(增加了JABBERID和DESC的元素)中使用，它被做两个小的修改。也指定了元素名是大写而不是在draft-dawson-vcard-xml-dtd-01中定义的小写字母。另外，Jabber社区延续了关于版本信息的草案的使用(而不是DTD)，把它作为vCard元素的属性而不是子元素。这格式在Jabber中和在“vcard-temp”命名空间下被Jabber社区实现。

==用例==

===检索用户的电子身份===

用户通过发送不含'to'地址并且包含以'vcard-temp'命名空间为限制的<vCard/>子元素的IQ-get节来检索他(她)自己的vCard电子身份。

'''例子1. vCard检索请求'''

<source lang="xml">
<iq from='stpeter@jabber.org/roundabout'
id='v1'
type='get'>
<vCard xmlns='vcard-temp'/>
</iq>
</source>

如果用户拥有vCard，则服务器必须(MUST)返回IQ-result。

'''例子2. 服务器返回vCard'''

<source lang="xml">
<iq id='v1'
to='stpeter@jabber.org/roundabout'
type='result'>
<vCard xmlns='vcard-temp'>
<FN>Peter Saint-Andre</FN>
<N>
<FAMILY>Saint-Andre</FAMILY>
<GIVEN>Peter</GIVEN>
<MIDDLE/>
</N>
<NICKNAME>stpeter</NICKNAME>
<URL>http://www.xmpp.org/xsf/people/stpeter.shtml</URL>
<BDAY>1966-08-06</BDAY>
<ORG>
<ORGNAME>XMPP Standards Foundation</ORGNAME>
<ORGUNIT/>
</ORG>
<TITLE>Executive Director</TITLE>
<ROLE>Patron Saint</ROLE>
<TEL><WORK/><VOICE/><NUMBER>303-308-3282</NUMBER></TEL>
<TEL><WORK/><FAX/><NUMBER/></TEL>
<TEL><WORK/><MSG/><NUMBER/></TEL>
<ADR>
<WORK/>
<EXTADD>Suite 600</EXTADD>
<STREET>1899 Wynkoop Street</STREET>
<LOCALITY>Denver</LOCALITY>
<REGION>CO</REGION>
<PCODE>80202</PCODE>
<CTRY>USA</CTRY>
</ADR>
<TEL><HOME/><VOICE/><NUMBER>303-555-1212</NUMBER></TEL>
<TEL><HOME/><FAX/><NUMBER/></TEL>
<TEL><HOME/><MSG/><NUMBER/></TEL>
<ADR>
<HOME/>
<EXTADD/>
<STREET/>
<LOCALITY>Denver</LOCALITY>
<REGION>CO</REGION>
<PCODE>80209</PCODE>
<CTRY>USA</CTRY>
</ADR>
<EMAIL><INTERNET/><PREF/><USERID>stpeter@jabber.org</USERID></EMAIL>
<JABBERID>stpeter@jabber.org</JABBERID>
<DESC>
More information about me is located on my
personal website: http://www.saint-andre.com/
</DESC>
</vCard>
</iq>
</source>

如果不存在 vCard , 服务必须 MUST 返回一个节错误 (它应该 (SHOULD) 是 <item-not-found/>) 或一个包含空的 <vCard/> 元素的 IQ-result.

例子 3. 没有vCard(条目没找到)

<source lang="xml">
<iq id='v1'
to='stpeter@jabber.org/roundabout'
type='error'>
<vCard xmlns='vcard-temp'/>
<error type='cancel'>
<item-not-found xmlns='urn:ietf:params:xml:ns:xmpp-stanzas'/>
</error>
</iq>
</source>

例子 4. 没有vCard(空元素)

<source lang="xml">
<iq id='v1'
to='stpeter@jabber.org/roundabout'
type='result'>
<vCard xmlns='vcard-temp'/>
</iq>
</source>

===更新用户的vCard===

用户通过发送类型为'set'，不带'to'地址的IQ节来发布或者更新他(她)的vCard，，并且符合前个用例的格式。

'''例子5. vCard更新请求'''

<source lang="xml">
<iq id='v2' type='set'>
<vCard xmlns='vcard-temp'>
<FN>Peter Saint-Andre</FN>
<N>
<FAMILY>Saint-Andre</FAMILY>
<GIVEN>Peter</GIVEN>
<MIDDLE/>
</N>
<NICKNAME>stpeter</NICKNAME>
<URL>http://www.xmpp.org/xsf/people/stpeter.shtml</URL>
<BDAY>1966-08-06</BDAY>
<ORG>
<ORGNAME>XMPP Standards Foundation</ORGNAME>
<ORGUNIT/>
</ORG>
<TITLE>Executive Director</TITLE>
<ROLE>Patron Saint</ROLE>
<TEL><WORK/><VOICE/><NUMBER>303-308-3282</NUMBER></TEL>
<TEL><WORK/><FAX/><NUMBER/></TEL>
<TEL><WORK/><MSG/><NUMBER/></TEL>
<ADR>
<WORK/>
<EXTADD>Suite 600</EXTADD>
<STREET>1899 Wynkoop Street</STREET>
<LOCALITY>Denver</LOCALITY>
<REGION>CO</REGION>
<PCODE>80202</PCODE>
<CTRY>USA</CTRY>
</ADR>
<TEL><HOME/><VOICE/><NUMBER>303-555-1212</NUMBER></TEL>
<TEL><HOME/><FAX/><NUMBER/></TEL>
<TEL><HOME/><MSG/><NUMBER/></TEL>
<ADR>
<HOME/>
<EXTADD/>
<STREET/>
<LOCALITY>Denver</LOCALITY>
<REGION>CO</REGION>
<PCODE>80209</PCODE>
<CTRY>USA</CTRY>
</ADR>
<EMAIL><INTERNET/><PREF/><USERID>stpeter@jabber.org</USERID></EMAIL>
<JABBERID>stpeter@jabber.org</JABBERID>
<DESC>
Check out my blog at https://stpeter.im/
</DESC>
</vCard>
</iq>
</source>

然后服务器返回IQ-result(或者IQ-error)

'''例子6. 服务器返回成功'''

<source lang="xml">
<iq id='v2'
to='stpeter@jabber.org/roundabout'
type='result'/>
</source>

注意，上述的IQ-Set只有一个元素发生了变化(<DESC/>元素)。目前没有可以局部更新vCard的方法，为了更新任何一部分的vCard,必须发送完整的vCard到服务器。

如果用户企图执行一个关于其他用户的vCard的IQ set(即，把to地址设为不是发送者的纯JID)，那么服务必须(MUST)返回一个节错误，应该为 <forbidden/> 或 <not-allowed/>.

'''例子 7. 实体试图修改别人的vCard'''

<source lang="xml">
<iq id='v2'
to='stpeter@jabber.org/roundabout'
type='error'>
<error type='auth'>
<forbidden xmlns='urn:ietf:params:xml:ns:xmpp-stanzas'/>
</error>
</iq>
</source>

===查看另一个用户的vCard===

用户可能要查看另一个用户的vCard,通过发送类型为get的IQ到另一个用户的纯JID

'''例子8. 请求另一个用户的vCard'''

<source lang="xml">
<iq from='stpeter@jabber.org/roundabout'
id='v3'
to='jer@jabber.org'
type='get'>
<vCard xmlns='vcard-temp'/>
</iq>
</source>

根据XMPP Core [[XEP-0054#附录G:备注|5]]，一个兼容的服务器必须(MUST)代表(被请求者)响应请求并且不将IQ转发到被请求者的已连接的资源。

'''例子9. 接收另一个用户的vCard'''

<source lang="xml">
<iq from='jer@jabber.org'
to='stpeter@jabber.org/roundabout'
type='result'
id='v3'>
<vCard xmlns='vcard-temp'>
<FN>JeremieMiller</FN>
<N>
<GIVEN>Jeremie</GIVEN>
<FAMILY>Miller</FAMILY>
<MIDDLE/>
</N>
<NICKNAME>jer</NICKNAME>
<EMAIL><INTERNET/><PREF/><USERID>jeremie@jabber.org</USERID></EMAIL>
<JABBERID>jer@jabber.org</JABBERID>
</vCard>
</iq>
</source>

如果不存在 vCard 或该用户不存在, 服务必须 MUST 返回一个节错误, 它应该 SHOULD 是 <service-unavailable/> 或 <item-not-found/>.

'''例子 10. 无vCard'''

<source lang="xml">
<iq id='v3'
to='stpeter@jabber.org/roundabout'
type='error'>
<vCard xmlns='vcard-temp'/>
<error type='cancel'>
<service-unavailable xmlns='urn:ietf:params:xml:ns:xmpp-stanzas'/>
</error>
</iq>
</source>

注意：vCard的使用不受限于自然人用户帐号。比如，XMPP服务器可以有自己的vCard，该vCard可以被服务器主机上的组织，物理位置，相关的联系地址定义。

==确定支持==

如果一个实体支持 vcard-temp 协议, 它必须 MUST 报告这一点，通过在对[[XEP-0030|服务发现]] [[XEP-0054#附录G:备注|6]]信息请求disco#info的回应中包含一个服务发现特性 "vcard-temp" (关于发行一个或多个名字空间，参见[[XEP-0054#协议名字空间|协议名字空间]]):

'''例子 11. 服务发现信息请求'''

<source lang="xml">
<iq type='get'
from='juliet@capulet.lit/balcony'
to='capulet.lit'
id='disco1'>
<query xmlns='http://jabber.org/protocol/disco#info'/>
</iq>
</source>

'''例子 12. 服务发现信息应答'''

<source lang="xml">
<iq type='result'
from='capulet.lit'
to='juliet@capulet.lit/balcony'
id='disco1'>
<query xmlns='http://jabber.org/protocol/disco#info'>
...
<feature var='vcard-temp'/>
...
</query>
</iq>
</source>

这个信息也可以通过 [http://xmpp.org/extensions/xep-0115.html 实体能力] [[XEP-0054#附录G:备注|7]] 为那些共享出席信息的实体封装.

==安全事项==

发送到Jabber服务器的vCard信息是在整个世界范围内可读的；因此，用户应该谨慎地决定更新哪些信息。(比如，街道地址，个人电话，email地址)。

==IANA事项==

本文档与[http://www.iana.org/ 互联网编号分配授权机构] [[XEP-0054#附录G:备注|8]]无关。

==XMPP注册事项==

===协议名字空间===

[http://www.xmpp.org/registrar/ XMPP Registrar] [[XEP-0054#附录G:备注|9]]在它的协议名字空间注册项中包含了'vcard-temp'(参考<http://www.xmpp.org/registrar/namespaces.html>)。

===URI查询类型===

作为由[http://www.xmpp.org/extensions/xep-0147.html XMPP URI Query Components] [[XEP-0054#附录G:备注|10]]授权的机构，XMPP登记处维护着一个用于 XMPP URIs 的查询和键-值对的注册项（见<[http://www.xmpp.org/registrar/querytypes.html http://www.xmpp.org/registrar/querytypes.html]>）。

vCard的查询类型是作为vCard相关的动作被注册的。

'''例子13. vCard 动作：IRI/URI'''

<source lang="xml">
xmpp:romeo@montague.net?vcard
</source>

'''例子14. vCard动作：结果节'''

<source lang="xml">
<iq to='romeo@montague.net' type='get'>
<vCard xmlns='vcard-temp'/>
</iq>
</source>

下面的提交注册了vCard查询类型。

<source lang="xml">
<querytype>
<name>vcard</name>
<proto>vcard-temp</proto>
<desc>enables retrieval of an entity's vCard data</desc>
<doc>XEP-0054</doc>
</querytype>
</source>

==实现注意事项==

注意以下事项：

* 这个被包含的元素的正确大小写是<vCard/>(XML元素名称是大小写敏感的)。

* 所有在<vCard/>中的元素必须(MUST)是大写的(即使和draft-dawson-vcard-xml-dtd-01中的不一致)

* 国家的简称是<CTRY/>元素，不是<COUNTRY/>元素(即使和draft-dawson-vcard-xml-dtd-01不一致)。

* 电话号码必须(MUST)包含在<NUMBER>元素里，而不是包含在CDATA中的<TEL/>元素里

* 如果<TEL/>元素没有包含电话号码，那么空的<NUMBER/>也必须被包含。

* Email地址必须(MUST)包含在<USERID>元素里，而不是CDATA中的<EMAIL/>元素

* 一些Jabber实现会添加version属性到<vCard/>元素，属性值为2.0或者3.0。DTD是不正确的，draft-dawson-vcard-xml-dtd-01中的例子明确的指出通过version属性表示版本信息，而不是DTD中定义的<VERSION/>元素。然而，为了符合draft-dawson-vcard-xml-dtd-01，版本信息应该被设置为3.0，不是2.0。

==DTD==

下面的DTD包含了轻微修改过的draft-dawson-vcard-xml-dtd-01版本。除此外，其他唯一修改的地方就是添加JABBERID和DESC元素。

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>








<!ELEMENT xCard (vCard)+>


<!ELEMENT vCard (
(VERSION, FN, N),
(NICKNAME?,
PHOTO?,
BDAY?,
ADR?,
LABEL?,
TEL?,
EMAIL?,
JABBERID?,
MAILER?,
TZ?,
GEO?,
TITLE?,
ROLE?,
LOGO?,
AGENT?,
ORG?,
CATEGORIES?,
NOTE?,
PRODID?,
REV?,
SORT-STRING?,
SOUND?,
UID?,
URL?,
CLASS?,
KEY?,
DESC?
)*)>


<!ELEMENT VERSION (#PCDATA)>


<!ELEMENT FN (#PCDATA)>


<!ELEMENT N ( FAMILY?, GIVEN?, MIDDLE?, PREFIX?, SUFFIX?)>

<!ELEMENT FAMILY (#PCDATA)>
<!ELEMENT GIVEN (#PCDATA)>
<!ELEMENT MIDDLE (#PCDATA)>
<!ELEMENT PREFIX (#PCDATA)>
<!ELEMENT SUFFIX (#PCDATA)>


<!ELEMENT NICKNAME (#PCDATA)>


<!ELEMENT PHOTO ((TYPE, BINVAL) | EXTVAL)>


<!ELEMENT BDAY (#PCDATA)>


<!ELEMENT ADR (
HOME?,
WORK?,
POSTAL?,
PARCEL?,
(DOM | INTL)?,
PREF?,
POBOX?,
EXTADD?,
STREET?,
LOCALITY?,
REGION?,
PCODE?,
CTRY?
)>

<!ELEMENT POBOX (#PCDATA)>
<!ELEMENT EXTADD (#PCDATA)>
<!ELEMENT STREET (#PCDATA)>
<!ELEMENT LOCALITY (#PCDATA)>
<!ELEMENT REGION (#PCDATA)>
<!ELEMENT PCODE (#PCDATA)>
<!ELEMENT CTRY (#PCDATA)>


<!ELEMENT LABEL (
HOME?,
WORK?,
POSTAL?,
PARCEL?,
(DOM | INTL)?,
PREF?,
LINE+
)>


<!ELEMENT LINE (#PCDATA)>


<!ELEMENT TEL (
HOME?,
WORK?,
VOICE?,
FAX?,
PAGER?,
MSG?,
CELL?,
VIDEO?,
BBS?,
MODEM?,
ISDN?,
PCS?,
PREF?,
NUMBER
)>


<!ELEMENT NUMBER (#PCDATA)>


<!ELEMENT EMAIL (
HOME?,
WORK?,
INTERNET?,
PREF?,
X400?,
USERID
)>

<!ELEMENT USERID (#PCDATA)>



<!ELEMENT JABBERID (#PCDATA)>


<!ELEMENT MAILER (#PCDATA)>


<!ELEMENT TZ (#PCDATA)>


<!ELEMENT GEO (LAT, LON)>


<!ELEMENT LAT (#PCDATA)>


<!ELEMENT LON (#PCDATA)>


<!ELEMENT TITLE (#PCDATA)>


<!ELEMENT ROLE (#PCDATA)>


<!ELEMENT LOGO ((TYPE, BINVAL) | EXTVAL)>


<!ELEMENT AGENT (vCard | EXTVAL)>


<!ELEMENT ORG (ORGNAME, ORGUNIT*)>

<!ELEMENT ORGNAME (#PCDATA)>

<!ELEMENT ORGUNIT (#PCDATA)>


<!ELEMENT CATEGORIES (KEYWORD+)>

<!ELEMENT KEYWORD (#PCDATA)>


<!ELEMENT NOTE (#PCDATA)>


<!ELEMENT PRODID (#PCDATA)>


<!ELEMENT REV (#PCDATA)>


<!ELEMENT SORT-STRING (#PCDATA)>


<!ELEMENT SOUND (PHONETIC | BINVAL | EXTVAL)>


<!ELEMENT PHONETIC (#PCDATA)>


<!ELEMENT UID (#PCDATA)>


<!ELEMENT URL (#PCDATA)>



<!ELEMENT DESC (#PCDATA)>


<!ELEMENT CLASS (PUBLIC | PRIVATE | CONFIDENTIAL)>

<!ELEMENT PUBLIC EMPTY>

<!ELEMENT PRIVATE EMPTY>

<!ELEMENT CONFIDENTIAL EMPTY>


<!ELEMENT KEY (TYPE?, CRED)>

<!ELEMENT CRED (#PCDATA)>






<!ELEMENT HOME EMPTY>
<!ELEMENT WORK EMPTY>
<!ELEMENT POSTAL EMPTY>
<!ELEMENT PARCEL EMPTY>
<!ELEMENT DOM EMPTY>
<!ELEMENT INTL EMPTY>
<!ELEMENT PREF EMPTY>
<!ELEMENT VOICE EMPTY>
<!ELEMENT FAX EMPTY>
<!ELEMENT PAGER EMPTY>
<!ELEMENT MSG EMPTY>
<!ELEMENT CELL EMPTY>
<!ELEMENT VIDEO EMPTY>
<!ELEMENT BBS EMPTY>
<!ELEMENT MODEM EMPTY>
<!ELEMENT ISDN EMPTY>
<!ELEMENT PCS EMPTY>
<!ELEMENT INTERNET EMPTY>
<!ELEMENT X400 EMPTY>


<!ELEMENT TYPE (#PCDATA)>


<!ELEMENT BINVAL (#PCDATA)>


<!ELEMENT EXTVAL (#PCDATA)>


</source>

==附录==
===附录A:文档信息===

Source Control: HTML RSS
This document in other formats: XML PDF

系列：[http://xmpp.org/extensions/ XEP]

序号：0054

发布者：[http://xmpp.org/xsf/ XMPP标准基金会]

状态：[http://xmpp.org/extensions/xep-0001.html#states-Active 活跃的]

类型：[http://xmpp.org/extensions/xep-0001.html#types-Historical 历史的]

版本：1.2

最后更新：2008-07-16

批准机构：[http://xmpp.org/council/ XMPP理事会]

依赖标准： XMPP Core

替代标准：无

被替代标准：无

缩略名：vcard-temp

原文控制： [http://svn.xmpp.org:18080/browse/XMPP/trunk/extensions/xep-0054.xml HTML] [http://svn.xmpp.org:18080//changelog/~rss/XMPP/trunk/extensions/xep-0054.xml/rss.xml RSS]

本文的其它格式： [http://xmpp.org/extensions/xep-0054.xml XML] [http://xmpp.org/extensions/xep-0054.pdf PDF]

===附录B:作者信息===

'''Peter Saint-Andre'''

Email: [mailto:stpeter@jabber.org stpeter@jabber.org]

JabberID: stpeter@jabber.org

URI: https://stpeter.im/

{{Template:XEP附录CDEF}}

===附录G:备注===

# RFC 2426: vCard MIME Directory Profile <http://tools.ietf.org/html/rfc2426>.
# 本文被归档于 <http://www.watersprings.org/pub/id/draft-dawson-vcard-xml-dtd-01.txt>.
# 本文被归档于 <http://www.watersprings.org/pub/id/draft-dawson-vcard-xml-dtd-02.txt>.
# 本文被归档于 <http://www.watersprings.org/pub/id/draft-dawson-vcard-xml-dtd-03.txt>.
# RFC 3920: 可扩展的消息和出席信息协议 (XMPP): Core <http://tools.ietf.org/html/rfc3920>.
# XEP-0030: Service Discovery <http://xmpp.org/extensions/xep-0030.html>.
# XEP-0115: Entity Capabilities <http://xmpp.org/extensions/xep-0115.html>.
# 互联网编号分配机构(IANA) 是用于互联网协议的唯一性参数值分配的核心协调者, 例如号码和URI计划. 更多信息, 见 <http://www.iana.org/>.
# XMPP登记员XMPP Registrar 维护着一个保留的协议名字空间以及用于由XMPP标准基金会批准的XMPP扩展协议的上下文参数的注册项的列表. 更多信息, 见 <http://xmpp.org/registrar/>.
# XEP-0147: XMPP URI Query Components <http://xmpp.org/extensions/xep-0147.html>.

===附录H:修订历史===

注意: 本协议的旧版本可能在 http://xmpp.org/extensions/attic/ 还可用

'''版本 1.2 (2008-07-16)'''

更多完全定义的错误情景; 增加了确定支持的章节.

(psa)

'''版本 1.1 (2003-03-26)'''

澄清了特定历史的不准确并增加了连接到 Frank Dawson's 的互联网草案的归档版本.

(psa)

'''版本 1.0 (2003-01-09)'''

通过Jabber理事会投票更新状态为活跃.

(psa)

'''版本 0.2 (2002-11-06)'''

很多小修改; 增加了实现注意事项.

(psa)

'''版本 0.1 (2002-10-31)'''

初始版本.

(psa)

----
结束

RFC6121

2012-09-12T07:56:43Z

Zoey1990:

[[Category:XMPP相关RFC]]
[[Category:XMPP核心RFC]]
[[Category:翻译中]]

"本文的英文原文来自[http://xmpp.org/rfcs/rfc6121.html RFC 6121]

{|border="1" cellspacing="0" width="65%"
|互联网工程任务组(IETF) || P. Saint-Andre
|-
|申请讨论: 6121 || Cisco
|-
|取代: 3921 || 2011年3月
|-
|类别: 标准跟踪 ||
|-
|ISSN: 2070-1721 ||
|}

:::'''可扩展的消息和出席信息协议 (XMPP): 即时消息和出席信息'''

'''摘要'''

:本文定义提供了遵循RFC2779要求的基本的即时消息(IM)和出席信息功能的可扩展的消息和出席信息协议(XMPP)的核心功能的扩展. 本文取代了 RFC 3921.

'''本文的状态'''

:这是一个互联网标准跟踪文档.

:本文是互联网工程工作组(IETF)的一个成果. 它代表了IETF社区的一致意见. 它已经公开审核并由互联网工程控制组(IESG)批准发布了. 更多关于互联网标准的信息请参见RFC 5741第2章.

:关于本文当前状态的信息, 任何错误, 以及如何对它提出反馈，请到 http://www.rfc-editor.org/info/rfc6121 .

'''版权通知'''

:Copyright (c) 2011 IETF Trust and the persons identified as the document authors. All rights reserved.

:This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License.

==序论==
===概述===

可扩展的消息和出席信息协议(XMPP)是可扩展的标记语言[[RFC6121#常规备注|XML]]的一个应用范畴,它能使两个或更多网络实体之间的结构化并且可扩展的数据进行准实时的交换. 在[[RFC6120|XMPP‑CORE]]中定义的XMPP的核心特性提供了各种类型的准实时应用的积木, 通过发送由特定的XML命名空间(参考[[RFC6121#常规备注|XML‑NAMES]])所限定的应用特有的数据,它们可被叠加在核心之上. 本文定义的XMPP扩展提供一个[[RFC6121#提示性备注|IMP‑REQS]]所述的即时消息(IM)和出席信息应用所预期的基本功能.

===历史===

XMPP的基本语法和语义最开始是由Jabber开源社区开发的, 主要是在1999年. 2002年, 根据 [[RFC6121#提示性备注|IMP‑REQS]] ，XMPP工作组被允许基于Jabber协议开发一个适合IETF的即时消息和出席信息技术. 到了2004年10月, 发布了 [[RFC3920]] 和 [[RFC3921]] , 意味着那时候XMPP的主要定义完成了.

从2004年开始，互联网社区已经获得了广泛的XMPP实现和布署经验, 包括XMPP标准基金会(XSF)主持下开展的正式的互操作性测试. 本文全面整合了从软件开发者和XMPP服务提供者得到的反馈, 包含了一系列向后兼容的修改，见 [[RFC6121#附录E:和RFC3921的不同|附录E]] . 结果是, 本文反映了互联网社区对于XMPP1.0的即时消息和出席信息特性的初步共识, 因此废止了RFC 3921.

===需求===
===功能汇总===
===术语===

==管理花名册 Managing the Roster==

在XMPP中，一个用户的花名册(roster)包含任意数量的特定联系人。一个用户的花名册由用户的服务器代替用户储存，从而使用户可以从任何资源设备访问花名册信息。当用户添加或修改花名册项目，并且无错误发生时，服务器如果有可能应该(SHOULD)不加修改的存储数据，并且当一个授权的客户端请求花名册时，服务器必须(MUST)返回已存储的数据。

安全警告: 因为用户的花名册包含机密的数据，因此服务器必须(MUST)限制对这些数据的访问，只有经授权验证的实体(典型的为帐户拥有者)才有权利检索，修改和删除它。

===语法和语义===

XEP-0004

2012-09-04T05:55:03Z

Zoey1990:

[[Category:XMPP扩展]]
[[Category:已翻译]]

'''本文的英文原文来自[http://xmpp.org/extensions/xep-0004.html XEP-0004]'''

'''XEP-0004: 数据表单'''

摘要: 本文定义了一个XMPP扩展协议用于数据表单，可以用于worklows如服务配置以及特定应用的数据描述和报告。这个协议包括表单处理的轻量级语义(如请求,响应,提交和取消),定义了几种常见的字段类型(布尔、单个或多个选择的列表选项、单行或多行的文本,单个或多个JabberID、隐藏字段,等等),为以后的数据类型提供扩展性,可以用在广泛的应用中。该协议并不是要提供完整的表格处理功能（由W3C XForms技术提供），而是提供这种功能的基本子集给XMPP使用。

作者: Ryan Eatmon, Joe Hildebrand, Jeremie Miller, Thomas Muldowney, Peter Saint-Andre

XMPP扩展协议的版权(1999-2008)归XMPP标准化基金会(XSF)所有

版权: ? 1999 - 2010 XMPP标准化基金会(XSF). 参见[[XEP-0004#法律通告|法律通告]].

状态: 最终

类型: 标准跟踪

版本: 2.9

最后更新日期: 2007-08-13

注意: 这里定义的协议是XMPP标准化基金会的一个最终标准.对于实现和布署来说可以被认为是一个稳定技术.

==绪论==

几个现有的Jabber/XMPP的协议包含用户和应用程序之间的结构数据交换，为常用的任务，如注册（[http://xmpp.org/extensions/xep-0077.html In-Band Registration][[XEP-0004#附录G:备注|1]]）和搜索（[http://xmpp.org/extensions/xep-0055.html Jabber Search] [[XEP-0004#附录G:备注|2]]）。不幸的是，这些早期的协议是“硬编码”，因此很大的限制了可交换信息的范围。此外，其他协议(如，[http://xmpp.org/extensions/xep-0045.html Multi-User Chat] [[XEP-0004#附录G:备注|3]])可能需要以交换数据为目的，例如配置，但是配置选项可能根据具体实施或部署不同。最后，开发人员可能要以灵活的方式扩展其他协议(如, [http://xmpp.org/extensions/xep-0030.html Service Discovery][[XEP-0004#附录G:备注|4]])，以提供在基本协议没有定义的信息。在所有这些情况下，这将有助于使用一个通用的数据描述格式，可以用于动态表单生成和各种情况下的数据“建模”。

一个例子可能会有帮助。试想一下，当用户创建一个文本会议服务的多用户聊天室，该服务允许用户以各种方式配置房间。虽然大多数实现可能提供了一个较为常见的可配置功能集（讨论记录，房间拥有者的最大数量，等等）。还会有一些分歧：也许一个实现允许把房间日志以各种文件类型（XML，HTML，PDF等格式）和各种时间周期（每小时，每天，每周等）保存。而另一个实现，可能只存在登录的开/关选择一种格式（如，在HTML保存每日日志）。很明显，第一个实现比第二个实现有更多的配置选项。而不像“硬编码”每个选项通过不同的XML元素（如，<room_logging_period/>），一个好的设计应该包含更多灵活的格式。

此处所描述的'jabber:x:data'协议为Jabber/XMPP实体的使用定义了灵活的格式，控制在“名称值”对的简单和[http://www.w3.org/TR/xforms/ XForms 1.0] [[XEP-0004#附录G:备注|5]]（当这个协议被设计时才开始发展的）的复杂之间。在很多方面，'jabber:x:data' 与[http://www.w3.org/TR/xhtml1/ XHTML 1.0][[XEP-0004#附录G:备注|6]]的表单模块类似。但它提供一些Jabber特有的数据类型，允许应用程序请求数据字段，更自然地集成到IQ节的“workflow”语义中。而且它可以作为现有的Jabber/XMPP协议的扩展，而当这个协议被开发出来时，XHTML的表单模块却不能（尤其是当时并没有[http://www.w3.org/TR/2004/WD-xhtml-modularization-20040218/ Modularization of XHTML] [[XEP-0004#附录G:备注|7]]）。

==需求==

本文档涉及下列需求:

# '''数据收集''' -- 该协议应允许表单处理实体（通常是一个服务器，服务，或bot）从表单提交实体（通常是一个由用户控制的客户端）收集数据。应该是通过不同的数据字段来做，每个都可以是不同的数据“类型”，而且允许自由格式的输入或多个选项的选择（就像HTML表单一样）。
# '''数据报告''' -- 该协议应允许表单处理的实体向表单提交的实体报告数据，再通过不同的数据字段。
# '''可移植性''' -- 协议应该尽量只定义普通数据格式和基本的数据类型。提示应该在相关的用户界面提供，但应该仅仅是提示，而不是严格的要求。
# '''简单''' -- 协议在客户端的实施应该简单，并且大多数复杂的工作（如，数据有效性和处理）应由服务器和组件去完成，而不是客户端。
# '''灵活性''' -- 协议应该具有灵活性和可扩展性，而不像“硬编码”。
# '''兼容性''' -- 协议应该为已有的Jabber/XMPP协议定义一个扩展，而且不破坏已有的实现，除非绝对必要。

==协议==

'jabber:x:data' 命名空间的基本语法如下（正式的描述可以在下面的XML节中找到）:

<source lang="xml">
<x xmlns='jabber:x:data'
type='{form-type}'>
<title/>
<instructions/>
<field var='field-name'
type='{field-type}'
label='description'>
<desc/>
<required/>
<value>field-value</value>
<option label='option-label'><value>option-value</value></option>
<option label='option-label'><value>option-value</value></option>
</field>
</x>
</source>

受'jabber:x:data' 命名空间限制的<x/>元素，应该包括直接作为<message/>节第一级子元素或作为<iq/> 节（其中第一级子元素是由一个"wrapper"命名空间限制的）的第二级子节。参见下文列举的限制。

可选项<title/>和<instructions/>元素，允许表单处理实体把表单标记为一个整体并指定自然语言指令，后面跟着表单提交实体。这些元素的XML字符数据不应包含换行符（\n和\r字符），而任何换行符操作（如，在用户界面显示）在这里不是特指的。但<instructions/>元素的多个实体可以被包括在内。

===表单类型===

由'jabber:x:data'表单收集或提供的数据可位于许多不同的上下文中。例如，一个需要填写的空表单，一个填好的表单，提交的结果，一个搜索结果，或仅仅是用'jabber:x:data'命名空间封装的一组数据。完整的数据上下文由3个条件提供：

# "wrapper"协议（比如，以<iq/>节直接子元素为根元素的命名空间和受'jabber:x:data' 命名空间限制的<x/>元素的父元素）
# 在一个事务（如，一个IQ "set"或"result"）或结构化的会话（如，一个消息<thread/>）中表单的位置
# 表单中<x/>根元素的'type'属性

前2件上下文信息由其他协议提供，而表单类型见下面表格。

:'''表1：表单类型(Form Types)'''

{|border="1" cellspacing="0"
! 类型 !! 描述
|-
|form || 表单处理实体(form-processing entity)请求表单提交实体(form-submitting entity)去完成表单
|-
|submit || 表单提交实体提交数据给表单处理实体。提交信息可以(MAY)包含空表单中没有提供的字段，但表单处理实体必须(MUST)忽略任何无法识别的字段
|-
|cancel || 表单提交实体取消向表单处理实体提交数据
|-
|result || 表单处理实体返回数据（如查询结果）给表单提交实体，或数据是一个通用的数据集
|}

为了维护form类型中获取的数据的上下文，必须(MUST)遵守以下规则:

:* 对于<iq/>节，在类型为"form" 或"submit"的表单中受"wrapper" 命名空间限制的根元素，必须(MUST)以一个类型为"result"的表单的形式返回。受'jabber:x:data'命名空间限制的<x/>元素，必须(MUST)是"wrapper"命名空间根元素的子元素。根据[http://tools.ietf.org/html/rfc3920 XMPP Core] [[XEP-0004#附录G:备注|8]]所定义， 'id' 属性必须(MUST)在IQ结果中被复制。对于类型为"form" 或 "result"的数据表单,<iq/>节应该(SHOULD)是"result"类型。对于类型为"submit" 或"cancel"的数据表单， <iq/>节应该(SHOULD)是"set"类型。

:* 对于<message/>节，如果提供<thread/>的话，应该(SHOULD)在回复中被复制。受'jabber:x:data'命名空间限制的<x/>元素，必须(MUST)是<message/>节的子元素。

===字段元素===

一个"form"，"submit"，或 "result"类型的数据表单应该(SHOULD)包含至少一个<field/>元素。一个"cancel"类型的数据表单，不应该(SHOULD NOT)包含任何<field/>元素。

<field/>元素可以(MAY)包含以下任何子元素:

:'''<desc/>'''
:该元素的XML字符数据提供了该字段一个自然语言的描述，为了在用户代理中展现（如，作为一个"tool-tip"，帮助按钮，或在字段附近的文本说明）。<desc/>元素不应(SHOULD NOT)包含换行符（\n和\r字符），因为布局是用户代理的责任，任何换行的处理（如，在用户界面中的展现）在这里是未指定的。（注意：提供一个字段的描述，推荐(RECOMMENDED)使用<desc/>元素，而不是一个单独的"fixed"类型的<field/>元素。）

:'''<required/>'''
:该元素必须(MUST)为空，标记字段为必填字段。

:'''<value/>'''
:该元素的XML字符数据在"form"类型数据表单中为字段（根据表单处理实体）定义了默认值，在"submit"类型数据表单中是由表单提交实体提供的数据，在"result"类型数据表单中是数据结果。在"form"类型数据表单中，如果表单处理实体通过<value/>元素提供了一个默认值，表单提交实体就不应该(SHOULD NOT)尝试去执行一个不同的默认值（虽然为了尊重用户的首选项，或预测用户输入也可能(MAY)这么做）。"list-multi"，"jid-multi"，"text-multi"和"hidden"类型的字段也许(MAY)包含多个<value/>元素；所有其它类型的元素不能(MUST NOT)包含多于一个<value/>元素。

:'''<option/>'''
:在"list-single"或"list-multi"类型字段中的一个选项。<value/>子元素的XML字符定义了选项的值，而'label'属性为选项定义了一个可读的名称。<option/>元素必须(MUST)且只能包含一个<value/>子元素。如果字段类型不是"list-single"或"list-multi"，就一定不能(MUST NOT)包含<option/>元素。

如果<field/>元素不是"fixed"类型（见下文），它必须(MUST)有一个'var'属性在表单的上下文中唯一的标识字段（如果是"fixed"，可以(MAY)有一个'var'属性）。<field/>元素可以(MAY)有一个'label'属性，为字段定义一个可读的名称。对于"form"类型的数据表单，每个<field/>元素应该(SHOULD)有'type'属性定义字段数据的数据 "类型"（如果没有指定'type'，则默认为"text-single"）。在其他表单类型的上下文中提供的字段，也可以(MAY)有一个'type'属性。对于"submit"类型的数据表单，'type'属性是可选的(OPTIONAL)，因为表单处理实体被假定知道它处理的表单的数据类型。

如果字段出现在用户页面上（如，问卷中的项或表单结果），在XML中的字段元素的顺序应该(SHOULD)决定向用户展现的项目的顺序。

===字段类型===
以下字段类型代表在Jabber/XMPP实体之间交换的通用的数据类型。这些字段类型并不打算像[http://www.w3.org/TR/xmlschema-2/ XML Schema Part 2] [[XEP-0004#附录G:备注|9]]中定义的数据类型一样全面，也没有定义用户界面元素。

:'''表2:字段类型(Field Types)'''

{|border="1" cellspacing="0"
! 类型 !! 描述
|-
|boolean || 该字段允许一个实体收集或提供一个只能二选一的选项。默认值为"false"。[[XEP-0004#附录G:备注|10]]
|-
|fixed || 该字段用于数据描述（如，可读的"section"头信息）而不是数据收集或供给。<value/>子元素不应该(SHOULD NOT)包含换行符（\n和\r字符）；然而一个应用应该(SHOULD)生成多个固定的字段，每个都包含<value/>子元素。
|-
|hidden || 该字段未展现给表单提交实体，但是和表单一起返回。表单提交实体不能(SHOULD NOT)修改隐藏字段的值，但如果这种行为被'using protocol'（"所使用的协议"?）定义时可以(MAY)这样做。
|-
|jid-multi || 该字段允许一个实体收集或提供多个Jabber ID。每个提供的JID应该(SHOULD)是唯一的（as determined by comparison that includes application of the Nodeprep, Nameprep, and Resourceprep profiles of Stringprep as specified in XMPP Core）（通过比较，包括在XMPP Core中详细说明的Nodeprep、Nameprep和Resourceprep应用程序字符串处理配置文件，来确定？翻译得较拗口），而重复的JID必须(MUST)忽略。*
|-
|jid-single || 该字段允许一个实体收集或提供单个Jabber ID。*
|-
|list-multi || 该字段允许一个实体从很多选项中收集或提供一个或多个选项。表单提交实体从表单处理实体提交的选项中选择一个或多个项，而且不能(MUST NOT)插入新的选项。表单处理实体不能(MUST NOT)修改从表单处理实体处获取的项目的顺序，因为项目的顺序可能(MAY)很重要。**
|-
|list-single || 该字段允许一个实体从很多选项中收集或提供一个选项。表单提交实体从表单处理实体提交的选项中选择一个项，而且不能(MUST NOT)插入新的选项。**
|-
|text-multi || 该字段允许一个实体收集或提供多行的文本。***
|-
|text-private || 该字段允许一个实体收集或提供一行或一个词的文本，其应该在界面上遮蔽。（如，显示多个星号字符）
|-
|text-single || 该字段允许一个实体收集或提供一行或一个词的文本，其应该在界面上显示。这个字段类型是缺省的，并且当一个表单提交实体收到一个不知道的字段类型时，就必须(MUST)假定为这个类型。
|}

* 注意：为字段类型"jid-single"或"jid-multi"提供的数据必须包含一个或一个以上的有效Jabber ID，有效性是由XMPP Core（参看后面章节的Data Validation）定义的寻址规则决定的。

** 注意：在list-multi和list-single中的<option/>元素必须是唯一的，唯一性是由‘label’属性的值和<value/>元素中的XML字符数据决定的。（即，2个都必须是唯一的）

注意：为字段类型"text-multi"提供的数据不应该包含任何换行符（\n和\r字符）。而应用程序应该把数据分为多个字符串（基于平台插入的换行符），然后用不同的<value/>元素中的XML字符数据指定每一个字符串。同样的，以"text-multi"字段类型接收了多个<value/>元素的应用程序，应该把value元素中的XML字符数据合并成一个文本块以提交给用户。每一个字符串为平台适时的通过换行符分开。

===表单结果中的多个项目===
在某些情况下（如，查询请求的结果），传达多个项目是必须的。因此，一个"result"类型的数据表单可能包含2个上面基本语法没有描述的子元素:

#只有一个<reported/>元素，可以理解为一个“表头”描述数据去遵循。
#零个或更多<item/>元素，可以理解为包含符合请求的数据（如果有的话）的"table cells"。

其语法如下：

<source lang="xml">
<x xmlns='jabber:x:data'
type='result'>
<reported>
<field var='field-name' label='description' type='{field-type}'/>
</reported>
<item>
<field var='field-name'>
<value>field-value</value>
</field>
</item>
<item>
<field var='field-name'>
<value>field-value</value>
</field>
</item>
.
.
.
</x>
</source>

这些元素每个都必须包含一个或多个<field/>子元素。<reported/>元素为结果项定义数据格式，通过为每个项目指定所期望的字段。为此，除了'var'属性，<field/>元素还应该有'type'属性'label'属性；而且不能包含<value/>元素。在结果集中，每个<item/>元素定义一个项目，而且必须包含在<reported/>元素（虽然<value/>元素中的XML字符数据可能为空）中指定的字段。

==数据有效性==

数据有效性是表单处理实体（通常是一个服务器，服务，或bot）的责任，而不是表单提交实体（通常是一个由用户控制的客户端）。这有助于满足保持客户端实现简单的要求。如果表单处理实体确定提供的数据是无效的，它应该返回一个“不接受”的错误。选择在XMPP <text/>元素中提供文字说明，或识别问题的特殊应用子元素（参考[http://xmpp.org/extensions/xep-0086.html Error Condition Mappings] [[XEP-0004#附录G:备注|11]]中的映射和格式）。

==例子==

对于下面的例子，我们假设存在一个bot hosting服务在Jabber network上，位于<botster.shakespeare.lit>。这个服务允许注册用户创建和配置新的bots，对已经存在的bots查找和交互，等等。我们假定这些交互的发生使用的Ad-Hoc Commands [12]协议，协议被用作表单的"wrapper"协议，受'jabber:x:data'命名空间限制。下面章节中的例子，体现了前文中描述的数据表单协议的大部分特性。

注意：额外的例子可以通过各种“使用协议”的说明书中找到。如XEP-0045:Multi-User Chat和XEP-0055:Jabber Search。

===配置===

:第一步是为用户在主机上创建一个新的bot。我们假设这是通过发送一个“创建”命令给期望的bot来实现的:

:'''例1.用户请求Bot创建'''

<source lang="xml">
<iq from='romeo@montague.net/home'
to='joogle@botster.shakespeare.lit'
type='get'
xml:lang='en'
id='create1'>
<command xmlns='http://jabber.org/protocol/commands'
node='create'
action='execute'/>
</iq>
</source>

:然后主服务返回一个数据表单个用户:

:'''例2.服务返回一个Bot创建表单'''

<source lang="xml">
<iq from='joogle@botster.shakespeare.lit'
to='romeo@montague.net/home'
type='result'
xml:lang='en'
id='create1'>
<command xmlns='http://jabber.org/protocol/commands'
node='create'
sessionid='create:20040408T0128Z'
status='executing'>
<x xmlns='jabber:x:data' type='form'>
<title>Bot Configuration</title>
<instructions>Fill out this form to configure your new bot!</instructions>
<field type='hidden'
var='FORM_TYPE'>
<value>jabber:bot</value>
</field>
<field type='fixed'><value>Section 1: Bot Info</value></field>
<field type='text-single'
label='The name of your bot'
var='botname'/>
<field type='text-multi'
label='Helpful description of your bot'
var='description'/>
<field type='boolean'
label='Public bot?'
var='public'>
<required/>
</field>
<field type='text-private'
label='Password for special access'
var='password'/>
<field type='fixed'><value>Section 2: Features</value></field>
<field type='list-multi'
label='What features will the bot support?'
var='features'>
<option label='Contests'><value>contests</value></option>
<option label='News'><value>news</value></option>
<option label='Polls'><value>polls</value></option>
<option label='Reminders'><value>reminders</value></option>
<option label='Search'><value>search</value></option>
<value>news</value>
<value>search</value>
</field>
<field type='fixed'><value>Section 3: Subscriber List</value></field>
<field type='list-single'
label='Maximum number of subscribers'
var='maxsubs'>
<value>20</value>
<option label='10'><value>10</value></option>
<option label='20'><value>20</value></option>
<option label='30'><value>30</value></option>
<option label='50'><value>50</value></option>
<option label='100'><value>100</value></option>
<option label='None'><value>none</value></option>
</field>
<field type='fixed'><value>Section 4: Invitations</value></field>
<field type='jid-multi'
label='People to invite'
var='invitelist'>
<desc>Tell all your friends about your new bot!</desc>
</field>
</x>
</command>
</iq>
</source>

:然后用户提交配置表单:

:'''例3.用户提交bot创建表单'''

<source lang="xml">
<iq from='romeo@montague.net/home'
to='joogle@botster.shakespeare.lit'
type='set'
xml:lang='en'
id='create2'>
<command xmlns='http://jabber.org/protocol/commands'
node='create'
sessionid='create:20040408T0128Z'>
<x xmlns='jabber:x:data' type='submit'>
<field type='hidden' var='FORM_TYPE'>
<value>jabber:bot</value>
</field>
<field type='text-single' var='botname'>
<value>The Jabber Google Bot</value>
</field>
<field type='text-multi' var='description'>
<value>This bot enables you to send requests to</value>
<value>Google and receive the search results right</value>
<value>in your Jabber client. It' really cool!</value>
<value>It even supports Google News!</value>
</field>
<field type='boolean' var='public'>
<value>0</value>
</field>
<field type='text-private' var='password'>
<value>v3r0na</value>
</field>
<field type='list-multi' var='features'>
<value>news</value>
<value>search</value>
</field>
<field type='list-single' var='maxsubs'>
<value>50</value>
</field>
<field type='jid-multi' var='invitelist'>
<value>juliet@capulet.com</value>
<value>benvolio@montague.net</value>
</field>
</x>
</command>
</iq>
</source>

:然后服务返回结果给用户:

:'''例4.服务返回bot创建的结果'''

<source lang="xml">
<iq from='joogle@botster.shakespeare.lit'
to='romeo@montague.net/home'
type='result'
xml:lang='en'
id='create2'>
<command xmlns='http://jabber.org/protocol/commands'
node='create'
sessionid='create:20040408T0128Z'
status='completed'>
<x xmlns='jabber:x:data' type='result'>
<field type='hidden' var='FORM_TYPE'>
<value>jabber:bot</value>
</field>
<field type='text-single' var='botname'>
<value>The Jabber Google Bot</value>
</field>
<field type='boolean' var='public'>
<value>0</value>
</field>
<field type='text-private' var='password'>
<value>v3r0na</value>
</field>
<field type='list-multi' var='features'>
<value>news</value>
<value>search</value>
</field>
<field type='list-single' var='maxsubs'>
<value>50</value>
</field>
<field type='jid-multi' var='invitelist'>
<value>juliet@capulet.com</value>
<value>benvolio@montague.net</value>
</field>
</x>
</command>
</iq>
</source>

===搜索===

既然用户已经创建了这个搜索bot,我们假设他所邀请的好友中的一个，决定通过发送一个搜索请求来试一试:

:'''例5.用户请求搜索表单'''

<source lang="xml">
<iq from='juliet@capulet.com/chamber'
to='joogle@botster.shakespeare.lit'
type='get'
xml:lang='en'
id='search1'>
<command xmlns='http://jabber.org/protocol/commands'
node='search'
action='execute'/>
</iq>
</source>

:'''例6.服务返回搜索表单'''

<source lang="xml">
<iq from='joogle@botster.shakespeare.lit'
to='juliet@capulet.com/chamber'
type='result'
xml:lang='en'
id='search1'>
<command xmlns='http://jabber.org/protocol/commands'
node='search'
status='executing'>
<x xmlns='jabber:x:data' type='form'>
<title>Joogle Search</title>
<instructions>Fill out this form to search for information!</instructions>
<field type='text-single'
var='search_request'>
<required/>
</field>
</x>
</command>
</iq>
</source>

:'''例7.用户提交搜索表单'''

<source lang="xml">
<iq from='juliet@capulet.com/chamber'
to='joogle@botster.shakespeare.lit'
type='get'
xml:lang='en'
id='search2'>
<command xmlns='http://jabber.org/protocol/commands'
node='search'>
<x xmlns='jabber:x:data' type='submit'>
<field type='text-single' var='search_request'>
<value>verona</value>
</field>
</x>
</command>
</iq>
</source>

:'''例8.服务返回搜索结果'''

<source lang="xml">
<iq from='joogle@botster.shakespeare.lit'
to='juliet@capulet.com/chamber'
type='result'
xml:lang='en'
id='search2'>
<command xmlns='http://jabber.org/protocol/commands'
node='search'
status='completed'>
<x xmlns='jabber:x:data' type='result'>
<title>Joogle Search: verona</title>
<reported>
<field var='name'/>
<field var='url'/>
</reported>
<item>
<field var='name'>
<value>Comune di Verona - Benvenuti nel sito ufficiale</value>
</field>
<field var='url'>
<value>http://www.comune.verona.it/</value>
</field>
</item>
<item>
<field var='name'>
<value>benvenuto!</value>
</field>
<field var='url'>
<value>http://www.hellasverona.it/</value>
</field>
</item>
<item>
<field var='name'>
<value>Universita degli Studi di Verona - Home Page</value>
</field>
<field var='url'>
<value>http://www.univr.it/</value>
</field>
</item>
<item>
<field var='name'>
<value>Aeroporti del Garda</value>
</field>
<field var='url'>
<value>http://www.aeroportoverona.it/</value>
</field>
</item>
<item>
<field var='name'>
<value>Veronafiere - fiera di Verona</value>
</field>
<field var='url'>
<value>http://www.veronafiere.it/</value>
</field>
</item>
</x>
</command>
</iq>
</source>

==服务发现==

如果一个实体支持包含受'jabber:x:data'命名空间限制的<x/>元素作为<message/>节直接子元素，它必须报告支持包含一个"jabber:x:data"（参看Protocol Namespaces中关于一个或多个永久命名空间的发行）的服务搜索特征，去响应服务搜索信息请求:

:'''例9.服务搜索信息请求'''

<source lang="xml">
<iq type='get'
from='romeo@montague.net/orchard'
to='juliet@capulet.com/balcony'
id='disco1'>
<query xmlns='http://jabber.org/protocol/disco#info'/>
</iq>
</source>

:'''例10.服务搜索信息响应'''

<source lang="xml">
<iq type='result'
from='juliet@capulet.com/balcony'
to='romeo@montague.net/orchard'
id='disco1'>
<query xmlns='http://jabber.org/protocol/disco#info'>
...
<feature var='jabber:x:data'/>
...
</query>
</iq>
</source>

如果实体支持数据表单，间接的通过在wrapper命名空间中包含数据表单，它不能为'jabber:x:data'命名空间通知支持，因为在wrapper协助中的支持是隐性的。

==安全性考虑==

没有安全问题与上述的规范和XMPP Core中相关章节的描述有关。

==IANA考虑==

这份文档与[http://www.iana.org/ Internet Assigned Numbers Authority (IANA)] [[XEP-0004#附录G:备注|13]]无关。

==XMPP注册考虑==

===协议命名空间===

[http://xmpp.org/registrar/ XMPP Registrar] [[XEP-0004#附录G:备注|14]]在它注册的协议命名空间中包含'jabber:x:data'命名空间。

===参数值===

XMPP注册员维持着一个与'jabber:x:data'命名空间相关的注册参数值。具体定义在[http://xmpp.org/extensions/xep-0068.html Field Standardization for Data Forms] [[XEP-0004#附录G:备注|15]]。注册的地方是<http://xmpp.org/registrar/formtypes.html>。

==XML 架构==

该架构是描述性的，不是规范的。

<source lang="xml">
<?xml version='1.0' encoding='UTF-8'?>

<xs:schema
xmlns:xs='http://www.w3.org/2001/XMLSchema'
targetNamespace='jabber:x:data'
xmlns='jabber:x:data'
elementFormDefault='qualified'>

<xs:annotation>
<xs:documentation>
The protocol documented by this schema is defined in
XEP-0004: http://www.xmpp.org/extensions/xep-0004.html
</xs:documentation>
</xs:annotation>

<xs:element name='x'>
<xs:complexType>
<xs:sequence>
<xs:element name='instructions'
minOccurs='0'
maxOccurs='unbounded'
type='xs:string'/>
<xs:element name='title' minOccurs='0' type='xs:string'/>
<xs:element ref='field' minOccurs='0' maxOccurs='unbounded'/>
<xs:element ref='reported' minOccurs='0' maxOccurs='1'/>
<xs:element ref='item' minOccurs='0' maxOccurs='unbounded'/>
</xs:sequence>
<xs:attribute name='type' use='required'>
<xs:simpleType>
<xs:restriction base='xs:NCName'>
<xs:enumeration value='cancel'/>
<xs:enumeration value='form'/>
<xs:enumeration value='result'/>
<xs:enumeration value='submit'/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
</xs:element>

<xs:element name='field'>
<xs:complexType>
<xs:sequence>
<xs:element name='desc' minOccurs='0' type='xs:string'/>
<xs:element name='required' minOccurs='0' type='empty'/>
<xs:element ref='value' minOccurs='0' maxOccurs='unbounded'/>
<xs:element ref='option' minOccurs='0' maxOccurs='unbounded'/>
</xs:sequence>
<xs:attribute name='label' type='xs:string' use='optional'/>
<xs:attribute name='type' use='optional'>
<xs:simpleType>
<xs:restriction base='xs:NCName'>
<xs:enumeration value='boolean'/>
<xs:enumeration value='fixed'/>
<xs:enumeration value='hidden'/>
<xs:enumeration value='jid-multi'/>
<xs:enumeration value='jid-single'/>
<xs:enumeration value='list-multi'/>
<xs:enumeration value='list-single'/>
<xs:enumeration value='text-multi'/>
<xs:enumeration value='text-private'/>
<xs:enumeration value='text-single'/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name='var' type='xs:string' use='optional'/>
</xs:complexType>
</xs:element>

<xs:element name='option'>
<xs:complexType>
<xs:sequence>
<xs:element ref='value'/>
</xs:sequence>
<xs:attribute name='label' type='xs:string' use='optional'/>
</xs:complexType>
</xs:element>

<xs:element name='value' type='xs:string'/>

<xs:element name='reported'>
<xs:annotation>
<xs:documentation>
When contained in a "reported" element, the "field" element
SHOULD NOT contain a "value" child.
</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element ref='field' maxOccurs='unbounded'/>
</xs:sequence>
</xs:complexType>
</xs:element>

<xs:element name='item'>
<xs:complexType>
<xs:sequence>
<xs:element ref='field' maxOccurs='unbounded'/>
</xs:sequence>
</xs:complexType>
</xs:element>

<xs:simpleType name='empty'>
<xs:restriction base='xs:string'>
<xs:enumeration value=''/>
</xs:restriction>
</xs:simpleType>

</xs:schema>
</source>

==最终状态的修改==

当本规范已经是最终状态时，下面的实体协议已经做了修改：

* 指定的'var'属性是所有字段类型所必须的，除了"fixed", 因为'var'属性是可选的。

* 通过服务搜索指定何时去通知支持。

* 移除引用<presence/>节。

==草稿状态的修改==

当本规范在草稿状态时，下面的实体协议已经做了修改：

* <x/>元素可能直接包含在<message/>和<presence/>节中。
* <x/>元素可能包含一个<title/>子元素，在表单或结果中。
* <x/>元素必须拥有一个‘类型’属性。
* <field/>元素可能是类型='jid-single'。
* 结果可能以<item/>标签的方式返回报告。
* 结果可能包含一个<reported/>元素的结果集。
* <reported/>字段可能拥有一个‘类型’属性，提供如何与数据交互的提示（类型='jid-single'是最有用的）。

==附录==
===附录A:文档信息===

系列：[http://xmpp.org/extensions/ XEP]

序号：0004

发布者：[http://xmpp.org/xsf/ XMPP标准基金会]

状态：[http://www.xmpp.org/extensions/xep-0001.html#states-Final 终结版]

类型：[http://www.xmpp.org/extensions/xep-0001.html#types-Standards%20Track 标准跟踪]

版本：2.9

最后更新：2007-07-13

批准机构：[http://xmpp.org/council/ XMPP理事会]

依赖标准：[[RFC3920|XMPP Core]]

替代标准：无

被替代标准：无

缩略名：x-data

XML架构:<http://www.xmpp.org/schemas/x-data.xsd>

原文控制： [http://svn.xmpp.org:18080/browse/XMPP/trunk/extensions/xep-0004.xml HTML] [http://svn.xmpp.org:18080//changelog/~rss/XMPP/trunk/extensions/xep-0004.xml/rss.xml RSS]

本文的其它格式： [http://xmpp.org/extensions/xep-0004.xml XML] [http://xmpp.org/extensions/xep-0004.pdf PDF]

===附录B:作者信息===

'''Ryan Eatmon'''

Email: [mailto:reatmon@jabber.org reatmon@jabber.org]

JabberID: reatmon@jabber.org

'''Joe Hildebrand'''

Email: [mailto:jhildebr@cisco.com jhildebr@cisco.com]

JabberID: hildjj@jabber.org

'''Jeremie Miller'''

Email: [mailto:jer@jabber.org jer@jabber.org]

JabberID: jer@jabber.org

'''Thomas Muldowney'''

Email: [mailto:temas@jabber.org temas@jabber.org]

JabberID: temas@jabber.org

'''Peter Saint-Andre'''

Email: [mailto:stpeter@jabber.org stpeter@jabber.org]

JabberID: stpeter@jabber.org

URI: https://stpeter.im/

{{Template:XEP附录CDEF}}

===附录G:备注===
#XEP-0077: In-Band Registration <http://xmpp.org/extensions/xep-0077.html>.
#XEP-0055: Jabber Search <http://xmpp.org/extensions/xep-0055.html>.
#XEP-0045: Multi-User Chat <http://xmpp.org/extensions/xep-0045.html>.
#XEP-0030: Service Discovery <http://xmpp.org/extensions/xep-0030.html>.
#XForms 1.0 <http://www.w3.org/TR/xforms>.
#XHTML 1.0 <http://www.w3.org/TR/xhtml1>.
#Modularization of XHTML <http://www.w3.org/TR/2004/WD-xhtml-modularization-20040218/>.
#RFC 3920: Extensible Messaging and Presence Protocol (XMPP): Core <http://tools.ietf.org/html/rfc3920>.
#XML Schema Part 2: Datatypes <http://www.w3.org/TR/xmlschema-2/>.
#In accordance with Section 3.2.2.1 of XML Schema Part 2: Datatypes, the allowable lexical representations for the xs:boolean datatype are the strings "0" and "false" for the concept 'false' and the strings "1" and "true" for the concept 'true'; implementations MUST support both styles of lexical representation.
#XEP-0086: Error Condition Mappings <http://xmpp.org/extensions/xep-0086.html>.
#XEP-0050: Ad-Hoc Commands <http://xmpp.org/extensions/xep-0050.html>.
#The Internet Assigned Numbers Authority (IANA) is the central coordinator for the assignment of unique parameter values for Internet protocols, such as port numbers and URI schemes. For further information, see <http://www.iana.org/>.
#The XMPP Registrar maintains a list of reserved protocol namespaces as well as registries of parameters used in the context of XMPP extension protocols approved by the XMPP Standards Foundation. For further information, see <http://xmpp.org/registrar/>.
#XEP-0068: Field Data Standardization for Data Forms <http://xmpp.org/extensions/xep-0068.html>.

===附录H:修订历史===

注意:

'''版本 2.9 (2007-08-13)'''

Clarified the definition and handling of the list-multi and list-single field types; specified that hidden field values should not be modified unless such behavior is defined for the using protocol; specified that a submission should include all fields provided in the empty form and may include additional fields, but that additional fields must be ignored if not understood by the form-processing entity.

(psa)

'''版本 2.8 (2007-05-21)'''

Removed mentions of presence stanzas; added section on discovering support; added section on substantive changes in Final state.

(psa)

'''版本 2.7 (2006-01-25)'''

Incorporated errata: (1) clarified rules regarding inclusion of option and value elements depending on field type; (2) clarified handling of default values; (3) added value elements to list-multi field in Example 2; (4) harmonized spelling of form-processing entity and form-submitting entity.

(psa)

Version 2.6 (2004-10-13)
Incorporated errata: (1) corrected syntax of <reported/> element (<field/> element should not contain a <value/> child); (2) corrected Example 8.

(psa)
Version 2.5 (2004-05-07)
Clarified terminology regarding form-processing entities and form-submitting entities; corrected several small errors in the schema.

(psa)
Version 2.4 (2004-05-04)
Per discussion by the authors and Jabber Council, specified that the 'var' attribute is required for all field types except "fixed", for which the 'var' attribute is optional.

(psa)
Version 2.3 (2004-03-31)
Formalization and further editorial revisions.

(psa)
Version 2.2 (2004-01-22)
Editorial revisions.

(psa)
Version 2.1 (2003-02-16)
Added schema.

(psa)
Version 2.0 (2002-12-09)
Per a vote of the Jabber Council, changed status to Final.

(psa)
Version 1.1 (2002-10-15)
Call for Experience changes (see Changes in Draft State section). This version voted to Final on 2002-12-09.

(rwe)
Version 1.0 (2002-04-24)
Per a vote of the Jabber Council, changed status to Draft.

(psa)
Version 0.6 (2002-03-15)
Protocol tweaks based on Standards list discussion.

(rwe)
Version 0.5 (2002-02-06)
Protocol tweaks based on implementation and discussion.

(rwe)
Version 0.4 (2001-11-16)
Major redesign to attempt to clarify the scope of this document and limit what it is trying to solve.

(rwe)
Version 0.3 (2001-07-23)
Protocol update

(rwe)
Version 0.2 (2001-06-29)
Protocol update and DocBook version

(rwe)
Version 0.1 (2001-01-25)
Initial release

(rwe)
[http://essaywritingservices.org/index.php essay writing service]

XEP-0004

2012-09-04T04:36:55Z

Zoey1990:

[[Category:XMPP扩展]]
[[Category:已翻译]]

'''本文的英文原文来自[http://xmpp.org/extensions/xep-0004.html XEP-0004]'''

'''XEP-0004: 数据表单'''

摘要: 本文定义了一个XMPP扩展协议用于数据表单，可以用于worklows如服务配置以及特定应用的数据描述和报告。这个协议包括表单处理的轻量级语义(如请求,响应,提交和取消),定义了几种常见的字段类型(布尔、单个或多个选择的列表选项、单行或多行的文本,单个或多个JabberID、隐藏字段,等等),为以后的数据类型提供扩展性,可以用在广泛的应用中。该协议并不是要提供完整的表格处理功能（由W3C XForms技术提供），而是提供这种功能的基本子集给XMPP使用。

作者: Ryan Eatmon, Joe Hildebrand, Jeremie Miller, Thomas Muldowney, Peter Saint-Andre

XMPP扩展协议的版权(1999-2008)归XMPP标准化基金会(XSF)所有

版权: ? 1999 - 2010 XMPP标准化基金会(XSF). 参见[[XEP-0004#法律通告|法律通告]].

状态: 最终

类型: 标准跟踪

版本: 2.9

最后更新日期: 2007-08-13

注意: 这里定义的协议是XMPP标准化基金会的一个最终标准.对于实现和布署来说可以被认为是一个稳定技术.

==绪论==

几个现有的Jabber/XMPP的协议包含用户和应用程序之间的结构数据交换，为常用的任务，如注册（[http://xmpp.org/extensions/xep-0077.html In-Band Registration][[XEP-0004#附录G:备注|1]]）和搜索（[http://xmpp.org/extensions/xep-0055.html Jabber Search] [[XEP-0004#附录G:备注|2]]）。不幸的是，这些早期的协议是“硬编码”，因此很大的限制了可交换信息的范围。此外，其他协议(如，[http://xmpp.org/extensions/xep-0045.html Multi-User Chat] [[XEP-0004#附录G:备注|3]])可能需要以交换数据为目的，例如配置，但是配置选项可能根据具体实施或部署不同。最后，开发人员可能要以灵活的方式扩展其他协议(如, [http://xmpp.org/extensions/xep-0030.html Service Discovery][[XEP-0004#附录G:备注|4]])，以提供在基本协议没有定义的信息。在所有这些情况下，这将有助于使用一个通用的数据描述格式，可以用于动态表单生成和各种情况下的数据“建模”。

一个例子可能会有帮助。试想一下，当用户创建一个文本会议服务的多用户聊天室，该服务允许用户以各种方式配置房间。虽然大多数实现可能提供了一个较为常见的可配置功能集（讨论记录，房间拥有者的最大数量，等等）。还会有一些分歧：也许一个实现允许把房间日志以各种文件类型（XML，HTML，PDF等格式）和各种时间周期（每小时，每天，每周等）保存。而另一个实现，可能只存在登录的开/关选择一种格式（如，在HTML保存每日日志）。很明显，第一个实现比第二个实现有更多的配置选项。而不像“硬编码”每个选项通过不同的XML元素（如，<room_logging_period/>），一个好的设计应该包含更多灵活的格式。

此处所描述的'jabber:x:data'协议为Jabber/XMPP实体的使用定义了灵活的格式，控制在“名称值”对的简单和[http://www.w3.org/TR/xforms/ XForms 1.0] [[XEP-0004#附录G:备注|5]]（当这个协议被设计时才开始发展的）的复杂之间。在很多方面，'jabber:x:data' 与[http://www.w3.org/TR/xhtml1/ XHTML 1.0][[XEP-0004#附录G:备注|6]]的表单模块类似。但它提供一些Jabber特有的数据类型，允许应用程序请求数据字段，更自然地集成到IQ节的“workflow”语义中。而且它可以作为现有的Jabber/XMPP协议的扩展，而当这个协议被开发出来时，XHTML的表单模块却不能（尤其是当时并没有[http://www.w3.org/TR/2004/WD-xhtml-modularization-20040218/ Modularization of XHTML] [[XEP-0004#附录G:备注|7]]）。

==需求==

本文档涉及下列需求:

# '''数据收集''' -- 该协议应允许表单处理实体（通常是一个服务器，服务，或bot）从表单提交实体（通常是一个由用户控制的客户端）收集数据。应该是通过不同的数据字段来做，每个都可以是不同的数据“类型”，而且允许自由格式的输入或多个选项的选择（就像HTML表单一样）。
# '''数据报告''' -- 该协议应允许表单处理的实体向表单提交的实体报告数据，再通过不同的数据字段。
# '''可移植性''' -- 协议应该尽量只定义普通数据格式和基本的数据类型。提示应该在相关的用户界面提供，但应该仅仅是提示，而不是严格的要求。
# '''简单''' -- 协议在客户端的实施应该简单，并且大多数复杂的工作（如，数据有效性和处理）应由服务器和组件去完成，而不是客户端。
# '''灵活性''' -- 协议应该具有灵活性和可扩展性，而不像“硬编码”。
# '''兼容性''' -- 协议应该为已有的Jabber/XMPP协议定义一个扩展，而且不破坏已有的实现，除非绝对必要。

==协议==

'jabber:x:data' 命名空间的基本语法如下（正式的描述可以在下面的XML节中找到）:

<source lang="xml">
<x xmlns='jabber:x:data'
type='{form-type}'>
<title/>
<instructions/>
<field var='field-name'
type='{field-type}'
label='description'>
<desc/>
<required/>
<value>field-value</value>
<option label='option-label'><value>option-value</value></option>
<option label='option-label'><value>option-value</value></option>
</field>
</x>
</source>

受'jabber:x:data' 命名空间限制的<x/>元素，应该包括直接作为<message/>节第一级子元素或作为<iq/> 节（其中第一级子元素是由一个"wrapper"命名空间限制的）的第二级子节。参见下文列举的限制。

可选项<title/>和<instructions/>元素，允许表单处理实体把表单标记为一个整体并指定自然语言指令，后面跟着表单提交实体。这些元素的XML字符数据不应包含换行符（\n和\r字符），而任何换行符操作（如，在用户界面显示）在这里不是特指的。但<instructions/>元素的多个实体可以被包括在内。

===表单类型===

由'jabber:x:data'表单收集或提供的数据可位于许多不同的上下文中。例如，一个需要填写的空表单，一个填好的表单，提交的结果，一个搜索结果，或仅仅是用'jabber:x:data'命名空间封装的一组数据。完整的数据上下文由3个条件提供：

# "wrapper"协议（比如，以<iq/>节直接子元素为根元素的命名空间和受'jabber:x:data' 命名空间限制的<x/>元素的父元素）
# 在一个事务（如，一个IQ "set"或"result"）或结构化的会话（如，一个消息<thread/>）中表单的位置
# 表单中<x/>根元素的'type'属性

前2件上下文信息由其他协议提供，而表单类型见下面表格。

:'''表1：表单类型(Form Types)'''

{|border="1" cellspacing="0"
! 类型 !! 描述
|-
|form || 表单处理实体(form-processing entity)请求表单提交实体(form-submitting entity)去完成表单
|-
|submit || 表单提交实体提交数据给表单处理实体。提交信息可以(MAY)包含空表单中没有提供的字段，但表单处理实体必须(MUST)忽略任何无法识别的字段
|-
|cancel || 表单提交实体取消向表单处理实体提交数据
|-
|result || 表单处理实体返回数据（如查询结果）给表单提交实体，或数据是一个通用的数据集
|}

为了维护form类型中获取的数据的上下文，必须(MUST)遵守以下规则:

:* 对于<iq/>节，在类型为"form" 或"submit"的表单中受"wrapper" 命名空间限制的根元素，必须(MUST)以一个类型为"result"的表单的形式返回。受'jabber:x:data'命名空间限制的<x/>元素，必须(MUST)是"wrapper"命名空间根元素的子元素。根据[http://tools.ietf.org/html/rfc3920 XMPP Core] [[XEP-0004#附录G:备注|8]]所定义， 'id' 属性必须(MUST)在IQ结果中被复制。对于类型为"form" 或 "result"的数据表单,<iq/>节应该(SHOULD)是"result"类型。对于类型为"submit" 或"cancel"的数据表单， <iq/>节应该(SHOULD)是"set"类型。

:* 对于<message/>节，如果提供<thread/>的话，应该(SHOULD)在回复中被复制。受'jabber:x:data'命名空间限制的<x/>元素，必须(MUST)是<message/>节的子元素。

===字段元素===

一个"form"，"submit"，或 "result"类型的数据表单应该(SHOULD)包含至少一个<field/>元素。一个"cancel"类型的数据表单，不应该(SHOULD NOT)包含任何<field/>元素。

<field/>元素可以(MAY)包含以下任何子元素:

:'''<desc/>'''
:该元素的XML字符数据提供了该字段一个自然语言的描述，为了在用户代理中展现（如，作为一个"tool-tip"，帮助按钮，或在字段附近的文本说明）。<desc/>元素不应(SHOULD NOT)包含换行符（\n和\r字符），因为布局是用户代理的责任，任何换行的处理（如，在用户界面中的展现）在这里是未指定的。（注意：提供一个字段的描述，推荐(RECOMMENDED)使用<desc/>元素，而不是一个单独的"fixed"类型的<field/>元素。）

:'''<required/>'''
:该元素必须(MUST)为空，标记字段为必填字段。

:'''<value/>'''
:该元素的XML字符数据在"form"类型数据表单中为字段（根据表单处理实体）定义了默认值，在"submit"类型数据表单中是由表单提交实体提供的数据，在"result"类型数据表单中是数据结果。在"form"类型数据表单中，如果表单处理实体通过<value/>元素提供了一个默认值，表单提交实体就不应该(SHOULD NOT)尝试去执行一个不同的默认值（虽然为了尊重用户的首选项，或预测用户输入也可能(MAY)这么做）。"list-multi"，"jid-multi"，"text-multi"和"hidden"类型的字段也许(MAY)包含多个<value/>元素；所有其它类型的元素不能(MUST NOT)包含多于一个<value/>元素。

:'''<option/>'''
:在"list-single"或"list-multi"类型字段中的一个选项。<value/>子元素的XML字符定义了选项的值，而'label'属性为选项定义了一个可读的名称。<option/>元素必须(MUST)且只能包含一个<value/>子元素。如果字段类型不是"list-single"或"list-multi"，就一定不能(MUST NOT)包含<option/>元素。

如果<field/>元素不是"fixed"类型（见下文），它必须(MUST)有一个'var'属性在表单的上下文中唯一的标识字段（如果是"fixed"，可以(MAY)有一个'var'属性）。<field/>元素可以(MAY)有一个'label'属性，为字段定义一个人们易读的名称。对于“form”类型的数据表单，每个<field/>元素应该拥有'type'属性，它定义了字段数据的数据 "type"（如果没有'type'被指定，则默认为"text-single"）。在其他表单类型的上下文中提供的字段，也可以拥有一个'type'属性。对于"submit"类型的数据表单，'type'中包含的属性是可选的，因为表单处理实体被假定知道它处理的表单的数据类型。

如果字段出现在用户页面上（如，问卷中的项或表单结果），在XML中的字段元素的顺序，应该决定出现在用户处的项目的顺序。

===字段类型===
以下字段类型代表Jabber/XMPP实体之间通用的数据类型。这些字段并打算像数据类型一样被广泛定义，如[http://www.w3.org/TR/xmlschema-2/ XML Schema Part 2] [[XEP-0004#附录G:备注|9]], 也没有定义用户界面元素。

:'''表2:字段类型'''

{|border="1" cellspacing="0"
! 类型 !! 描述
|-
|布尔型 || 该字段允许一个实体收集或提供一个在两个选项中只能二选一的选择。默认值为"false"。[[XEP-0004#附录G:备注|10]]
|-
|固定 || 该字段是用于数据的描述（如，人们易读的"section"头信息）而不是数据的收集或提供。<value/>子元素不应该包含换行符（\n和\r字符）；然而一个应用应该生成多个固定的字段，每个都包含<value/>子元素。
|-
|隐藏 || 该字段未展现给表单提交实体，但是和表单一起返回。表单提交实体不能修改隐藏字段的值，但如果这种行为被定义为是“使用协议”时可以这样做。
|-
|多jid || 该字段允许一个实体收集或提供多个Jabber ID。每个提供的JID应该是唯一的（比较确定的，包括Nodeprep的应用、Nameprep和Resourceprep profiles of Stringprep，按XMPP Core中说明的），而重复的JID一定会被忽略。*
|-
|单jid || 该字段允许一个实体收集或提供单个的Jabber ID。
|-
|多选项列表 || 该字段允许一个实体从很多选项中收集或提供一个或多个选项。表单提交实体从表单处理实体提交的选项中选择一个或多个项，而且不能插入新的选项。表单处理实体不能修改从表单处理实体处获取的项目的顺序，因为项目的顺序可能很重要。**
|-
|单选项列表|| 该字段允许一个实体从很多选项中收集或提供一个选项。表单提交实体从表单处理实体提交的选项中选择一个项，而且不能插入新的选项。**
|-
|多文本|| 该字段允许一个实体收集或提供多行的文本。***
|-
|私有文本|| 该字段允许一个实体收集或提供一行或一个词的文本，其应该在界面上遮蔽。（如，星号显示的多个实体）
|-
|单文本|| 该字段允许一个实体收集或提供一行或一个词的文本，其应该在界面上显示。这个字段类型是缺省的而且必须假定，当一个表单提交实体收到一个不知道的字段类型时。
|}

注意：为字段类型"jid-single"或"jid-multi"提供的数据必须包含一个或一个以上的有效Jabber ID，有效性是由XMPP Core（参看后面章节的Data Validation）定义的寻址规则决定的。

注意：在list-multi和list-single中的<option/>元素必须是唯一的，唯一性是由‘label’属性的值和<value/>元素中的XML字符数据决定的。（即，2个都必须是唯一的）

注意：为字段类型"text-multi"提供的数据不应该包含任何换行符（\n和\r字符）。而应用程序应该把数据分为多个字符串（基于平台插入的换行符），然后用不同的<value/>元素中的XML字符数据指定每一个字符串。同样的，以"text-multi"字段类型接收了多个<value/>元素的应用程序，应该把value元素中的XML字符数据合并成一个文本块以提交给用户。每一个字符串为平台适时的通过换行符分开。

===表单结果中的多个项目===
在某些情况下（如，查询请求的结果），传达多个项目是必须的。因此，一个"result"类型的数据表单可能包含2个上面基本语法没有描述的子元素:

#只有一个<reported/>元素，可以理解为一个“表头”描述数据去遵循。
#零个或更多<item/>元素，可以理解为包含符合请求的数据（如果有的话）的"table cells"。

其语法如下：

<source lang="xml">
<x xmlns='jabber:x:data'
type='result'>
<reported>
<field var='field-name' label='description' type='{field-type}'/>
</reported>
<item>
<field var='field-name'>
<value>field-value</value>
</field>
</item>
<item>
<field var='field-name'>
<value>field-value</value>
</field>
</item>
.
.
.
</x>
</source>

这些元素每个都必须包含一个或多个<field/>子元素。<reported/>元素为结果项定义数据格式，通过为每个项目指定所期望的字段。为此，除了'var'属性，<field/>元素还应该有'type'属性'label'属性；而且不能包含<value/>元素。在结果集中，每个<item/>元素定义一个项目，而且必须包含在<reported/>元素（虽然<value/>元素中的XML字符数据可能为空）中指定的字段。

==数据有效性==

数据有效性是表单处理实体（通常是一个服务器，服务，或bot）的责任，而不是表单提交实体（通常是一个由用户控制的客户端）。这有助于满足保持客户端实现简单的要求。如果表单处理实体确定提供的数据是无效的，它应该返回一个“不接受”的错误。选择在XMPP <text/>元素中提供文字说明，或识别问题的特殊应用子元素（参考[http://xmpp.org/extensions/xep-0086.html Error Condition Mappings] [[XEP-0004#附录G:备注|11]]中的映射和格式）。

==例子==

对于下面的例子，我们假设存在一个bot hosting服务在Jabber network上，位于<botster.shakespeare.lit>。这个服务允许注册用户创建和配置新的bots，对已经存在的bots查找和交互，等等。我们假定这些交互的发生使用的Ad-Hoc Commands [12]协议，协议被用作表单的"wrapper"协议，受'jabber:x:data'命名空间限制。下面章节中的例子，体现了前文中描述的数据表单协议的大部分特性。

注意：额外的例子可以通过各种“使用协议”的说明书中找到。如XEP-0045:Multi-User Chat和XEP-0055:Jabber Search。

===配置===

:第一步是为用户在主机上创建一个新的bot。我们假设这是通过发送一个“创建”命令给期望的bot来实现的:

:'''例1.用户请求Bot创建'''

<source lang="xml">
<iq from='romeo@montague.net/home'
to='joogle@botster.shakespeare.lit'
type='get'
xml:lang='en'
id='create1'>
<command xmlns='http://jabber.org/protocol/commands'
node='create'
action='execute'/>
</iq>
</source>

:然后主服务返回一个数据表单个用户:

:'''例2.服务返回一个Bot创建表单'''

<source lang="xml">
<iq from='joogle@botster.shakespeare.lit'
to='romeo@montague.net/home'
type='result'
xml:lang='en'
id='create1'>
<command xmlns='http://jabber.org/protocol/commands'
node='create'
sessionid='create:20040408T0128Z'
status='executing'>
<x xmlns='jabber:x:data' type='form'>
<title>Bot Configuration</title>
<instructions>Fill out this form to configure your new bot!</instructions>
<field type='hidden'
var='FORM_TYPE'>
<value>jabber:bot</value>
</field>
<field type='fixed'><value>Section 1: Bot Info</value></field>
<field type='text-single'
label='The name of your bot'
var='botname'/>
<field type='text-multi'
label='Helpful description of your bot'
var='description'/>
<field type='boolean'
label='Public bot?'
var='public'>
<required/>
</field>
<field type='text-private'
label='Password for special access'
var='password'/>
<field type='fixed'><value>Section 2: Features</value></field>
<field type='list-multi'
label='What features will the bot support?'
var='features'>
<option label='Contests'><value>contests</value></option>
<option label='News'><value>news</value></option>
<option label='Polls'><value>polls</value></option>
<option label='Reminders'><value>reminders</value></option>
<option label='Search'><value>search</value></option>
<value>news</value>
<value>search</value>
</field>
<field type='fixed'><value>Section 3: Subscriber List</value></field>
<field type='list-single'
label='Maximum number of subscribers'
var='maxsubs'>
<value>20</value>
<option label='10'><value>10</value></option>
<option label='20'><value>20</value></option>
<option label='30'><value>30</value></option>
<option label='50'><value>50</value></option>
<option label='100'><value>100</value></option>
<option label='None'><value>none</value></option>
</field>
<field type='fixed'><value>Section 4: Invitations</value></field>
<field type='jid-multi'
label='People to invite'
var='invitelist'>
<desc>Tell all your friends about your new bot!</desc>
</field>
</x>
</command>
</iq>
</source>

:然后用户提交配置表单:

:'''例3.用户提交bot创建表单'''

<source lang="xml">
<iq from='romeo@montague.net/home'
to='joogle@botster.shakespeare.lit'
type='set'
xml:lang='en'
id='create2'>
<command xmlns='http://jabber.org/protocol/commands'
node='create'
sessionid='create:20040408T0128Z'>
<x xmlns='jabber:x:data' type='submit'>
<field type='hidden' var='FORM_TYPE'>
<value>jabber:bot</value>
</field>
<field type='text-single' var='botname'>
<value>The Jabber Google Bot</value>
</field>
<field type='text-multi' var='description'>
<value>This bot enables you to send requests to</value>
<value>Google and receive the search results right</value>
<value>in your Jabber client. It' really cool!</value>
<value>It even supports Google News!</value>
</field>
<field type='boolean' var='public'>
<value>0</value>
</field>
<field type='text-private' var='password'>
<value>v3r0na</value>
</field>
<field type='list-multi' var='features'>
<value>news</value>
<value>search</value>
</field>
<field type='list-single' var='maxsubs'>
<value>50</value>
</field>
<field type='jid-multi' var='invitelist'>
<value>juliet@capulet.com</value>
<value>benvolio@montague.net</value>
</field>
</x>
</command>
</iq>
</source>

:然后服务返回结果给用户:

:'''例4.服务返回bot创建的结果'''

<source lang="xml">
<iq from='joogle@botster.shakespeare.lit'
to='romeo@montague.net/home'
type='result'
xml:lang='en'
id='create2'>
<command xmlns='http://jabber.org/protocol/commands'
node='create'
sessionid='create:20040408T0128Z'
status='completed'>
<x xmlns='jabber:x:data' type='result'>
<field type='hidden' var='FORM_TYPE'>
<value>jabber:bot</value>
</field>
<field type='text-single' var='botname'>
<value>The Jabber Google Bot</value>
</field>
<field type='boolean' var='public'>
<value>0</value>
</field>
<field type='text-private' var='password'>
<value>v3r0na</value>
</field>
<field type='list-multi' var='features'>
<value>news</value>
<value>search</value>
</field>
<field type='list-single' var='maxsubs'>
<value>50</value>
</field>
<field type='jid-multi' var='invitelist'>
<value>juliet@capulet.com</value>
<value>benvolio@montague.net</value>
</field>
</x>
</command>
</iq>
</source>

===搜索===

既然用户已经创建了这个搜索bot,我们假设他所邀请的好友中的一个，决定通过发送一个搜索请求来试一试:

:'''例5.用户请求搜索表单'''

<source lang="xml">
<iq from='juliet@capulet.com/chamber'
to='joogle@botster.shakespeare.lit'
type='get'
xml:lang='en'
id='search1'>
<command xmlns='http://jabber.org/protocol/commands'
node='search'
action='execute'/>
</iq>
</source>

:'''例6.服务返回搜索表单'''

<source lang="xml">
<iq from='joogle@botster.shakespeare.lit'
to='juliet@capulet.com/chamber'
type='result'
xml:lang='en'
id='search1'>
<command xmlns='http://jabber.org/protocol/commands'
node='search'
status='executing'>
<x xmlns='jabber:x:data' type='form'>
<title>Joogle Search</title>
<instructions>Fill out this form to search for information!</instructions>
<field type='text-single'
var='search_request'>
<required/>
</field>
</x>
</command>
</iq>
</source>

:'''例7.用户提交搜索表单'''

<source lang="xml">
<iq from='juliet@capulet.com/chamber'
to='joogle@botster.shakespeare.lit'
type='get'
xml:lang='en'
id='search2'>
<command xmlns='http://jabber.org/protocol/commands'
node='search'>
<x xmlns='jabber:x:data' type='submit'>
<field type='text-single' var='search_request'>
<value>verona</value>
</field>
</x>
</command>
</iq>
</source>

:'''例8.服务返回搜索结果'''

<source lang="xml">
<iq from='joogle@botster.shakespeare.lit'
to='juliet@capulet.com/chamber'
type='result'
xml:lang='en'
id='search2'>
<command xmlns='http://jabber.org/protocol/commands'
node='search'
status='completed'>
<x xmlns='jabber:x:data' type='result'>
<title>Joogle Search: verona</title>
<reported>
<field var='name'/>
<field var='url'/>
</reported>
<item>
<field var='name'>
<value>Comune di Verona - Benvenuti nel sito ufficiale</value>
</field>
<field var='url'>
<value>http://www.comune.verona.it/</value>
</field>
</item>
<item>
<field var='name'>
<value>benvenuto!</value>
</field>
<field var='url'>
<value>http://www.hellasverona.it/</value>
</field>
</item>
<item>
<field var='name'>
<value>Universita degli Studi di Verona - Home Page</value>
</field>
<field var='url'>
<value>http://www.univr.it/</value>
</field>
</item>
<item>
<field var='name'>
<value>Aeroporti del Garda</value>
</field>
<field var='url'>
<value>http://www.aeroportoverona.it/</value>
</field>
</item>
<item>
<field var='name'>
<value>Veronafiere - fiera di Verona</value>
</field>
<field var='url'>
<value>http://www.veronafiere.it/</value>
</field>
</item>
</x>
</command>
</iq>
</source>

==服务发现==

如果一个实体支持包含受'jabber:x:data'命名空间限制的<x/>元素作为<message/>节直接子元素，它必须报告支持包含一个"jabber:x:data"（参看Protocol Namespaces中关于一个或多个永久命名空间的发行）的服务搜索特征，去响应服务搜索信息请求:

:'''例9.服务搜索信息请求'''

<source lang="xml">
<iq type='get'
from='romeo@montague.net/orchard'
to='juliet@capulet.com/balcony'
id='disco1'>
<query xmlns='http://jabber.org/protocol/disco#info'/>
</iq>
</source>

:'''例10.服务搜索信息响应'''

<source lang="xml">
<iq type='result'
from='juliet@capulet.com/balcony'
to='romeo@montague.net/orchard'
id='disco1'>
<query xmlns='http://jabber.org/protocol/disco#info'>
...
<feature var='jabber:x:data'/>
...
</query>
</iq>
</source>

如果实体支持数据表单，间接的通过在wrapper命名空间中包含数据表单，它不能为'jabber:x:data'命名空间通知支持，因为在wrapper协助中的支持是隐性的。

==安全性考虑==

没有安全问题与上述的规范和XMPP Core中相关章节的描述有关。

==IANA考虑==

这份文档与[http://www.iana.org/ Internet Assigned Numbers Authority (IANA)] [[XEP-0004#附录G:备注|13]]无关。

==XMPP注册考虑==

===协议命名空间===

[http://xmpp.org/registrar/ XMPP Registrar] [[XEP-0004#附录G:备注|14]]在它注册的协议命名空间中包含'jabber:x:data'命名空间。

===参数值===

XMPP注册员维持着一个与'jabber:x:data'命名空间相关的注册参数值。具体定义在[http://xmpp.org/extensions/xep-0068.html Field Standardization for Data Forms] [[XEP-0004#附录G:备注|15]]。注册的地方是<http://xmpp.org/registrar/formtypes.html>。

==XML 架构==

该架构是描述性的，不是规范的。

<source lang="xml">
<?xml version='1.0' encoding='UTF-8'?>

<xs:schema
xmlns:xs='http://www.w3.org/2001/XMLSchema'
targetNamespace='jabber:x:data'
xmlns='jabber:x:data'
elementFormDefault='qualified'>

<xs:annotation>
<xs:documentation>
The protocol documented by this schema is defined in
XEP-0004: http://www.xmpp.org/extensions/xep-0004.html
</xs:documentation>
</xs:annotation>

<xs:element name='x'>
<xs:complexType>
<xs:sequence>
<xs:element name='instructions'
minOccurs='0'
maxOccurs='unbounded'
type='xs:string'/>
<xs:element name='title' minOccurs='0' type='xs:string'/>
<xs:element ref='field' minOccurs='0' maxOccurs='unbounded'/>
<xs:element ref='reported' minOccurs='0' maxOccurs='1'/>
<xs:element ref='item' minOccurs='0' maxOccurs='unbounded'/>
</xs:sequence>
<xs:attribute name='type' use='required'>
<xs:simpleType>
<xs:restriction base='xs:NCName'>
<xs:enumeration value='cancel'/>
<xs:enumeration value='form'/>
<xs:enumeration value='result'/>
<xs:enumeration value='submit'/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
</xs:element>

<xs:element name='field'>
<xs:complexType>
<xs:sequence>
<xs:element name='desc' minOccurs='0' type='xs:string'/>
<xs:element name='required' minOccurs='0' type='empty'/>
<xs:element ref='value' minOccurs='0' maxOccurs='unbounded'/>
<xs:element ref='option' minOccurs='0' maxOccurs='unbounded'/>
</xs:sequence>
<xs:attribute name='label' type='xs:string' use='optional'/>
<xs:attribute name='type' use='optional'>
<xs:simpleType>
<xs:restriction base='xs:NCName'>
<xs:enumeration value='boolean'/>
<xs:enumeration value='fixed'/>
<xs:enumeration value='hidden'/>
<xs:enumeration value='jid-multi'/>
<xs:enumeration value='jid-single'/>
<xs:enumeration value='list-multi'/>
<xs:enumeration value='list-single'/>
<xs:enumeration value='text-multi'/>
<xs:enumeration value='text-private'/>
<xs:enumeration value='text-single'/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name='var' type='xs:string' use='optional'/>
</xs:complexType>
</xs:element>

<xs:element name='option'>
<xs:complexType>
<xs:sequence>
<xs:element ref='value'/>
</xs:sequence>
<xs:attribute name='label' type='xs:string' use='optional'/>
</xs:complexType>
</xs:element>

<xs:element name='value' type='xs:string'/>

<xs:element name='reported'>
<xs:annotation>
<xs:documentation>
When contained in a "reported" element, the "field" element
SHOULD NOT contain a "value" child.
</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element ref='field' maxOccurs='unbounded'/>
</xs:sequence>
</xs:complexType>
</xs:element>

<xs:element name='item'>
<xs:complexType>
<xs:sequence>
<xs:element ref='field' maxOccurs='unbounded'/>
</xs:sequence>
</xs:complexType>
</xs:element>

<xs:simpleType name='empty'>
<xs:restriction base='xs:string'>
<xs:enumeration value=''/>
</xs:restriction>
</xs:simpleType>

</xs:schema>
</source>

==最终状态的修改==

当本规范已经是最终状态时，下面的实体协议已经做了修改：

* 指定的'var'属性是所有字段类型所必须的，除了"fixed", 因为'var'属性是可选的。

* 通过服务搜索指定何时去通知支持。

* 移除引用<presence/>节。

==草稿状态的修改==

当本规范在草稿状态时，下面的实体协议已经做了修改：

* <x/>元素可能直接包含在<message/>和<presence/>节中。
* <x/>元素可能包含一个<title/>子元素，在表单或结果中。
* <x/>元素必须拥有一个‘类型’属性。
* <field/>元素可能是类型='jid-single'。
* 结果可能以<item/>标签的方式返回报告。
* 结果可能包含一个<reported/>元素的结果集。
* <reported/>字段可能拥有一个‘类型’属性，提供如何与数据交互的提示（类型='jid-single'是最有用的）。

==附录==
===附录A:文档信息===

系列：[http://xmpp.org/extensions/ XEP]

序号：0004

发布者：[http://xmpp.org/xsf/ XMPP标准基金会]

状态：[http://www.xmpp.org/extensions/xep-0001.html#states-Final 终结版]

类型：[http://www.xmpp.org/extensions/xep-0001.html#types-Standards%20Track 标准跟踪]

版本：2.9

最后更新：2007-07-13

批准机构：[http://xmpp.org/council/ XMPP理事会]

依赖标准：[[RFC3920|XMPP Core]]

替代标准：无

被替代标准：无

缩略名：x-data

XML架构:<http://www.xmpp.org/schemas/x-data.xsd>

原文控制： [http://svn.xmpp.org:18080/browse/XMPP/trunk/extensions/xep-0004.xml HTML] [http://svn.xmpp.org:18080//changelog/~rss/XMPP/trunk/extensions/xep-0004.xml/rss.xml RSS]

本文的其它格式： [http://xmpp.org/extensions/xep-0004.xml XML] [http://xmpp.org/extensions/xep-0004.pdf PDF]

===附录B:作者信息===

'''Ryan Eatmon'''

Email: [mailto:reatmon@jabber.org reatmon@jabber.org]

JabberID: reatmon@jabber.org

'''Joe Hildebrand'''

Email: [mailto:jhildebr@cisco.com jhildebr@cisco.com]

JabberID: hildjj@jabber.org

'''Jeremie Miller'''

Email: [mailto:jer@jabber.org jer@jabber.org]

JabberID: jer@jabber.org

'''Thomas Muldowney'''

Email: [mailto:temas@jabber.org temas@jabber.org]

JabberID: temas@jabber.org

'''Peter Saint-Andre'''

Email: [mailto:stpeter@jabber.org stpeter@jabber.org]

JabberID: stpeter@jabber.org

URI: https://stpeter.im/

{{Template:XEP附录CDEF}}

===附录G:备注===
#XEP-0077: In-Band Registration <http://xmpp.org/extensions/xep-0077.html>.
#XEP-0055: Jabber Search <http://xmpp.org/extensions/xep-0055.html>.
#XEP-0045: Multi-User Chat <http://xmpp.org/extensions/xep-0045.html>.
#XEP-0030: Service Discovery <http://xmpp.org/extensions/xep-0030.html>.
#XForms 1.0 <http://www.w3.org/TR/xforms>.
#XHTML 1.0 <http://www.w3.org/TR/xhtml1>.
#Modularization of XHTML <http://www.w3.org/TR/2004/WD-xhtml-modularization-20040218/>.
#RFC 3920: Extensible Messaging and Presence Protocol (XMPP): Core <http://tools.ietf.org/html/rfc3920>.
#XML Schema Part 2: Datatypes <http://www.w3.org/TR/xmlschema-2/>.
#In accordance with Section 3.2.2.1 of XML Schema Part 2: Datatypes, the allowable lexical representations for the xs:boolean datatype are the strings "0" and "false" for the concept 'false' and the strings "1" and "true" for the concept 'true'; implementations MUST support both styles of lexical representation.
#XEP-0086: Error Condition Mappings <http://xmpp.org/extensions/xep-0086.html>.
#XEP-0050: Ad-Hoc Commands <http://xmpp.org/extensions/xep-0050.html>.
#The Internet Assigned Numbers Authority (IANA) is the central coordinator for the assignment of unique parameter values for Internet protocols, such as port numbers and URI schemes. For further information, see <http://www.iana.org/>.
#The XMPP Registrar maintains a list of reserved protocol namespaces as well as registries of parameters used in the context of XMPP extension protocols approved by the XMPP Standards Foundation. For further information, see <http://xmpp.org/registrar/>.
#XEP-0068: Field Data Standardization for Data Forms <http://xmpp.org/extensions/xep-0068.html>.

===附录H:修订历史===

注意:

'''版本 2.9 (2007-08-13)'''

Clarified the definition and handling of the list-multi and list-single field types; specified that hidden field values should not be modified unless such behavior is defined for the using protocol; specified that a submission should include all fields provided in the empty form and may include additional fields, but that additional fields must be ignored if not understood by the form-processing entity.

(psa)

'''版本 2.8 (2007-05-21)'''

Removed mentions of presence stanzas; added section on discovering support; added section on substantive changes in Final state.

(psa)

'''版本 2.7 (2006-01-25)'''

Incorporated errata: (1) clarified rules regarding inclusion of option and value elements depending on field type; (2) clarified handling of default values; (3) added value elements to list-multi field in Example 2; (4) harmonized spelling of form-processing entity and form-submitting entity.

(psa)

Version 2.6 (2004-10-13)
Incorporated errata: (1) corrected syntax of <reported/> element (<field/> element should not contain a <value/> child); (2) corrected Example 8.

(psa)
Version 2.5 (2004-05-07)
Clarified terminology regarding form-processing entities and form-submitting entities; corrected several small errors in the schema.

(psa)
Version 2.4 (2004-05-04)
Per discussion by the authors and Jabber Council, specified that the 'var' attribute is required for all field types except "fixed", for which the 'var' attribute is optional.

(psa)
Version 2.3 (2004-03-31)
Formalization and further editorial revisions.

(psa)
Version 2.2 (2004-01-22)
Editorial revisions.

(psa)
Version 2.1 (2003-02-16)
Added schema.

(psa)
Version 2.0 (2002-12-09)
Per a vote of the Jabber Council, changed status to Final.

(psa)
Version 1.1 (2002-10-15)
Call for Experience changes (see Changes in Draft State section). This version voted to Final on 2002-12-09.

(rwe)
Version 1.0 (2002-04-24)
Per a vote of the Jabber Council, changed status to Draft.

(psa)
Version 0.6 (2002-03-15)
Protocol tweaks based on Standards list discussion.

(rwe)
Version 0.5 (2002-02-06)
Protocol tweaks based on implementation and discussion.

(rwe)
Version 0.4 (2001-11-16)
Major redesign to attempt to clarify the scope of this document and limit what it is trying to solve.

(rwe)
Version 0.3 (2001-07-23)
Protocol update

(rwe)
Version 0.2 (2001-06-29)
Protocol update and DocBook version

(rwe)
Version 0.1 (2001-01-25)
Initial release

(rwe)
[http://essaywritingservices.org/index.php essay writing service]