Skip to content

Latest commit

 

History

History
197 lines (160 loc) · 11.7 KB

README.md

File metadata and controls

197 lines (160 loc) · 11.7 KB
Raw

betsy (BPEL/BPMN Engine Test System)

Dependency Status Coverage Status

Betsy is a tool to check the degree of conformance of a BPEL/BPMN engine against the BPEL/BPMN standard.

This software is licensed under the LGPL Version 3 Open Source License!

Releases

Software Requirements

  • Windows 7
  • JDK 1.8.0_05 (64 Bit) or higher
    • JAVA_HOME should point to the jdk directory
    • PATH should include JAVA_HOME/bin
  • JDK 1.7.X
    • JAVA7_HOME should point to the jdk directory (needed to exectue older engines not supporting Java 8)

Licensing

LGPL Version 3: http://www.gnu.org/licenses/lgpl-3.0.html

Usage

Requirements (see above) have to be fulfilled to execute betsy on the command line with the configuration from config.properties.

BPEL

usage: betsy [OPTIONS] <ENGINES> <PROCESSES>

Options:
 -b,--build-only                     Builds only the artifacts. Does
                                     nothing else.
 -c,--check-deployment               Verifies deployment instead of test
                                     success
 -e,--use-external-partner-service   Use external partner service instead
                                     of internal one
 -h,--help                           Print usage information.
 -o,--open-results-in-browser        Opens results in default browser
 -p,--partner-address <arg>          Partner IP and Port (defaults to
                                     localhost:2000)
 -t,--to-core-bpel <arg>             Transform to Core BPEL
 -f,--use-custom-test-folder <arg>   Use a custom test folder (folder name defaults to "test")

GROUPS for <ENGINES> and <PROCESSES> are in CAPITAL LETTERS.
<ENGINES>: [ALL, LOCALS, VMS, RECENT, ode__1_3_5, ode__1_3_6,
ode__1_3_5__in-memory, ode__1_3_6__in-memory, openesb__2_2, openesb__2_3,
openesb__2_3_1, openesb__3_0_1, openesb__3_0_5, orchestra__4_9,
activebpel__5_0_2, petalsesb__4_0, petalsesb__4_1, bpelg__5_3,
bpelg__5_3__in-memory, wso2__3_2_0, wso2__3_1_0, wso2__3_0_0, wso2__2_1_2,
ode__1_3_5__virtual, bpelg__5_3__virtual, openesb__2_2__virtual,
petalsesb__4_0__virtual, orchestra__4_9__virtual,
activebpel__5_0_2__virtual, ode, bpelg, wso2, petalsesb, active_bpel,
orchestra, openesb]

<PROCESSES>: [ALL, BASIC_ACTIVITIES_WAIT, BASIC_ACTIVITIES_THROW,
BASIC_ACTIVITIES_RECEIVE, BASIC_ACTIVITIES_INVOKE,
BASIC_ACTIVITIES_ASSIGN, BASIC_ACTIVITIES, SCOPES_EVENT_HANDLERS,
SCOPES_FAULT_HANDLERS, SCOPES, STRUCTURED_ACTIVITIES_FLOW,
STRUCTURED_ACTIVITIES_IF, STRUCTURED_ACTIVITIES_FOR_EACH,
STRUCTURED_ACTIVITIES_PICK, STRUCTURED_ACTIVITIES, CONTROL_FLOW_PATTERNS,
STATIC_ANALYSIS, SA00019, SA00018, SA00017, SA00012, SA00056, SA00011,
SA00055, SA00010, SA00054, SA00053, SA00016, SA00015, SA00059, SA00014,
SA00058, SA00013, SA00057, SA00063, SA00062, SA00061, SA00060, SA00023,
SA00067, SA00022, SA00066, SA00021, SA00065, SA00020, SA00064, SA00025,
SA00069, SA00024, SA00068, SA00070, SA00072, SA00071, SA00034, SA00078,
SA00077, SA00032, SA00076, SA00037, SA00036, SA00035, SA00079, SA00081,
SA00080, SA00085, SA00084, SA00083, SA00082, SA00008, SA00007, SA00006,
SA00001, SA00045, SA00089, SA00044, SA00088, SA00087, SA00086, SA00005,
SA00048, SA00003, SA00047, SA00002, SA00046, SA00092, SA00091, SA00090,
SA00052, SA00051, SA00095, SA00050, SA00093, FAULTS, ERRORS, ...]

# Examples
$ betsy bpel # Running all tests for all engines
$ betsy bpel ode # Running all tests for Apache ODE
$ betsy bpel ode,bpelg # Running all tests for Apache ODE and bpel-g
$ betsy bpel ALL Sequence # Running Sequence test for all engines
$ betsy bpel ALL Sequence,While # Running Sequence and While test for all engines
$ betsy bpel ode Sequence # Running Sequence test for Apache ODE
$ betsy bpel ode Invoke-Catch # Running Invoke-Catch test for Apache ODE
$ betsy bpel -t sequence.xsl,pick.xsl ode_v # Running all tests for the virtualised Apache ODE with sequence.xsl and pick.xsl CoreBPEL transformations
$ betsy bpel -o # Opens the results in the default browser after a successful run

BPMN

usage: betsy bpmn [OPTIONS] <ENGINES> <PROCESSES>

Options:
 -b,--build-only                Builds only the artifacts. Does nothing
                                else.
 -h,--help                      Print usage information.
 -o,--open-results-in-browser   Opens results in default browser

GROUPS for <ENGINES> and <PROCESSES> are in CAPITAL LETTERS.
<ENGINES>: [ALL, camunda__7_0_0, camunda__7_1_0, camunda__7_2_0,
camunda__7_3_0, activiti__5_16_3, activiti__5_17_0, activiti__5_18_0,
activiti__6_0_0_beta1, jbpm__6_0_1, jbpm__6_1_0, jbpm__6_2_0, jbpm__6_3_0,
activiti, jbpm, camunda]


<PROCESSES>: [ALL, GATEWAYS, ACTIVITIES, ERRORS, EVENTS, BASICS, DATA,
PATTERNS, MINIMAL, ExclusiveGateway, ExclusiveGateway_Default,...]

Administrative Tasks

$ gradlew idea # Generating Intellij IDEA project files
$ gradlew eclipse # Generating Eclipse project files
$ gradlew groovydoc # Generating GroovyDoc
$ gradlew enginecontrol # Opens a Swing GUI that allows to install, start and stop supported engines

Downloads

From public subversion directory https://lspi.wiai.uni-bamberg.de/svn/betsy/

Project Structure

downloads/ # downloads of the engines
server/ # engine installation directory
test/ # execution results and reports
src/main/tests/configuration/[standard]/ # the test configuration
src/main/tests/files/[standard]/ # the test files
src/main/xslt/[standard]/[engine/] # common and engine specific xslt scripts
src/main/resources/[standard]/[engine/] # common and engine specific xsds and other resources
src/main/groovy # the main source code
src/main/java # mock web service implementation

# for BPMN
maven/ # Maven
jbpmdependencies/ # Dependencies for jBPM
jbpmdeployer/ # jars to deploy a process to jBPM

# for BPEL
ant/ # Apache Ant
soapui/ # soapUI

Test Structure

test/
test/reports/
test/reports/html/ # html junit reports
test/$engine/
test/$engine/$process/
test/$engine/$process/process/
test/$engine/$process/reports/
test/$engine/$process/logs/

BPEL structure
test/$engine/$process/pgk/ # deployable zip files
test/$engine/$process/soapui/ # soapUI test suite
[test/$engine/$process/binding/ # binding package]
[test/$engine/$process/composite/ # composite package]

BPMN structure
test/$engine/$process/testSrc/ # source java files for the test
test/$engine/$process/testBin/ # class files for the test
[test/$engine/$process/war/ # the files for the war file]

Authors (in alphabetical order)

Adrian Bazyli, Annalena Bentele, Mathias Casar, Matthias Geiger, Simon Harrer, Christian Kremitzl, Joerg Lenhard, Lea-Louisa Maaß, Frederik Müller, Christian Preißinger, Cedric Röck , Severin Sobetzko and Andreas Vorndran

Publications

The following scientific publications are either about betsy, have used betsy to present benchmarks or use and build upon data obtained through betsy:

Contribution Guide

  • Fork
  • Send Pull Request