openemr/tests/e2e

Selenium + PHPUnit Test OpenEMR

Author: Sharon Cohen, Oleg Sverdlov

This is a guide on how to install and run a simple selenium test (using phpunit) to the Open EMR system.

This is just a sample test (and simple one).

The example test includes:

• Open the browser and go to local OpenEMR installation
• Login with default admin credentials
• Go to New patient form
• Add a new patient with random names(string) and DOB
• Accept the creation of the new patient
• Check the database that this patient exist in the table patient_data
• Close the browser

Things to improve:

To have a complete set of test they should include:

• Login failure
• Validation test when creating a new patient
• Checking the existence/inexistence of clinical reminders according to personal configuration

Installation:

The test works for OpenEMR installed on local computer. You'll need Chrome browser :) (Note that with a simple code change, there is also the option of using the Firefox browser)

Install Composer and packages

If you don't have Composer refer to https://getcomposer.org/download/

From OpenEMR folder install phpunit and phpunit-selenium via composer

composer require --dev phpunit/phpunit
composer require --dev phpunit/phpunit-selenium

(depending on how you installed Composer you may need to run php composer.phar )

Install Browser driver

To use Chrome as a test Browser download the driver from here: https://sites.google.com/a/chromium.org/chromedriver/downloads

Move the downloaded file to an executable directory

sudo mv chromedriver /usr/local/bin/ 

sudo chmod 755 /usr/local/bin/chromedriver

Install Selenium server

Download standalone selenium server from here: http://docs.seleniumhq.org/download/

Download and install JRE. You can get JRE from java.com or from your Linux distro repositories. Check you can run it:

java -version

Running tests

*never run the tests on production database!

First, run Selenium server in separate process

java -jar selenium-server-standalone-<version>.jar

Then, run the test:

./vendor/bin/phpunit Tests/selenium/CheckCreateUser.php

References:

https://getcomposer.org/download/

https://phpunit.de/manual/current/en/installation.html

https://sites.google.com/a/chromium.org/chromedriver/downloads

http://docs.seleniumhq.org/download/

https://www.sitepoint.com/using-selenium-with-phpunit/

https://phpunit.de/manual/3.7/en/selenium.html

https://phpunit.de/manual/current/en/database.html