开发者中心

# ESB数据源

# 一、ESB数据源概述

核心作用：实现表单直接调用第三方业务系统数据（如SAP、CRM等）

典型场景：

  • 表单需要选择供应商（数据在SAP）
  • 需要引用客户主数据（数据在CRM）
  • 其他跨系统数据交互场景

# 二、数据源创建（以SAP供应商为例）

# 2.1 基本配置步骤

  1. 新建数据源
    • 进入流程库 → ESB数据源 → 添加
    • 初始结构包含Listener和Response两个节点

新建数据源 ▲ 新建数据源

  1. 添加SAP集成节点
    • 拖入SAP集成组件到Listener和Response之间
    • 配置三个关键属性页签：
      • 常规：设置SAP连接和BAPI接口
      • 调用：配置接口调用参数
      • 返回：处理返回数据

添加SAP集成节点 ▲ 添加SAP集成节点

  1. 选择SAP接口
    • 搜索VENDOR相关BAPI
    • 选择BBP_VENDOR_GETLIST（供应商列表接口）

选择BAPI ▲ 选择BAPI

  • 设置COMP_CODE等必要参数

设置COMP_CODE参数 ▲ 设置COMP_CODE参数

# 2.2 数据映射配置

  1. 输出结构调整
    • 修改默认列名（column1→供应商编号，column2→供应商名称）
    • 删除无用列

输出结构调整 ▲ 输出结构调整

  1. 字段映射
    • 将SAP返回的VENDOR_NO映射到"供应商编号"
    • 将NAME映射到"供应商名称"

字段映射 ▲ 字段映射

  1. 测试验证
    • 保存数据源（命名为"SAP供应商"）
    • 执行测试查看返回数据格式

执行测试查看数据 ▲ 执行测试查看数据

# 三、表单集成步骤

# 3.1 配置开窗查询

  1. 添加控件

    • 在表单设计中拖入"开窗查询"控件

  2. 绑定数据源

    • 属性面板选择"数据源"
    • 在ESB数据源页签选择已创建的"SAP供应商"

  3. 显示设置

    • 指定值列（供应商编号）
    • 配置视图显示字段

配置开窗查询 ▲ 配置开窗查询

# 3.2 使用验证

  1. 测试运行

    • 点击放大镜图标触发查询
    • 验证供应商列表显示是否正确

  2. 数据选择

    • 选择具体供应商
    • 确认回填到表单的数据格式

选择数据回填表单 ▲ 选择数据回填表单

# 四. 最佳实践建议

  1. 命名规范

    • 使用业务人员易懂的字段名称
    • 保持数据源命名与业务场景一致

  2. 性能优化

    • 只映射必要的字段
    • 合理设置查询参数减少数据量

  3. 维护建议

    • 添加数据源说明文档
    • 定期验证接口可用性

# 五. 扩展应用

  • 相同方法可集成其他系统（CRM、ERP等）
  • 支持复杂数据转换和处理
  • 可组合多个数据源实现复合查询

提示：本指南展示了基础配置流程，实际项目中可根据需要添加错误处理、数据缓存等高级功能。

← ESB数据源输入、输出 →