主数据管理平台
产品介绍

文档介绍iPaaS集成到主数据，iPaaS安装步骤请参考iPaaS安装手册。

# 主数据集成iPaaS文档

# 集成准备

  • 主数据微服务版安装介质需要加上PLATFORM_8.3.3_AFCENTER_20250822_P2补丁。

  • 主数据套件版配置文件修改application.properties

    # spring.redis.xxx配置修改为和iPaaS同一个
spring.redis.host=127.0.0.1
spring.redis.port=6379
spring.redis.password=primeton
spring.redis.lettuce.pool.max-active=100
spring.redis.lettuce.pool.max-idle=10
spring.redis.lettuce.pool.max-wait=5000

# 原配置去除map -> redis
eos.cache.mode=redis

# 原配置去除org.springframework.boot.autoconfigure.data.redis.RedisAutoConfiguration、org.redisson.spring.starter.RedissonAutoConfiguration
spring.autoconfigure.exclude=org.springframework.boot.autoconfigure.mongo.MongoAutoConfiguration,\
  org.springframework.boot.autoconfigure.hazelcast.HazelcastAutoConfiguration,\
  org.springframework.boot.autoconfigure.hazelcast.HazelcastJpaDependencyAutoConfiguration,\
  org.apache.dolphinscheduler.scheduler.quartz.QuartzSchedulerAutoConfiguration,\
  org.springframework.boot.actuate.autoconfigure.metrics.web.servlet.WebMvcMetricsAutoConfiguration

  • 重启主数据

# IpaaS部署

IpaaS集成至主数据套件，微服务版跳过此步从这里开始阅读

  • 后端

    • 准备工作

      • 确认主数据套件环境已安装并运行
      • 准备好 IPaas 应用的部署包,部署到服务器上,iPaaS 安装需要使用有 Primeton_iPaaS_9.1.0_Portal_Server.tar Primeton_iPaaS_9.1.0_ESB_Server.tar

    • 修改应用配置

      • application.properties

        redis配置与主数据相同

        spring.redis.host=127.0.0.1
  spring.redis.port=6379
  spring.redis.password=primeton

      • application-afc.properties 主数据套件应用默认端口为28090,如果修改.则将其修改为对应端口. 如果应用没有部署在同一台服务器上.也需要将ip修改为主数据应用部署服务器的真实ip

        # 原配置
afc.application.name=AFCENTER

# 修改为Standalone后端地址
afc.application.name=127.0.0.1:28090

    • 启动 IPaas 应用

  • 前端

    • 获取 IPaas 前端介质 Primeton_iPaaS_9.1.0_Portal_UI.tar

    • 部署到 前端部署 目录

      将 IPaas 前端介质复制到并进行解压

      ${standalone_path}/web/afcenter/esb

    • 修改nginx配置文件${standalone_path}/web/conf/mdm.conf

      # 添加以下配置
location /api/esb/ {
  proxy_pass http://127.0.0.1:28088/api/esb/;# 修改为iPaaS后端IP和端口
}

    • 重载 Nginx 配置

      # 重载配置
./nginx -s reload -c ${standalone_path}/web/conf/mdm.conf

# 创建 iPaaS Token

1.登录iPaaS控制台，点击页面右上角圆形头像，选择“token管理”

image-20250828142319752

2.点击“新建token”按钮，选择token过期时间并点击“确定”生成token。

image-20250828142350548

# 主数据配置系统环境变量

  • 登录主数据控制台，进入应用中心，点击菜单“通用管理” > “ 系统变量 ” ，选择“主数据平台变量”，添加如下变量：
变量名称 变量说明 变量举例 对应版本
esb_server_ip iPaaS 后端服务ip地址 192.168.xx.xx ESB 9.0GA, iPaaS 9.1.0
esb_server_port iPaaS 后端服务端口 18080 ESB 9.0GA, iPaaS 9.1.0
esb_server_name iPaaS 后端服务用户名 esb_username ESB 9.0GA, iPaaS 9.1.0
esb_server_afc-token iPaaS 的有效token user_token ESB 9.0GA, iPaaS 9.1.0

image-20250828142255062

# iPaaS配置

# 1.添加服务器组

1.1.登录iPaaS控制台，进入管理门户，点击菜单“资源管理” > “ 服务器管理 ” ，选择“服务器组管理”页签，进入“服务器组管理 ” 界面。

image-20250828142608390

1.2.点击“新增”按钮，填写服务器组信息，点击“确定”按钮，保存服务器组信息。

image-20250828142748098

# 2.添加服务器

2.1.登录iPaaS控制台，进入管理门户，点击菜单 “资源管理” > “ 服务器管理 ” ，选择“服务器管理”页签，进入“服务器管理 ” 界面。

image-20250828142637347

2.2.点击“新增”按钮，填写服务器配置，选择刚刚创建的服务器组，点击“确定”按钮，保存服务器信息。

image-20250828142748098

# 3.添加域

3.1.登录iPaaS控制台，进入管理门户，点击菜单“资源管理”>"域管理“，进入域管理页面。

image-20250828143128980

3.2.点击“新增”按钮，填写域配置，选择上一步所创建的服务器组，点击”确定“按钮，保存域信息。

image-20250828143408616

# 4.添加系统管理

4.1.登录iPaaS控制台，进入管理门户，点击菜单“资源管理”>"系统管理“，进入系统管理页面。

image-20250828143541848

4.2.点击“新增”按钮，填写系统配置，选择上一步创建的域，点击”确定“按钮，保存系统。

image-20250828143815726

# 5.添加端口

5.1.登录iPaaS控制台，进入管理门户，点击菜单“资源管理”>"端口管理“，进入端口管理页面。

image-20250828155817934

5.2.点击“新增”按钮，填写端口、选择HTTP协议，点击”确定“按钮，保存端口。

image-20250828144025159

# 主数据配置

# 1.创建通用接口客户端

1.1.登录主数据控制台，进入管理门户，点击菜单“数据分发”>"服务客户端“，进入服务客户端管理页面。

image-20250828160223517

1.2.点击“新增”按钮，填写客户端信息，点击”确定“按钮，保存客户端。

image-20250828151448211

1.3.保存访问凭证，后续验证步骤需要。

image-20250828160459415

# 2.模型通用接口授权

2.1.登录主数据控制台，进入管理门户，点击菜单“数据分发”>"服务授权“，进入服务授权管理页面。

image-20250828160654352

2.2.点击“新增”按钮，选择模型和上一步创建的客户端，勾选要授权的模型列权限和接口权限，并提交。

image-20250828154246496

image-20250828154856487

# 3.iPaaS接口注册

3.1.登录主数据控制台，进入管理门户，点击菜单“模型管理”>"主数据“，找到上一步授权的模型，点击“服务管理”，进入服务管理页面。

image-20250828161157060

3.2.点击“注册服务按钮”，选择上述步骤中添加的域、系统和端口，并点击“提交”按钮，等待接口注册成功。

image-20250828152303967

image-20250828153902356

# 接口验证

1.登录iPaaS控制台，进入开发门户，点击菜单“API管理”>"我的发布“，从菜单中中找到刚刚发布的API接口。

image-20250828154042967

2.找一个GET接口如GET方式查询业务数据，查询参数body，点击“编辑”按钮打开API文档，复制API访问地址。

image-20250828161857875

3.使用curl验证接口，在header中添加上述步骤中创建的凭证信息。

curl "http://192.168.16.182:8079/api/mdm/openapi/c_supplier/query/get" \
>     --header 'Accept: application/json' \
>     --header 'x-mdm-client-code: iPaaS' \
>     --header 'x-mdm-client-secret: 00a4993270679846B50B2E2623F31a62dE9E'

输出结果

{
    "content": [
        {
            "main_market_area": "华东",
            "supplier_short_name": "IBM CHINA",
            "supplier_status": "1",
            "company_profile": "擦的撒从",
            "company_website": "擦的撒",
            "postal_code": 371243,
            "supplier_name": "IBM",
            "supplier_code": 3421,
            "supplier_brand": "数据库"
        }
    ],
    "pageable": {
        "sort": {
            "sorted": false,
            "unsorted": true,
            "empty": true
        },
        "pageNumber": 0,
        "pageSize": 10,
        "offset": 0,
        "paged": true,
        "unpaged": false
    },
    "totalPages": 1,
    "last": true,
    "totalElements": 1,
    "sort": {
        "sorted": false,
        "unsorted": true,
        "empty": true
    },
    "numberOfElements": 1,
    "first": true,
    "size": 10,
    "number": 0,
    "empty": false
}

← 平台配置 →