11.1 The submission Element

The attributes of submission can be divided into three groups, describing what is to be submitted, how it is to be submitted, and what to do with the result.

Common Attributes: Common

Special Attributes:

What to submit:

Single Item Binding

Optional binding that selects the data to be submitted: the node and all its descendants are selected. The default is "/".

value

Optional expression, overriding the single item binding, that calculates a value representing the data to be submitted. If this attribute is present, the relevant, nonrelevant, validate and serialization attributes are ignored.

=================

11.2 Submission Processing

In brief, data is selected, checked for validity as necessary, serialized in the required form, and sent to the server. The server sends a response, possibly accompanied by some data which is then dealt with appropriately.

[...]

11.2.1 Selecting and Validating the Submission Data

If the serialization attribute value is "none", no data is selected.

Otherwise, an update is done if necessary.

• If the value attribute is present, it is evaluated and converted to a string.
• If the value attribute is not present, the binding attributes of submission are evaluated; if the result is the empty sequence or an item other than an element or an instance document root node, submission fails with no-data. A copy of the evaluated node and its descendent nodes are selected. Non-relevant nodes are either deselected, or made empty, according to the value of the nonrelevant attribute, or the deprecated relevant attribute. If no nodes remain, submission fails with no-relevant-data. If the attribute validate is true, whether by default or declaration, and any selected instance data node is invalid, submission fails with validation-error.

==============

11.2.2 Serializing the Data

The submission method is obtained from the method attribute if present, otherwise from the first method child element if any, and otherwise is "get".

The submission resource is obtained from the resource attribute if present, otherwise from the deprecated action attribute if present, and otherwise from the first resource child element, if any; otherwise submission fails with resource-error.

If the value of the submission resource is an absolute URI it is used as the submission URI; otherwise (it is a relative URI) the submission URI is constructed by combining the relevant parts of the value of location-uri() and the submission resource.

The protocol to be used is determined from the submission URI.

The serialized data is obtained:

• If the serialization attribute value is "none", then the empty string is used.
• Otherwise, the (deprecated) xforms-submit-serialize event is dispatched to the submission element; if the submission-body property of the event is changed from the initial value of empty string, then its content is used.
• Otherwise, if the value attribute was present, then the string obtained from evaluating that is used.
• Otherwise, the default serialization format is determined according to the rules stated in Submission Protocols, based on the method and the protocol; if the default is application/xml and the serialization attribute contains a value, that value is used; otherwise the default format is used; the selected data is then serialized in that format according to the rules stated in Serialization Formats.