Server Post Integration
What is Server Post Integration?
Server Post Integration allows responses from your form to be sent to a third-party server. A Professional level FormSite account is required.
FormSite's Server Post Settings
Your form's Server Post settings are controlled on the "Form->Third Party->Server Post" page.
- Login to www.formsite.com and go to the "Form->Third Party->Server Post" page for your form.
- Enter the URL of the server. This should be the full URL, including the HTTP/HTTPS prefix. You can define additional parameters below.
- Select the Message Format. This is the format the results will be in when sent to the server. "Name-Value Pairs" is the standard HTTP parameters format, but you can also choose XML or one of our Comma-Separated (CSV) formats, depending on what your server application requires.
- Enabling the "Use Server Response as Success Page" setting will cause the server's response to be displayed to the user filling out the form in place of the regular Success Page.
- Use the Additional Parameters setting to pass other parameters to your server. These should be in the Name=Value format, and will be appended to the URL during the POST request.
- Select the Results View, Results Filter, and Custom Labels that should be applied to results when posting them to the server. Only those responses allowed by the Results View and Filter will have their results sent.
- Select whether you want results to be stored in FormSite after the post or not. The default is to store the results, but if you do not want to keep them you can set this option to "No".
Collecting Server Post Results
Once Server Post Integration has been completed, your form is ready to accept results. When a user fills out your form, their responses will be sent to the URL of the server when the user submits the last page and the result enters the "Completed" status.
When editing a result from the "Results->Summary Table" page, or when using the Form Login feature, the updated results will automatically be sent to the server.
Results for form items will closely resemble the naming conventions specified by FormSite's API at the "Form->API" page. You can modify the names of the item parameters by using Custom Labels. The basic format for different item types when using the Name-Value Pairs format is:
| Text field | ID |
| Radio/Checkbox | ID-choice |
| Text Matrix | ID-subquestion-row |
| Radio/Checkbox Matrix | ID-row-column |
| Radio/Checkbox Multi-Scale | ID-scale-row |
If the Server Post for a result fails, it will enter the "Failed" status, and the user will be shown an error page. You can see the status on the "Results->Summary Table" page.
Tips and Troubleshooting
If for some reason a result was not submitted to the server, or Server Post Integration was not setup yet when the result was collected, you can repost it to the server by simply editing and saving the result at the "Results->Summary Table" page.
Use the Additional Parameters to pass special identification or authentication parameters to your server.
Additional Information
Server Post Integration uses the HTTP POST method and results will be sent in the request's Content section, encoded based upon the selected Message Format.
The Additional Parameter(s) option is only available for the Name-Value Pairs format.