Class Ext.form.Action.Submit

A class which handles submission of data from Forms and processes the returned response.

Instances of this class are only created by a Form when submitting.

A response packet must contain a boolean success property, and, optionally an errors property. The errors property contains error messages for invalid fields.

By default, response packets are assumed to be JSON, so a typical response packet may look like this:

{
    success: false,
    errors: {
        clientCode: "Client not found",
        portOfLoading: "This field must not be null"
    }
}

Other data may be placed into the response for processing by the Ext.form.BasicForm's callback or event handler methods. The object decoded from this JSON is available in the result property.

Alternatively, if an errorReader is specified as an XmlReader:

errorReader: new Ext.data.XmlReader({
            record : 'field',
            success: '@success'
        }, [
            'id', 'msg'
        ]
    )

then the results may be sent back in XML format:

<?xml version="1.0" encoding="UTF-8"?>
<message success="false">
<errors>
    <field>
        <id>clientCode</id>
        <msg><![CDATA[Code not found. <br /><i>This is a test validation message from the server </i>]]></msg>
    </field>
    <field>
        <id>portOfLoading</id>
        <msg><![CDATA[Port not found. <br /><i>This is a test validation message from the server </i>]]></msg>
    </field>
</errors>
</message>

Other elements may be placed into the response XML for processing by the Ext.form.BasicForm's callback or event handler methods. The XML document is available in the errorReader's xmlData property.