Skip to content

Latest commit

 

History

History

e2e

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
CheckCreateUser.php
CheckCreateUser.php
 
 
README.md
README.md
 
 

README.md

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:https://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:https://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