INTRO

$Id: README 237 2006-07-07 12:42:31Z jonasbn $

The 'Workflow' Perl module implements a standalone workflow system. It aims to be simple but flexible and therefore powerful. Each piece of the workflow system has a direct and easily stated job, and hopefully you'll find that you can put the pieces together to create very useful systems.

Read 'perldoc Workflow' for a more detailed introduction, sample usage, interactions with your applications, and more.

INSTALLATION

To install this module type one of the following:

perl Makefile.PL or perl Build.PL

 make                   ./Build
 make test              ./Build test
 make install           ./Build install

QUICK START

The eg/ticket/ directory contains a configured workflow system. You can access the same data and logic in two ways:

To initialize:

perl ticket.pl --db

To run the command-line application:

perl ticket.pl

To access the database and data from CGI, add the relevant configuration for your web server and call ticket.cgi:

http://www.mysite.com/workflow/ticket.cgi

To start up the standalone web server:

perl ticket_web.pl

(Barring changes to HTTP::Daemon and forking the standalone server won't work on Win32; use CGI instead, although patches are always welcome.)

For more info, see 'eg/ticket/README'

MORE INFO

Questions, comments, ideas? E-mail them:

Chris Winters <chris@cwinters.com>

When we get them, issues (tasks, feature requests, bugs) are tracked via CPAN's RT at:

https://rt.cpan.org/NoAuth/Bugs.html?Dist=Workflow

When it gets big enough, the Workflow home page will be at:

http://workflow.openinteract.org/

You can see the slides of a talk 'Workflows in Perl' given to the Pittsburgh Perlmongers in October 2004:

http://www.cwinters.com/pdf/workflow_pgh_pm.pdf

DEPENDENCIES

This module requires these other modules and libraries:

Class::Accessor
Class::Factory
Class::Observable
DateTime
DateTime::Format::Strptime
DBD::Mock
Exception::Class
Log::Dispatch
Log::Log4perl
Safe

Test::More
XML::Simple

Other optional modules include:

Data::UUID
DBI (plus a relevant DBD)
SPOPS

For the sample application you'll also need:

CGI
CGI::Cookie
DBD::SQLite
HTTP::Daemon
HTTP::Request
HTTP::Response
HTTP::Status
Template (Template Toolkit)

(For Win32 systems you can get the Template Toolkit and DBD::SQLite PPDs from TheoryX:
http://theoryx5.uwinnipeg.ca/cgi-bin/ppmserver?urn:/PPMServer58)

COPYRIGHT AND LICENCE

Copyright (c) 2003-2006 Chris Winters and Arvato Direct. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.