Content Comparison

...

Particular behaviour for the superset of interpreters:
Since the SupersetOfInterpreter accepts that the specification may contain rows that are not contained in the SUD,  will not colour the rows contained in the specification but not returned by the SUD.

Writing a List specification

When do we use the CollectionInterpreters

The CollectionInterpreters are used to express any kind of group, list or set of values.

When a CollectionInterpreters is executed, Image Added compares the list of expected values with the list of values returned by the system under development. The test result depends on the specific CollectionInterpreters selected.

Image Added offers four different CollectionInterpreters:

First row: Identification of the Collection Interpreter

As for all other interpreters, the first row of any CollectionInterpreter specifies the name of the interpreter and the name of the collection to be tested.

• Example - Provinces of Canada: A simple example would be a system containing the Canadian provinces name and code. In that particular case, we could define the collection as Canada Province Codes :

  list of

  Canada Province Codes

• Example - Phone Book : A phone book application able to manage the first name, last name and the phone number of people. The ListOfInterpreter could be express as

  list of

  phone book entries

Other rows: A set of elements

From the third row, we specify the set of values to test.

• Example - Provinces of Canada :

  list of	Canada Province Codes
  Name	Code
  ALBERTA	AB
  BRITISH COLUMBIA	AB

• Example - Phone Book :

  list of	phone book entries
  FirstName	LastName	Phone Number
  Fred	Flintstone	(123) 456-7890
  Barney	Rubble	(123) 321-7666
  Great	Gazoo	(123) 989-4455

Execution of specification

Once the developers have coded the functionality and the fixture(the fixture is the link between the system under development and the executable specification), the specification can be executed by clicking on the Execute button on the top of the page.

During execution, Image Added will color the rows in green if the rows are in the list of elements returned by the SUD as expected in the specification.
If a row is missing or in surplus in the list returned by the SUD, then Image Added will color the entire row in red and specify if the row is missing or in surplus.

Since the ListOfInterpreter expects to match exactly the list expected and the list returned by the SUD, Image Added compare each cell of the table separately. If the expected value is different from the returned value, Image Added color the cell in red and provide the two values.

Since the SupersetOfInterpreter accept that the specification may contains rows that are not contained in the SUD, Image Added will not color the rows in the specification but not returned by the SUD.

Executable specification for the example - Provinces of Canada

Executable specification for the example - Phone Book

Creating the collection of data
We will use the DoWithInterpreter to create our personal phone book.

ListOfInterpreter : The requirement list should be the same as the SUD list.

SetOfInterpreter : The requirement set should be the same as the SUD set.

SubsetOfInterpreter : The requirement set should be a subset of the SUD set.

SupersetOfInterpreter : The requirement set should be a superset of the SUD set.