Custom Form Fields

Learn about the functionalities related to custom fields in Test Management.

Test Management allows you to create, amend, and manage custom fields in your Test Management projects.

Custom Fields

Custom fields help you to customize your Test Management experience. You can add the fields you need to monitor the most important information to your project. This allows you to expand the standard test management fields, enabling you to track additional test information and adapt the platform to your specific workflow.

Currently, Test Management supports the following custom field types:

• String
• Text Area
• User
• Dropdown

After creating or editing custom fields, always assign them to relevant projects. This ensures that the fields are available for use within those projects. You can assign custom fields to all projects or choose specific projects. Unassigned fields will not appear in any project.

Create a Custom Field

Following are the steps to create a custom field.

1. Navigate to Form Fields and Values under Settings.

   

2. Click Create Field.

3. Select the type of custom field from the Type drop-down menu. Enter the necessary details.

   

4. Enable the Mark this field as required toggle to make this a mandatory field in your test case form.

5. Click Update to link projects.

   

6. Select the projects to link with the field.

   

7. Click Create.

   

A custom field is created and is available in the form fields list view. Now, the custom field will appear in all the linked projects.

Update a Custom Field

To update an existing custom field:

1. Click the kebab menu on the right of the desired custom field.

2. Click Configure Fields.

   

   Update the necessary fields or switch on Mark this field as required toggle.

3. Click Update.

   

The custom field is updated and is available in the form fields list view.

Delete a Custom Field

When managing custom fields, it is important to note that only the user who creates a custom field can delete it. System-defined fields cannot be deleted.

To delete a custom field in the desired form field:

1. Click the kebab menu on the right of the desired custom field.

2. Click Delete.

   

3. Click Delete in the confirmation pop-up.

   

The custom field is deleted and removed from the form fields list view and the associated projects.

Create a Custom Dropdown Field

Custom dropdown fields provide pre-defined options to select from within your projects. Datasets are collections of values that you can assign to these dropdown fields; each dataset maps to multiple projects. The following procedure guides you through defining the field, creating datasets with dropdown options, and linking the field to relevant projects.

1. Navigate to Form Fields and Values under Settings.

   

2. Click Create Field.

3. Select Dropdown from the Type dropdown menu.

   

4. Enter a descriptive name in the Field Name textbox. If necessary, enter placeholder text in the Placeholder text textbox.

   

5. Switch on Mark this field as required toggle to make this field mandatory in the test case form.
6. Click Add New Dataset.

7. Enter value name in the textbox, which is an option in the dropdown, and click Add Value.

   

8. Optionally, select the DEFAULT toggle next to the value you want to be pre-selected in the dropdown field. This value will automatically appear as the initial selection.

   

9. Click Update in the Link Dataset to Project field.

   

10. Select projects where you want to use this dropdown field and click Update.

    

11. Optionally, create additional datasets with unique values by repeating steps 6 through 10.

    

12. Click Create.

    

You have created a custom dropdown field with its associated datasets.

Manage Custom Dropdown Fields and Datasets

You can manage datasets and values associated with your custom dropdown fields. Here is how changes to datasets affect linked projects.

Link and Unlink Datasets from Projects

Linking and unlinking datasets from projects, as needed, can ensure that your custom dropdown fields always offer suitable options.

To link and unlink datasets from projects:

1. In the Link Dataset to Project field, click Update.

   

2. Select the projects to link with the field.

   

3. Click Update and confirm the action.

Now, the projects linked to the datasets are updated.

Update a Dataset Value

If you edit values within a dataset, the dropdown menu in linked projects will automatically reflect these changes. This ensures you always have access to the most up-to-date custom field.

To edit a value from a custom dropdown dataset:

1. Click the kebab menu next to the value you want to modify.

   

2. Select Edit value.

3. Update the value in the text box and click Update.

   

The dataset value is updated.

Modify Default Value

A custom dropdown field can have a designated default value. This pre-selected value automatically appears when you interact with the dropdown for the first time. Here is how to modify the default value within your dropdown field.

1. Locate the value within the dataset that currently has the DEFAULT toggle enabled.

2. Click the DEFAULT toggle next to this value to deactivate it.

   

3. Find the value you want to make the new default and click its DEFAULT toggle to enable it.

The modified default value will now be the automatic selection when you interact with the dropdown field.

Delete a Dataset Value

If you delete values within a dataset, the dropdown menu in linked projects will automatically reflect these changes.

To delete a value from a custom dropdown dataset:

1. Click the kebab menu next to the value you want to remove.

   

2. Click Deleteand confirm the action.

3. Click Delete.

   

The value is deleted, and the dataset is updated to reflect the new dataset.

Delete a Dataset

If you delete values within a dataset, the dropdown menu in linked projects will automatically reflect these changes. To delete a value from a custom dropdown dataset:

1. Click the Delete icon next to the dataset you want to remove.

   

2. Click Delete and confirm the action.

   

The dataset is deleted, and the custom dropdown field has been updated.