e cology工作流接口技术方案说明书.doc

文档版本历史 变更序号 日期 版本 文件变更 申请编号 变更说明 修改人 1 2007年4月27日 V1.0 无 新文件 衡晓辉 2 2007年6月20日 V1.1 无 张小丰 目 录 一、前言 4 1.1编写目的 4 1.2名词定义 4 二、需求概述 5 2.1客户需求 5 2.2数据输入需求分析 6 2.3数据输出需求分析 7 三、技术方案 8 3.1技术实现 8 3.2接口应用范围 8 3.3 交换数据范围 8 3.4 附件传递 8 四、接口设计 9 4.1流程创建接口 9 4.2流程修改接口 13 4.3流程操作接口 13 4.4流程写接口 13 4.5流程列表读接口 13 4.6流程数据读接口 17 五、接口应用设计 22 5.1工作流节点、出口附加操作改进 22 5.2流程监控改进 22 一、前言 1.1编写目的 为实现e-cology系统工作流模块的标准输入输出接口，特编写本文档，定义以下内容： 概要分析e-cology工作流接口需求； 定义e-cology工作流输入输出接口的技术实现方案； 定义e-cology工作流输入输出接口的功能范围； 定义e-cology工作流输入输出接口在e-cology系统内的功能应用； 本文档用于针对系统集成需求，对客户及第三方软件供应商的技术方案描述。 工作流接口内容定义，请参见《e-cology工作流接口详细设计说明书》。 工作流接口使用说明，请参见《e-cology工作流接口使用白皮书》。 1.2名词定义 1、e-cology系统： 指提供本工作流接口，用于与其他系统数据交接的e-cology系统。 2、外部系统： 指调用或实现e-cology工作流输入输出接口，与e-cology系统进行数据交接的其他系统。 3、workflow 指工作流，也称流程，包括表单（或单据）定义、节点定义、节点路径定义等，比如流程管理员设置的请假申请工作流。 4、request 指某一工作流的实例，也称请求，即具体的某一表单（或单据），比如某用户创建的一张请假申请单。 二、需求概述 概要分析e-cology工作流接口需求。 2.1客户需求 1、外部系统在e-cology系统中触发一个新的流程,不回写值； 2、外部系统在e-cology系统中触发一个新的流程,并在某个节点上进行回写； 3、e-cology系统中创建一个流程，在某节点触发外部系统，外部系统处理后返回OA系统继续流转(其中包括跟随外部系统处理阶段直接影响流程流转)； 4、e-cology系统中创建一个流程在某个节点对外部系统进行回写； 5、外部系统获取e-cology系统中的一些数据.(例如: 流转日志)； 2.2数据输入需求分析 外部系统通过工作流接口，向e-cology系统输入数据。 创建新的工作流或修改、操作已有流程数据。 2.2.1 通过接口创建流程 指外部系统通过调用e-cology流程创建接口，在e-cology系统内触发具体的流程。 新建表单数据由外部系统通过接口传入。 e-cology流程创建接口返回流程创建结果，外部系统可保留requestid，用以之后其他接口的调用。 2.2.2 通过接口修改表单数据 指外部系统通过调用e-cology流程修改接口，修改e-cology系统内具体流程的表单数据。 修改表单数据由外部系统通过接口传入。 2.2.3 通过接口操作流程 指外部系统通过调用e-cology流程操作接口，对e-cology系统内具体流程做提交或退回操作。 操作类型及签字意见由外部系统通过接口传入。 e-cology流程操作接口返回流程操作结果。 2.3数据输出需求分析 e-cology系统通过工作流输出接口，实现对外部系统的数据输出； 或外部系统通过e-cology工作流数据输出接口，读取e-cology流程数据，实现流程数据输出。 2.3.1 流程数据自动输出 指通过e-cology系统在流程流转过程中，对工作流输出接口的调用，实现实时、自动对外部系统的数据输出。 输出的流程数据，在外部系统内所做的操作内容，由对方系统对工作流输出接口的实现内容决定。 可以在e-cology工作流节点、出口附加操作上，设置对工作流数据输出接口的调用，以实现流程流转过程中，与外部系统数据交换的无缝链接。 2.3.2 在e-cology系统选择输出范围手动输出 指通过e-cology系统在相应功能中，对工作流输出接口的调用，实现可选择流程范围、手动对外部系统的数据输出。 输出的流程数据，在外部系统内所做的操作内容，由对方系统对工作流输出接口的实现内容决定。 可以在e-cology流程监控功能上，添加对工作流数据