Single Line Fields

Single line fields are the least specialized of all the field types. They accept numbers and characters, making them well-suited for accepting names, numbers, and many other values. If there is a chance that the user filling in this field will enter a combination of characters and numbers, you should use a single line field rather than a more specialized one.

Single line fields are also incredibly useful because you can use either regular expressions or simplified field masks (in the form designer) to restrict what the fields accept.

Example: You can use regular expressions with single line fields to ensure that phone numbers or Social Security numbers are entered with the proper formatting. Learn more

Note: The characters "&", "#", or "<" cannot be entered in a field if they are also followed by another character. However, you can enter one of those characters if it is followed by a space.

Field settings

To edit a single line field

  1. Select the field on the canvas, and the options will appear in the right pane.
  2. Under Field Label, enter the field label that will appear next to the field on the form. Click the Insert Variables button to include a variable in the label.
  3. Under Variable, specify a name for the field variable associated with this field. If you do not specify a variable name, Laserfiche will automatically assign the field one based on its label.
  4. Under Text Above Field and Text Below Field, you can enter any additional text that should appear with the field. Click the Insert Variables button to include a variable with this text.
  5. Under Display Options, select Required if users must fill in this field before submitting the form. Select Read-only if users should not be allowed to modify this field. Select Accept barcode scan if you want to allow Laserfiche app users to fill the field by scanning a barcode.
  6. Example: Sue has a "Case ID" field that is auto-populated from the company database using a lookup rule. To ensure nobody can change the case ID on the form, Sue makes this field read-only.

    Note: If a required field is hidden with a field rule, it is no longer required. A required field is only required when it appears on the form.

  7. Under Placeholder Text, enter the value that will appear in the field by default. This text will not be saved in a submission and is for disply-only to assist the user. Click the Insert Variables button to use a variable as part of the placeholder text.
  8. Under Default value, enter the value that will appear in the field by default. If this option is blank, the field will appear empty by default. Click the Insert Variables button to use a variable as a default value.
  9. To configure advanced options, click the Advanced tab.
    • Under Calculation, specify a formula that will populate the contents of this field. Learn more.
    • Under Character limit, enter the maximum number of characters the field will accept. By default, this number is 20,000.
    • Under Auto suggestions, enter any suggestions that should appear as users fill in this field.
    • Under Tooltip, specify the help text that will appear when users hover over the field. Click the Insert Variables button to include a variable with this text.
    • Under CSS classes, specify one or more CSS classes to assign to this field.
    • Under Perform Custom Input Validation, select either to Use a regular expression or Use an input mask to limit the values that this field will accept. Learn more about regular expressions.
    •  If enabled for your account, click the question mark icon to access the Regular Expression Builder.
      • Select Write a regular expression that validates and describe what you want to validate in the field. For example, "a telephone number" or "a phrase in title case." The definition can be as specific as necessary. Click Write Expression to generate an expression and full description of how it works. Click Use Expression to close the dialog and save the expression for field.
      • Select Troubleshoot regular expression to test or learn more about how the expression is evaluating an input.

        Note: The Regular Expression Builder is subject to service limits and may be disabled by account administrators.

    • If using an input mask, create the mask using the characters defined on the Field Masks page.
  10. Your changes will be applied automatically.

Note: The labels, tooltip, text above, and text below settings support the use of simple HTML markup for formatting purposes.

  1. Select the field on the canvas and click Edit.
  2. Under Field label, enter the field label that will appear next to the field on the form. Click the Insert Variables button to include a variable in the label.
  3. Under Variable, specify a name for the field variable associated with this field. If you do not specify a variable name, Laserfiche will automatically assign the field one based on its label.
  4. Under Field options, select Required if users must fill in this field before submitting the form. Select Read-only if users should not be allowed to modify this field. Select Accept barcode scan if you want to allow Laserfiche app users to fill the field by scanning a barcode.
  5. Example: Sue has a "Case ID" field that is auto-populated from the company database using a lookup rule. To ensure nobody can change the case ID on the form, Sue makes this field read-only.

    Note: If a required field is hidden with a field rule, it is no longer required. A required field is only required when it appears on the form.

  6. Under Text above field and Text below field, you can enter any additional text that should appear with the field. Click the Insert Variables button to include a variable with this text.
  7. Under Field width, select whether the field should be Small, Medium, Large, or X-Large in width.
  8. Under Character limit, enter the maximum number of characters the field will accept. By default, this number is 20,000.
  9. Under Default value, enter the value that will appear in the field by default. If this option is blank, the field will appear empty by default. Click the Insert Variables button to use a variable as a default value.
  10. To configure advanced options, click the Advanced tab.
    • Under Calculation, specify a formula that will populate the contents of this field. Learn more.
    • Under Tooltip, specify the help text that will appear when users hover over the field. Click the Insert Variables button to include a variable with this text.
    • Under Auto suggestions, enter any suggestions that should appear as users fill in this field.
    • Under Regular expression for validation, specify a regular expression to limit the values that this field will accept. Learn more about regular expressions.
    • Under CSS class, specify a CSS class to assign this field.
  11. When you have finished editing the field settings, click Done. Your changes will be saved automatically.

Simplified input mask information

Mask character Character description
0 Any single digit, required. This element will accept any single digit between 0 and 9.
9 Any single digit or space, optional.
# Any single digit, space, plus (+) or minus (-) sign, optional.
L Any single letter, required. This mask element is equivalent to [a-zA-Z] in regular expressions.
? Any single letter, optional. This mask element is equivalent to [a-zA-Z]? in regular expressions.
A Any single alphanumeric character, required. This mask element behaves similar to the "a" element.
a Any single alphanumeric character, optional. This mask element behaves similar to the "A" element.
\ Escape. Escapes a mask character, turning it into a literal. "\\" is the escape sequence for a backslash. "\A" results in a literal "A"

Examples:

Use case Masking syntax
US format phone number (000) 000-0000
Social Security Number 000-00-0000
Canadian Postal Code L0L 0L0