TextBox Form Field

About this article

This article explains what a TextBox form field is and how it can be created through the dynamics designer. Sections in this article:

• What is a TextBox form field?
• Creating a textbox form field
• TextBox form field examples

Prerequisites

What is a TextBox form field?

A textbox form field is a type of form field that allows the user to enter free text. Textboxes have a number of configurable options that determine the size, prepopulated text, mandatory filling requirement etc. Often, a textbox is used to populate a text binding or a document property. Below is an example of a setup with 4 textboxes for an end-user creating a letter.

Creating a textbox form field

In it's simplest form, a textbox is a Name and a Label with a single line.  The Name being used in the binding syntax and the Label being placed above the textbox for user guidance. Therefore the simplest textbox creation consists of the following steps:

1. Go to the Dynamics Designer
2. Click the Form tab.
3. Click Add form field
4. Select TextBox
5. Fill out the Name and Label and any additional options
6. Click Save

Below is an example of the above.

Additional options

• Required: Check this box if you'd like to mandate the user fills out the textbox, an asterisk will indicate to them that it's required.
• Placeholder: Prepopulate text that is deleted when the textbox is clicked.
• Default Value: Prepopulate text that stays when clicked and is editable. The default value can be your own text, or you can use a binding as default value, for example {{UserProfile.Location}} or {{HostSystem.Subject}}.
• Lines: Sets the height of the textbox in lines of text.
• Spacing before: Adds space above the form field.
• Space after: Adds space below the form field.
• Helptext prefix: Adds help text above the dropdown, this can be useful for guiding the user on filling out the form field.
• Helptext postfix: Adds help text below the dropdown, this can be useful for guiding the user on filling out the form field.
• Share value: Allows the form field to be recognizable as shared by dynamic documents.

TextBox form field examples

Example 1

A textbox form field where Lines is set to 5.

Example 2

A single line textbox where Default Value is set to a commonly used city "Chicago".

Related articles