Read Me

================= Business Process Emulator (BPE) ==========================
It is an academic software developed by the University of Trento as part of
Ianus Project. The main idea of the software is provide
a flexible and powerful software tool to perform functional testing of 
service-oriented business processes. The software includes a plugin for 
Signavio process modeler editor, a Google Sheet template and a web-service
process emulator engine.
More info about its functionlities can be found in this short video:
http://www.youtube.com/watch?v=rWS9FPUs_WQ

author: Jorge Saldivar Galli
email: jorgesaldivar@gmail.com
======================================================================

==================== INSTALLATION ====================

A. == Google Sheet Plugin
1. Follow this instructions 
https://developers.google.com/drive/service-accounts#google_apis_console_project_service_accounts
to create a Google APIs console project service accounts.
2. Upload to Google Drive the spreadsheet template located in DIRECTORY_BPE/conf/resources/Template.xlsx
3. Open the template as a Google Sheet (right click over the document -> open with -> Google Sheet
4. Click on Tools -> Script editor...
5. Copy and paste the content of DIRECTORY_BPE/conf/resources/DoEmulation.gs into new script.

B. == BPE Database
1.Download MySQL community server from here http://www.mysql.com/downloads/mysql
2.Install MySQL and run the server
3.Running the following command: 
`mysql -u username -ppassword -h localhost databasename <event_log.sql` apply 
the database schema located in BPE_DIRECTORY/conf/resources/log/

D. == BPE Configuration
In BPE_DIRECTORY/conf/application.conf file change the values of
1. db.default.url, db.default.user, db.default.password according to the 
URL, username and password of the database set up before.
2. server.host.url, server.host.port according to the URL and port of the server
in which BPE will run.
3. gdrive.spreadsheettemplate.id according to the ID of the spreadsheet template.
The ID is the set of characters located after 'key=' in the URL of the 
spreadsheet template.
4. gdrive.accountemail according to the email address obtained from the step A.1.

D. == BPE Execution
1.Download the Play! framework from http://www.playframework.com/download and
unzip it into some directory.
2. From BPE_DIRECTORY execute the command `PLAY_FRAMEWORK_DIRECTORY/play run`

F. == Signavio Plugin
1. Execute the command 
`svn checkout http://signavio-core-components.googlecode.com/svn/trunk/ signavio`
2. Follow the following instruction to install it 
https://code.google.com/p/signavio-core-components/wiki/InstallationInstructions
3. Copy the file BPE_DIRECTORY/conf/resources/signavio_plugin/emulator.js to SIGNAVIO_DIR/editor/src/scripts/Plugins/
4. Copy the file BPE_DIRECTORY/conf/resources/signavio_plugin/BPMNHandler.java to SIGNAVIO_DIR/platform/src/com/signavio/warehouse/model/handler/
5. In SIGNAVIO_DIRECTORY execute the command `patch -p0 -i BPE_DIRECTORY/conf/resources/signavio_plugin/bpe_plugin.diff` 
6. Copy the files BPE_DIRECTORY/conf/resources/signavio_plugin/ajax-loader.gif BPE_DIRECTORY/conf/resources/signavio_plugin/tick.png and BPE_DIRECTORY/conf/resources/signavio_plugin/table_gear.png to SIGNAVIO_DIR/editor/src/images/
5. In SIGNAVIO_DIRECTORY execute the command `ant build-and-deploy-all-in-one-war-to-tomcat`
6. When the previous command finished you can access signavio at http://SERVER_URL:TOMCAT_PORT/signavio