[自研开源] MyData 使用手册 v0.7.1

作者：LIEN

2024-03-07
江苏
本文字数：1884 字
阅读完需：约 6 分钟

版本介绍

MyData v0.7.1 版本主要提供在项目范围内多个环境的数据集成，通过定时任务调用应用的 API 获取、存储和消费业务数据；

系统架构

采用前后端分离的模式，前端使用 Sword 框架开发，后端使用 SpringBlade 框架的 Boot 版本开发；
系统分为 3 个服务，分别是：管理服务、任务服务、业务数据服务；
管理服务，提供数据集成的管理功能；
任务服务，根据任务配置调用第三方接口，分别实现：调用接口获取数据并交由数据服务存储和从数据服务读取数据并调用接口消费数据；
业务数据服务，封装 MongoDB 实现自定义标准数据的存储和动态扩展；

功能介绍

登录系统

默认租户 id 是 6 个 0，账密 admin/admin，填写验证码点击登录按钮；

数据融合

以下介绍实现数据集成的过程，示例内容为模拟 3 个应用之间的数据集成；

应用管理

应用管理用于维护应用信息，以便集成时了解数据的来源和去向；

示例中添加了 3 个应用，其中 hr 系统作为用户数据的来源，oa 和 pm 系统消费用户数据；

API 管理

API 管理用于维护接口信息，以便任务通过调用 API 传输数据；

新增 API

API 类型的 提供数据 表示该接口返回数据、消费数据 表示该接口接收数据；
相对路径是指接口不包含 ip 和端口的访问地址，结合环境的前置路径形成完整路径，减少 API 的维护量；
数据类型目前仅支持 JSON 格式；
JSON 字段层级前缀，格式为 x.y.z，根据 API 类型有 2 种情况
若 API 类型是提供数据，则表示从接口返回 JSON 的哪一层解析业务数据；

例如下 JSON，则前缀需设置为 data；

{    "code": 200,    "success": true,    "data": [{        "createUser": -1,        "createTime": "",        "updateUser": -1,        "updateTime": "",        "status": -1,        "isDeleted": 0,        "id": 1,        "userCode": "user_001",        "userName": "用户11",        "birthday": "2000-01-01 00:00:00",        "age": 1,        "salary": 111.00        },        ...    ],    "msg": "操作成功"}

复制代码

若 API 类型是消费数据，则表示调用接口传递 JSON 数据时需增加的属性名；

同上示例，若设置为 data 则向接口发送的 JSON 如下：

{    "data": [{        "createUser": -1,        "createTime": "",        "updateUser": -1,        "updateTime": "",        "status": -1,        "isDeleted": 0,        "id": 1,        "userCode": "user_001",        "userName": "用户11",        "birthday": "2000-01-01 00:00:00",        "age": 1,        "salary": 111.00        },        ...    ]}