【泛微E9】统一待办中心集成

1、什么是统一待办中心集成

概述：目前有很多第3方系统都有流程，操作人都会有待办事宜、已办事宜。但这些待办流程都分散在不同系统中，用户操作不方便，对相应流程也无法及时处理。客户希望能在泛微OA中对所有的第3方流程做统一展示，即泛微OA作为处理流程的统一入口；进而点击流程标题后，根据各个系统的流程，展示各个系统流程的审批页面。

2、使用场景

例如：某财务公司会有3套系统；财务系统、OA和hr系统，但是他们想只由OA一个系统就可以处理所有系统的相关流程业务，那么就可以通过财务系统和hr系统分别调用OA的统一待办接口，以此将数据推送到OA中；这就是统一待办中心集成这一功能的使用场景之一。

3、配置项名词解释

3.1 异构系统

**标识：**该字段值有唯一性校验，标识是提供给第3方系统使用，另外，标识不能为中文。
**简称：**该字段值有唯一性校验。
**全称：**该字段值有唯一性校验。
**接口安全IP：**白名单，只允许设置范围内的IP用户调用接口创建流程。（2008版本及以后为必填！）
**内外网自动登录：**默认关闭，开启后点击“放大镜”可以设置内外网，点击“网段策略”按钮可以新建、编辑、删除设置IP网段数据。

3.2 内外网设置说明

a. 关闭“内网外自动登录”开关，单点登录取 PC内部地址
b. 开启“内网外自动登录”开关，不设置网段，单点登录取 PC外部地址
c. 开启“内网外自动登录”开关，设置网段，客户机IP在设置的网段范围内，单点登录取 PC内部地址
d. 开启“内网外自动登录”开关，设置网段，客户机IP不在设置的网段范围内，单点登录取 PC外部地址
**PC地址内部前缀：**输入PC端访问链接的内部地址前缀,防止客户第3方系统因域名切换或IP切换导致无法访问问题。
**PC地址外部前缀：**输入PC端访问链接的外部地址前缀,防止客户第3方系统因域名切换或IP切换导致无法访问问题。
**PC中转页面：**满足PC端打开异构系统流程跳转需要做验证处理时使用。（2011版本及以后必须要配置PC中转页面才可以打开流程）
**APP地址前缀：**输入手机端访问链接的地址前缀,防止客户第3方系统因域名切换或IP切换导致无法访问问题。
**APP中转页面：**满足APP端打开异构系统流程跳转需要做验证处理时使用。
**人员转换规则：**选项：OA人员ID、OA登录名、人员编号、身份证号、电子邮件,默认为OA人员ID,该规则在第3方系统调用webservice接口和servlet接口时，将人员转换为相应的人员id。
**自动创建流程类型：**默认为 开启。开启：表示接口接收该系统流程时，判断流程类型是否存在，如果不存在则自动创建流程类型。关闭：表示接口接收该系统流程时，判断流程类型是否存在，如果不存在，不自动创建流程类型，也不接收流程数据。
**编辑流程类型：**默认为 开启。开启：表示在流程类型列表页面中，显示【新建】按钮，并且可对流程类型做【编辑】操作。关闭：表示在流程类型列表页面中，不显示【新建】按钮，并且不可对流程类型做【编辑】操作。
**接收流程数据：**默认为 开启。开启：表示接口接收该系统流程数据。关闭：表示接口不接收该系统流程数据。
**显示顺序：**设置异构系统在应用时的显示顺序（-999.99~9999.99）
**显示到PC端：**开关默认开启，开启时会将异构系统流程数据信息通知到PC端流程，显示在门户流程中心列表、流程待办/已办列表中，关闭则不会显示。
**显示到移动端：**开关默认开启，开启时会将流程数据信息通知到移动端流程，显示到工作台的待办事宜和已办事宜等中，关闭则不会显示。
**提醒到消息中心：**默认关闭，开启后该异构系统消息数据独立提醒到【消息中心】，由消息中心处理提醒到各应用（包括提醒到PC端，提醒到EM7）
**提醒到IM：**默认关闭，开启后接收到异构系统待办数据时，发送提醒消息 到IM。
**提醒到短信：**默认关闭，开启后可设置待办和待阅的短信提醒模板，接收到异构系统待办数据时，发送提醒消息 到手机。
**自定义提醒：**默认关闭，开启后可设置自定义类，实现自定义消息提醒。
**自定义提醒接口实现类：**开启【自定义提醒】后才出现此设置项。
**监控状态：**调用接口时显示状态，未调用显示异常。
**提醒方式：**提醒方式：工作流提醒、短信提醒、邮件提醒。
被提醒人员：人力字段单选按钮，可以选择提醒人员。

3.3 流程数据

**异构系统：**异构系统单选浏览框，点击可以选择异构系统，以简称显示。
**流程类型：**流程类型单选浏览框，通过【异构系统】做过滤。
**流程ID：**ofs_workflow表中的workflowid值
**标题：**流程标题
处理状态： 默认待办，可选：待办、待阅、已办、办结
**查看状态：**默认未查看，可选：未查看、已查看
**步骤名称：**流程节名称
**PC地址：**异构系统PC地址
**APP地址：**异构系统APP地址
**创建人：**对应OA人员姓名
**创建人原值：**不可编辑，通过“创建人”带出原值（依据异构系统中“人员转换规则”转换）
**创建日期：**日期按钮
**创建时间：**时间按钮
**接收人：**对应OA人员姓名
**接收人原值：**不可编辑，通过“接收人”带出原值（依据异构系统中“人员转换规则”转换）
**接收日期：**日期按钮
接收时间：时间按钮

3.4 集成日志

主要用来展示调用接口的日志

3.5 集成参数

**启用：**开启：表示异构系统集成功能可用，异构系统接口可接收数据；关闭：表示异构系统集成功能不可用，异构系统接口不可接收数据。
**显示系统名称：**用于控制流程标题前是否显示异构系统名称。
选项：
a. 不显示：不显示异构系统名称
b. 简称：显示异构系统简称
c. 全称：显示异构系统全称
**显示已办：**开启：将处理状态为【已办】和【办结】的异构系统流程显示到【流程-已办事宜】、【流程元素】中；关闭：【流程-已办事宜】、【流程元素】中不显示处理状态为【已办】和【办结】的异构系统流程。
**系统简称：**用于设置OA系统简称，依据“显示系统名称”项，在流程列表 显示OA系统产生的流程的系统名称。
**系统全称：**用于设置OA系统全称，依据“显示系统名称”项，在流程列表 显示OA系统产生的流程的系统名称。
**统一待办中心版本号：**记录统一待办接口修改版本。
**提醒到消息中心：**默认开启，开启后异构系统消息数据提醒到【消息中心】，由消息中心处理提醒到各应用（包括提醒到PC端，提醒到EM7）注：KB9002006版本已将【提醒到手机版】、【提醒到e-message】、【提醒到云桥】设置项合并为一个【提醒到消息中心】
**提醒到IM：**默认关闭，开启后接收到异构系统待办数据时，发送提醒消息 到IM。
**提醒到短信：**默认关闭，开启后可设置待办和待阅的短信提醒模板，接收到异构系统待办数据时，发送提醒消息 到手机。（支持版本：KB9002006版本及以后）
**自定义提醒：**默认关闭，开启后可设置自定义类，实现自定义消息提醒。（支持版本：KB9002006版本及以后）
**自定义提醒接口实现类：**开启【自定义提醒】后才出现此设置项。
**REST接口监控：**默认关闭，开启后调用rest接口会将输入数据写入/log/integration/ofs/ofs.log中
**定期清除日志：**默认关闭，开启后会自动清理的日志（根据保留日志天数进行清理），包括ofs_log表,日志文件:/log/integration/ofs。
**保留日志天数：**开启“定期清理日志”开关后显示，默认30。

3.6 自定义字段

设置设置自定义字段，是为了满足第三方系统推送流程到OA时，统一待办接口当前字段不够用的情况，自定义添加字段来满足需求，提供ofs_custom_data表存储自定义字段数据。
接口自定义字段传参使用说明：REST接口中的待办接口json格式为例（通过Postman调用）

{
    "syscode":"{{syscode}}",
    "flowid":"{{flowid}}",
    "requestname":"sxy-统一待办测试-JSON-TEST",
    "workflowname":"sxy-统一待办测试-JSON",
    "nodename":"1审批",
    "pcurl":"/showtask.aspx?id=WebService-Json-001",
    "appurl":"/showtask.aspx?id=WebService-Json-001",
    "creator":"xxw",
    "createdatetime":"2021-12-17 10:10:10",
    "receiver":"wld",
    "receivedatetime":"2021-12-17 10:10:10",
    "receivets":"",
    "custom":{
        "goahead":"111",
        "gotodo":"333",
        "gotodo1":"444"
    }
}

·配置示例
E9推送至E9（均2110版本）
注：以下示例仅在标准功能基础上，仅供参考。
推送端配置

①启用按钮开启
**②标识：**xqw1113（作为与接收端的对应关系唯一标识，即与接收端的标识一致。）
**③名称：**主干推送到gs（顾名思义，名称而已 看自己喜好 自行定义）
**④服务端地址：**http://10.10.27.12:8080（一定是要服务端的地址）
**⑤实现类：**weaver.ofs.interfaces.SendRequestStatusDataImplForE9（根据说明进行复制粘贴即可）
**⑥人员转换规则：**OA登录账号（人员的登录名我用的xqw002，主要用作与推送端的人员作对应关系）
推送端Token认证一定要开启，如下图所示！！

接收端配置

①标识： xqw1113（作为与推送端的对应关系唯一标识，即与推送端的标识一致。）
②简称： 主干推送到gs（顾名思义，名称而已 看自己喜好 自行定义）
③接口安全ip： 10.10.27.11（允许调用本接口的IP地址，支持通配符：...）
④PC地址内部前缀：http://10.10.27.11:8080（一定是要推送端的地址）
⑤PC地址外部前缀： http://10.10.27.11:8080（一定是要推送端的地址）
⑥pc中转页面： /interface/transfer/pctransferfore9.jsp（主要用来打开pc推送端审批页面）
⑦APP地址前缀： http://10.10.27.11:8080（与pc地址相同即可）
⑧APP中转页面： /interface/transfer/mobile/apptransferfore9.jsp（主要用来打开推送端em7审批页面）
⑨人员转换规则： OA登录账号（人员的登录名我用的xqw002，主要用作与推送端的人员作对应关系）
⑩自动创建流程类型： 开关开启（接口接收该系统流程时，判断流程类型是否存在，如果不存在则自动创建流程类型）
**⑪编辑流程类型：**开关开启（在流程类型列表页面中可以进行一些显示项的编辑）
**⑫接收流程数据：**开关开启（接口允许接收该系统流程数据）
**⑬显示到pc端：**开关开启（将异构系统流程数据信息通知到PC端流程，显示在门户流程中心列表、流程待办/已办列表中，关闭则不会显示）
**⑭显示到移动端：**开关开启（会将流程数据信息通知到移动端流程，显示到工作台的待办事宜和已办事宜等中，关闭则不会显示）
**⑮启用：**开关开启（表示异构系统集成功能可用，异构系统接口可接收数据；关闭：表示异构系统集成功能不可用，异构系统接口不可接收数据。在2108版本之后该按钮默认开启）