Skip to content

Assigning & Changing the 'Description' of a Test Script

Quick Links:

Click on the links below to jump to the relevant section of interest to you:

Significance of the 'Description' of a test script:

The 'Description' is verbose text that you can optionally enter to capture anything of importance that is not covered by the name you assigned to the test script. Here are some ideas on what you can populate into the description:

  • Purpose of the test script
  • High level scope of the test case(s) you are automating with an automated test script. We would recommend using labels to map your automated test scripts to manual test cases or application module features.  For more on this click here.
  • Change history on 'why' a test script is being changed. Please note that the information on 'who' changed it and 'when' is automatically maintained for you under 'Additional Info' --> 'Activity History'. 

The 'description' can be any combination of alphanumeric characters, not exceeding 512 characters.

Watch Out: Please do not copy into the 'description' field the 'name' you assigned to the test script. It yields no benefit to you by doing so. Remember that this 'description' is optional. You don't have to force yourself to enter something if you really don't have anything of importance to enter. 

Assigning the 'Description' to a test script (during script creation/upload) - Overview:  

You assign the description to a test script that you author to test 'Web Applications for Desktop and Mobile Browsers' and 'Native or Hybrid Mobile Apps' on the screen that comes up when you (browser) upload the test script(s) you create using QaSCRIBE or using Excel respectively into the Worksoft SaaS application.

For test scripts that you author with QaSCRIBE, the description is NOT defaulted and is left blank. If you want to enter a description, you have to enter it in.

Assigning the Description' to a test script - Web Apps:  

The image below shows how you enter the description for a test script that tests 'Web Applications for Desktop and Mobile Browsers':


Assigning the 'Description' to a test script - Native/Hybrid Apps:  

The images below show how you enter the description for a test script that tests 'Native or Hybrid Mobile Apps':  

 

Changing (editing) the 'Description' of a test script - Overview:  

You can change the description of a test script as long it is in the 'WIP' (Work In Progress) status or the 'WIP of an Active' status.

Let's assume that you develop and unit test your test script using QaSCRIBE on Firefox. Then you upload it into Worksoft SaaS application, and then while its status is 'WIP', you attempt to certify that the script works well on other desktop and mobile browsers (like Chrome, Safari, Mobile Safari, Android Chrome, etc). You may need a day or two (or however long it takes for you) to finish the edits you need to your script to make it execute well against all browsers of interest. During this period, you are free to change the description of the test script, if a need arises.

In Worksoft SaaS, you can 'activate' a 'WIP' version of a test script. That creates the test script in 'Active' status. When you edit an 'Active' version of the test script, a new 'WIP' version is created for it while retaining the 'Active' version. That WIP is called the 'WIP of an Active' version, and Worksoft SaaS allows you to change the description of the test script on the 'WIP of an Active' version (unlike the 'name' of the test script which is not allowed to be changed).

Editing the 'Description' of a test script in 'WIP' status:


                                     

Editing the 'Description' of a test script in 'WIP of an Active' status:


You are allowed to change the description of a test script when the status of the test script is 'WIP of an Active'. 


Searching for (finding) a test script based on its 'Description':


The Test Scripts home screen currently does NOT allow you to search for or filter the test scripts listed within the 'My Favorites' view or the 'Script Library' view based on the 'description' of the test script. If you need this functionality, please do not hesitate to 'Post a New Idea' on our Knowledge Base.


Feedback and Knowledge Base