Overview
Version
Report Server Version | App Version | Functional Change |
11.0 | / | / |
11.0.2 | 11.0.54 | Added the NFC Input function on mobile terminals. |
11.0.21 | 11.0.85 | Added the Allow One-Click Clearance function for the text widget on mobile terminals. |
Application Scenario
Data Entry Widget
You can enter text information and fill in data through the text widget in data entry reports.
Parameter Widget
You can enter text information and query parameters through the text widget on the parameter panel.
Adding Methods
Data Entry Widget
Select a cell, click Widget Setting on the right attribute panel, and select Text Widget from the drop-down menu of Select Widget.
Parameter Widget
Drag the Text Widget from the widget toolbar into the parameter panel.
Widget Introduction
There are three setting pages for the text widget — Attribute, Event, and Mobile Terminal. These pages include general settings.
Attribute
The Attribute page includes all basic widget attributes that you can configure or modify by checking, entering, and selecting.
Data Entry Widget
The following figure shows the Attribute setting page of the text 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 | 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 eight supported validation rules: 1. None: No rules are validated. 2. Length: validates the text length. You can customize the error prompt. 3. Email: validates the email address format. You can customize the error prompt. 4. ID Number: validates whether the ID number format is standard. You can customize the error prompt. 5. Post Code: validates the post code length. You can customize the error prompt. 6. Telephone Number: validates the fixed telephone number format. You can select preset formats and customize the error prompt. 7. Mobile Number: validates the mobile number length. You can customize the error prompt. 8. Custom (empty by default): You can customize validation rules through regular expressions. For details, see Regular Expression. |
Parameter Widget
The following figure shows the Attribute setting page of the text widget.
The following table introduces the settings of each attribute in detail.
Classification | Settings | Introduction |
Basic | Widget Name | Displays the name (default value as textEditor#) 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 like "North China". 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 eight supported validation rules: 1. None: No rules are validated. 2. Length: validates the text length. You can customize the error prompt. 3. Email: validates the email address format. You can customize the error prompt. 4. ID Number: validates whether the ID number format is standard. You can customize the error prompt. 5. Post Code: validates the post code length. You can customize the error prompt. 6. Telephone Number: validates the fixed telephone number format. You can select preset formats and customize the error prompt. 7. Mobile Number: validates the mobile number length. You can customize the error prompt. 8. Custom (empty by default): You can 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 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 widget include JavaScript, Summit to Database, Send Email, Export Event, and Mobile Pop-up.
Select a corresponding event response method.
Mobile Terminal
Text widget on mobile terminals support four input methods — Manual Input, Code Scan, NFC Input, and Allow One-Click Clearance.
Advanced:
Manual Input: allows you to manually enter content.
Code Scan: allows you to enter content by scanning QR codes.
NFC Input: includes Card content and UID, allowing you to enter content through the NFC function.
Allow One-Click Clearance: allows you to delete the entered content with one click.
The following figure shows the effect of Code Scan.
Note:If you select Code Scan, note the following aspects:
1. Code scanning is not supported in browsers. If you scan codes through browsers, a prompt pops up, indicating that the current browser does not support code scanning.
2. If you preview data by scanning codes through the DataAnalyst app, the preview effect displays only when the PC terminal that generates the code and the mobile terminal share the same server. Otherwise, the HTML5 terminal effect is displayed and the code scanning fails.
3. Before the scanning, ensure that the camera is assigned with permissions. Otherwise, the code scanning fails.
Application Example
The following table introduces how to apply the text widget.
Previous：Widget Introduction
