You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
93 lines
2.5 KiB
93 lines
2.5 KiB
2 years ago
|
# 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
|
||
|
|
|
||
|
|
|