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. Make it less likely that you'll make mistakes documenting test scripts.

A separate lesson describes how you can also 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...

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

... into test SCRIPTS like these that contain detailed tester instructions.

... into test SCRIPTS like these 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 a different lesson.

Remember Mad Libs?

Remember Mad Libs?

Creating Auto-scripts in Hexawise is a lot like that.

Except that instead of adding adjectives and nouns into pre-formed sentences, 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.

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.

Next, click on the "pencil" icon to enter instructions for your first test step.

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

Next, enter detailed written instructions for a tester for each test step.  For now, type Mad Libs-like sentences, as shown above, 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.

Next, replace those blank lines with the appropriate Parameter names.
  1. Highlight each blank line.
  2. Confirm that the Parameter name you want to insert is showing in the Parameter Name Drop Down List (and adjust if necessary).
  3. Click ctl + y (or the "Insert" link if you prefer, but the cool kids do the crl-y thing).
  4. Rinse and repeat for the other blank lines.

Usage Tip For Lazy Users and 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 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 typing ctl-y 4 times 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 kind of funny.

You'll notice when you're entering and editing your Auto-Scripts that your sentences probably look kind of funny.
  1. 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.
  2. Save each test step before you add your next one.

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 from test to test are in normal text.

The words that change from test to test (the Values you entered on the Define Inputs screen) are shown in bold.

Usage Tip: you can click on different tests (on the bottom half of your screen) to see how your test scripts will change.

Usage Tip: you can click on different tests (on the bottom half of your screen) to see how your test scripts will change.

Notice that when Test number 1 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 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.

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 a lot of 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. Like improving your Angry Birds skills, making overdue calls to your mother, baking cookies, honing your Crazy Frog dance moves, or even constructing a "bacon lance of death."