= ruote-rest
 
A RESTful instance of OpenWFEru (ruote) powered by Sinatra (http://sinatrarb.com)
 
 
== getting it
 
To get Ruote and Ruote-Rest :
 
    git clone git://github.com/jmettraux/ruote-rest.git
 
Then
 
    cd ruote-rest 
    rake install_workflow_engine
 
( or get a prepackaged release of ruote + ruote-rest at http://rubyforge.org/frs/?group_id=2609 )
 
To prepare the development database
 
    rake recreate_mysql_db
 
Expects a mysql db with a 'root' admin account with sufficient access rights. 
It will create a database named "ruoterest_development".
 
(
To prepare the test database
 
    rake recreate_mysql_db stage=test
 
To prepare the dev database with the admin 'toto'
 
    rake recreate_mysql_db dbadmin=toto
)
 
 
== starting it
 
    bin/start
 
 
Then head to
 
    http://localhost:4567/processes
 
 
== interface
 
By default, XML representations will be returned. The 'Accept' header is used 
to determine which representation the client expects. 
 
The 'format' query parameter can be used to override that, like in
 
     GET /processes?format=json
 
For debugging purposes, you can force to a text/plain content type 
with 'plain' :
 
    GET /workitems?format=json&plain=true
 
 
=== /processes
 
GET /processes
 
    lists all the [business] processes currently running in the engine
 
 
POST /processes
 
    launches a new process instance
 
 
GET /processes/{wfid}
 
    returns the detailed status of a given process instance
 
 
GET /processes/{wfid}/representation
 
    returns the JSON representation of the current process instance tree
 
 
DELETE /processes/{wfid}
 
    cancels a business process instance
 
 
=== /expressions
 
GET /expressions/{wfid}
 
    returns all the expressions of a business process instance
 
 
GET /expressions/{wfid}/{expid}
 
    returns one expression
 
 
GET /expressions/{wfid}/{expid}?format=yaml
 
    returns the YAML representation of an expression
    (note that using the Accept header is the best way to do that)
 
 
PUT /expressions/{wfid}/{expid}
 
    updates an expression, live. Expects a YAML version of the expression
 
 
DELETE /expressions/{wfid}/{expid}
 
    cancels one expression
 
 
=== /workitems
 
GET /workitems
 
    lists all the workitems 
 
GET /workitems/{wid}
 
    returns a workitem
 
GET /workitems?wfid=x
 
    returns all the workitems belonging to a [business] process instance
 
PUT /workitems/{wid}
 
    updates a workitem
    If the workitem field '_state' is set to 'proceeded' the workitem will 
    resume its travel in its business process
 
 
== configuration
 
conf/db.rb
 
    database configuration
 
conf/engine.rb
 
    engine configuration
 
conf/participants.rb
conf/participants_development.yaml
 
    participants configuration, the yaml file holds the list of 
    'active participants' (the worklist in fact).
 
 
== license
 
BSD
 
 
== feedback
 
http://groups.google.com/group/openwferu-users