OThinker.H3.WorkItem.IWorkItemManager
类:OThinker.H3.WorkItem.IWorkItemManager
说明:
工作项管理器
方法:.AddCirculateItem(OThinker.H3.WorkItem.CirculateItem)
方法说明:
添加一个传阅任务
名称 | 说明 |
CirculateItem | 传阅任务 |
返回值:
方法:.AddCirculateItems(OThinker.H3.WorkItem.CirculateItem[])
方法说明:
批量添加传阅任务
名称 | 说明 |
CirculateItems | 传阅任务集合 |
返回值:
方法:.DoCirculateItem(System.String)
方法说明:
打开传阅任务表单
名称 | 说明 |
ItemID | 传阅任务ID |
返回值:
记录任务已阅读状态
方法:.FinishCirculateItem(System.String,System.String,OThinker.H3.WorkItem.AccessPoint)
方法说明:
完成一个传阅任务
名称 | 说明 |
ItemID | 传阅任务ID |
Finisher | 任务完成人 |
FinishAccessPoint | 完成入口 |
返回值:
返回传阅完成是否成功
方法:.GetCirculateItem(System.String)
方法说明:
获取传阅任务
名称 | 说明 |
ItemID | 任务ID |
返回值:
返回传阅任务
方法:.Circulate(System.String,System.String,System.String[],System.Boolean,System.String)
方法说明:
将某个任务传阅给多个人,这个操作也需要锁定,否则在发送任务完毕前,源任务就已经完成了
名称 | 说明 |
Creator | 请求传阅的人员 |
WorkItemID | 工作项ID |
Receivers | 接收传阅的人员 |
Recirculatable | 是否允许再转传阅 |
WorkItemDisplayName | 传阅时创建的新任务的显示名称 |
返回值:
新任务的ID
方法:.AddWorkItem(OThinker.H3.WorkItem.WorkItem)
方法说明:
为某个用户添加一项工作。 1、这里需要将该作业直接添加到数据库中,否则无法实时地检索出来 2、添加一个作业的时候,需要在这里设置他的被添加时间,而不能以创建的时间为准,因为创建的时间可能来自于其他服务器或者客户端,这就有可能涉及时区的问题,如果以外部的时间为准就无法统一了。 3、如果WorkItem是发起活动的任务的话,那么不会调用委托关系。
名称 | 说明 |
WorkItem | 要添加的工作项 |
返回值:
新添加的对象的ID
方法:.AddWorkItems(OThinker.H3.WorkItem.WorkItem[])
方法说明:
添加一组用户作业,这样可以保证事务化,以防有的作业刚刚添加就被完成了。
名称 | 说明 |
WorkItems | 新增的工作项 |
返回值:
添加的工作项的ID
方法:.InstanceFinished(System.String)
方法说明:
流程完成的时候调用。取消掉非传阅类的所有未完成工作项
名称 | 说明 |
InstanceId | 流程ID |
返回值:
返回取消的数量
方法:.InstanceCanceld(System.String)
方法说明:
流程取消的时候调用。取消掉所有未完成的工作项。
名称 | 说明 |
InstanceId | 流程ID |
返回值:
返回取消的数量
方法:.ActivityActivated(System.String,System.Int64)
方法说明:
活动被取回的时候调用
名称 | 说明 |
InstanceId | 流程ID |
TokenID | 步骤ID |
返回值:
返回取消的数量
方法:.ActivityFinished(System.String,System.Int64)
方法说明:
活动完成的时候调用。取消掉非传阅类的所有未完成工作项。
名称 | 说明 |
InstanceId | 流程ID |
TokenID | 步骤ID |
返回值:
返回取消的数量
方法:.ActivityCanceled(System.String,System.Int64)
方法说明:
活动被取消的时候调用。取消掉所有未完成的工作项。
名称 | 说明 |
InstanceId | 流程ID |
TokenID | 步骤ID |
返回值:
返回取消的数量
方法:.CancelWorkItem(System.String,System.Boolean)
方法说明:
取消一个工作项。相应的征询意见的工作项也会被取消。
名称 | 说明 |
WorkItemID | 工作项ID |
Force | 是否强制取消。强制取消意味着,如果工作项处于正在工作的状态下也执行取消操作 |
返回值:
执行结果
方法:.ActivityAdjusted(System.String,System.Int64,System.String[])
方法说明:
当一个活动被调整活动的时候,取消一组工作项,同时重置过去的锁
名称 | 说明 |
InstanceId | 流程ID |
TokenId | 步骤ID |
WorkItemsToBeCanceled | 工作项ID |
方法:.GetWorkItem(System.String)
方法说明:
根据作业的ID获得工作项
名称 | 说明 |
WorkItemID | 工作项ID |
返回值:
获得的工作项
方法:.ForwardWorkItem(System.String,System.String,System.Boolean)
方法说明:
委托一个任务给某人,不能创建新任务,否则引用这些任务的地方无法取消这个任务
名称 | 说明 |
WorkItemID | 工作项ID |
Participant | 接收人 |
IsDelegant | 是否被委托人转发,默认为本人转发 |
返回值:
执行结果
方法:.ActivateWorkItem(System.String)
方法说明:
将工作项重新从取消状态激活为等待状态
名称 | 说明 |
WorkItemID | 工作项ID |
返回值:
执行结果
方法:.DoWorkItem(System.String)
方法说明:
开始工作一个作业
名称 | 说明 |
WorkItemID | 工作项ID |
返回值:
执行结果
方法:.FinishWorkItem(System.String,System.String,OThinker.H3.WorkItem.AccessPoint,System.String,OThinker.Data.BoolMatchValue,System.String,System.String,OThinker.H3.WorkItem.ActionEventType,System.Int32)
方法说明:
完成一个作业
名称 | 说明 |
WorkItemID | 工作项ID |
Finisher | 提交人员 |
FinishAccessPoint | 提交人员的接入方式 |
ParticipateJob | 提交人员使用的角色 |
Approval | 审批结果 |
Comment | 审批意见 |
ActionName | 操作名称 |
ActionEventType | 操作的事件的类型:OThinker.H3.WorkItem.ActionEventType |
ActionButtonType | 操作的按钮的类型:OThinker.H3.WorkSheet.SheetButtonType,保存:2,驳回:10,提交:11 |
返回值:
执行结果
方法:.UpdateUrged(System.String,System.Boolean)
方法说明:
标志一个工作项被催办过
名称 | 说明 |
WorkItemId | 工作项ID |
Urged | 是否被催办过 |
返回值:
执行结果
方法:.ConsultWorkItem(System.String,System.String,System.String[],System.String,System.Boolean)
方法说明:
将某个任务发送给多个人以征询意见,这个操作也需要锁定,否则在发送任务完毕前,源任务就已经完成了。请注意:对于以任何形式参与过该步骤的人员,将不会发送征询意见的任务。比如:如果用户A已经参与了该活动,现在B向A发出征询意见的请求,那么将不会创建该征询意见的工作项。
名称 | 说明 |
Creator | 申请征询意见的人 |
WorkItemID | 源工作项ID |
Consultants | 接收征询意见的人员 |
WorkItemDisplayName | 征询意见时创建的新任务的显示名称 |
MonitorConsultant | 监听顾问的完成/取消事件 |
返回值:
新征询意见的任务的ID
方法:.Consult(System.String,System.Int64,System.String[],System.String)
方法说明:
将某个任务发送给多个人以征询意见,这个操作也需要锁定,否则在发送任务完毕前,源任务就已经完成了。该方法是提供给系统本身使用的,用于在某个活动开始的时候,执行征询意见,所以不需要指定源工作项,也不需要制定请求人。
名称 | 说明 |
InstanceId | 流程ID |
TokenId | 步骤 |
Consultants | 接收征询意见的人员 |
WorkItemDisplayName | 征询意见时创建的新任务的显示名称 |
返回值:
新征询意见的任务的ID
方法:.AssistWorkItem(System.String,System.String,System.String[],System.String,System.Boolean,OThinker.H3.WorkItem.ReturnToType)
方法说明:
协办某个工作项
名称 | 说明 |
Creator | 要协办的人 |
WorkItemId | 要协办的工作项 |
Assistants | 协办者 |
WorkItemDisplayName | 工作项名称 |
MonitorConsultant | 是否监听处理人完成/取消的事件 |
ReturnTo | 指定:任务完成后,返回给哪个任务。true表示返回自己,false表示返回给源任务。 |
返回值:
协办工作项的ID
方法:.Assist(System.String,System.Int64,System.String[],System.String)
方法说明:
创建协助工作项。由系统本身调用,不需要指定源协办工作项,也不需要制定创建人。请注意:对于以任何形式参与过该步骤的人员,将不会发送征询意见的任务。比如:如果用户A已经参与了该活动,现在B向A发出征询意见的请求,那么将不会创建该征询意见的工作项。
名称 | 说明 |
InstanceId | 流程ID |
TokenId | 步骤 |
Assistants | 协办者 |
WorkItemDisplayName | 工作项名称 |
返回值:
新创建的工作项ID
方法:.UpdatePriority(System.String,OThinker.H3.Instance.PriorityType)
方法说明:
更新工作项的优先级属性
名称 | 说明 |
WorkItemID | 工作项ID |
Priority | 优先级 |
返回值:
执行结果
方法:.Transfer(System.String,System.String)
方法说明:
转移工作项
名称 | 说明 |
WorkItemID | 工作项ID |
Receiptor | 接收转移的人员 |
返回值:
执行结果
方法:.UpdateDisplayName(System.String,System.String)
方法说明:
更新工作项的显示名称
名称 | 说明 |
WorkItemID | 工作项ID |
DisplayName | 显示名称 |
返回值:
执行结果
方法:.LockActivity(System.String,System.String,System.Boolean)
方法说明:
锁定流程
名称 | 说明 |
LockedByWorkItemId | 请求锁定的工作项的ID |
LockedBy | 请求锁定的用户ID |
CancelOtherWorkItems | 是否要取消掉其他的工作项。如果为false,则不取消任何工作项,否则取消掉除“请求锁定的工作项”之外的所有工作项 |
返回值:
锁结果
方法:.DropLock(System.String,System.Boolean)
方法说明:
放弃自己的锁定。用户可以显示解锁,也可以在用户提交或者取消后系统自动解锁
名称 | 说明 |
LockedByWorkItemId | 请求锁定的工作项 |
ActivateOtherWorkItems | 是否重新激活曾经被自己取消的工作项 |
返回值:
锁结果
方法:.GetLocker(System.String,System.Int64)
方法说明:
获得锁定的人员
名称 | 说明 |
InstanceId | 流程ID |
TokenId | 步骤ID |
返回值:
锁定该步骤的人员