Web Forms

Web Forms

Stakeholders who are not part of your organization may need to interact with your OneHash instance. You can authorize customers, suppliers, job applicants, students, and guardians to access certain information or even create certain transactions. For example, you can let anyone create an account on your website (created with OneHash) and apply for a job. You can let your customers see the details of the complaints they have registered. These can be done using Web Forms.

There are two types of in-built interfaces available in OneHash . The Desk View and the Web View. Desk is for users who regularly interact with OneHash instance, like employees of your organization.

Web View is for users who need to interact with an OneHash instance occasionally. Web forms are similar to the forms you generally fill in various websites on the internet. Webforms are part of the Web View interface in OneHash .

To create a new Web Form go to:

Home > Website > Web Site > Web Form




Select the DocType based on which you want to build your Web Form. The Route will be set based on the Title of your Web Form. You can also add an Introduction text to show a friendly message above your form.

Add fields to your Web Form. These are the fields from the DocType you have selected. You can change the Label for these fields. Try to keep number of fields to be minimum as long forms are cumbersome to fill.




Click on See on Website in the sidebar to view your Web form.



Here is an explanation of each of the checkboxes on the right.

1. Published: Web Form will be accessible only if this is enabled.
2. Login Required: User can fill the Web Form only if they are logged in. When Login Required is checked,
3. Route to Success Link: Go to Success Link after the form is submitted.
4. Allow Edit: If this is unchecked the form becomes read-only once it is saved.
5. Allow Multiple: Allow user to create more than one record.
6. Show as Grid: Show records in a table format.
7. Allow Delete: Allow user to delete the records that he/she has created.
8. Allow Comments: Allow user to add comments on the created form.
9. Allow Print: Allow user to print the document in the selected Print Format.
10. Allow Incomplete Forms: Allow user to submit form with partial data.

2. Features

2.1 Sidebar

You can also show contextual links in a sidebar on your Web Form. Set it up in Sidebar Settings.

2.2 Creating Web Forms with Child Table

You can add child tables to your web forms, just like regular forms.

2.3 Payment Gateway Integration

You can now add a Payment Gateway to the web form, so that you can ask users to pay against a web form. A good example for this is a conference ticket.

2.4 Portal User

We have also introduced roles for Website users. Before version 11, if you assigned any 'Role' to a user he would get access to 'Desk View'. From version 11 you can assign a 'Role' but still disallow access to 'Desk View' by unchecking 'Desk Access' in Role.




In Portal Settings, you can set a role against each menu item so that only users with that role will be allowed to see that item.

2.5 Custom Script

You can write custom scripts for your Web Form for things like validating your inputs, auto-filling values, showing a success message, or any arbitrary action.

Learn how to write custom scripts for your Web Forms here.

2.6 Custom CSS

You can customize the look and feel of your Web Form by writing your own Custom CSS. Inspect the elements on the page to see what classes are available for styling. Learn more about CSS here.

2.7 Actions

You can add the text in 'Success Message' field and this text will be shown to user once he successfully submits the web form . And the user is redirected to the URL given at 'Success URL' when clicked on 'Continue' button. This is only applicable to webforms accessible without the user login(webforms with 'Login Required' checkbox unchecked).

2.8 Result

When a website user submits the form, the data will be stored in the document/doctype for which web form is created.

Embeddable Forms

For embedding a web form in your website, first go to “Web Form” list and select one of previously created Web Form or create a new one.





Now in the Embeddable Section of Web Form, tick the “Is Embeddable” checkbox to enable embedding of the Web Form. Now you just have to copy the “Embed Url” code and paste it into your website to access the Embeddable Web Form.



Note: “Login Required” and “Is Embeddable” do not work together.




For every successful submission of Web Form, a record gets created in “Web Form Log”.

In Embeddable Section you also get following features, which you can enable as shown in above image…

Collect Geo Location : This enables the embeddable form to capture the geo location of the user submitting the form.

Collect IP Address : This enables the embeddable form to capture the ip address of the user submitting the form.

Captcha : This enables the embeddable form to ensure the user is a human using Google reCaptcha

Site Key : If the captcha is enabled, you have to put the site key of Google reCaptcha verified for your OneHash site url.

Restrict Number of Submission : This number indicates the maximum number of submission allowed for an embeddable web form.

Restrict Submission per IP : This number indicates the maximum number of submission allowed for an embeddable web form per IP Address.

Time Limit : This enables the form to be submittable within a defined set of datetime. Please ensure to check time as well.

From Date : This marks the datetime starting which the embeddable forms is submittable.

To Date : This marks the datetime after which the embeddable forms is not submittable.

Updated on: 22/03/2023