README.md

# Webakzeptanztests Tutorial

## Voraussetzungen

 - Visual Studio 
 - Python 3 Extension (Workload Python Entwicklung) https://www.visualstudio.com/de/vs/python/  (Python 3.6 64bit)
 - Chrome Web Browser (mindestens Version 59 für Headless Mode für Linux und Mac)
 - Repository [0] clonen oder ZIP herunterladen und entpacken

## Installation

 - Python Virtualenv erstellen [1].
 - Requirements installieren. (Visual Studio übernimmt das.)

**Achtung!** in der VS-Solution kommt eine Python Virtualenv `env` mit. Diese muss von der Disk und der
Solution gelöscht werden, bevor eine neue Python Virtualenv mit genau dem Namen `env` erstellt wird.

**Achtung!** Vor allem beim Download als ZIP kann es vorkommen, dass der Pfad für die Python Umgebung zu lang
ist und es zu einer Fehlermeldung kommt. Der Pfad muss dann durch Verschieben der Solution oder Umbenennen der
Verzeichnisse verkürzt werden.

 - Chrome Driver [2] in der Virtualenv installieren

**Achtung!** Die beiden Verzeichnisse `./Acceptance Test Tutorial/env` und
`./Acceptance Test Tutorial/env/Scripts` müssen im Pfad Environment sein,
damit Python und der Testrunner gefunden werden.


## Selenium

Gestartet ist Selenium als Firefox Addon [3]. Mittlerweile hat es sich zum Platzhirsch des 
automatisierten Blackbox Akkzeptanztestings für Webseiten und Anwendungen etabliert. Das
Firefox Addon ist mittlerweile EOL [4].

Selenium wird heutzutage direkt aus den Testingtools verschiedener Programmiersprachen
verwendet. Es gibt offizielle Integrationen für Java, C#, Ruby, Python, JavaScript (Node).

## Robot Framework

Eine Möglichkeit der Steuerung von Selenium ist das generische
Akzeptanztestframework Robot Framework [5]. Dieses Framework
wird vom Team Web für die Akzeptanztests des Webauftritts und
anderer Services verwendet.

### Warum Robot Framework?

 * Gut dokumentiert
 * Erweiterbar auf andere (nicht Web) Bereich - zB SMTP, Mobile, etc.
 * Gutes Level an Abstraktion (DRY)
 * Goodies wie Testbericht und Screenshots


### Das Kleingdruckte

 * Auch Tests müssen (analog anderer Software) gewartet werden.
   Eine sinnvolle Beschränkung auf die wichtigsten Features ist angeraten
 * Es kommt immer wieder zu False Positives.
   Da die Abhängigkeiten bei Selenium recht komplex sind, kommt es immer
   wieder zu Testfehlschlägen, die eigentlich keine sind.
   Es gibt Abhängigkeiten zu Browser, WebDriver, Netzwerk, Server, etc.
   Hier hilft die Tests so klein wie möglich zu halten und
   bei öfterem Auftreten neu zu organisieren.
 * Je nach Szenarium dauert die Ausführung und damit ein vermeintliches
   Debugging lange. Für unmittelbare Feedbacks sind Seleniumtests
   eher ungeeignet. Mit dem Grundsatz "Weniger ist mehr" und einer
   Parallelisierung der Testausführung kann diesem Nachteil entgegegen
   gewirkt werden.

## Übungen vorbereiten

Um die Übungen durführen zu können, muss ein lokaler Server auf Port
8000 laufen. 

```
C:\...>"Acceptance Test Tutorial\env\Scripts\python.exe" -m http.server
Serving HTTP on 0.0.0.0 port 8000 (http://0.0.0.0:8000/) ...
```

# Übungen

* [Beispiel 1: Erster Selenium Test](Beispiel1.md)
* [Beispiel 2: Debugging von Robot Tests](Debugging.md)
* [Beispiel 3: Selektoren](Selektoren.md)
* [Beispiel 4: Formulare](Formulare.md)
* [Beispiel 5: Typische Probleme](TypischeProbleme.md)
* [Beispiel 6: Dynamische Seiten](DynamischeSeiten.md)
* [Beispiel 7: Knacknüsse - iFrames, WYSIWYG, etc.](KnackNuesse.md)
* [Beispiel 8: Robot Erweiterungen](RobotExtensions.md) 
* [Anhang 1: Dokumentation](Documentation.md)

[0]: https://gitlab.fhnw.ch/web/acceptancetest-tutorial
[1]: https://docs.microsoft.com/en-us/visualstudio/python/python-environments
[2]: https://sites.google.com/a/chromium.org/chromedriver/
[3]: http://www.seleniumhq.org/projects/ide/
[4]: https://seleniumhq.wordpress.com/2017/08/09/firefox-55-and-selenium-ide/
[5]: http://robotframework.org/