[[TOC(heading=User tests)]]
[[TOC(heading=Omgeving, sectionindex, compact, depth=3, allactive, Documentatie/Ontwikkelaar/Omgeving/)]]
[[TOC(heading=Ontwikkelaar, sectionindex, compact, depth=2, allactive, Documentatie/Ontwikkelaar/)]]
[[TOC(heading=Documentatie, sectionindex, compact, depth=1, allactive, Documentatie/)]]

= User tests =

[[NoteBox(warn, Dit is informatie over work-in-progress naar aanleiding van ticket #8500. Hier worden de bevindingen en bedenkingen over de beschikbare tools opgesteld.)]]

== Sikuli ==

Met Sikuli ([http://www.sikuli.org/ origineel] en [http://www.sikulix.com/ courant]) kunnen user-interacties gescript worden op basis van screenshots. Het Sikuli-systeem kan met image-herkenning op het scherm de user-interface aansturen via kliks en tekst-invoer. Sikuli-scripts worden in Python geschreven; de driver/runtime is Java / Jython.

In de beheer repository zitten interacties met het medewerkerscherm en met het relatiescherm.

=== Pro ===

 - Image-driven, 
 - Meegeleverde IDE kan goed helpen om test-interacties samen te stellen
 - Python scripting (dus ook OpenAC-functies kunnen worden gebruikt)

=== Con ===

 - Image-driven betekent dat het ook gevoelig is voor dingen als veranderingen van lettergrootte, Windows-themes, enz.
 - Image-driven betekent dat de screenshots niet gedeeld kunnen worden tussen Linux en Windows (Gtk vs Windows widgets).

= Installatie =
Zorg dat je minstens Java 8 geïnstalleerd hebt. Download het bestand `sikulix.jar` van de [http://www.sikulix.com/ Sikuli website] en plaats dit ergens vanwaar je het op zal starten.

Installeer [https://www.jython.org/download Jython] en onthoud waar het staat. Dubbelklik de Sikuli jar of draai `java -jar sikuli.jar` om Sikuli te starten. Wanneer het voor het eerst start kan het zo zijn dat Jython niet gevonden wordt. Kies dan in het menu Bestand > Open Special Files en in het dialoogvenster voor 2 (Extensions). Pas de regel met `jython = ...` aan zodat het geen commentaar is en naar de Jython installatie locatie verwijst.

= Tests draaien =
**Let op, om de tests te draaien moet je eerst zorgen dat config.ini aangepast is en naar de mappen van de tests gekopieerd is.**

Sikuli kan gestart worden door de IDE te openen waarna je de python bestanden in de mappen opstarten.sikuli, dossier_invoeren.sikuli en relatie_invoer.sikuli kan openen en uitvoeren.

Een Sikuli script kan ook vanaf de opdrachtregel gestart worden: `java -jar sikulix.jar -r beheer\sikuliscripts\opstarten`

Tip: draai Sikuli op je hoofd beeldscherm. Dit kan het scherm van je laptop zijn als er nooit iets gewijzigd is. Je kan het via Windows instellingen nagaan.
Tip: wanneer Sikuli niets lijkt te doen, beweeg dan heel even een beetje met de muis.