【泛微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版本之后该按钮默认开启）