WorkflowService (Eaching-all 3.7 API)

All Superinterfaces:: IBase<Workflow>, IBaseService<Workflow>

public interface WorkflowService
extends IBaseService<Workflow>

Method Summary

All Methods Instance Methods Abstract Methods Deprecated Methods
Modifier and Type	Method and Description
`java.util.List<StepInfo>`	`getBackStepsById(java.lang.String stepid)` Deprecated.
`java.util.List<StepInfo>`	`getBeforeStepListById(java.lang.String stepid)` 获取指定节点的所有之前的节点列表
`StepInfo`	`getFirstStep(java.lang.String workflowid)`
`java.util.List<StepInfo>`	`getLastSteps(java.lang.String workflowid)`
`java.util.List<Workflow>`	`getListForPermissionQuery(java.util.Map<java.lang.String,java.lang.Object> whereMap)` 查询返回有编辑权限的工作流,以第一个节点的工作流为主
`java.util.List<WfRequest>`	`getMyRequest()` 获取我的流程请求
`java.util.List<WfRequest>`	`getMyRequest(int wfStatus)` 按状态获取我的流程请求
`java.util.List<WfRequest>`	`getMyRequest(java.lang.String workflowId, int wfStatus)` 按状态获取我的流程请求
`StepOperator`	`getOperatorById(java.lang.String operatorId)`
`StepInfo`	`getStepInfoById(java.lang.String stepId)`
`java.util.List<StepInfo>`	`getStepInfoList(java.lang.String workflowid)` 获取指点工作流的所有节点对象
`java.util.List<StepOperator>`	`getStepOperatorList(java.lang.String stepid)` 获取指点节点的操作者列表
`StepPath`	`getStepPathById(java.lang.String stepPathId)`
`java.util.List<StepPath>`	`getStepPathBySourceId(java.lang.String stepid)`
`java.util.List<StepPath>`	`getStepPathByTagetId(java.lang.String stepid)`
`java.util.List<StepPath>`	`getStepPathList(java.lang.String workflowid)` 获取指定工作流的所有流转路径
`java.lang.String`	`getWorkflowNameByid(java.lang.String workflowids)`
`WfRequest`	`newRequest(java.lang.String wfId)`
`java.lang.String`	`processDebugWorkflowProcess(IWorkflowProcess process, WfRequest req, java.lang.String eventName, java.util.Map<java.lang.String,java.lang.Object> initParams)` 调试工作流接口处理器,调试时不调用getClientScript()和doClientAction()方法而setRequest()和init()方法总是执行
`int[]`	`processPermissionByFinish(WfRequest request, boolean isDelForward, java.lang.String stepIds, int agentAction, int supervisorPermit)` 重构指定归档流程的权限,不修改操作者.如果非归档流程直接返回0,请调用processPermissionByRunning(...). 代理人员的权限重构，是根据操作者列表中的接收日期是否存在代理配置如果历史数据有代理配置，而之后代理人员配置删除的话，则不会产生权限
`int[]`	`processPermissionByRunning(WfRequest request, boolean isDelForward, java.lang.String stepIds, int agentAction)` 重构正在流转的流程,重构操作者.如果已请归档,请调用processPermissionByFinish(...)方法代理人员的权限重构，是根据操作者列表中的接收日期是否存在代理配置如果历史数据有代理配置，而之后代理人员配置删除的话，则不会产生权限
`java.lang.String`	`processWfOldGraph(Workflow wf)`
`int`	`removeStepOperator(StepOperator oper)` 删除操作者，当初始节点时，需要删除初始节点的工作流类型的权限记录，这样对应的人员就没有创建流程的权限，已创建的流程不能提交，已流转的流程则不影响当是开始节点时，需要对所有处于第一个节点（当前节点）状态的且非退回的流程进行无法提交的处理操作，需要再次申请（才能确定当前人有没有新的创建权限）一个流程才行。其他节点不能删除，不然流程其他节点的历史流程权限和监控权限也会没有导致无法查看。
`int`	`saveAndCopyWorkflow(Workflow wf, java.lang.String oriWfid)` 将复制得到的wf保存，并将根据原工作流oriWfid生成流程图和节点
`int`	`SaveWorkflowStep(Workflow wf, net.sf.json.JSONObject stepInfoObject)` Deprecated.
`java.util.Map<java.lang.String,java.lang.Object>`	`SaveWorkflowStep(Workflow wf, java.lang.String xml, java.lang.String steps, java.lang.String paths, java.lang.String delids)` 如果Map.errNum<0表示保存失败
`int`	`updateRequestName(java.util.List<WfRequest> reqList, java.util.Map<java.lang.String,java.lang.String> varSql, java.lang.String fields)` 用于批量更新流程的标题，

Methods inherited from interface cn.sucang.core.service.IBaseService
invalidLabelCascade, recreateLabelCascade

Methods inherited from interface cn.sucang.core.IBase
executeUpdate, executeUpdate, getById, getById, getByQuery, getByWhere, getByWhere, getByWhere, getCounts, getCounts, getJdbcDao, getJdbcTemplate, getList, getListByWhere, getListByWhere, getListForQuery, getListForQuery, getNewItem, getPageList, getPageList, getPageListForQuery, remove, removeById, removeByObject, save, saveOrUpdate, saveOrUpdateByObject, updateLabelByOldLabel

- Method Detail
  - getMyRequest
```
java.util.List<WfRequest> getMyRequest()
```
    获取我的流程请求
    
    Returns:
    
    List<WfRequest>
  - getMyRequest
```
java.util.List<WfRequest> getMyRequest(int wfStatus)
```
    按状态获取我的流程请求
    
    Parameters:
    
    wfStatus - as int//见Constant.WF_**
    
    Returns:
    
    List<WfRequest>
  - getMyRequest
```
java.util.List<WfRequest> getMyRequest(java.lang.String workflowId,
                                       int wfStatus)
```
    按状态获取我的流程请求
    
    Parameters:
    
    workflowId - as String //workflow.id
    
    wfStatus - as int//见Constant.WF_**
    
    Returns:
    
    List<WfRequest>
  - newRequest
```
WfRequest newRequest(java.lang.String wfId)
```
  - saveAndCopyWorkflow
```
int saveAndCopyWorkflow(Workflow wf,
                        java.lang.String oriWfid)
```
    将复制得到的wf保存，并将根据原工作流oriWfid生成流程图和节点
    
    Parameters:
    
    wf -
    
    oriWfid -
    
    Returns:
  - getListForPermissionQuery
```
java.util.List<Workflow> getListForPermissionQuery(java.util.Map<java.lang.String,java.lang.Object> whereMap)
```
    查询返回有编辑权限的工作流,以第一个节点的工作流为主
    
    Parameters:
    
    whereMap - as Map
    
    Returns:
    
    List<Workflow>
  - SaveWorkflowStep
```
int SaveWorkflowStep(Workflow wf,
                     net.sf.json.JSONObject stepInfoObject)
```
    Deprecated.
    
    返回值为0表示正常更新，如果>0表示新增了几个节点信息。
    
    Parameters:
    
    wf - as Workflow
    
    stepInfoObject - as JSONObject
    
    Returns:
    
    int
  - SaveWorkflowStep
```
java.util.Map<java.lang.String,java.lang.Object> SaveWorkflowStep(Workflow wf,
                                                                  java.lang.String xml,
                                                                  java.lang.String steps,
                                                                  java.lang.String paths,
                                                                  java.lang.String delids)
```
    如果Map.errNum<0表示保存失败
    
    Parameters:
    
    wf - //对应的流程图对象
    
    xml - //流程图的xml，如果有新增听则需要替换xml节点内容
    
    steps - //所有的节点，需要判断哪些是新增的或修改
    
    paths - //所有的路径，需要判断哪些是新增的或修改
    
    delids - //删除的节点id或路径id
    
    Returns:
    
    Map = {errNum, errMsg, steps, paths}
  - getStepInfoList
```
java.util.List<StepInfo> getStepInfoList(java.lang.String workflowid)
```
    获取指点工作流的所有节点对象
    
    Parameters:
    
    workflowid - as String
    
    Returns:
    
    List<StepInfo>
  - getFirstStep
```
StepInfo getFirstStep(java.lang.String workflowid)
```
  - getLastSteps
```
java.util.List<StepInfo> getLastSteps(java.lang.String workflowid)
```
  - getStepPathList
```
java.util.List<StepPath> getStepPathList(java.lang.String workflowid)
```
    获取指定工作流的所有流转路径
    
    Parameters:
    
    workflowid - as String
    
    Returns:
    
    List<StepPath>
  - getStepPathBySourceId
```
java.util.List<StepPath> getStepPathBySourceId(java.lang.String stepid)
```
  - getStepPathByTagetId
```
java.util.List<StepPath> getStepPathByTagetId(java.lang.String stepid)
```
  - getStepPathById
```
StepPath getStepPathById(java.lang.String stepPathId)
```
  - getStepInfoById
```
StepInfo getStepInfoById(java.lang.String stepId)
```
  - getOperatorById
```
StepOperator getOperatorById(java.lang.String operatorId)
```
  - getBackStepsById
```
java.util.List<StepInfo> getBackStepsById(java.lang.String stepid)
```
    Deprecated.
    
    默认不处理流程图中向后节点流的路径为后退操作,为兼容性和扩展保留该方法，默认返回为null
    如果需要返回向前流转的路径指向的节点，调用stepInfoDao.getBackStepsById($stepid)方法
    
    Parameters:
    
    stepid - as String
    
    Returns:
    
    List<StepInfo>
  - getBeforeStepListById
```
java.util.List<StepInfo> getBeforeStepListById(java.lang.String stepid)
```
    获取指定节点的所有之前的节点列表
    
    Parameters:
    
    stepid - as String
    
    Returns:
  - getStepOperatorList
```
java.util.List<StepOperator> getStepOperatorList(java.lang.String stepid)
```
    获取指点节点的操作者列表
    
    Parameters:
    
    stepid - as String
    
    Returns:
    
    List<StepOperator>
  - getWorkflowNameByid
```
java.lang.String getWorkflowNameByid(java.lang.String workflowids)
```
  - updateRequestName
```
int updateRequestName(java.util.List<WfRequest> reqList,
                      java.util.Map<java.lang.String,java.lang.String> varSql,
                      java.lang.String fields)
```
    用于批量更新流程的标题，
    
    Parameters:
    
    reqList - 流程对象
    
    varSql - 流程标题的变量查询Sql定义
    
    Returns:
    
    int 返回更新成功的记录数
  - processPermissionByFinish
```
int[] processPermissionByFinish(WfRequest request,
                                boolean isDelForward,
                                java.lang.String stepIds,
                                int agentAction,
                                int supervisorPermit)
```
    重构指定归档流程的权限,不修改操作者.如果非归档流程直接返回0,请调用processPermissionByRunning(...).
    代理人员的权限重构，是根据操作者列表中的接收日期是否存在代理配置
    如果历史数据有代理配置，而之后代理人员配置删除的话，则不会产生权限
    
    Parameters:
    
    request -
    
    isDelForard - as boolean //表示是否删除转发的临时权限
    
    stepIds - String //处理指定节点的权限,如果为空表示除开始节点外的所有定义并操作(者)过的节点权限
    
    agentAction - as int //表示对代理人员的权限处理,1-不处理代理人权限, 2-重新生成代理人权限, 3-仅删除代理人权限
    
    supervisorPermit - as int //1-表示不处理监控权限, 2-重新生成监控权限, 3-仅删除监控人员权限。（监控权限不限制于某个节点）
    
    Returns:
    
    int[]{删除的权限条数,增加的权限条数}
  - processPermissionByRunning
```
int[] processPermissionByRunning(WfRequest request,
                                 boolean isDelForward,
                                 java.lang.String stepIds,
                                 int agentAction)
```
    重构正在流转的流程,重构操作者.如果已请归档,请调用processPermissionByFinish(...)方法
    代理人员的权限重构，是根据操作者列表中的接收日期是否存在代理配置
    如果历史数据有代理配置，而之后代理人员配置删除的话，则不会产生权限
    
    Parameters:
    
    request -
    
    isDelForard - as boolean //表示是否删除转发的临时权限
    
    stepIds - String //处理指定节点的权限,如果为空表示除开始节点外的所有定义并操作(者)过的节点权限
    
    agentAction - as int //表示对代理人员的权限处理,1-不处理代理人权限, 2-重新生成代理人权限, 3-仅删除代理人权限
    
    Returns:
    
    int[]{删除的权限条数,增加的权限条数}
  - processDebugWorkflowProcess
```
java.lang.String processDebugWorkflowProcess(IWorkflowProcess process,
                                             WfRequest req,
                                             java.lang.String eventName,
                                             java.util.Map<java.lang.String,java.lang.Object> initParams)
```
    调试工作流接口处理器,调试时不调用getClientScript()和doClientAction()方法
    而setRequest()和init()方法总是执行
    
    Parameters:
    
    process - as IWorkflowProcess
    
    req - as WfRequest
    
    eventName - as String 如果为空，不执行直接返回,多个事件用逗号分隔，否则仅执行指定的接口处理中的事件
    
    initParams - as Map<String,Object>
    
    Returns:
    
    String //返回值预留，暂无意义。
  - removeStepOperator
```
int removeStepOperator(StepOperator oper)
```
    删除操作者，当初始节点时，需要删除初始节点的工作流类型的权限记录，这样对应的人员就没有创建流程的权限，已创建的流程不能提交，已流转的流程则不影响
    当是开始节点时，需要对所有处于第一个节点（当前节点）状态的且非退回的流程进行无法提交的处理操作，需要再次申请（才能确定当前人有没有新的创建权限）一个流程才行。
    其他节点不能删除，不然流程其他节点的历史流程权限和监控权限也会没有导致无法查看。
    
    Parameters:
    
    oper - as StepOperator
    
    Returns:
  - processWfOldGraph
```
java.lang.String processWfOldGraph(Workflow wf)
```

Interface WorkflowService

Method Summary

Methods inherited from interface cn.sucang.core.service.IBaseService

Methods inherited from interface cn.sucang.core.IBase

Method Detail

getMyRequest

getMyRequest

getMyRequest

newRequest

saveAndCopyWorkflow

getListForPermissionQuery

SaveWorkflowStep

SaveWorkflowStep

getStepInfoList

getFirstStep

getLastSteps

getStepPathList

getStepPathBySourceId

getStepPathByTagetId

getStepPathById

getStepInfoById

getOperatorById

getBackStepsById

getBeforeStepListById

getStepOperatorList

getWorkflowNameByid

updateRequestName

processPermissionByFinish

processPermissionByRunning

processDebugWorkflowProcess

removeStepOperator

processWfOldGraph