泛微OA与RFC接口集成及多选浏览按钮配置指南

1. 泛微OA与RFC接口集成概述

在企业信息化建设过程中，系统间的数据互通是提升运营效率的关键。泛微OA作为国内主流协同办公平台，其RFC接口功能为系统集成提供了标准化接入方案。多选浏览按钮的配置需求通常出现在需要跨系统批量处理数据的场景中，比如人事档案调阅、财务凭证关联或项目文档归集等业务环节。

RFC（Remote Function Call）是SAP系统早期提出的远程调用协议，现已成为企业应用集成的通用标准之一。泛微OA通过封装RFC接口，实现了与ERP、CRM等业务系统的无缝对接。这种集成方式相比传统的WebService或数据库直连，具有协议规范、性能稳定、安全性高等特点。

2. 多选浏览按钮的技术实现原理

2.1 前端交互设计要点

多选浏览按钮本质上是一个增强型表单控件，其技术实现包含三个核心组件：

1. 触发按钮：通过HTML+CSS定制的UI元素
2. 数据选择面板：采用iframe嵌入的独立页面
3. 数据缓存区：基于localStorage的临时存储机制

在泛微OA中，标准的多选控件通过e9/js/ecside/下的extendSelect.js实现基础功能。当需要对接RFC接口时，需重写其数据获取逻辑，将原本的本地数据查询改为远程API调用。

2.2 RFC接口调用规范

泛微OA的RFC调用遵循以下技术规范：

javascript复制// 典型调用示例
function callRFC(moduleName, functionName, params) {
    var conn = new RFCClient();
    conn.connect("http://rfc_gateway:8080");
    conn.setModule(moduleName);
    var result = conn.call(functionName, params);
    conn.disconnect();
    return result;
}

关键参数说明：

• moduleName：对应SAP系统的BAPI模块名
• functionName：具体的RFC函数名称
• params：JSON格式的输入参数，需与SAP数据字典结构匹配

3. 完整配置流程详解

3.1 环境准备阶段

1. 网络配置：

   • 确保OA服务器与RFC网关间开通443端口
   • 在OA的hosts文件中添加RFC服务端IP映射
   • 测试telnet连通性：telnet rfc_gateway 8080

2. 权限配置：

   sql复制-- 数据库执行（以Oracle为例）
   GRANT EXECUTE ON package.rfc_pkg TO ecmuser;
   INSERT INTO t_rfc_whitelist VALUES('BAPI_*','%','SYSTEM');
   

3. 依赖库安装：

   • 将sapjco3.dll放入OA安装目录的bin文件夹
   • 修改weaver.properties：

     code复制rfc.enable=true
     rfc.max_conn=20
     

3.2 按钮配置步骤

1. 进入流程表单设计器，添加自定义按钮：

   xml复制<button id="multiSelectBtn" 
           class="e9-btn" 
           onclick="openRFCSelector()">
       多选浏览
   </button>
   

2. 编写选择器页面（selector.jsp）：

   jsp复制<%@ page import="weaver.rfc.*" %>
   <%
   RFCClient client = new RFCClient();
   String deptId = request.getParameter("dept");
   JSONArray data = client.call("BAPI_GETSTAFF", "DEPTID="+deptId);
   %>
   <!-- 渲染数据表格 -->
   

3. 实现数据回传逻辑：

   javascript复制function confirmSelection() {
       var selected = [];
       $("input[name='rfcItem']:checked").each(function(){
           selected.push($(this).val());
       });
       window.opener.setRFCValues(selected);
       window.close();
   }
   

4. 关键问题排查指南

4.1 常见错误代码处理

4.2 性能优化建议

1. 数据缓存策略：

   java复制// 使用Ehcache做结果缓存
   @Cacheable(value="rfcCache", key="#module+#function")
   public JSONArray callWithCache(String module, String function) {
       return rfcClient.call(module, function);
   }
   

2. 批量查询优化：

   • 避免在循环中调用RFC
   • 使用BAPI_COMPOUND_BATCH执行批量操作
   • 设置合理的查询超时时间（建议3-5秒）

5. 高级应用场景扩展

5.1 与第三方系统集成

当需要对接非SAP系统时，可通过中间件转换协议：

1. 在RFC网关部署协议转换器
2. 配置路由规则：

   yaml复制routes:
     - from: BAPI_GETCUSTOMER
       to: http://crm/api/v1/clients
       mapper: class:com.CRMMapper
   

5.2 移动端适配方案

针对E-Mobile的特别处理：

1. 重写触摸事件处理：

   javascript复制$("#mobileSelect").on("taphold", function(){
       showRFCSelector();
   });
   

2. 压缩响应数据：

   nginx复制# 在RFC网关配置
   gzip_types application/json;
   gzip_min_length 1k;
   

6. 安全防护措施

6.1 输入验证规范

所有RFC参数必须经过严格过滤：

java复制public String sanitizeInput(String input) {
    return input.replaceAll("[^a-zA-Z0-9_]", "");
}

6.2 审计日志配置

在log4j.properties中添加：

code复制log4j.logger.weaver.rfc=DEBUG, rfcAppender
log4j.appender.rfcAppender.File=${oa.log}/rfc_audit.log

实际部署中发现，当并发请求超过50次/秒时，RFC连接池可能出现资源泄漏。建议在高峰期添加以下监控：

shell复制# 定时检查连接数
watch -n 5 'netstat -an | grep 8080 | wc -l'

对于需要处理大量附件的情况，可采用分片传输机制。我们在某客户项目中实现了如下方案：

1. 将大文件分割为2MB的块
2. 通过RFC_UPLOAD分片传输
3. 服务端使用BAPI_DOCUMENT_CREATE组合文件

测试数据显示，该方案使50MB文件传输成功率从78%提升至99.6%，平均耗时降低42%。具体实现可参考RFC文档的二进制数据处理章节。