Overview
Version
Report Server Version | App Version | Functional Change |
11.0 | / | / |
11.0.21 | 11.0.85 | Added the Allow One-Click Clearance and Show Word Count functions on the Mobile Terminal tab page. |
Application Scenario
Data Entry Widget
You can enter multiple lines of text information and fill in data through the Text Area Widget in data entry reports.
Parameter Widget
You can enter multiple lines of text information and query parameters through the Text Area Widget on the parameter panel.
Notes
1. Text Area Widget supports wrapping. You can wrap by pressing Ctrl + Enter on the data entry preview page, or by pressing the Enter key on the parameter panel and in dashboards.
2. The line break in the Text Area Widget can be submitted for storage. But the wrapping effect can be viewed only in template previews, rather than in databases and template datasets.
3. You cannot undo an action by pressing Ctrl + Z in the Text Area Widget.
Adding Methods
Data Entry Widget
Select a cell, click Widget Setting on the right attribute panel, and choose Text Area Widget from the drop-down menu of Select Widget.
Parameter Widget
Drag the Text Area Widget from the widget toolbar into the parameter panel.
Widget Introduction
Attribute
Data Entry Widget
The following figure shows the attribute setting page of the Text Area Widget.
The following table introduces the settings of each attribute in detail.
Note:Classification | Settings | Introduction |
Basic | Widget Name | Name (empty by default) of the widget. It is manually entered and usually used in conjunction with parameters. For example, you can pass the widget value to the corresponding parameter after the widget is obtained through the widget name. |
Available | Determines whether the widget is available. Checked (default setting): The widget is editable in the data entry. Unchecked: The widget is grayed out and not editable. | |
Visible | Determines whether the widget is visible. Checked (default setting): The widget is displayed on the data entry page. Unchecked: The widget is not displayed on the data entry page. | |
Advanced | Watermark | Displays light gray watermark texts in the widget during the data entry. You can manually enter the needed prompt information in Watermark (empty by default). The watermark disappears after you click the widget editing area. |
Validation | Allow Null | Determines whether the widget can be empty. Checked (default setting): The widget can be empty. Unchecked: A prompt appears in the data entry validation and submission. |
Error Tip | Appears when Allow Null is unchecked, allowing you to customize the prompt message. The default message is: "Can not be null." | |
Filling Rule | Includes rules that need to be met when you enter values in a widget. An error message pops up if the rules are not met. The following shows three supported validation rules: 1. None (default): No validation rules 2. Length: allows you to customize the length range of the text area and validate the multiple-line text length. 3. Custom: allows you to customize validation rules through regular expressions. For details, see Regular Expression. |
Parameter Widget
The following figure shows the attribute setting page of the Text Area Widget.
The following table introduces the settings of each attribute in detail.
Classification | Settings | Introduction |
Basic | Widget Name | Displays the name (default value as textArea#) of the widget. It is manually entered and usually used in conjunction with parameters. For example, you can pass the widget value to the corresponding parameter after the widget is obtained through the widget name. |
Available | Determines whether the widget is available. Checked (default setting): The widget is editable in the data entry. Unchecked: The widget is grayed out and not editable. | |
Visible | Determines whether the widget is visible. Checked (default setting): The widget is displayed on the data entry page. Unchecked: The widget is not displayed on the data entry page. | |
Advanced | Label Name | You can use the label name to achieve the label function on mobile terminals, because the widget label attribute is supported and the Label Name attribute of general widgets can be recognized on mobile terminals. The Label Widget on the parameter panel is not supported on mobile terminals. |
Widget Value | Displays the default value (empty by default) during the widget initialization. String, Field, and Formula are supported. String: includes characters and texts. Strings containing multiple whitespace characters (such as "New York California") wrap around in the Text Area Widget. Field: includes dataset fields, such as the Region field of the dataset ds1. Datasets include template datasets and server datasets. Formula: includes formulas supported by the designer, such as the following formula through which the value of the cell A1 can be obtained. | |
Watermark | Displays light gray watermark texts in the widget during the data entry. You can manually enter the needed prompt information in Watermark (empty by default). The watermark disappears after you click the widget editing area. | |
Font Size | Includes the size of the font (default value as 12) entered in the text box. Note: | |
Validation | Allow Null | Determines whether the widget can be empty. Checked (default setting): The widget can be empty. Unchecked: A prompt appears in the data entry validation and submission. |
Error Tip | This setting item appears when Allow Null is unchecked, allowing you to customize the prompt message. The default message is: "Can not be null." | |
Filling Rule | Includes rules that need to be met when you enter values in a widget. An error message pops up if the rules are not met. The following shows three supported validation rules: 1. None (default): No validation rules 2. Length: allows you to customize the length range of the text area and validate the multiple-line text length. 3. Custom: allows you to customize validation rules through regular expressions. For details, see Regular Expression. | |
Coords & Size | Widget Location | Includes the widget location (changed based on the horizontal and vertical coordinates) on the parameter panel. The coordinate is automatically displayed based on the widget location. |
Widget Size | Includes the widget size. You can resize the widget by changing the Width and Height values. You can also hover your cursor to the widget boundary and drag the boundary until the widget reaches the desired width and height. |
Event
You can add events for the widget on the Event tab page to achieve certain effects. The Text Area Widget supports four events — After Initialization, Before Editing, After Editing, and After Exiting Edit.
Select an event and add the event content. The event response methods supported by the text area widget include JavaScript, Summit to Database, Send Email, Export Event, and Mobile Pop-up.
Select a corresponding event response method.
Mobile Terminal
The Allow One-Click Clearance and Show Word Count functions are supported on the Mobile Terminal tab page.
Advanced:
Allow One-Click Clearance: allows you to delete the entered content with one click.
Show Word Count: counts the word number in the widget and displays the result in the bottom right corner.
Application Example
The following table introduces how to apply the Text Area Widget.
Application Scenario | Actual Effect |
Scenario: Perform multiple value queries on the same field in a table. | |
Scenario: Remind reporters if the content they entered in the Text Area Widget does not meet the filling rules. | |
Previous：Text Widget
