Skip to main content

Custom Field Type: Text Box - Text Multiple Lines

Anthony Eidt
Updated

General Description

This component is a text box that can accommodate one or more lines of text.

Note: The field can support a maximum length of 16,777,215 (2^24 - 1) characters.

 

Field Illustrated

Cf tbml ex1.png
Text - Multiple Lines custom field, displayed in View Mode (above)

 

Field Options

  • Default Text: The initial text that will appear in the text box.
  • ReadOnly: The contents of the field can be viewed but not altered.
  • Enable Hashtags: When activated, this feature allows users to input hashtags in this field. Hashtags can facilitate the searching and categorization of records within the system.
  • Enable Note Entry Mode: When activated, this option will display the history of previous values saved in the multi-line text field in a table below the field. It will indicate the name of the user who entered each value along with a timestamp of when the value was recorded. When this option is enabled, any value saved in the field will be removed from the input text area.
  • History date format: This option allows for the customization of the date format in the history section. It is only visible when Enable Note Entry Mode is activated.
  • History time format: This option allows for the customization of the time format in the history section. It is only visible when Enable Note Entry Mode is activated.
  • Maximum Length: Defines the maximum allowable length of text input.
    • Show Counter determines whether a character counter will be visible to the user.
    • Count Words configures the counter to tally words instead of characters, which is the default setting.
  • Exceeded Maximum Message: The message displayed to the user upon reaching the maximum length limit.

Note Entry Mode

When the Enable Note Entry Mode option* is activated for the field, any value entered will be cleared from the input text area upon saving the page and will be recorded in the history section below.

The history section will display the name of the user who entered the value along with a timestamp indicating when the value was recorded.

EnableNoteEntry1.png

*NOTE: This option is not available when track changes is enabled.

 

Exporting Multiple Lines Text Fields to HTML

If you intend to include a Multiple Lines Text field in a report that will be displayed or exported to HTML, please note that line breaks will not be visible.

The line breaks stored in the Multiple Lines Text field can be converted to HTML line breaks (<br />) by incorporating the following into the Calculated Value of the field:

REPLACE([this],CHAR(13,10),"<br />")

Helpful Links