Number Properties

Number fields store numerical values. Both decimal and whole numbers are supported. Which numerical format is accepted is determined by the Number Properties selected for the Number field.  Non-numerical values are not accepted in number fields.

When a Number form field is dragged and dropped onto the Form Builder body/grid, the Number Properties appear in the Toolbox as shown in the figure below.

 


Data Section


The Field Name and Reporting Label properties available in the Data section for a Number field are the same as those for a text field. For more complete information about assigning a Field Name and Reporting Label, please see the Text Properties section above.

Field Name – The Field Name Property allows the Form Designer to define the Field Name stored in the database. All Field Names are capitalized by default. If a Field Name is typed in lower case, after the cursor is moved from the field, the text will automatically convert to upper case.

To define a Field Name, click in the text box next to Field Name, type in the desired name for the field and press the Tab or Enter key.

Reporting Label – The Reporting Label Property allows the Form Designer to designate an abbreviated name to be used for reporting and exporting of data.


General Section


Maximum Length - The Maximum Length field allows the Form Designer to set the maximum number of numbers allowed in the field. If the Maximum length property is not defined, the default length is 6 numbers. To designate a Maximum Length for the field, simply enter a value in the maximum length property.

 

Decimal Places – The Decimal places field allows the Form Designer to define the number of places accepted after a decimal. For example: To set the number field to display 23.46, the Maximum length should be 5 and the Decimal places would be 2. If the Decimal Place property is not defined the field defaults to zero.

 

ToolTip – The ToolTip field is an optional property that can be used at the field level to provide a “Tip” or “Help Message” explaining how to complete the field or provide a reason or explanation for the field. Clicking on the View/Edit link will display the Tooltip window. Using the Tooltip window, the Form Designer can type in the desired message which will be presented to the user completing form when hovering over the field.

 

Show in Log – The Show in Log checkbox should be selected if the form being created is part of a Log Form. Selecting this property for a Subject type form will show this particular field in the Log forms section displayed on the Subject Visits and Events Manager page accessed by selecting a Subject ID from the Subject Manager page (accessed from the Subject menu). Selecting this property for a Study type form will show this particular field in the Log Form displayed on the Study Forms page accessed from the Subject menu using the Access Study Related Forms… link. The Log Forms feature is only available for use on Subject and Study type forms created in the Study Form Builder.

Special Type: – (For Mobile Display Only) The Special Type - Slider (Mobile) can be used to provide end users in either Clinical Studio forms or ePRO applications to slide the numeric value for field.  This is set on numeric fields only and can be used effectively on pain scale forms.



End user view of configuration above on hand held device.  Slide the control button across scale to desired numeric value.  The numeric value increments on right of dialogue box on screen.



User has slid pain scale to 48 in example below on device screen:



Validations Section


Validations allow the Form Designer to define conditions that a field(s) value must meet (or not meet). Please refer to the Conditional Actions – Validation Help file for the complete instructions.

 

Required – Selecting the “Required” checkbox indicates the field must be completed when the user is filling out the form. If the field is not completed, when the form is saved an error message will be displayed indicating, “This field is required.”

 

Valid Range (min/max) – The Valid Range (min/max) property allows the Form Designer to set a low and high number value the field is required to meet when filling out the form. If the field is required and a user inputs a data value which is outside of the range (either less than – min or greater than - max) the field will be saved with a red error message indicating the field is not within the set values. Also, if a range is defined, the field will not allow any number to be entered into the field that is less than (min) or greater than (max) the range value entered. If no range is defined the system defaults to 0-9999.

 

Conditional Actions - View/Edit – Selecting the View/Edit link brings up the Conditional Actions dialog box and allows the Form Designer to create simple to complex edit checks (validations) for fields (and forms). The Conditional Actions dialog box can be used to: disable or hide fields (or forms) based on some criteria, produce edit checks (validations), display a popup message, compute a value, populate a field with a value based on some criteria and/or send an Email notification. Each field can contain multiple conditional actions. The number that precedes the View/Edit link indicates the number of conditional actions present on the field (or form). Please refer to the library of Conditional Actions help documents for complete instructions.

 

Layout Section


The Layout Properties enable the Form Designer to designate the exact location on the Form Builder body/grid where the Number Field will be placed. The Layout properties allow the Form Designer to align various fields in a form so they are uniform and the appropriate size when the form is rendered.

 

Left (pixels) – This field allows the Form Designer to designate where the left edge of the Number Field will be located.

Top (pixels) – This field allows the Form Designer to designate where the top edge of the Number Field will be located.

Width – This field allows the Form Designer to designate the width of the Number Field. The width of the field can be expressed in pixels or a percentage using the dropdown control.

 

Pixels – This dropdown choice allows the Form Designer to designate the width of the Number Field by the number of pixels.

Percent – This dropdown choice allows the Form Designer to designate the width of the Number Field as a percentage of the total Form Layout width. For example: If the width of the form is designated in the form properties is 800 pixels and a Number Field Width of 50 percent is selected, the Number Field Width will be 400 pixels wide (half the width of the Form).