# Configuring Test Step Additional Prompts (Validation Management)

_Test Step Additional Prompts_ are available in the Test Authoring Interface and the Text Execution Interface for setup and execution steps. _Test Step Additional Prompts_ that are a part of a _Test Script_ display all associated prompts defined by a Test Author; a maximum of 15 prompts can be defined for each _Test Step_. The default prompts for a step are _Procedure_, _Expected Results_, and _Actual Results_, but Vault supports the following prompt types for _Test Steps_:

* **Procedure**: Describes what the Executor must do to complete the step.
* **Expected Results**: Describes the expected outcome after completing the step. This is only available for execution steps.
* **Actual Results**: An input prompt that allows the Executor to describe the results after testing.
* **Reference Instruction**: An additional reference instruction, such as an image, video, or document.
* **Text Instruction**: Additional instructions for the executor.
* **Text Response**: An input prompt for the Executor to provide text.
* **Date/Time Response**: An input prompt for the Executor to provide a date and time value.
* **Number Response**: An input prompt for the Executor to provide a numerical value with a unit of measure.

## Configuration Overview

Admins can complete the following steps to configure _Test Step Additional Prompts_:

* Configure the [permission sets](/en/lr/50533904/#minimum-field) for _Test Step Additional Prompts_.
* Configure the [_Test Step Additional Prompt_][1] object.
* Configure the [_Test Step Additional Prompt_][2] object lifecycle.
* Optional: Configure the available [document types][3] for _Reference Instruction Prompts_.
* Optional: Configure the [document subtype and classification][4] for _Reference Instruction Prompts_.
* Optional: Configure the [_Reference Instruction Prompt_][5] document lifecycle.

### Configuring the Test Step Additional Prompt Object {#test-step-object}

Activate the _Test Step Additional Prompt_ (`val_test_step_additional_prompt__v`) object, and ensure that the following object types are available on the _Test Step_ (`val_test_step_svo__v`) object:

* _Procedure Setting_ (`procedure_setting__v`)
* _Procedure Fit to Width_ (`fit_to_width__v`)
* _Actual Results Fit to Width_ (`actual_results_fit_to_width__v`)
* _Expected Results Setting_ (`expected_results_fit_to_width__v`)
* _Expected Results Fit to Width_ (`expected_results_fit_to_width__v`)
* _Verdict Setting_ (`verdict_setting__v`)
* _Actual Results Setting_ (`actual_results__v`)
* _Attachment Setting_ (`attachment_setting__v`)

Optionally, activate the _Reference Instruction_ (`document_instruction__v`) object type on the _Test Step Additional Prompt_ (`val_test_step_additional_prompt__v`) object, and ensure that a _Document Instruction_ and a _Description_ field are enabled for the object type. This ensures that Test Authors can use the _Reference Instruction Prompt_ to include a file or link an existing document in a _Test Step_. These files and documents provide Executors with immediate access to critical reference materials during test execution.

## Configuring the Test Step Additional Prompt Lifecycle {#test-step-lifecycle}

At minimum, add the Test Author and Executor roles to the _Test Step Additional Prompt_ lifecycle and give _Edit_ permissions to the applicable states, such as _In Authoring_, _Pre-Approved_, _In Execution_, and _Completed_. Also configure the atomic security settings for the Test Author and Executor roles for the applicable states. 

Optionally, you can update the _Test Step_ object lifecycle to change the states of additional prompts when a _Test Step_ moves to another state.

## Configuring the Reference Instruction Prompt Settings {#reference-settings}

To configure the available document types for _Reference Instruction Prompts_:

1. Navigate to **Admin > Configurations > Validation Reference Instruction Prompt Settings**. 
2. Select the document types for the _Reference Instruction Prompts_ for display in the Test Authoring Interface and related Validation Management application pages.
   1. If you select a document subtype, all existing classifications under that subtype are automatically selected.
   2. You cannot deselect the _Reference Instruction Prompt_ document type as it is required to upload the file attachments or existing documents.

## Configuring the Reference Instruction Prompt Document Subtype {#document-subtype}

Activate the _Test Step Prompt_ document subtype and _Reference Instruction Prompt_ classification under the _Validation_ (`validation__v`) document type to ensure that Vault uses this document type when creating a new document for a _Reference Instruction Prompt_. 

## Configuring the Reference Instruction Prompt Document Lifecycle {#document-lifecycle}

To configure the _Reference Instruction Prompt_ document lifecycle:

1. Configure the role security settings for the _Draft_ and _Available for Use_ states.
2. Add the _Set Major Version_ entry action for the _Available for Use_ state.

Additionally, If there are required fields for the _Reference Instruction Prompt_ document type, change them to optional. If required fields are inherited from the parent document type, change the fields to optional on the parent document type, and add field dependency settings to make those fields required for all other document types except the _Reference Instruction Prompt_ document type. If these fields are not made optional, Vault will experience an issue uploading files for the _Reference Instruction Prompt_ in the Test Authoring Interface.

[1]: #test-step-object
[2]: #test-step-lifecycle
[3]: #reference-settings
[4]: #document-subtype
[5]: #document-lifecycle