help.hexawise.com (Lessons Explaining How to Use Hexawise Features) Instructions for the Practitioner ➜ Expert AchievementsHow do I Auto-script test cases to quickly include detailed written tester instructions in my tests?

How do I Auto-script test cases to quickly include detailed written tester instructions in my tests?

This lesson explains how you can use the Auto-Scripting feature to reduce the amount of time it takes you to document test scripts. The Auto-Scripting feature exists to provide you with 2 benefits:

1) Save you time documenting test scripts

2) Reduce the likelihood that you'll make mistakes documenting test scripts

A separate lesson shows how to add automatically-generated Expected Results into your Auto-Scripts.

With Hexawise's Auto-Scripts feature, you can quickly transform sets of optimized test CONDITIONS like these...

... into customizable test SCRIPTS that contain detailed tester instructions.

You can even add automatically-generated Expected Results to your tests steps and test scripts if you want to; that topic is covered in how to save test documentation time.

Remember Mad Libs?

Remember Mad Libs?

Creating Auto-scripts in Hexawise is similar to that. Instead of adding adjectives and nouns into pre-formed sentences, however, you’ll be more like the author of the Mad Libs sentences themselves. You need to:

1) Create sentences containing tester instructions that will be common to most of the test scripts and

2) Identify "spaces" to indicate where Hexawise should "fill in the blanks" you’ve left with test conditions appropriate to each test case.

First, navigate to the Auto-Scripts screen and (optionally) add instructions to be completed before test execution on these tests begins.

1) Navigate to the Auto-Scripts screen

2) Optionally in the "Start" section at the top of the screen, enter instructions that should be completed before any of the tests are executed.  The instructions that you enter into the "Start" box will only appear once at the beginning; they will not repeatedly appear before each and every test

3) Save your starting instructions

Next, click on the "pencil" icon to enter instructions for your first test step. Alternatively, you may click the text already present for the step.

Next, enter detailed written instructions for a tester for each test step. For now, type Mad Libs-like sentences, as shown below with blank lines to indicate where Values are to be inserted.

As shown above, for example, you will want to type the words that will remain the same from test to test and leave four blanks (one for each place that Values will change from test to test):

1) One blank for the type of flight,

2) One blank for when the outbound flight leaves,

3) One blank for the destination country, and

4) One blank for whether or not there would be a Saturday-night stayover.

Next, replace those blank lines with the appropriate Parameter names.

1) Highlight the first blank line

2) Confirm that the Parameter Name to be inserted is in the Parameter Name drop down list (adjust if necessary)

3) Press "ctl-y" on the keyboard (or the "Insert" link if you prefer, but the cool kids do the ctl-y shortcut)

4) Press "ctl-enter" on the keyboard (or the "Save link," but again cool kids use appropriate shortcuts)

5) Rinse and repeat for the other blank lines

For Lazy Users / Efficiency Nuts: You'll notice that the Parameter Name automatically advances to the next one in line.  This is done to save you time.  Being the busy person that you are, with things to do and places to go, we thought it only right to give you the option of saving that fraction of a second you'd spend moving your mouse over to that drop down list.  Highlighting each blank line and pressing ctl-y on the keyboard would get this job done in the blink of an eye.

You'll notice when you're entering and editing your Auto-Scripts that your sentences probably look strange.

The words inside the { squiggly lines } are Parameter Names. When you're editing the Auto-Script, your sentences won't look like "normal" sentences. The trick is to think about what your sentences will look like when the names of the actual Values will be inserted into each sentence.

Don't forget to save each step before you add your next one! Thankfully, Hexawise notifies you under the last edited step that there are unsaved edits, as shown below.

As soon as you save each step, sanity prevails. You will now see the "normal" sentences you've constructed.

As soon as you save each step, sanity prevails.  You will now see the "normal" sentences you've constructed.

The words that are the same between tests are in normal text. Words that change from test to test (the Values you entered on the Inputs screen) are shown in bold.

Click on different tests at the bottom half of your screen to see how your test scripts will change.

Notice that when Test 2 is selected at the bottom of the screen, the words shown in Step 2 provide tester instructions for Test # 1, but...

When you click on Test 2, below, the wording of the test script automatically adjusts. Cool, huh? That's what Auto-scripting is all about!

When you click on Test # 2, below, the wording of test script automatically adjusts.  Cool, huh?  That's what Auto-scripting is all about.

Finally, in the "Finish" section you may want to add some instructions that will appear only once at the end of all of the test scripts.

When you have many tests to document, this Auto-Scripting feature will save you boat-loads of time that you can put to more productive use on other endeavors.  Things like improving your Angry Birds skills, making overdue calls to your mother, baking cookies, or even constructing a "bacon lance of death."