eForms - Custom Form Layout

Introduction

• Upload your pre-designed forms and use them with the eForm module.
  
  

• Using this path-breaking Custom Form Layout module, users can associate existing eForm fields with fields on custom designed PDF or HTML forms so that when data is submitted to the eForm, it is accepted into the custom designed form instead of the standard eForm. Submitted data can also be exported out into these custom designed forms.

• Custom form layout module facilitates the user to perform the following:

  • Upload custom form layout in the form of PDF(s) or HTML templates, to the user's account for submitting and exporting data.

  • Provide one-to-one mapping between eForm and the uploaded custom form layout fields. In addition, the user can also map eForm fields with multiple custom form layouts.

  • Extract data into single or multiple custom form layouts and download the resulting PDF. If data is exported to multiple PDFs then all resulted PDFs are zipped and zip file is available for the download.

  • Configure automatic email sending functionality along with the custom form layout file(s) using Include PDF attachment with notification email whenever the eForm is submitted.

 

To start with the custom form layout module, create a new eForm or edit an existing one and go to Step 4 of 5 for Custom Form Layout & Export Configuration.

It has 3 tabs to configure the custom form layout settings:

• Custom Form Layout – to add/edit/remove custom form layout files.

• Field Mappings – to provide mapping between custom form layout fields and the eForm fields so that they can be used to collect and export the data.

• Advanced Settings – to do the advanced settings like Action Form Mappings, to configure which custom form layout will be used while creating & updating eForm data and configure the folder path where generated custom form layout files can be stored for future reference.

 

 

Custom Form Layout Tab

On this tab, you can add/edit/remove custom form layouts.

 

Add Custom Form Layout:

Click on the Add Custom Form Layout button to upload a new PDF/HTML custom form layout file. Click on the Upload button to select and upload the custom form layout. Once the form is uploaded click the Save button to complete the add process.

 

  

A valid custom form layout must satisfy the following rules:

1. The custom form layout being uploaded must have .PDF or .html or .htm or .zip extension.

2. The uploaded custom form layout must have one or more input fields.

3. Only those PDFs which can be handled by an integrated third party PDF library are allowed to be used as custom form layout for data export.

4. In case of a password protected PDF, the password must be entered into the Form Password text-box to enable the system to work with such a PDF.

5. The uploaded .zip file (compressed html file along with its resources) should contain at least one valid html file with .html or .htm extension. 

 

Note: Refer this support article for more information on how to create a valid custom form layout.

 

Edit Custom Form Layout:

You can edit custom form layout details by clicking the pencil icon within the custom form layout grid. Clicking the edit icon opens the following window from where you can re-upload the custom form layout file. 

 

Custom Form Layout Status:

Until it is approved, a custom form layout goes through the following statuses after it is uploaded (each status is indicated in the grid with unique color legend):

1. Pending Conversion - The custom form layout has been uploaded and file conversion process is in progress.
2. Pending Configuration - The custom form layout conversion has been completed and it is now ready for providing field mappings.
3. Pending Approval - The custom form layout has been sent for approval.
4. Approved - The custom form layout has been approved and it can now be used for data capture and export.
5. Rejected - The uploaded custom form layout has been rejected. The reason for rejection can be found in the Comments column.

 

Preview Custom Form Layout:

When an uploaded custom form layout has been Approved, you will get the option to preview the form and confirm its look and feel. Click on the preview icon to preview the form.

Delete Custom Form Layout:

You can delete one or more custom form layouts by checking the checkbox against the forms to be deleted and clicking the Remove Selected Form(s) button.

 

Note: When a custom form layout is deleted, its field mappings provided in Field Mappings Tab and the settings within the Advanced Settings Tab also get deleted.

 

Field Mappings Tab

On this tab, you can provide one-to-one mapping between the uploaded custom form layout fields and the eForm fields. 

 

This grid has two main sections: Custom Form Layout Details & eForm Details.

Custom Form Layout Details

• Custom Form Layout Field – Field name present in the custom form layout

• Field Type – Type of the custom form layout field

• Values – If field type is checkbox, radio button, combo box or list box then this column will show expected possible values for such fields

• Field details – Additional info for the field. It also displays other information like max length, whether the field is multiline, multi select or password etc.

eForm Details

• Form Field – Field name present in the eForm

• Field Type – Type of the field in the eForm

 

Manage mapping suggestions

Use this intelligent feature to auto-map custom form layout fields with the eForm fields. The background of the field turns green for those fields for which mapping suggestions have been provided by the system. You have the option to accept the suggested field mapping or change it as per your requirement.

You can uncheck this checkbox if you don't want the system to suggest field mappings.

 

Mapping the fields

The grid has inline editing capability, click anywhere on a grid row to make it editable. You can provide a new mapping or edit the existing mapping by selecting the appropriate form field from the dropdown.

 

• Changes are tracked and retained even if you sort or change the page.

• You can click the Save Mappings button to save the changed/newly added mappings.

• You can discard the changes by clicking the Reset button.

• You can remove the field mapping by selecting the first item from the dropdown.

Field Mapping Rules

• There must be one-to-one mapping between eForm and the custom form layout fields.

• eForm fields Address, Full Name and Phone are special composite fields that have specific parts such as Full Name has First Name and Last Name, Address has Street Address, City, Country, etc. Such eForm fields can either be mapped as a whole to the custom form layout field or its specific parts to the custom form layout fields.

• eForm field File Upload can only be mapped with custom form layout field type 'FileInput'.

• eForm field Signature can only be mapped with custom form layout field type 'Signature'.

• eForm field Password can only be mapped with custom form layout field type 'Password'.

• eForm field Table can only be mapped with custom form layout field type 'Table'.

• eForm field File Download can only be mapped with custom form layout field type 'FileDownload'.

• eForm field Create Folder can only be mapped with custom form layout field type 'CreateFolder'.

• Mapping an eForm calculated field to the custom form layout field, all the eForm fields included in the formula expression should also be mapped to the custom form layout field.

 

Mapping of table type field on eForm with html type custom form layout can be configured like below:

 

Mapping of table columns on eForm with PDF type custom form layout can be configured like below:

 

To auto populate the assignment details of eForm into the custom form layout. You can map the following placeholders with custom form layout field:

Place Holder	Description
[Requester - Username]	Username of the requester
[Requester - Full Name]	Display name of the requester
[Requester - First Name]	First name of the requester
[Requester - Last Name]	Last name of the requester
[Requester - Email]	Email address of the requester
[Requester - Phone]	Phone number of the requester
[Requested On]	Date and time when the data is submitted

Placeholder Mapping Rules

• [Requester - Username], [Requester - Full Name], [Requester - First Name] and [Requester - Last Name] placeholders can only be mapped with custom form layout field types TextBox or TextArea.

• [Requester - Email] placeholder can only be mapped with custom form layout field types TextBox, TextArea or EmailAddress.

• [Requester - Phone] placeholder can only be mapped with custom form layout field types TextBox, TextArea or PhoneNumber.

• [Requested On] placeholder can only be mapped with custom form layout field types TextBox, TextArea, DateInput, DateInputMonth, DateInputWeek, DateTimeInput, DateTimeLocalInput or TimeInput.

• Usage: Unlike other form fields; you may use above placeholders to map with multiple custom form layout fields.

Send the Custom Form Layout for Approval

All the newly uploaded custom form layouts are displayed with a suffix (U) in the custom form layout dropdown. For all such forms you will get a button labelled Send For Approval. When you are done with all the field mappings you may click this button and it will send the form to our QA team for review and approval.

 

Advanced Settings Tab

On this tab you will find two sections Action Form Settings and Destination folder for exported forms.

Action Form Settings

Here you can configure custom form layouts to be used for creating or submitting eForm data. The selected Action Form will be displayed to the end users for data submission.

Forms to be sent

Select which custom form layout file will be sent along with automated email notifications to the configured recipients on eForm submit.

 

Destination folder for exported forms

Here you can configure the folder path where the generated custom form layout files will be stored for future reference.

Whenever the custom form layout file is sent along with automated email notifications to the recipients, the system will store such files in the specified path.

  

Still Have Questions?

If you have further questions, please feel free to contact us and we will be happy to assist you.