How Can We Help?

Working with Forms

You are here:
< Back

Forms have two different names. When you’re looking at UI states, they’re called forms because that’s how they appear on the screens of your application—like a form with blank fields that your user fills out.
When you’re looking at client or server controller states, forms are called groups because they are collections of fields that are packaged together.

Forms let you arrange fields (and other forms) so that they travel together. For example, if you have seventeen fields you always want to appear together on five different screens, think of what a pain it would be to have to replicate seventeen things five times. That’s almost eighty-six things.

Using forms, you don’t have to recreate multiple fields on different screens manually. You can just call up the form, and it will display the fields.

Just to confuse you, forms can contain other forms. For more information about that, see the Creating Subforms Help topic.

Adding Forms/Groups

You can create forms/groups in a couple of different ways.

NOTE! For information on how to create a form using Text-to-software, see Creating Forms Using Text-to-Software.

TO CREATE A FORM FROM A FIELD
1. On the Requirements Analysis tab, ensure you are viewing UI screens—Right-click in the States box and click Show UI State.
2. Right-click a field in the Fields box and click Become Form.

TO CREATE A FORM FROM A USE CASE
When you create a form from a use case, Text-to-Software creates the form, and it creates fields for any requirement in the use case. Text-to-Software also creates a field for the use case.
1. On the Requirements tab, ensure you are viewing UI screens—Right-click in the States box and click Show UI State.
2. In the Use Cases box, right-click a use case and click Instantiate.
3. In the Add a group for these new elements dialog box, click Yes.

TO RENAME A FORM
1. On the Requirements Analysis tab, ensure you are viewing UI screens—Right-click in the States box and click Show UI State.
2. In the Forms/Groups box, right-click a form and click Rename.
3. Type a name in the Enter new name box.
4. Click OK.

TO DELETE A FORM OR GROUP
1. On the Requirements Analysis tab, ensure you are viewing UI screens—Right-click in the States box and click Show UI State.
2. In the Forms/Groups box, right-click a form/group and click Delete.

Adding Fields to Forms

You have to add each field to a form for the field to show up in your final application. In the final application, fields are displayed in the same order as they appear in the form. To change the order of fields, see the Changing The Order Fields/Elements Are Displayed Help topic.
You can also remove fields from forms.

TO ADD A FIELD TO A FORM
1. On the Requirements Analysis tab, ensure you are viewing UI screens—Right-click in the States box and click Show UI State.
2. In the Forms box, click a form.
3. Right-click a field in the Fields box and click Add to Form.

TO REMOVE A FIELD FROM A FORM
1. On the Requirements Analysis tab, ensure you are viewing UI screens—Right-click in the States box and click Show UI State.
2. Right-click a field in the Fields box and click Remove From Form.

Creating Subforms/Subgroups

In addition to fields, forms can contain other forms. These subforms behave the same way as forms, with the same properties and features. You can organize, rename, and delete them just like forms.

You can also create a new subform by copying a form. When you that, you will choose the form to create the subform in, and you’ll also give the subform a new name.

TO CREATE A SUBFORM FROM A FIELD
1. On the Requirements Analysis tab, ensure you are viewing UI screens—Right-click in the States box and click Show UI State.
2. Right-click a field in the Fields box and click Become Subform.

TO MAKE AN EXISTING FORM INTO A SUBFORM
1. On the Requirements Analysis tab, in the Forms/Groups box, right-click a form and click Become Member of…
2. In the Choose which group to join box, click a form.
3. Click OK.

Changing the type of Form/Group

You can choose from two form types. Each type displays information in a different way:
• Tree—Displays items in a vertical list; and
• Grid—Displays items in a horizontal row.

TO CHANGE THE FORM TYPE
1. In the Forms or Groups box, right-click a form and click Set Type.
2. Click one of the following buttons:
• Tree
• Grid

Previous Working with Fields
Next Working with Logic
Table of Contents