Configuring Mandatory and Read-Only Fields

Overview

This article describes how to configure Mandatory and Read-Only fields for a record type at the system-wide level and project level.

For each record type in TopTeam, you can configure fields as Mandatory or Read-Only.

Who should read this?

  • TopTeam Administrators
  • Project Administrators

Prerequisites

  • You must have System Administrator permissions to configure Mandatory and Read-Only fields at the system-wide level.
  • You must have System Administrator or Project Admin permissions to configure Mandatory and Read-Only fields at the project level.

1. Configure "Mandatory and Read-only" properties at system-wide level

When you configure “Mandatory and Read-Only” properties at the system-wide level, it will be applicable to all projects in the repository.

Step 1. Navigate to the "Configure Fields: Mandatory and Read-Only Properties" screen from the Administration section of TopTeam

wpid22180-media_1452488234086-1.png

 

Step 2. Select a Record Type

wpid22178-media_1452486114072-1.png

 

By default, the "Use default behavior (Inherited)" option is selected

wpid22179-media_1452488066288-1.png

This option when selected for a state, will inherit all the Mandatory and Read-Only fields behavior defined for the <<Default Behavior>> state.
Alternately, you can define specific behavior of fields for a state by selecting the Specify special behavior for option.

Step 3. Specify the field behavior for the state – When a new record is added

wpid22187-media_1452533899261-1.png

Select fields and set their behavior to Mandatory.

Step 4. Save the field behavior

wpid22181-media_1452488756048-1.png

 

Step 5. Specify the field behavior for another state

wpid22183-media_1452493872964-1.png

Select another field and set its behavior to Mandatory.

Step 6. Save the field behavior

wpid22184-media_1452494095600-1.png

 

Step 7. Create a new record for User Stories record type

wpid22190-media_1452580060494-1.png

Step 8. Create a new User Story

wpid22188-media_1452534437853-1.png

Save the record after entering values in the Name and Description fields.

Step 9. Change the state of the User Story to Completed, the Acceptance Criteria field becomes Mandatory

wpid22185-media_1452494302852-1.png

 

Step 10. The "Set Mandatory Field Values" window displays, if you try to save the record without entering any values in all its mandatory fields

wpid22186-media_1452494467534-1.png

Click OK to save the record and click Cancel to cancel the save operation.

2. You can also configure fields at the project level, navigate to the "Configure Fields: Mandatory and Read-Only Properties" screen from the Administration section of TopTeam

wpid22182-media_1452491023234-1.png

NOTE: Project level will override default behavior which is defined at the system-wide level for the same state.

Revised: March 19th, 2018