Table of Contents

Tool Name: Email Address


Tool Description:


The Email Address Field is designed to store an email address. Only syntactically correct email addresses are accepted in the field when the form is completed.


Tool Use:


Email Address Properties


When an Email Address form field is dragged and dropped onto the Form Builder body/grid, the Email Address 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 an Email Address field are the same as those for a Text field. For 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, the text will automatically convert to upper case after the cursor is moved from the field.

 

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: Allows a User to designate a short name for reporting and exporting of data. 

 

Validations Section


Validations allow the Form Designer to define conditions that a field(s) value must meet (or not meet). 

 

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, an error message will be displayed when the form is saved, indicating, “This field is required.”

 

Conditional Actions - View/Edit – Selecting the View/Edit link brings up the Conditional Actions dialog box. It allows the Form Designer to create simple to complex edit checks (validations) for fields (and forms). You can use the Conditional Actions dialog box 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 requirements 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 dependent actions present on the field (or form). Please refer to the library of Conditional Actions help documents for complete instructions.

 

General Section


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.


For more information on the available Field Types, please visit the Field Types Knowledge base article.

 

Show in Log – You should select the Show in Log checkbox 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). Setting 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.

 

Layout Section


The Layout Properties enable the Form Designer to designate the exact location on the Form Builder body/grid where the Email Address Field will be placed. The Layout properties allow the Form Designer to align various fields, 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 Email Address Field's left edge will be located.

 

Top (pixels): This field allows the Form Designer to designate where the Email Address Field's top edge will be located.

 

Width: This field allows the Form Designer to designate the width of the Email Address 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 Email Address Field width by the number of pixels.


Percent – This dropdown choice allows the Form Designer to designate the Email Address Field width 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 an Email Address Field of 50 percent is selected, the Email Address Field width will be 400 pixels wide (half the width of the form).


Need more help?

Please visit the Datatrak Contact Information page.