Toegevoegd Specialisterren januari 2021

We gebruiken generiek, als template, dit sample (voorbeeld) project binnen Specialisterren om een project op te starten als we met HSAC-FitNesse testen automatiseren.

Voer de volgende acties uit bij de start van een project:

• Vraag of trek met een test engineer op die vaker de inrichting van een project heeft gedaan om dit template te gebruiken.
• Vervolgens vraag je aan de testlead of klant waar de repository moet komen te staan bij de klant in hun versie controle systeem zoals de GitHub omgeving van de klant.
• Gebruik de Fork optie om dit project te kopieren, de klant/projectnaam te geven en vanuit de Fork ga je vervolgens met pull requests de scripts (testautomatisering) committen.
• Eerste vraagbaak bij onduidelijkheden is Rutger Slangen om je vragen aan te stellen. Bij zijn afwezigheid kun je Lukas Boekenoogen vragen stellen.
• Lees en gebruik de informatie die hieronder vermeld wordt Hieronder volgt informatie en meer uitleg hoe het FitNesse-HSAC werkt en ook in relatie tot Maven en JDK.

Introduction

This testing project uses the FitNesse baseline provided by hsac-fitnesse-fixtures. It offers a web environment (wiki) to define and run tests. It is extended with Praegus' Toolchain plugin, improving the vanilla wiki.

Baseline Features

The hsac-fitnesse-fixtures aim to assist in testing (SOAP) web services and web applications (using Selenium) minimizing the amount of (custom) Java code needed to define tests.

The baseline FitNesse installation offers the following features:

• Ability to easily create a standalone (no JDK or Maven required) FitNesse environment.
• Run FitNesse tests on a build server, reporting the results in both JUnit XML format and HTML.
• FitNesse installation for test/fixture developers containing:
  • the fixture base classes (and Selenium drivers for Chrome, Internet Explorer, Edge and Firefox),
  • HSAC's fitnesse-plugin to add additional Wiki features (random values, calculating relative dates, Slim scenarios without need to specify all parameters, Slim scripts that take a screenshot after each step),
  • easy fixture debugging,
  • Praegus' toolchain-plugin, improving the wiki's look and feel and page editing features, combining:
    • Bootstrap-plus wiki theme
    • Autocomplete responder

More details can be found on its GitHub Wiki, or in the local wiki installation (see instructions below on how to start in).

Running Locally

To start the wiki locally execute: mvn clean compile dependency:copy-dependencies exec:exec, it can then be accessed at http://localhost:9090/.

More details on the features of hsac-fitnesse-fixtures, and example tests, can then be accessed at http://localhost:9090/HsacExamples.

An empty ('template' or 'boilerplate') test suite, to give you a flying start creating your own test suite, can be found at http://localhost:9090/MyTestSuite. All basic setup has been taken care of, so you can start defining your own tests in this suite immediately.

Upgrading

To upgrade to newer version of the hsac-fitnesse-fixtures project:

• stop FitNesse
• stop all selenium webdrivers that might be running
• upgrade hsac.fixtures.version property in pom.xml
• run mvn clean -Pdelete-hsac-fitnesse-fixtures
• start as normal

Upgrade FitNesse version used:

• stop FitNesse
• upgrade fitnesse.version property in pom.xml
• start as normal

Setting Up a Development Environment

A description on how to set up a development environment to work based on this project can be found in the hsac-fitnesse-fixtures' wiki.