Data Forms XML Element

%ents; ]>

Data Forms XML Element This specification defines an XMPP protocol extension for including XML-data in XEP-0004 data forms. &LEGALNOTICE; 0315 Deferred Standards Track Standards XMPP Core XEP-0004 xml-element Sergey Dobrov binary@jrudevels.org binary@jrudevels.org http://jrudevels.org/ 0.1.1 2019-06-19 fs

Fix shortname and section heading to avoid collision with XEP-0221

0.1 2012-10-15 psa

Initial published version approved for publication by the XMPP Council.

0.0.2 2012-06-21 snd

Root element name changed to "wrapper"; xmlns fixed in the XML-schema.

0.0.1 2012-06-13 snd

Initial version.

In certain protocols that make use of &xep0004;, it can be helpful to include XML-data (for example, when we want to insert a big amount of structured data which is hard to insert as a separate fields). This document defines a method for including XML-data in a data form.

The root element for XML-data is <wrapper/>. This element MUST be qualified by the "urn:xmpp:xml-element" namespace. The <wrapper/> element MUST be contained within a <field/> element qualified by the 'jabber:x:data' namespace.

The <wrapper/> element SHOULD contain an XML-data which needs to be represented in a form.

Romeo's Microblog tag:montague.lit,2008:home 2008-05-08T18:30:02Z Romeo Montague xmpp:romeo@montague.lit ]]> [ ... ] Romeo's Microblog tag:montague.lit,2008:home 2008-05-08T18:30:02Z Romeo Montague xmpp:romeo@montague.lit [ ... ] ]]>

XML-data is usually hard for manual editing and SHOULD be used only for machine level iteractions. So it's RECOMMENDED to include it in the form as a "hidden" field.

However, there are situations when human editing of XML-data may be useful (for example, to see XML-logs of some XMPP-service). In that case it's RECOMMENDED for a client to represent this XML in a pretty formatted form and give an instruments to make it easier to edit XML-data.

This document requires no interaction with &IANA;.

The ®ISTRAR; includes "urn:xmpp:xml-element" in its registry of protocol namespaces (see &NAMESPACES;).





  
    
      The protocol documented by this schema is defined in
      XEP-XXXX: http://www.xmpp.org/extensions/xep-xxxx.html
    
  

  
    
      
        
      
    
  


]]>