Migration Consideration from v4
...
There is a change in the form submission XML in v5.1.1 in terms of the form name. The submission xml, in previous versions, included the name attribute in the root element. Here is an example of the submisson xml for a form named MyTestForm in v4v4x:
Code Block |
---|
<ns:form xmlns:ns="http://www.frevvo.com/schemas/_cUipsAwZEeOBRuTQ9KKS8w" name="MyTestForm"> <FirstName>Tom</FirstName> </ns:form> |
...
The value in the Element Name field will reflect in the root element of the form’s submission XML. Here is an example of submisson xml for a form that has My Test Form as a value in the Element Name field in v5.1.1:
Code Block |
---|
<p0:MyTestForm xmlns:p0="http://www.frevvo.com/schemas/_r3Pq8AwLEeOZFu_wpeK3Ag"> <FirstName>Tom</FirstName> </p0:MyTestForm> |
...
There are new strings present in the default locale properties file for forms/flows in v5. For example.: strings for mobile devices. You will need to manually add these new strings to your uploaded locale files for forms created in v4. New strings can be found by downloading the v5 default properties file for your form. Server wide customizations can be done by unzipping the <frevvo-home>/tomcat/webapps/frevvo.war. See this documentation for the details.
Data API
The browser doc feature in v4 is no longer supported. It introduced a new doc action that can be enabled by the API and where, on submission, the XML document would be sent back to the browser with the HTTP response. This enabled the capture of updated XML and make sure it updated their own systems in a single db transaction.
In 5.x, we have a new mechanism. It is possible now to submit forms using the API and receive back a DataSource? with multiple parts (multipart/form-data) one for each submission document: XML, snapshot, attachments, etc. This is above and beyond what the browser docs provide, but much simpler. See API's submitInstance() and Data Source documentation (coming soon...).
...