osworkflow学习笔记-标签<initial-actions>、<restrict-to>、beanshell、class

关键字：osworkflow 入门教程， 初体验，环境搭建，示例，笔记，用法，标签 含义 释义。。。。。。

 

打开osworkflow-2.8.0\src\webapp\WEB-INF\classes\example.xml

看看这些的标签：

<initial-actions>
<action id="100" name="Start Workflow">
<restrict-to>
<conditions type="AND">
<condition type="beanshell">
<arg name="script">true</arg>
</condition>
<condition type="class">
<arg name="class.name">com.opensymphony.workflow.util.OSUserGroupCondition</arg>
<arg name="group">foos</arg>
</condition>
</conditions>
</restrict-to>
<pre-functions>
<function type="class">
<arg name="class.name">com.opensymphony.workflow.util.Caller</arg>
</function>
</pre-functions>
<results>
<unconditional-result old-status="Finished" status="Underway" step="1" owner="${caller}"/>
</results>
</action>
</initial-actions>

 
1  initial-actions：

一组初始动作，在工作流实例被赋予任何状态之前执行，每個流程都至少需定義一個initial-actions，這是流程的起點,初始化步骤是一种特殊类型的步骤，它用来启动工作流。在一个工作流程开始前，它是没有状态，不处在任何一个步骤，用户必须采取某些动作才能开始这个流程。这些特殊步骤被定义在 <initial-actions>。

可以用来定义通用动作(common action)和全局动作(global action)。

我们再看看example.xml的 initial-actions里干了啥：

首先定义了一个约束restrict-to,约束里有两个AND
关系的条件，然后用pre-funcitons取出当前用户名，传给step1
。

 

2 condition type="beanshell"

：

在beanshell

表达式范围内中始终存在三个变量，entry、context和store。entry变量是一个实现了com.opensymphony.workflow.spi.WorkflowEntry接口的对象，它代表workflow实例。context变量是com.opensymphony.workflow.WorkflowContext类型的对象，它允许BeanShell方法回滚事务或决定调用者的名字。store变量是com.opensymphony.workflow.WorkflowStore类型的对象，它允许方法访问workflow底层的持久化存储区。

另外beanshell


是一种脚本语言，一种完全符合java语法的java脚本语言

我们再看看example.xml的
beanshell


里干了啥： 直接返回true，啥也没干，这里应该可以做一些稍复杂的判断

 

3  condition type="class"

：能够调用一些实现了com.opensymphony.workflow.FunctionProvider接口的
外部类，这个接口只有一个方法——execute，这个方法有三个参数transientVars, args和propertySet可用
，通过这三个参数能获取或编辑当前工作流里的很多信息。

<condition type="class">

       <arg name="class.name">com.opensymphony.workflow.util.OSUserGroupCondition</arg>

       <arg name="group">foos</arg>

</condition>

这是一个条件语句，意思是：判断当前执行改流程的用户在不在group组（foos是组的名字）中，是执行什么流程，不是执行什么流程。

 

参考：http://baixiaozhe.iteye.com/blog/753603
关于权限


         http://baixiaozhe.iteye.com/blog/753587关于class

 

4 <pre-functions>：

在事情发生之前执行的函数和它相对应是post-functions就是在事情发生以后执行的。

    这里是获取到当前用户名，并放到临时变量caller中。

5 unconditional-result

：

对于每一个动作，都需要存在一个无条件结果，叫做unconditional-result。这个结果只不过是一些指令，告诉OSWorkflow下一步要做什么。这一结果让组成工作流的状态机从一个状态流转到下一个状态。

 

<unconditional-result old-status="Finished" status="Underway" step="1" owner="${caller}"/>

大概意思就是这一步已经完事，已经不在是当前动作了
，所以上一步
的状态为Finished， 当前流程
状态为"办理中"即Underway，现在已经到step1去了，带过去的参数是ower，即当前用户