### 管易云·奇门数据集成到金蝶云星空的技术实现案例
在企业级应用场景中，系统之间的数据集成是一个关键的问题。本文将分享如何通过API接口，将管易云·奇门的销售订单数据无缝对接到金蝶云星空的销售出库模块，实现高效、安全、可靠的数据流转。
#### 案例背景与需求
本次案例主要解决如何从管易云·奇门获取销售订单数据，并批量写入至金蝶云星空对应表单。具体操作包括以下几方面：
1. **定时抓取**：我们采用轻易云平台具备的定时任务调度功能，从管易云·奇门接口`gy.erp.trade.get`定期拉取最新销售订单数据。
2. **批量写入**：利用高吞吐量的数据处理能力，通过金蝶API `batchSave` 批量插入大量订单记录，以提升效率和性能。
3. **监控和告警**：通过实时监控和异常处理机制，确保每个数据处理环节精准透明，同时具备错误重试功能以提高过程稳定性。
#### 关键技术点解析
为了实现上述目标，我们需要重点关注几个技术要点：
- **接口调用与分页限流问题**：
- 在使用`gy.erp.trade.get`接口获取大量数据时，需要考虑分页及限流策略，以防止因超额请求导致服务异常终止。此外，还需保证全周期内不漏单，依赖响应头中的分页信息进行多轮次的数据提取。
- **自定义转换逻辑与映射配置**：
- 数据结构差异是跨系统集成中的常见问题。为此，我们构建了自定义逻辑层来将管易做出的JSON格式转化为符合金蝶要求的模型，这一步骤可以借助轻宜提供的可视化工具来配置映射关系，使得设计更直观且管理更加简捷。
- **实时监控和日志记录**：
- 集成过程中建立全面的日志体系并启用实时状态监测，是保障整个流程透明化不可或缺的一部分；这些措施能帮助我们及时发现并解决潜在问题，提高整体运行可靠性。
所谓“魔鬼藏在细节中”，接下来会详细讲解各步骤中的具体实施方法及注意事项，包括如何合理调度API，正确设置HTTP头信息，以及解析响应结果等，为您完整还原这个复杂但极具实用价值的实际案例。
### 调用管易云·奇门接口gy.erp.trade.get获取并加工数据
在轻易云数据集成平台中，调用源系统接口是数据处理生命周期的第一步。本文将详细探讨如何通过管易云·奇门接口`gy.erp.trade.get`获取销售订单数据，并进行初步加工。
#### 接口配置与请求参数
在轻易云平台中，我们需要配置元数据以调用管易云·奇门接口。以下是关键的元数据配置：
```json
{
"api": "gy.erp.trade.get",
"method": "POST",
"number": "code",
"id": "code",
"pagination": {
"pageSize": 100
},
"idCheck": true,
"request": [
{"field":"start_date","label":"开始时间","type":"string","value":"{{LAST_SYNC_TIME|datetime}}"},
{"field":"end_date","label":"结束时间","type":"string","value":"{{CURRENT_TIME|datetime}}"},
{"field":"date_type","label":"时间类型","type":"string","describe":"默认0 0:创建时间 1:拍单时间2:付款时间3:修改时间","value":"3"},
{"field":"order_state","label":"订单类型","type":"string","describe":"默认0 0:全部1:未审核2:已审核","value":"2"},
{"field":"warehouse_code","label":"仓库代码","type":"string"},
{"field":"shop_code","label":"店铺代码","type":"string"},
{"field":"vip_name","label":"会员名称","type":"string"},
{"field":"platform_code","label":"平台单号","type":"string"},
{"field":"receiver_mobile","label":"收件手机","type":"string"},
{"field":"code","label":"单据编号","type":"string"},
{"field":"has_cancel_data","label":"是否附带返回已取消与已删除的订单数据","type":"string","describe":"false:不返回 true:返回 默认false", "value": "false"}
],
"otherRequest": [
{"field": "page_no", "label": "页号", "type": "string", "describe": "默认1", "value": "{PAGINATION_START_PAGE}"},
{"field": "page_size", "label": "分页大小", "type": "string", "describe": "默认为10", "value": "{PAGINATION_PAGE_SIZE}"}
],
"condition":[
[{"field": "shop_code", "logic": "eqv2", "value": "DY001"}],
[{"field": "shop_code", "logic": "eqv2", "value": "DY002"}]
]
}
```
#### 请求参数解析
1. **基本参数**：
- `start_date` 和 `end_date`：用于指定查询的时间范围，分别对应上次同步时间和当前时间。
- `date_type`：设置为`3`表示按修改时间查询。
- `order_state`：设置为`2`表示只查询已审核的订单。
- `has_cancel_data`：设置为`false`表示不返回已取消或已删除的订单。
2. **分页参数**：
- `page_no` 和 `page_size`：用于控制分页，确保每次请求的数据量适中，避免一次性获取过多数据导致性能问题。
3. **条件过滤**：
- `shop_code`: 使用逻辑运算符“eqv2”进行店铺代码过滤，确保只获取特定店铺的订单。
#### 数据请求与清洗
调用接口后，我们会得到一个包含多个销售订单的数据集。接下来，需要对这些数据进行清洗和初步加工，以便后续的数据转换和写入步骤。以下是一些常见的数据清洗操作：
1. **字段映射**：
将接口返回的数据字段映射到目标系统所需的字段。例如，将管易云中的“单据编号”映射到金蝶系统中的“销售出库单编号”。
2. **数据格式转换**：
确保日期、金额等字段符合目标系统要求的格式。例如，将日期格式从“YYYY-MM-DD HH:mm:ss”转换为“YYYYMMDD”。
3. **异常数据处理**：
对缺失值、异常值进行处理，例如填充默认值或丢弃无效记录。
#### 示例代码
以下是一个简单的示例代码片段，用于调用接口并处理返回的数据：
```python
import requests
import json
from datetime import datetime
# 设置请求参数
params = {
'start_date': (datetime.now() - timedelta(days=1)).strftime('%Y-%m-%d %H:%M:%S'),
'end_date': datetime.now().strftime('%Y-%m-%d %H:%M:%S'),
'date_type': '3',
'order_state': '2',
'has_cancel_data': 'false',
'page_no': '1',
'page_size': '100'
}
# 发起POST请求
response = requests.post('https://api.guanyiyun.com/erp/trade/get', data=json.dumps(params))
# 检查响应状态
if response.status_code == 200:
data = response.json()
# 数据清洗和初步加工
cleaned_data = []
for order in data['orders']:
cleaned_order = {
'sales_outbound_no': order['code'],
'order_date': datetime.strptime(order['created'], '%Y-%m-%d %H:%M:%S').strftime('%Y%m%d'),
# 更多字段映射和转换...
}
cleaned_data.append(cleaned_order)
else:
print(f"Error: {response.status_code}")
# 后续处理...
```
通过以上步骤，我们成功地调用了管易云·奇门接口获取销售订单数据，并进行了初步清洗和加工，为后续的数据转换与写入奠定了基础。这一过程展示了轻易云平台在实现异构系统间无缝对接方面的强大能力。
### 使用轻易云数据集成平台实现管易销售订单到金蝶销售出库的ETL转换
在数据集成生命周期的第二步，我们需要将已经从源平台（如管易）获取的数据进行ETL转换，并将其转化为目标平台（金蝶云星空API接口）能够接收的格式，最终写入目标平台。以下是具体的技术实现过程。
#### 1. API 接口配置
首先，我们需要配置金蝶云星空API接口的元数据。根据提供的元数据配置，我们使用`batchSave` API接口，通过POST方法将数据批量保存到金蝶系统中。
```json
{
"api": "batchSave",
"method": "POST",
"idCheck": true,
"operation": {
"rowsKey": "array",
"rows": 1,
"method": "batchArraySave"
},
"request": [
{"field":"FBillTypeID","label":"单据类型","type":"string","describe":"单据类型","parser":{"name":"ConvertObjectParser","params":"FNumber"},"value":"XSCKD01_SYS"},
{"field":"FBillNo","label":"单据编号","type":"string","describe":"单据编号","value":"{platform_code}"},
{"field":"FDate","label":"日期","type":"string","describe":"日期","value":"{createtime}"},
{"field":"FSaleOrgId","label":"销售组织","type":"string","describe":"组织","parser":{"name":"ConvertObjectParser","params":"FNumber"},"value":"100"},
{"field":"FCustomerID","label":"客户","type":"string","describe":"基础资料","parser":{"name":"ConvertObjectParser","params":"FNumber"},"value":"{shop_code}"},
{"field":"FStockOrgId","label":"发货组织","type":"string","describe":"组织","parser":{"name":"ConvertObjectParser","params":"FNumber"},"value":"100"},
{"field":"FNote","label":"备注","type":"string","describe":"","value":""},
{"field":"F_mhgj_Assistant", "label": "管易订单类型", "type": "string", "describe": "", "value": "{order_type_name}"}
],
...
}
```
#### 2. 数据清洗与转换
在ETL过程中，数据清洗和转换是关键步骤。我们需要确保从源平台获取的数据能够正确映射到目标平台所需的字段格式和类型。
##### 示例：单据类型字段转换
```json
{
"field": "FBillTypeID",
"label": "单据类型",
"type": "string",
"describe": "",
"parser": {
"name": "ConvertObjectParser",
"params": "FNumber"
},
"value": "XSCKD01_SYS"
}
```
这里，我们使用`ConvertObjectParser`解析器，将源数据中的单据类型转换为金蝶系统中的编码`XSCKD01_SYS`。
##### 示例：日期字段映射
```json
{
"field": "FDate",
"label": "",
"type": "",
...
}
```
日期字段直接从源数据中的`createtime`字段映射过来，确保格式一致。
#### 3. 明细信息处理
对于复杂的嵌套结构，如订单明细信息，需要特别注意每个子字段的映射和解析。
```json
{
...
}
```
##### 示例：物料编码转换
```json
{
...
}
```
物料编码需要从源数据中的`item_code`字段映射过来，并通过解析器进行处理。
#### 4. 提交与审核
在所有字段都正确映射并转换后，我们需要将数据提交到金蝶系统，并选择是否自动审核。
```json
{
...
}
```
通过设置`IsAutoSubmitAndAudit`为true，可以实现自动提交并审核，提高业务流程效率。
#### 总结
通过以上步骤，我们成功地将管易销售订单的数据进行ETL转换，并写入到金蝶云星空系统中。在整个过程中，充分利用了轻易云数据集成平台提供的可视化操作界面和强大的解析功能，实现了不同系统间的数据无缝对接。
