Use the Step Library to keep a reusable set of test instructions, such as signing in or preparing checkout data. A step collection holds the shared script. Test Cases can reference that collection so your team can maintain the common instructions together.
Before you begin
Open Vansah in the Jira space where you want to manage the collection. Your account needs access to that space and permission to view and edit Test Cases.
A step collection is different from a Test Data Collection. Step collections store test instructions; Test Data Collections store variables and values used by tests.
Create a collection
Open Vansah’s Test Cases tab and show the Test Repository pane.
Open the more options menu beside Test Repository and select Step Library. You can also open Step library from a saved Test Case’s script toolbar.
Select Add collection.
Choose the owning Jira space and Script Type. Enter a clear Collection name, such as Sign in as a registered shopper.
Select the checkmark labeled Save. The collection is created and opens for editing.
Collection names can contain 1–255 characters. The owning space is where the collection is managed. Check it before saving, especially when you have access to several spaces.
Choose the script format
Format | Use it when |
Multi Steps | You want separate actions, Test Data, and Expected Results. |
Plain Text | You want one formatted description of the shared procedure. |
Choose the format that matches the Test Cases where you plan to reuse the collection.
Add the reusable instructions
For Multi Steps, add the actions, data, and expected results. Finish each open step edit, then select the collection’s Save action to store the changes. Wait for uploads to finish before saving.
Step | Test Data | Expected Result |
Open the sign-in page. | The test site URL. | The email and password fields are visible. |
Enter the designated test account and submit the form. | A test account supplied by your test environment. | The shopper account page opens. |
For Plain Text, write the complete procedure in the editor, then save the collection. Keep passwords and other secrets out of shared instructions.
Reopen the collection and confirm the saved content. Creating the collection saves its name first; adding the instructions is a separate save.
Use and maintain the collection
Open the destination Test Case, select its version, and use Step library in the Test Script view to select and insert a compatible collection. Review the inserted script before testing.
Shared collections should contain instructions that are meant to stay consistent. Review where a collection is used before changing it. If you need a separate complete Test Case copy, use Clone Test Case instead.
If you cannot create or save
Check the owning Jira space and your Test Case edit permission.
Enter a nonblank name within the 255-character limit.
Finish any open step edit or upload before saving the collection.
If Vansah says the collection changed, reopen it and review the latest content before applying your edits.
If creation is interrupted, check the library for the collection before creating it again.