OSWorkflow Documentation

Transcription

1 OSWorkflow Documentation Update Time: 05/09/15 OSWorkflow Java workflow engine API 理 flow 行 XML 來 流 Database UI 不 流 GUI Designer end user 行 JSP+Servlet 行 OSWorkflow 2.8 說 了 OSWorkflow library library OSCore PropertySet 1.2+ Jakarta commons-logging BeanShell (optional) BSF (optional) EJB interfaces (not neccesarily an EJB container) XML parser (Not required for JDK 1.4) PS OSWorkflow JDK 1.3+ libraries zip Download 不 行 OSWorkflow servlet container 來 行 Tomcat Tomcat tomcat 4.1.x binary 來 不 行 bin/ startup script tomcat 了 連 tomcat 2. OSWorkflow OSWorkflow OSWorkflow osworkflow-2.x.0-example.war $TOMCAT_HOME/webapps tomcat $TOMCAT_HOME/webapps 料 osworkflow-2.x.0-example $TOMCAT_HOME/webapps/OSWorkflow example/WEB-INF/lib activation.jar

2 commons-logging.jar oscore jar osworkflow jar quartz.jar bsh-1.2b7.jar mail.jar osuser-1.0-dev-3dec03.jar propertyset apr04.jar WEB-INF/lib $TOMCAT_HOME/common/lib servlet.jar WEB-INF/lib 來 workflow xml implement 行流 class 行 workflow 了 流 理 Persistence Storage 來 流 OSWorkflow 了 MemoryStore ( 不 Storage memory ) SerializableStore JDBCStore OfbizStore EJBStore implement OSWorkflow API WorkflowStore interface MemoryStore OSWorkflow workflow 來 行 行 句 說 OSWorkflow step flow 行 workflow instance step(s) flow step 行 action 來 step workflow engine OSWorkflow 易 來 flow 流 result 行 step status OSWorkflow Underway Queued Finished status 來 step OSWorkflow 數 (id) 來 類 workflow instances steps actions results id 不 id 來 workflow workflow 說

3 External Function flow 行 說 更 料 external function 來 理 step action external function 不 pre-function post-function 行 function step action external function external function java-based functions beanshell function BSF function(perl script, vbscript, javascript) utility function document 更 說 Split & Join Split Join flow flow 行 flow flow 行 OSWorkflow split join target result 了 連 step 連 split join split join 更 說 result 連 split uncondtional results results 流 行 split current steps split 例來 行 來 result 連 不 steps join results 洞 result 連 join 不 什 Join join condition 立 立 行 join result condtion 來 steps status Validators Validator action input 料 行 action 不 InvalidInputException Exception Conditon Condition boolean condition AND OR 來 conditional result condition function java-based class beanshell script local EJB remore EJB OSWorkflow 了 condition AllowOwner initial-action 不 conditional result OSWorkflow bug forum 來 不 2.8 不 更

4 OSWorkflow workflow 行 例說 更 OSWorkflow 念 demo 例說 OSWorkflow workflow WEB-INF/classes/osworkflow.xml 了 1 <persistence class="com.opensymphony.workflow.spi.memory.memoryworkflowstore"/> 2 <factory class="com.opensymphony.workflow.loader.xmlworkflowfactory"> 3 <property key="resource" value="workflows.xml" /> 4 </factory> 5 </osworkflow> 1 3 行 1 行 什 persistence storage 裡 memory 3 行 workflow 錄 workflow.xml workflow.xml 裡 了 1 <workflows> 2 <workflow name="buy" type="resource" location="buy.xml"/> 3 </workflows> 裡 了 workflow 2 行 buy.xml workflow buy workflow 利 buy.xml workflow demo workflow 說 demo 流

5 來 buy.xml 1 <?xml version="1.0" encoding="utf-8"?> 2 <!DOCTYPE workflow PUBLIC "-//OpenSymphony Group//DTD OSWorkflow 2.8//EN" 3 " 4 <workflow> 5 <meta name="created">wed Sep 14 22:50:03 CST 2005</meta> 6 <meta name="lastmodified">wed Sep 14 23:01:15 CST 2005</meta> 7 <meta name="generator">osworkflow Designer</meta> 類 來 流 流 狀 不 流 <initial-actions> 8 <initial-actions> 9 <action id="0" name="but tickets and meals"> action <pre-functions> step 行 com.opensymphony.workflow.util.caller class workflow ${caller} 數 action id 不 10 <pre-functions> 11 <function name="set.caller" type="class"> 12 <arg name="class.name">com.opensymphony.workflow.util.caller</arg>

6 13 </function> 14 </pre-functions> <result> action old-status 來 狀 什 Finished step action step id uncondition-result 行 action 便 step id 1 Clerk-Ask step 15 <results> 16 <unconditional-result id="5" old-status="finished" status="queued" step="1" owner="${caller}"/> 17 </results> 18 </action> 19 </initial-actions> 20 <steps> 21 <step id="1" name="clerk-ask"> 22 <actions> 23 <action id="6" name="otherwise, pay the bill" view="clerk-ask"> 24 <pre-functions> 25 <function name="set.caller" type="class"> 26 <arg name="class.name">com.opensymphony.workflow.util.caller</arg> 27 </function> 28 </pre-functions> beanshell conditiion 來 不 step 2 行 uncondition result step 3 29 <results> 30 <result id="8" old-status="finished" status="queued" step="2" owner="${caller}" display-name="if buy any m 31 <conditions type="and"> 32 <condition name="bsh.condition" type="beanshell"> 33 <arg name="script"> 34 <![CDATA[propertySet.getLong("numberMealA")!=0 propertyset.getlong("numbermealb")!=0 35 propertyset.getlong("numbermealc")!=0]]>

7 36 </arg> 37 </condition> 38 </conditions> 39 </result> 40 <unconditional-result id="7" old-status="finished" status="queued" step="3" owner="${caller}"/> 41 </results> 42 </action> 43 </actions> 44 </step> unconditional-result step 3 45 <step id="2" name="kitchen-cook"> 46 <actions> 47 <action id="9" name="pay the bill" view="kitchen-cook"> 48 <pre-functions> 49 <function name="set.caller" type="class"> 50 <arg name="class.name">com.opensymphony.workflow.util.caller</arg> 51 </function> 52 </pre-functions> 53 <results> 54 <unconditional-result id="10" old-status="finished" status="queued" step="3" owner="${caller}"/> 55 </results> 56 </action> 57 </actions> 58 </step> 了 step 3 uncondition-result 行 action 便 step 4 ( end step ) 59 <step id="3" name="clerk-pony"> 60 <actions> 61 <action id="11" name="end the flow" view="clerk-pony"> 62 <pre-functions> 63 <function name="set.caller" type="class"> 64 <arg name="class.name">com.opensymphony.workflow.util.caller</arg> 65 </function>

8 66 </pre-functions> 67 <results> 68 <unconditional-result id="12" old-status="finished" status="queued" step="4" owner="${caller}"/> 69 </results> 70 </action> 71 </actions> 72 </step> 73 <step id="4" name="end"> 74 </step> 75 </steps> 76 </workflow> workflow 不 osworkflow 流 不 料 API 便 列 參數 參數 參數 來 數

9 立 來 來 例 不 來 參數 欄 數 來 料 例 數 來 料 例 workflow xml 易 GUI designer GUI Designer GUI designer java 行 disigner 1.4+ JVM snapshot

10 deisgner FSM(Finite State Machine) step state result transition function workflow GUI designer 不 類 OSWorkflow Step Action Result designer 兩 來 易 例來 藍 (step) function step action 裡 action action 更 xml 陋 不 designer step action result 連 什 conditional result condition ok function split join 不 demo workflow designer 易 理 來 designer validator step 連 condition validate 料 & workflow 了

11 念 利 來 立 例 例 例 念 領