Feedback Print

Rating

General Settings

This field allows the developer to create a field for rating using stars (or any other image), where the final user will be able to select a rate option according to the configuration made by the developer.

Interface de configuração do campo rating.

Description of the attributes available for configuration.

Data type

Define the type of the field in the application. In this case we must select the type Rating.

Label

Define the application title that will be showed when the application is executed. The terminology used in the interface of your application is very important for the usability, and we need to use familiar terms for the final user, instead of use terms from the system.

Example, this field “rating” that is named cmp_rating however, the customer would have a better understanding if the label uses Product Rating.

Besides use a fixed text, the Label attribute allows the use of Langs to define the field title, allowing the internationalization of your application.

Subtitle

Define the subtitle that will be shown in the field below the ratings. Example: “Thank you for your feedback!”.

As in the Label, the subtitle attribute also allows the use of Langs for internationalization of your application.

Amount of icons

Define the number of icons that will be displayed in the field. The value set in this attribute must be according to the way the evaluation will be realized.

To evaluate using Stars normally it is used five stars, so , we must to inform 5 in this attribute. After we set the images that will be displayed in the attributes Enabled icon and Disabled icon the result will be the same as in the example:

Campo rating com estrelas

To use Like/Dislike for example we must inform 1 in the amount of icons, so only one image will be displayed and will change according to the click. In this case, the storage in the database will be 1 for like (enabled icon) and 0 for dislike (disabled icon). You can see the field configured below as like/dislike:

Example with Like/Dislike

Enabled icon

Define the icon that will be shown for the amount selected. Following the like/dislike example, in this option, we must insert the Like imageLike. We must do the same for a star evaluation, where for default we must insert the stars filled Estrela preenchida.

Disabled icon

Define the icon that will be shown for the not selected icons. In this attribute, we set an image to represent the opposite of the previous images set in the Enabled icon.

Still referring the example of the Like/Dislike, in this attribute we must set the Dislike Dislike.

As in the stars example, we must insert the image with the empty stars Unfilled star.

Initial Value (type)

Allow the definition of an initial value for the field when the form application is in insert mode. The only option available in this field is Defined. Selecting this option the attribute Initial Value will be showed for set the value.

Example: The initial value is 3 when inserting a new record, the rate field will initiate with 3 stars already selected.

The value defined in this attribute will overlap any value defined previously.

Save variable

Allow saving a session variable(Global variable) with the field value for being used in other applications.

Example: In the login form, the user name can be saved in the session and used to be displayed in the header of other applications.

Variable Name

In this attribute, we must define a name for the session variable that was enabled previously to receive the field value.

We must inform only the variable name, - var_rating. Set variable name

We can recover the value as a global variable.

HTML Type

HTML object used to show the form field.

SQL Type

Inform the type of the field in the database.

Display Settings

The Display Settings allows to define the CSS values individually for each field. For each Display schema of ScriptCase, there are the same attributes available in Interface.

Display Settings configuration Interface.

Display Settings configuration Interface.

  • CSS of the Title
    • Font : Select the font type, that will be applied to the application field title.
    • Font Size : Defines the font size, that will be applied to the application field title.
    • Font Color : Choose a color to the font by using a valid hexadecimal color value or from the color picker.
    • Background Color : You can define the color for the field by using a valid hexadecimal color value or from the color picker.
    • Bold : Applies the bold style to the font.
    • Underline : Set the underline style to the font.
    • Border style : Choose a style for the border.
    • Collapse : Defines the collapse for the border.
    • Border Size : Applies the border size to the title of the field.
    • Border Color : Choose a color for the border, using a color palette to apply to the title.
    • Horizontal Alignment : Position the label of the field in the wanted position (left,right,center and justify).
    • Vertical Alignment : Position the label of the field in the wanted position (baseline, sub, super, top, text-top, middle, bottom, text-bottom).
    • Width : Defines a width for the title of the field.
    • Height : Set a height for the title of the field.

Help Settings

Allow the developer to set up instructions and hints about the field’s use, allowing the developer to help the users about the system usage.

Help Configuration Interface.

Description of the settings attributes.

Help Description

In this area, you can set up a text that will be shown in the application according to the type of help selected below.

Help Type


Pop-up - Display a default icon ! beside the field. To display the message just click in the icon that a Pop-up will be displayed with the help text.

Help Display Type Configuration Interface.


Hint - Display a default icon ! beside the field. When the mouse is above the icon a help text will be displayed.

Help Display Type Configuration Interface.

The icon displayed when selecting the types Hint or Pop-up vary according to the theme that is being used in the application. This icon can be modified in the CSS Buttons.


Text - Display a text inside of a <span></span> beside the field.

Help Display Type Configuration Interface.

Help button position

Allow to set up where the help button will be displayed in the field, there are two options:

Beside: The help icon will be displayed beside the field.
Column: The help icon will be displayed beside the label of the field.