2. Form and Survey Manager

You are here:
< All Topics

Introduction

The form and survey manager is part of the application which you will visit most frequently. You can see here all the forms that you have created in A1Surveys, plus all the actions that can be performed with each. For example, you can access to the responses, create reports, view statistics.

A1Surveys - Form Manager

Note: To access the Form Manager click the “Forms” menu in the navigation bar.

Create a form

Before you create your first form, please read the Form Builder documentation.

If you are on the Dashboard or in the Form Manager, follow these steps:

  1. Click “Create Form”
  2. Drag and drop all the fields that your form needs.
  3. Drag and drop one button or more, according to your needs.
  4. Click “Save Form”. A modal window will appear with 3 options:
    • Continue editing the form.
    • Go to Advanced Form Settings
    • Go to Form Manager

A1Surveys - Create a form

Note: If you close the modal window without choosing one of these three options, when you “Save” again, you create another form and not edit the already created. This option can be useful if you want to create several similar forms quickly.

View Form Record

To view the Form Record, click on the form name in the Form Manager. You can view from here its configuration and access all your options.

A1Surveys - View Form Record

Update a Form

If you have questions about updating your first form, please read the Form Builder documentation.

Updating a form can be done in two ways:

  1. From the Form Manager
    • Locate the form to update
    • Click on the “Actions” button and select “Update”
  2. From the Form Record
    • To access the Form Record click the name of the form
    • Then click the “Update” button (the pencil icon)
  3. Drag and drop one button or more, according to your needs.
  4. Click “Save Form”.

A1Surveys - Update a Form

Note: It is possible to update the form / survey even when it it live, however this will affect the integrity of your existing responses.

Save Form as Template

To save your Form as a Template, follow these steps:

  1. Go to the Form Builder
  2. Click the Up Arrow (At the right side of the “Save” button)
  3. Click “Save Form As Template
  4. Then you will be redirected to the Template Manager.

A1Surveys - Save Form as Template

Advanced Form Settings

First, navigate to the Form Manager and click on Form Settings.

  1. Click on the name of the form you want to set
  2. Click on “Settings” (the gear icon)

In Settings, you will see 4 tabs. Each of these tabs contains the setting of a form aspect:

1. Form Settings

It is the first tab of the Form Settings and is displayed by default. From here you can set up:

  • Form Name: Displayed on the application administration pages and as the title of the form public page.
  • Status: This is used to activate and deactivate the survey to respondents.
  • Language: This language will be used to display form messages. For example, validation errors.
  • Text Direction: Allows you to set the direction in which the values appear in the form. By default, the text direction is Left to Right (LTR).
  • Message: Sets the message to be displayed to the user when the form has been disabled (Off).
  • Shared With: This feature allows you to share the form/survey with other users. You have two options:
    • None: The form will only be visible by its creator.
    • Specific users: Allows you to select the users who will be able to see the form. Related permissions: Includes the word “Shared” in his name. For example, viewSharedForms, editSharedForms, deleteSharedForms.

      Important! Keep in mind that although a user can share a form with another user, this user must have the permissions to view, edit, delete, etc. required for each action. For example, if you share the form with two users with different roles: Manager and Editor. The Manager user could only have access to view the reports and statistics of shared forms, while the Editor user could only have access to the Form Builder and Form Settings of shared forms.

  • Generate Submission Number: This option allows you to set a custom sequential submission numbering for your form. The submission number will be increased by 1 always. Except, if you set a bigger number in form settings (In this case, we are going to use this number). So, only when the number is bigger than the submission number of the previous entry we are going to use it to prevent duplicates. Take into consideration that the Submission Number helps you to identify a Submission in your Form, but a Submission ID helps you to find a Submission in the entire application. Two different forms can have the same Submission Number, but never the same Submission ID.
  • Number Width: Set the minimum width of number without a prefix (zeros will be added to the left side). This will change the minimum width of the submission number for new submissions. E.g. set to 5 to have submission number displayed as 00001 instead of 1. Leave empty to disable.
  • Number Prefix: Prefix before submission number (optional). This will change the prefixes for new numbers.
  • Number Suffix: Suffix after submission number (optional). This will change the suffixes for new numbers.
  • Save DB: Indicates if form submissions must be stored in the database or not. In any case, this does not affect each emailing entry.
  • Protected Files: When this option is active, only Logged-In users with Form access can access or download the files.
  • Editable: When this option is active, form submissions can be edited by anonymous users by using the Form Widget. So, you will be able to allow your users edit form entries from your own website.
  • During: This unit of time represent the amount of time a user can edit a submission.
  • Unit of Time: It can be Hours, Days, Weeks, Months or Years. You can specify exactly the time allow.
  • If the Submission meets: Only Form Submissions that pass this condition can be edited. This allows us to enable/disable the edition depending on the value of form fields.
  • Limit total number of submission: Specify the maximum number of submissions that the form will accept in a period.
  • Total Number: Total number of submissions to be accepted.
  • Per Time Period: Period in which the number of submission will be counted.
  • Limit submissions per User: Sets the maximum number of submissions that the Form can receive from the same user in a period.
  • Limit By: There are four options: IP Address, Browser Fingerprint, IP Address or Browser Fingerprint and IP Address and Browser Fingerprint. Use Browser Fingerprint when you disable IP Tracking or when you are running A1Surveys in an intranet and want to limit the entries.
  • Max Number: Maximum number of submissions allowed.
  • Per Time Period: Period in which the number of submissions will be counted.
  • Schedule Form Activity: Set the start an end date in which the Form must be enabled (ON) Before and after it, the form will be automatically disabled.
  • Start Date: Select the date on which the form will be activated.
  • End Date: Select the date on which the form will be deactivated.
  • Use password: Enable or disable the form protection by using password. If the option has been enabled, you should fill the Password field. Otherwise, the form will not be saved and instead, a validation error will be displayed. By default, this setting is OFF.
  • Spam filter: Indicates if the form should use the honeypot technique to filter submissions made by real users from the ones made by bots (spam).
  • Authorized URLs: To prevent a third party from embedding your Form on their own website, your form can be restricted to a list of URLs that you authorize.
  • No validate: This option allows you to disable the Client-Side validation (by the browser). Take into account that the Server-Side validation won’t be disabled. It’s recommended to have this option in Off.
  • IP Tracking: When this option has been enabled, IP addresses won’t be collected by the application. You can enable the Browser Geo-location to collect the Sender information with consent.
  • Analytics: Enable/disable monitoring the form by the application. When, IP Tracking has been disabled, Form Stats will be collected with IP anonymization.
  • Autocomplete: Enables the browser’s autocomplete to forms that have been previously filled. By default, this setting is ON.
  • Save & Resume later: When this option has been enabled, the browser automatically will store the information entered by a user on each field to be resumed later, even if the user close the browser.

A1Surveys - Form Settings

2. Confirmation Settings

A1Surveys - Confirmation Settings

Here you can configure the submission confirmation:

    1. Inform immediately: Using a text message (alone or above the form) or redirect the user to another web page.
    1. Conditional Logic This feature gives you control once a user has submitted your survey/form. A common example of this would be if you wanted to provide your end users the option to download a file. In this scenario you can redirect to the file to start the download process. But, if the user don’t want to get the file, we will show the Thank You message.
    1. Send confirmation email to the user: If you select this option, each time a user submit a form will receive an email that will thank him.
  1. Double Opt-In You can enable the double opt-in feature to confirm your form submission. Then you can use the placeholder: {{optin_link}} to present the link to the Opt-In Confirmation Page. When the end-user clicks this link can be redirected to another web page or see a custom Thank You message.

A1Surveys - Confirmation Settings - Double Opt-In

3. Notification Settings

In this tab you can configure how Form Submissions / Survey Responses will be sent to your email (All data, only a link to the data or a custom message). Additionally, you can set the email subject, email addresses and more.

Four things to keep in mind:

  1. If the form has fields of “Email” type, you can select them as Send To and/or Reply To email address.
  2. If the form has fields of “File” type, you can attach uploaded files to emails.
  3. If you choose only Plain Text, a default message with all the submitted data will be sent in plain text.
  4. You can choose the event when the email notification will be sent:
    • Whe the form is submitted
    • When the email is verified by double opt-in

A1Surveys - Notification Settings

Note: You can insert placeholders into a notification emails. For more details, go to the ‘Confirmation Settings’.

4. UI Settings

UI = User Interface.

From here you can modify the form appearance: The design by using themes, and the functionality by using an external JavaScript file.

  1. Select a theme: You can select the theme that best fits your form or one you have created yourself. When you select a theme from the list, the form will be automatically displayed with the design chosen theme. You can change the themes over and over again to see differences.
  2. Load Javascript File: Enter the full URL of the JavaScript file that will be loaded with your form. By default, the jQuery library is available for you to make use of it when interacting with the form.

A1Surveys - UI Settings

Note: To save all the changes you make on any tab, click the “Save” button.

Reset Stats

You can reset the form stats from the Form Manager, by clicking the “Actions” button and “Reset Stats“. Then it will show a popup asking you to confirm your decision to delete the stats.

Delete a form

You can delete a form from the Form Manager, by clicking the “Actions” button and “Delete”. Then it will show a popup asking you to confirm your decision to delete the form.

A1Surveys - Delete a form

Important! When you delete a Survey/Form, all content related to it will be deleted too, including: Submissions, reports and graphs, statistics, configurations and more: This action cannot be undone.

Add conditional logic to your survey/form

A1Surveys features a powerful tool to add conditional logic to forms and surveys.

The rules are based on the information entered and allow you to disable/enable and show/hide fields and other elements in the DOM. In addition, you can also do math and skip pages with this powerful tool.

You can access the Rule Builder from the Form Manager:

  1. In the navigation bar, click “Forms”
  2. Click on the form name
  3. Click on the button “Conditional Rules”

A1Surveys - Add conditional logic to a form

Note: Form more information on this feature, please see Rule Builder.

Publish and Share a Form

You can access to publish and share a form using the Form Manager:

  1. In the navigation bar, click “Forms”
  2. Click on the form name you wish to share
  3. Click on the “Publish and Share” button (the green arrow icon)
  4. This allows you to get the code to be placed on the website which will display the form (inline or in a modal pop-up). You can also copy the form permanent link and share it via email or social networks. And now, with the 1.1 version you can also share links with friendly URLs to your forms, immediately!

A1Surveys - Publish and Share a Form

Pop up surveys and forms

You can place the your form/survey inside a pop up.

To use the pop up Designer, follow the next steps:

  1. In the navigation bar, click “Forms”
  2. Click on the form name you want to share
  3. Click on the “Publish and Share” button (the green arrow icon)
  4. Click on the “Embed pop up Form” menu.

In this page you can create popup’s that will get your visitors attention.

You can customize a lot of options like colors, borders, radius, backgrounds, button placements and many more.

A1Surveys - Popup Designer

To finish, click on the “Generate code” button to open a modal and copy the HTML code that you must insert in your web page.

Download QR Code

QR Codes are a great way to connect people from posters or to take part.

To download the QR code, follow the next steps:

  1. In the navigation bar, click “Forms”
  2. Click on the form name you want to share
  3. Click on the “Publish and Share” button
  4. Click on the “Download QR Code” menu.

In this page you can see the QR Code to the friendly link of your Form. Also, you can click the “Download” button to share it with your users.

Survey/Form’s Backend Endpoint / Download the HTML

A1Surveys has the ability to generate endpoints, then you can use them to make fully customizable forms.

You can download the HTML code of your Form to integrate it directly on your webpage or mobile app, and use the form’s backend endpoint to collect data.

To download the HTML code, follow the next steps:

  1. In the navigation bar, click “Forms”
  2. Click on the form name you want to share
  3. Click on the “Publish and Share” button (the green arrow icon)
  4. Click on the “Download the HTML” menu.

In this page you can see the button to download the HTML code as a zip file. Also, you can copy the Form Endpoint directly.

Note: If you want to replace the “name” attribute of each field, you need to set it as a Field Alias in the Form Builder.

A1Surveys - Download Html Code - Form Endpoint

Apply a theme to your form/survey

To apply the theme you have created to a form, go to the Form Manager. Then, perform the following steps:

  1. Click the “Actions” button of the form in which you are going to apply the theme
  2. Click “Settings”
  3. Click the “UI Settings” tab
  4. Select a theme from the menu
  5. Click “Save”

A1Surveys - Apply a theme to the form

Previous 1. What is A1Surveys?
Next 3. Form and Survey Builder
Table of Contents