Text To Software User Manual

  1. Home
  2. Text To Software User Manual
  3. Working with Fields

Working with Fields

Fields are the basic building blocks of applications made with Text-to-Software, like LEGO® bricks, if LEGO® bricks could be made into software.
Every field is associated with a requirement in a use case. To make a field, you first create a requirement in a use case, then create the associated field.

You can make fields into Smart Parts to give them functionality. You can make fields into:

• Action buttons
• Attachment fields
• Bar charts
• Calendars
• Charts
• Check boxes
• Data table charts
• Date fields
• Dependent numbers
• Email fields
• Forums
• Gauge charts
• Geographical charts
• Group combo boxes
• Images
• Import object fields
• Input fields
• JavaScript
• Labels
• Line charts
• Lists
• Logos
• Maps
• Navigators
• Pages
• Pie charts
• Radio buttons
• Realty maps

To make sure the fields that belong together are displayed together, you can organize them into forms. For more information about that, please see Working with Forms.
Other Text-to-Software components are made of fields. For example, to make a new activity or screen, you must first create a field and then turn it into an activity or screen.

Adding, Renaming and Deleting Fields

Fields are the basic building blocks of most Text-to-Software components. Once you’ve added a field, you can turn it into a form, activity, or UI state.
For information on how to turn a field into a form, see Working with Forms.
For information on how to turn a field into an activity, see Working with Activities.

TO ADD A FIELD
1. On the Requirements Analysis tab, in the Description box, type a name for the field.
2. Using your cursor, highlight the name of the field.
3. Do one of the following:

• Click the Reverse Engineering menu, Convert selected text to a single SageTea element.
• Press the F1 key on your keyboard.

TO ADD A FIELD USING A COMMAND
• On the Requirements Analysis tab, in the Run Command box, type “has a field named [Name]”, where [Name] is the name of the field.

TO ADD MULTIPLE FIELDS AT THE SAME TIME
When you add multiple fields, each word will become a single field.
1. On the Requirements Analysis tab, in the Description box, type a one-word name for each field you want to create.
2. Using your cursor, highlight the names of the fields.
4. Do one of the following:

• Click the Reverse Engineering menu, Convert selected text to a single SageTea Element.
• Press the F3 key on your keyboard.

TO ADD MULTIPLE FIELDS IN A GROUP AT THE SAME TIME
When you add multiple fields, each word will become a single field. You can add those fields can be created in an existing group, or in a new group.
1. On the Requirements Analysis tab, in the Description box, type a one-word name for each field you want to create.
2. Using your cursor, highlight the names of the field.
3. Do one of the following:

• To add the fields in an existing group, click the group you want to add them to. Then click the Reverse Engineering menu, Convert selected text to multiple SageTea Elements in selected SageTea group, or press F2 on your keyboard.
• To add the fields in a new group, click the Reverse Engineering menu, Convert selected text to multiple SageTea Elements as new SageTea group, or press F4 on your keyboard.

TO ADD A FIELD BY REFACTORING A REQUIREMENT
NOTE! All fields are associated with a requirement. To learn more about requirements, see the Working with Requirements Help topic.
1. Click the Requirements tab.
2. In the Use Cases box, right-click a requirement and click Refactor Requirement.
3. In the Refactor Description box, click one of the following:

• Yes—Adds the date of the refactoring to the description.
• No—Leaves the description as it is currently.

4. In the Add fields for the new requirements box, click Yes.

TO RENAME A FIELD
1. Click the Requirements Analysis tab.
2. Ensure you are viewing UI screens—Right-click in the States box and click Show UI States.
3. In the Fields box, right-click a field and click Rename.
4. In the Enter a new name box, type the new name for the field.

TO DELETE A FIELD
Much like performing a self-trepanation, there is no confirmation and no undo for this action. You’ll want to be pretty sure before you drill that hole.
1. Click the Requirements Analysis tab.
2. Ensure you are viewing UI screens—Right-click in the States box and click Show UI States.
3. In the Fields box, right-click a field and click Delete.

Was this article helpful to you? Yes No

How can we help?