Difference between revisions of "Web Forms"

From AgileApps Support Wiki
imported>Aeric
imported>Aeric
Line 72: Line 72:
|-
|-
|5. Save and Generate||
|5. Save and Generate||
*Enter the Title of this Web Form.<br>(Only used to access the Web Form in the platform. In the list of Web Forms for this Object, it appears in the ''Name'' column.)  
*Enter the Title of this Web Form.<br>(Only used in the platform. In the list of Web Forms for this Object, it appears in the ''Name'' column.)  
*Choose Type: Script or HTML.  
*Choose Type: Script or HTML.  
:;Script:Hosts the Web Form on the platform. Generates a script and a link to access it.
:;Script:Hosts the Web Form on the platform. Generates a script and a link to access it.
::* Either the script or the link can be embedded into a web page on your site.
::* Either the script or the link can be embedded into a web page on your site.
::* When you use the link, you can pre-fill values for selected fields in the Web Form by appending them as parameters: <tt>&field1=value&field2=value...</tt>.
::* When you use the link, you can pre-fill values for selected fields in the Web Form by appending them as parameters: <tt>&field1=value&field2=value...</tt>.
:::* To include "&" in a value use %26. For spaces, use %20. (For example, for company "A & B" specify <tt>company_name=A%20%26%20B</tt>.)
:::* To include "&" in a value use %26. For spaces, use %20.<br>(For example, for company "A & B" specify <tt>company_name=A%20%26%20B</tt>.)
:::* ''Learn more: [[Specifying Query Parameters in REST APIs#Specifying Request Arguments|Specifying Request Arguments]]
:::* ''Learn more: [[Specifying Query Parameters in REST APIs#Specifying Request Arguments|Specifying Request Arguments]]
::* The button label is "Send Request"
::* The button label is "Send Request"

Revision as of 19:07, 14 September 2011

Designer > Presentation > Web Forms

A Web Form is a collection of fields a user can fill in on another site, after which data is sent to the platform. You can use a Web Form on your corporate website, your intranet, or even a blog. Use it to plug visitor data directly into a platform application.

Working with Web Forms

Lock-tiny.gif

Users that have the Customize Objects permission can manage Web Forms. 
Generated Web Form

In the Web Form, you specify the input fields you want to embed in an HTML page. You put the resulting form into the page, and that page is dynamically linked to your application.

Fields in the Web Form are automatically validated according to the rules defined by the application, and you can generate an auto-response to the person submitting the form, or redirect them to a specific URL. You can also notify designated members of your team that someone has submitted the web form.

Just follow the steps in the Web Form wizard to design and preview the form layout and begin collecting information.

Considerations

Best Practices

Here are some pointers to making web forms work for your business.

  • Make sure you have a landing page for people to go to after they fill out the form, since in most cases it is their only confirmation that the submission was a success
  • When someone fills in a form, you can automatically email a thank you to them if you include a field of type Email
  • Likewise, you can alert a member of your team that someone has filled in the form with a notification - this is great for inquiries that need more interaction
  • If you want to fully customize the layout of the form, use HTML snippets instead of the one-line JavaScript as the final format - it gives you more control to layout the form as well as style controls
  • When using HTML snippets, you'll want to make sure you don't delete any INPUT tags marked HIDDEN or any embedded SCRIPT tags since these are what drive data into your application database
  • If you include an Email field in the form, the address can be used in email campaigns, allowing the user to register for newsletters, announcements, and product updates.

With a Web Form, you can collect information from your company web site that directly flows into the platform. The Web Form Wizard helps you generate a customized HTML/JSP (JavaServer Pages) that you can embed into your web site.

Web Form Wizard

The wizard walks you through the process to create a web form.

Add a Web Form

To launch the web form wizard:

  • Click Designer > Data > Objects > {object} > Web Forms.
  • Click the [New Web Form] button, or open an existing web form. The web form wizard opens.
Steps in the Wizard Instructions
1. Select Fields
  • Select the field(s) you want to include in the web form from the Fields list.
  • Click [Next]

Note: When you select a File Field or an Image Field, the form automatically includes a file-chooser dialog that lets the user browse for the file to include. ('Learn more: Field Display Types)

2. Mark Required Fields
  • Click the check box next to any field you want to mark as a Required Field. Some fields may be pre-selected automatically. As you click a check box, the field is marked as required in the Preview area.
  • Click [Next].
3. Notifications
  • In the Record Owner Information section, select the record owner from the Lookup field.
  • Optionally, click the check box to Send Email Notification to record owner when the web form is received.
  • Optionally, select additional user(s) to receive the email notification.
  • In the Email Notification Details section, enter the text you want to appear as the Subject of the email. Enter the text you want to appear as the email message in the Description fields. You can customize the message content, and include Template Variables. Use the Template Variable Tool to get the names of variables you can use in the template:
TemplateVariableTool.jpg
  • Click [Next].
4. Auto Response If an email address field was included in the web form, it is a good practice to create an auto response to acknowledge receipt of the web form information.
  • Complete the following information:
Email Field (To)
Choose from None or Email
  • If None, no auto response message is sent
  • If Email, the Subject and Description fields are required
Subject
Description for the auto response email message
Editor Type (Plain Text or HTML Editor)
If you select HTML Editor, the HTML formatting tools become available.
Description
Enter the body of the message, and optionally include Template Variables.
  • Click Next.
5. Save and Generate
  • Enter the Title of this Web Form.
    (Only used in the platform. In the list of Web Forms for this Object, it appears in the Name column.)
  • Choose Type: Script or HTML.
Script
Hosts the Web Form on the platform. Generates a script and a link to access it.
  • Either the script or the link can be embedded into a web page on your site.
  • When you use the link, you can pre-fill values for selected fields in the Web Form by appending them as parameters: &field1=value&field2=value....
  • To include "&" in a value use %26. For spaces, use %20.
    (For example, for company "A & B" specify company_name=A%20%26%20B.)
  • Learn more: Specifying Request Arguments
  • The button label is "Send Request"
HTML
Generates HTML code that can be embedded into a web page on your site.
  • You can then modify the layout, or change the label on the button the user clicks to submit the form.
  • Specify the platform-URL of the page the user goes to after submitting the form: Service?t=100&targetpage={platform_page}.jsp
    (The web needs to acknowledges the form submission.)
  • Click the [Save and Generate] button.
    The form (or the script and link) appears, along with a Preview.

Copy and Paste

  • If the Web Form you generated was of type HTML, copy the generated code and paste it into your web page.
  • If the selected type was Script, you can copy the code, or you can copy the generated link and paste that into your web page. (The link accesses the code, which is stored on the platform.)
  • When using a link, pre-filled values are embedded in the query-string of the URL. Those variables can be modified dynamically at your site, allowing you to pre-fill different values in different circumstances.

[[Category:Template:Features]]