Configuring A Text Field

Overview

Single Line and Multi Line field types accept all kinds of input, for example, plain text, special characters, numbers etc. The Single Line field type is most commonly used to collect data like "Name", "Product Name", "Coupon codes"  and other generic information which is usually short and one or two worded. On the other hand, Multi Line text field is used to collect relatively sizable amount of data like "Address" or "Comments". The Single Line field type and Multi Line field type can accept a maximum of 255 characters and 64 kb of data respectively.

Configuring a text field

  1. Drag and drop the Single Line or Multi Line text field to the editor area. You can also double click on the field type to add it to the Form.
  2. Enter a name for the field under field properties. The field will be labelled with the name specified by the user. The field deluge name is assigned automatically with underscores replacing the white spaces in the Field name. Users can also modify the field deluge name manually. Configure the rest of field properties as required.
  3. When the Application is accessed, the text field will be displayed in the Form to collect data.

Text Field Properties

The following properties can be customized for Single Line and Multi Line field types:

  1. Validation

    • Select the Mandatory checkbox to make it compulsory for users to enter data into the field. The Form submission will not be allowed unless the field contains data.
    • Select the No Duplicate Values checkbox to restrict duplicate entries. Which means every input into this field needs to be unique without any repetition.
    • The value specified in the Initial Value box will be pre-loaded into the Field when the Form is accessed. For example, if the field name is "Gadget type" and the "Initial Value" has been specified as "iPhone", the Form will load with "iPhone" as the default input value for "Gadget type" field. This value can be modified by the users, when they access the Form.
    • The number specified in the Max Characters box will be the maximum number of characters that the user can enter into the Field.
  2. User input for Mobile

    Select QR code or Barcode or both to allow Zoho Creator mobile app users to submit data by scanning optical codes using their phone camera. When either of them is selected, you can configure the following properties:

    • Select the Get input before the form is displayed checkbox to enable scanning of the optical code before the Form is loaded. In such a case, the camera is launched before the Form to scan the optical code. Once the scan is complete, field values are populated with data when the Form loads.
    • Select the Disable manual input checkbox to restrict the user from entering data into the fields manually.
    • Selecting the Default Camera option as "Primary" sets the rear camera of the mobile as the default scanner. The option "Secondary" sets the front camera of the mobile as the default scanner.
    • Select the Allow to Switch Camera checkbox to give the user the choice of selecting either the front or the rear camera to scan the optical code.
    • Select the Enable Photo Gallery checkbox to scan images of optical codes stored in your phone's photo gallery.
    • Select the Set Preview Duration checkbox to display a preview of the scanned code value. The preview can be configured to display for 3, 5, 10, 15 or 20 seconds, post which the Form loads with the field value.
    • Select Submit Form after capturing checkbox to automatically submit the Form with data after the scan is complete.
  3. Permission

    This section contains a property called Show field to with "Everyone" and "Admin Only" as the choices. Selecting "Everyone" will make the field visible to all the users. Selecting "Admin Only" will restrict the field visibilty to the Admin or the owner of the Application only.

  4. Rules

    A Rule defines the tasks to be triggered at the specified Form event(while adding a record, updating a record, or both) when the optional criteria is met. The tasks can be Field tasks, Form tasks or Subform tasks. Learn more about configuring rules and tasks.

  5. Appearance

    This section allows app owners to convert the field type, customize the field size, and write tool tip messages which will be displayed when the cursor is placed on the Field.

    • Field Type - A Single Line field type can be converted into Multi Line or Rich Text field types. A Multi Line field type can be converted into a Rich Text field type. 
    • Field Size - The field size can be set to small, medium, large or a custom size which can be customized. Multi Line field type has an additional setting to customize the field height.
    • Tooltip Message - This option can be used to write text, which would be displayed when Application users place the cursor on the field.

Note:

  • The String datatype is used in scripting for both Single Line and Multi Line field types.

Related Links

Phone Number Validation Example