Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info

The examples provided in this page are used to explain how to write the fixture for the DoWithInterpreter.

5. Scenario specification

Definition

Panel
titleDEFINITION
borderStylesolid

The ScenarioInterpreter is used to express interactions with the system under development that must be performed in a particular order. This form of specification provides information about the business flow.

When a sequence of action is executed, Image Added confirms that each action has successfully been performed.

ScenarioIdentification of the set of rule
Action 1
Action 2
...
Action i
  • As for all other interpreters, the first row of the ScenarioInterpreter specifies the name of the interpreter and the name of the sequence of actions to be tested. What makes the ScenarioInterpreter particular is that it only have to be defined once for all the sequences of actions expressed in a page. Obviously, the ScenarioInterpreter must be define before any sequence of actions.
  • The ScenarioInterpreter may also be expressed in Bullet List form or Number List form.

 

Coloring

Image Added will visually show the test result by coloring a complete row or words inside the row:

Panel
bgColorlightgreen
titleBGColorlightgreen
titleGreen
borderStyledashed

When the action has been executed successfully, Image Added color the row or words inside the row in green.

Panel
bgColor#f08080
titleBGColor#f08080
titleRed
borderStyledashed

If the action execution has failed, Image Added color the the row or words inside the row in red.

Panel
bgColor#f0e68c
titleBGColor#f0e68c
titleYELLOW
borderStyledashed

If the system encounters an execution error, the row is colored yellow and Image Added provides information about the error.

Panel
bgColorlightgrey
titleBGColorlightgrey
titleGrey
borderStyledashed

When the action has been executed successfully, Image Added will display the returned value in gray.

Writing a Scenario specification

When do we use the ScenarioInterpreter

The ScenarioInterpreter is used to express interactions with the system under development that must be performed in a particular order. This form of specification provides information about the business flow.

When a sequence of action is executed, Image Added confirms that each action has successfully been performed.

First row: Identification of the Scenario

As for all other interpreters, the first row of the ScenarioInterpreter specifies the name of the interpreter and the name of the sequence of actions to be tested. What makes the ScenarioInterpreter particular is that it only have to be defined once for all the sequences of actions expressed in a page. Obviously, the ScenarioInterpreter must be defined before any sequence of actions.

Example of a bank Account management system

Example context : The system under development must be able to manage two different types of bank account. The system should allow to execute the usual transactions within an account.

So the first line could be expressed as

scenariobank account management

or more simply as

scenariobank

Following rows: Actions & Verifications

The second and following rows are used to express specific actions or verifications. The business expert should express the action in human readable format rather than using computer like language.

Info

With this interpreter, only 1 cell is required to express the action (in comparison to the DoWithInterpreter).

Example: In our bank example, the first action would be to create a bank account .

If we want to take the account number as a parameter, we would have:

open checking account 12345-67890

But, if we want to consider the type of account, the account number, the owner first name and last name as parameters, we would have:

open checking account 12345-67890 under the name of Spongebob Squarepants

Example: Verify the balance of an account

In our example, there would be two parameters: the account number and the amount of balance.

verify that balance of account 12345-67890 is $0.00

Final expression of our example

scenariobank

Our first business rule says that a new account should have a balance of 0.00 dollars.

open checking account 12345-67890 under the name of Spongebob Squarepants
verify that balance of account 12345-67890 is $0.00

Our next rule says that the bank should not take any fees when we deposit money in our account.

deposit $100.00 in account 12345-67890
verify that balance of account 12345-67890 is $100.00

The following rule says that a customer should be able to withdraw funds if the balance of his account is sufficient.

withdraw $50.00 from account 12345-67890
verify that balance of account 12345-67890 is $50.00
can't withdraw $75.00 from account 12345-67890
verify that balance of account 12345-67890 is $50.00
can withdraw $25.00 from account 12345-67890

Execution of specification

Based on those executable specifications, the developers are now ready to code the functionality and the fixture (the fixture is the link between the system under development and the executable specification). Once this is done, the specification can be executed by clicking on the Execute button on the top of the page.

During execution, Image Added will color rows or words inside a row in green if the execution has passed and color it in red if the execution has failed.

Info

The examples provided in this page are used to explain how to write the fixture for the ScenarioInterpreter.