Form Submission To Email

The Form Submission To Email AppBlock ("Form Submit") allows you to create/design a form that will be displayed inside your application.

This form, when filled in by the end user, will be sent via email to the email address or email addresses specified by you in the Platform.  The data submitted will also be stored in AppOffice, which is the content management system for the AppBlock.

After you add a Form Submit AppBlock, there are four steps you need to complete:


 

 

Configuration

On the Configuration screen, fill in the fields below.  Note: if you do not know what to put into the fields now, you can come back at any time.  Be sure to click the "Apply" button to save your changes.



  • Item Name - this will be pre-populated with the Item Name you entered when creating the AppBlock.
  • Display Name - this is what will be shown in the navbar of the app when the app user is on the Form Submit page.  It is pre-populated with the original Item Name by default.
  • Sender Email Address - the recipient of the emails will see this email address as the sender.  The primary reason for this field is to allow the recipient to filter the emails in their email client.  Secondarily, you may also add this email address to your "White List" of accepted sender email address. Example: no-reply@mobilesmith.com.
  • Deep Link - this is a non-editable field commonly used with Gimbal.
  • Recipient Email Address - enter the email address(es) in which you want the form submitted.  Use a comma to separate email addresses.
  • Subject Line - the recipient of the emails will see this as the subject of each email.  Example: "MyAppName Contact Form".
  • Success Message - this message will display in the app once an end-user successfully submits a form.  Example: "Thank you for contacting us!  We'll get back to you as soon as we can!"
  • Failure Message - in the event that an end-user loses their data connection, this message will display in the app to inform the end-user that their form was not sent.  Example: "Sorry! It looks like you lost connection! Please try again."


Data Mapping

Configure the Data Mapping by dragging and dropping Canvas Elements into the empty area.  Each Canvas Element selected will become an Input Field that you will soon place on the Input View canvas.  There are no limitations to the number of Canvas Elements you select.  You may also drag & drop multiple of the same Canvas Elements types.  Example:  If you want to have "Name" and "Email" fields, then you will drag "Text Box" over twice.

Once you drag & drop a Canvas Element to your selected area, you can modify the name of that field.  Example:  If you want a "First Name" field on your form, you would first drag & drop a "Text Box" Canvas Element, then rename it from "Text Box" to "First Name".  Repeat this process until you have all the Canvas Elements desired.  You may also add or remove Canvas Elements later using the "Data Mapping" page for the AppBlock.


 

Canvas

In the left-hand menu, under "AppBlocks", find your newly created AppBlock.  Click the AppBlock title, then click "Phone Canvases".

In the Tool Box on the right side, under the Inputs tab, you will find the input fields you added in Data Mapping.  Drag & drop one of the fields onto the Input canvas.

Once a field is on the canvas, click it and you will be able to customize it in the Properties box on the right side.

Note: you do not need to add a "Submit" button.  The platform will automatically add this button for you.


 

Target

Set your AppBlock as the target of a button, row, or tab.

 

Now you can build a test app and see what your form looks like on a phone.

 

Form Submit AppBlock on Android

 

< < Android

 

 

iPhone > >

Form Submit AppBlock on iPhone


 

 

When the user taps "Send", it will display the success message you entered in Configuration.

 

Form Submit success message on iPhone

AppOffice

When an app user submits the form, it sends the email to the recipient(s) you entered in Configuration.  It also sends the data to AppOffice, where you can see all the data for any submitted form and resend the email for any submitted form.