RequestService (Eaching-all 3.7 API)

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

public interface RequestService
extends IBaseService<WfRequest>

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`int`	`addRequestSharePermission(java.lang.String requestid, java.lang.String staffid, java.lang.String viewLayoutId, int optRule)`
`int`	`addRequestSupervisor(java.lang.String requestid, java.lang.String staffid, java.lang.String viewLayoutId, int optRule)` 对指定requestid的流程增加监控（监管）人，同时可以指定布局，如果未指定则取流程活动节点的显示布局属性
`int`	`addRequestSupervisor(Workflow wf, java.lang.String requestid)` 根据Workflow中配置的监控人员信息添加监控权限
`int`	`executeAandonRequest(WfRequest request, boolean isRestore)` 将指定的流程作废或恢复
`PermissionRule`	`generateAgentPermission(java.lang.String requestid, RequestOperator ro, StepOperator stepOper)` 生成代理人员的权限,用于权限重构时调用
`int`	`generateStepPermission(WfRequest request, StepInfo newStep, boolean isSaveRequestOperator, java.util.List<RequestOperator> existsReqOperList)` 根据指定的节点的操作规则StepOperator生成流程权限规则,有可能会抛出未找到操作者的异常:NotFoundOperationException
`java.util.List<PermissionRule>`	`generatorRealRule2(CatalogPermissionRule ccRule, java.util.List<RequestOperator> opersList)` 返回当前动态权限规则的真正规则，即PermissionRuleUser,PermissionRuleStation,PermissionRuleOrg之一。当前规则只是作为暂存处理动态规则用，不保存至数据库，一对一对应至其他组织/岗位/人员的规则记录中。动态规则有可能会产生多条权限规则
`StepInfo`	`getFirstStep(WfRequest request)`
`java.util.Map<java.lang.Integer,java.lang.String>`	`getOnlyViewPermission(java.util.Map<java.lang.Integer,java.lang.String> perMap, boolean isFinish)` 表示非当前操作者人员的权限权限标记处理，用于监控人员或其他流程共享权限时，删除不必要的权限数据，保留布局等其他标识信息
`java.util.List<RequestOperator>`	`getRemindNeedOperator(java.lang.String workflowid, java.lang.String where)` 返回需要提醒的操作者列表
`java.util.List<RequestLog>`	`getRequestLog(WfRequest request)`
`java.util.List<RequestLog>`	`getRequestLog(WfRequest request, java.lang.String stepId, java.lang.String hqlWhere, java.lang.String orderBy)`
`java.util.Map<java.lang.String,java.lang.Integer>`	`getRequestLogViewColumn(WfRequest request, int layoutType)` 返回显示流程流转意见的显示定义,返回值是{'字段名':100,'字段名2':20,...} staffId,info,stepid,createDate,ntype,attachIds
`java.util.List<RequestOperator>`	`getRequestOperator(WfRequest request, StepInfo stepInfo)` 获取指定流程或指定节点下的操作者列表
`RequestOperator`	`getRequestOperatorBySubmited(WfRequest request, java.lang.String stepid, java.lang.String staffid, java.lang.Integer isSubmit)`
`java.util.List<java.util.Map>`	`getRequestOperatorList(WfRequest request, java.lang.String stepid)`
`java.util.Map<java.lang.String,java.lang.String>`	`getRequestQueryParams(java.lang.String strStatus)` 根据状态值获取请求流程数据的JOSN URL的参数部分,__pageTitle表示标题
`RequestStatus`	`getRequestStatus(WfRequest request)` 获取流程的当前第一个状态（可能会有多个状态）
`RequestStatus`	`getRequestStatus(WfRequest request, java.lang.String activeStepid)` 获取当前流程的指定节点的流程状态
`java.util.List<RequestStatus>`	`getRequestStatusList(WfRequest request)` 获取流程的状态列表,当流程处于并行分支时会有多个RequestStatus
`RequestStatus`	`getRequestStatusPermission(WfRequest request)` 获取流程的当前状态并判断有查看权限的节点状态,如果返回null表示对request没有任何权限
`java.lang.String[]`	`getRequestTitle(LayoutData data, Workflow wf)` 根据表单提交的数据和工作流的标题模板生成流程标题
`java.util.Map<java.lang.String,java.util.List<java.util.Map>>`	`getRequestTraceData(WfRequest request)` 获取指定流程记录的流转，使流程图路径描红,返回结果格式: {steps:[{id:'4028818327ba2e450127ba2e5b000033', cellid:'13'}], paths:[{"id":"4028818327ba2e450127ba2e5b000038","cellid":"18","target":"4028818327ba2e450127ba2e5b000037","source":"4028818327ba2e450127ba2e5b000013"]}
`StepInfo`	`getStepById(java.lang.String stepid)`
`java.lang.String`	`getTodoRequestWhere(int status, int actionType, Staff staff)` 获取待办事宜查询语句的SQL条件限制
`Layout`	`getWorkflowLayout(WfRequest request, int layoutType, java.lang.String stepInfoid)` 获取当前流程的节点布局和表单默认布局,权限规则的布局通过getRequestPermissionWithLayout()方法获取根据工作流中定义的布局权限和优先级来确定
`boolean`	`hasRequestLog(WfRequest request, java.lang.String stepid, int action)` 确定是否对当前Request状态的StepInfo有操作者权限,一般用于第一个节点时权限判断,之后的由于有动态权限需要到PermissionRule表中处理
`int`	`processAutoFlow(WfRequest request, StepInfo[] steps, LayoutData data)` 判断节点是否具备自动流转的条件,如果是则自动流转下去.
`int`	`processRequest(WfRequest request, LayoutData data, java.lang.String action)` 处理流程请求,实现节点流转和操作者变更
`java.lang.String`	`processStepAction(WfRequest request, StepInfo step, LayoutData data, java.lang.String action)`
`java.util.List<java.util.Map<java.lang.String,java.lang.Object>>`	`queryForRequestList(BeanMap<java.lang.String,java.lang.Object> whereMap)` 查询流程,如:待办事宜,已办事宜,我的请求等
`PageList<java.util.Map<java.lang.String,java.lang.Object>>`	`queryForRequestPage(int pageNum, int maxPerPage, BeanMap<java.lang.String,java.lang.Object> whereMap)` 查询流程,如:待办事宜,已办事宜,我的请求等 Map中的返回字段为:id,name,isRead,stepid,nstatus,workflowid,creatorId
`boolean`	`queryNotifyUnSubmit(RequestStatus status, java.lang.String staffid)` 检查指定的人员在当前流程状态下，是否知会人员及是否未提交
`java.lang.String`	`saveFormData(WfRequest request, LayoutData layoutData)`
`java.util.List<java.util.Map<java.lang.String,java.lang.Object>>`	`transRequestListData(java.util.List<java.util.Map<java.lang.String,java.lang.Object>> listdata)` 转译流程结果集，用于查询视图展示

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
  - getRequestLog
```
java.util.List<RequestLog> getRequestLog(WfRequest request)
```
  - getRequestLog
```
java.util.List<RequestLog> getRequestLog(WfRequest request,
                                         java.lang.String stepId,
                                         java.lang.String hqlWhere,
                                         java.lang.String orderBy)
```
  - getRequestLogViewColumn
```
java.util.Map<java.lang.String,java.lang.Integer> getRequestLogViewColumn(WfRequest request,
                                                                          int layoutType)
```
    返回显示流程流转意见的显示定义,返回值是{'字段名':100,'字段名2':20,...} staffId,info,stepid,createDate,ntype,attachIds
    
    Parameters:
    
    request - as WfRequest
    
    layoutType - as int
    
    Returns:
  - getRequestTraceData
```
java.util.Map<java.lang.String,java.util.List<java.util.Map>> getRequestTraceData(WfRequest request)
```
    获取指定流程记录的流转，使流程图路径描红,返回结果格式: {steps:[{id:'4028818327ba2e450127ba2e5b000033', cellid:'13'}], paths:[{"id":"4028818327ba2e450127ba2e5b000038","cellid":"18","target":"4028818327ba2e450127ba2e5b000037","source":"4028818327ba2e450127ba2e5b000013"]}
    
    Parameters:
    
    request -
  - getRequestOperator
```
java.util.List<RequestOperator> getRequestOperator(WfRequest request,
                                                   StepInfo stepInfo)
```
    获取指定流程或指定节点下的操作者列表
    
    Parameters:
    
    request - as WfRequest
    
    stepInfo - as StepInfo
    
    Returns:
    
    List<RequestOperator>
  - getRequestOperatorBySubmited
```
RequestOperator getRequestOperatorBySubmited(WfRequest request,
                                             java.lang.String stepid,
                                             java.lang.String staffid,
                                             java.lang.Integer isSubmit)
```
    Parameters:
    
    request -
    
    stepid - as String //如果为空则表示不过滤该条件
    
    staffid - as String //如果为空则表示不过滤该条件
    
    isSubmit - as Integer //如果为null表示不过滤该条件
    
    Returns:
  - getRequestOperatorList
```
java.util.List<java.util.Map> getRequestOperatorList(WfRequest request,
                                                     java.lang.String stepid)
```
    Parameters:
    
    request -
    
    stepid -
    
    Returns:
    
    RequestOperator,oper.staffName,oper.stepName,log.info,log.hasLog
  - saveFormData
```
java.lang.String saveFormData(WfRequest request,
                              LayoutData layoutData)
```
  - queryForRequestList
```
java.util.List<java.util.Map<java.lang.String,java.lang.Object>> queryForRequestList(BeanMap<java.lang.String,java.lang.Object> whereMap)
```
    查询流程,如:待办事宜,已办事宜,我的请求等
    
    Parameters:
    
    whereMap - as BeanMap<String,Object>
    
    Returns:
    
    List<Map<String,Object>>
  - getTodoRequestWhere
```
java.lang.String getTodoRequestWhere(int status,
                                     int actionType,
                                     Staff staff)
```
    获取待办事宜查询语句的SQL条件限制
    
    Parameters:
    
    status - as int //nstatus==1表示待办,3表示已办,4表示已完成
    
    actionType - as int //用于限制待办和已办actionType==0的条件
    
    staff - as Staff //查询人员
    
    Returns:
    
    String
  - queryForRequestPage
```
PageList<java.util.Map<java.lang.String,java.lang.Object>> queryForRequestPage(int pageNum,
                                                                               int maxPerPage,
                                                                               BeanMap<java.lang.String,java.lang.Object> whereMap)
```
    查询流程,如:待办事宜,已办事宜,我的请求等
    Map中的返回字段为:id,name,isRead,stepid,nstatus,workflowid,creatorId
    
    Parameters:
    
    pageNum - as int
    
    maxPerPage - as int
    
    whereMap - as BeanMap<String, Object>
    查询其他人员的待办，请传入参数：currentStaffid,默认总是查询当前人员
    如果是常量条件请使用BeanMap.FINAL_WHERE
    如果仅获取总数请使用BeanMap.QUERY_COUNT,并将以BeanMap.QUERY_COUNT的值作为列名返回
    其他查询条件请参考[流程查询]查询列表的查询字段名，并以[ 字段名_where ]作为key传入
    
    Returns:
    
    List<Map<String,Object>>
  - processRequest
```
int processRequest(WfRequest request,
                   LayoutData data,
                   java.lang.String action)
            throws NotFoundOperationException
```
    处理流程请求,实现节点流转和操作者变更
    
    Parameters:
    
    request - as WfRequest
    
    data - as LayoutData
    
    action - as String
    
    Returns:
    
    int
    
    Throws:
    
    NotFoundOperationException,如果表单字段唯一性校验不通过则抛出ValidationFieldException
    
    NotFoundOperationException
  - processAutoFlow
```
int processAutoFlow(WfRequest request,
                    StepInfo[] steps,
                    LayoutData data)
             throws NotFoundOperationException
```
    判断节点是否具备自动流转的条件,如果是则自动流转下去.
    
    Parameters:
    
    steps - as StepInfo[]
    
    Returns:
    
    Throws:
    
    NotFoundOperationException
  - getRequestQueryParams
```
java.util.Map<java.lang.String,java.lang.String> getRequestQueryParams(java.lang.String strStatus)
```
    根据状态值获取请求流程数据的JOSN URL的参数部分,__pageTitle表示标题
    
    Parameters:
    
    strStatus - as String
    
    Returns:
  - transRequestListData
```
java.util.List<java.util.Map<java.lang.String,java.lang.Object>> transRequestListData(java.util.List<java.util.Map<java.lang.String,java.lang.Object>> listdata)
```
    转译流程结果集，用于查询视图展示
    
    Parameters:
    
    listdata -
    
    Returns:
  - executeAandonRequest
```
int executeAandonRequest(WfRequest request,
                         boolean isRestore)
```
    将指定的流程作废或恢复
    
    Parameters:
    
    request -
    
    isRestore - as boolean //如果为true则表示作废指定的流程
    
    Returns:
    
    int //返回大0表示成功
  - getRequestTitle
```
java.lang.String[] getRequestTitle(LayoutData data,
                                   Workflow wf)
```
    根据表单提交的数据和工作流的标题模板生成流程标题
    
    Parameters:
    
    data -
    
    wf -
    
    Returns:
    
    String[]{标题，流程编号}
  - addRequestSupervisor
```
int addRequestSupervisor(Workflow wf,
                         java.lang.String requestid)
```
    根据Workflow中配置的监控人员信息添加监控权限
    
    Parameters:
    
    wf - as Workflow
    
    requestid -
    
    Returns:
  - addRequestSupervisor
```
int addRequestSupervisor(java.lang.String requestid,
                         java.lang.String staffid,
                         java.lang.String viewLayoutId,
                         int optRule)
```
    对指定requestid的流程增加监控（监管）人，同时可以指定布局，如果未指定则取流程活动节点的显示布局属性
    
    Parameters:
    
    requestid - as String
    
    staffids - as String
    
    layoutIds - as String //显示布局ID，因为只有查看权限，所有只有显示布局。
    
    optRule - as int 监控人员的权限,默认小于等于0时，自动添加OPT_QUERY权限
    
    Returns:
  - addRequestSharePermission
```
int addRequestSharePermission(java.lang.String requestid,
                              java.lang.String staffid,
                              java.lang.String viewLayoutId,
                              int optRule)
```
  - getOnlyViewPermission
```
java.util.Map<java.lang.Integer,java.lang.String> getOnlyViewPermission(java.util.Map<java.lang.Integer,java.lang.String> perMap,
                                                                        boolean isFinish)
```
    表示非当前操作者人员的权限权限标记处理，用于监控人员或其他流程共享权限时，删除不必要的权限数据，保留布局等其他标识信息
    
    Returns:
  - getFirstStep
```
StepInfo getFirstStep(WfRequest request)
```
    Parameters:
    
    request - //request.workflowid不能为空
    
    Returns:
  - getStepById
```
StepInfo getStepById(java.lang.String stepid)
```
  - getWorkflowLayout
```
Layout getWorkflowLayout(WfRequest request,
                         int layoutType,
                         java.lang.String stepInfoid)
```
    获取当前流程的节点布局和表单默认布局,权限规则的布局通过getRequestPermissionWithLayout()方法获取
    根据工作流中定义的布局权限和优先级来确定
    
    Parameters:
    
    request - as WfRequest //如果是新建流程,则为new WfRequest().setWorkflowid(wfid);
    
    layoutType - as int //见Constant.LAYOUT_EDIT , Constant.LAYOUT_VIEW,不能传Constant.LAYOUT_EDIT_DEFAULT,Layout_AUTO表示自动判断
    
    stepInfoid - as String //stepInfoid为null表示当前操作者是活动节点的操作者，如果非活动节点的权限者则传递具体节点过来。
    
    Returns:
    
    FormEditPage
  - getRequestStatusList
```
java.util.List<RequestStatus> getRequestStatusList(WfRequest request)
```
    获取流程的状态列表,当流程处于并行分支时会有多个RequestStatus
    
    Parameters:
    
    request - as WfRequest
    
    Returns:
    
    List<RequestStatus>
  - getRequestStatusPermission
```
RequestStatus getRequestStatusPermission(WfRequest request)
```
    获取流程的当前状态并判断有查看权限的节点状态,如果返回null表示对request没有任何权限
    
    Parameters:
    
    request - as WfRequest
    
    Returns:
  - getRequestStatus
```
RequestStatus getRequestStatus(WfRequest request)
```
    获取流程的当前第一个状态（可能会有多个状态）
    
    Parameters:
    
    request - as WfRequest
    
    Returns:
  - getRequestStatus
```
RequestStatus getRequestStatus(WfRequest request,
                               java.lang.String activeStepid)
```
    获取当前流程的指定节点的流程状态
    
    Parameters:
    
    request -
    
    activeStepid -
    
    Returns:
    
    RequestStatus
  - hasRequestLog
```
boolean hasRequestLog(WfRequest request,
                      java.lang.String stepid,
                      int action)
```
    确定是否对当前Request状态的StepInfo有操作者权限,一般用于第一个节点时权限判断,之后的由于有动态权限需要到PermissionRule表中处理
    
    Parameters:
    
    request - as WfRequest
    
    stepid - as String
    
    action - as //Constant.OPT_EDIT || WfRequest.ACTION_SUBMIT
    
    Returns:
    
    boolean
  - getRemindNeedOperator
```
java.util.List<RequestOperator> getRemindNeedOperator(java.lang.String workflowid,
                                                      java.lang.String where)
```
    返回需要提醒的操作者列表
    
    Parameters:
    
    workflowid - as String
    
    where - as String //查询条件的表别名为op
    
    Returns:
    
    List<RequestOperator>
  - processStepAction
```
java.lang.String processStepAction(WfRequest request,
                                   StepInfo step,
                                   LayoutData data,
                                   java.lang.String action)
```
    Parameters:
    
    request - as WfRequest
    
    step - as StepInfo
    
    data - as LayoutData
    
    action - as String //数据值为 preview | post
    
    Returns:
    
    String
  - generateAgentPermission
```
PermissionRule generateAgentPermission(java.lang.String requestid,
                                       RequestOperator ro,
                                       StepOperator stepOper)
```
    生成代理人员的权限,用于权限重构时调用
    
    Returns:
  - generateStepPermission
```
int generateStepPermission(WfRequest request,
                           StepInfo newStep,
                           boolean isSaveRequestOperator,
                           java.util.List<RequestOperator> existsReqOperList)
```
    根据指定的节点的操作规则StepOperator生成流程权限规则,有可能会抛出未找到操作者的异常:NotFoundOperationException
    
    Parameters:
    
    request - as WfRequest
    
    newStep - as StepInfo
    
    isSaveRequestOperator - as boolean //用于当前活动点权限重构时才设置为true
    
    existsReqOperList - as List<RequestOperator> //用于当前活动节点权限重构时保留已提交人员的提交状态信息
    
    Returns:
    
    int
    
    Throws:
    
    NotFoundOperationException
  - generatorRealRule2
```
java.util.List<PermissionRule> generatorRealRule2(CatalogPermissionRule ccRule,
                                                  java.util.List<RequestOperator> opersList)
```
    返回当前动态权限规则的真正规则，即PermissionRuleUser,PermissionRuleStation,PermissionRuleOrg之一。当前规则只是作为暂存处理动态规则用，不保存至数据库，一对一对应至其他组织/岗位/人员的规则记录中。动态规则有可能会产生多条权限规则
    
    Parameters:
    
    ccRule - as CatalogPermissionRule
    
    opersList - as List<RequestOperator>
    
    Returns:
    
    PermissionRule
  - queryNotifyUnSubmit
```
boolean queryNotifyUnSubmit(RequestStatus status,
                            java.lang.String staffid)
```
    检查指定的人员在当前流程状态下，是否知会人员及是否未提交
    
    Parameters:
    
    status -
    
    staffid -
    
    Returns:

Interface RequestService

Method Summary

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

Methods inherited from interface cn.sucang.core.IBase

Method Detail

getRequestLog

getRequestLog

getRequestLogViewColumn

getRequestTraceData

getRequestOperator

getRequestOperatorBySubmited

getRequestOperatorList

saveFormData

queryForRequestList

getTodoRequestWhere

queryForRequestPage

processRequest

processAutoFlow

getRequestQueryParams

transRequestListData

executeAandonRequest

getRequestTitle

addRequestSupervisor

addRequestSupervisor

addRequestSharePermission

getOnlyViewPermission

getFirstStep

getStepById

getWorkflowLayout

getRequestStatusList

getRequestStatusPermission

getRequestStatus

getRequestStatus

hasRequestLog

getRemindNeedOperator

processStepAction

generateAgentPermission

generateStepPermission

generatorRealRule2

queryNotifyUnSubmit