### 系统对接集成案例分享：金蝶云星空数据集成到轻易云平台
在企业系统集成过程中，实现不同平台的数据互通是一个关键任务。我们将聚焦于如何通过轻易云数据集成平台，将金蝶云星空的物料ID基本单位信息高效、可靠地同步过来，具体方案命名为W查询金蝶物料ID基本单位-T00。
**技术要点**：
1. **高效写入与大数据处理能力**
- 为了确保大量数据能够快速从金蝶云星空系统中写入到轻易云平台，我们选择了支持高吞吐量的数据写入策略，通过优化网络传输和API调用频率，有效提升了整体处理时效性。
2. **实时监控与告警机制**
- 采用集中监控和告警系统，对所有数据流动状态进行实时跟踪，使问题能够在第一时间被发现和解决，这对于保障各节点的稳定运作至关重要。此外，异常检测功能可以及时捕捉并处理各种可能出现的数据质量问题。
3. **自定义转换逻辑与格式差异处理**
- 金蝶云星空和轻易云集成平台之间存在一定的数据格式差异。通过自定义的数据转换逻辑，我们灵活适配了特定业务需求。这一过程主要依赖于对executeBillQuery接口返回结果的解析，并根据需要进行重新映射，以此保证最终存储在目标系统中的数据准确无误。
4. **API资产管理与资源优化配置**
- 借助双平台提供的API资产管理功能，通过统一视图控制台全面掌握各个接口使用情况。从而实现对资源的最优调度，同时也便于后续维护工作。
5. **分页及限流策略实施**
- 针对executeBillQuery接口可能遇到的大量分页请求以及调用次数限制，我们进行了合理化设计。一方面，通过批量抓取技术提高单次获取效率；另一方面，采用限流防护措施避免超载请求带来的额外开销，从而保障整体运行平稳、高效。
以上几点构建出一个具备高性能、强鲁棒性且能灵活应变业务需求的数据集成方案，为企业内部多个信息化模块间无缝衔接奠定坚实基础。在接下来的详细介绍中，我们将逐步拆解这个方案，实现每一步细节操作。
### 调用金蝶云星空接口executeBillQuery获取并加工数据
在轻易云数据集成平台的生命周期中，调用源系统接口是至关重要的一步。本文将深入探讨如何通过调用金蝶云星空的`executeBillQuery`接口来获取并加工数据。
#### 接口配置与请求参数
在元数据配置中，我们使用了`executeBillQuery`接口，该接口的主要作用是查询金蝶系统中的业务数据。以下是该接口的详细配置：
- **API**: `executeBillQuery`
- **Method**: `POST`
- **Effect**: `QUERY`
- **Request Fields**:
- `FMasterId`: id
- `FNumber`: 编码
- `FCreateOrgId_FNumber`: 创建组织
- `FUseOrgId`: 使用组织
- `FUseOrgId_FNumber`: 使用组织编码
- `FBaseUnitId`: 基本单位ID
- `FIsBatchManage`: 是否启用批号管理
- `FBaseUnitId_FNumber`: 基本单位编码
此外，还有一些其他请求参数用于分页和过滤：
- **Limit**: 最大行数，默认值为2000。
- **StartRow**: 开始行索引，用于分页。
- **TopRowCount**: 返回总行数。
- **FilterString**: 过滤条件，例如：`FUseOrgId.FNumber='T00' and FModifyDate>='{{LAST_SYNC_TIME|datetime}}'`。
- **FieldKeys**: 查询字段集合，格式为数组。
- **FormId**: 表单ID，例如：`BD_MATERIAL`。
#### 请求示例
为了更好地理解如何调用该接口，以下是一个具体的请求示例：
```json
{
"api": "executeBillQuery",
"method": "POST",
"number": "FNumber",
"id": "FMasterId",
"name": "FNumber",
"idCheck": true,
"request": [
{"field":"FMasterId","label":"id","type":"string","describe":"id","value":"FMasterId"},
{"field":"FNumber","label":"编码","type":"string","describe":"编码","value":"FNumber"},
{"field":"FCreateOrgId_FNumber","label":"创建组织","type":"string","describe":"创建组织","value":"FCreateOrgId.FNumber"},
{"field":"FUseOrgId","label":"使用组织","type":"string","describe":"使用组织","value":"FUseOrgId"},
{"field":"FUseOrgId_FNumber","label":"使用组织编码","type":"string","value":"FUseOrgId.FNumber"},
{"field":"FBaseUnitId","label":"基本单位ID","type":"string","value":"FBaseUnitId"},
{"field":"FIsBatchManage","label":"是否启用批号管理","type":"string","value":"FIsBatchManage"},
{"field":"FBaseUnitId_FNumber","label":"基本单位编码","type":"string","value":"FBaseUnitId.FNumber"}
],
"otherRequest": [
{"field": "Limit", "label": "最大行数", "type": "string", "describe": "金蝶的查询分页参数", "value": "2000"},
{"field": "StartRow", "label": "开始行索引", "type": "string", "describe": "金蝶的查询分页参数", "value": "{PAGINATION_START_ROW}"},
{"field": "TopRowCount", "label": "返回总行数", "type": "int", "describe": "金蝶的查询分页参数"},
{"field": "FilterString", "label": "过滤条件", "type": "string",
"describe":
"示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>=",
"value":
"FUseOrgId.FNumber='T00' and FModifyDate>='{{LAST_SYNC_TIME|datetime}}'"
},
{"field":
"FieldKeys",
"label":
"需查询的字段key集合",
"type":
"array",
"describe":
"金蝶分录主键ID格式： FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber",
"parser":{
"name":
"ArrayToString",
"params":
","
}
},
{
"field":
"FormId",
"label":
"业务对象表单 Id ",
"type":
" string ",
" describe ":
必须填写金蝶的表单 ID 如 :PUR_PurchaseOrder ",
value ":"
BD_MATERIAL "
}
],
autoFillResponse : true ,
omissionRemedy :{
crontab :"*\/5 * * * * ",
takeOverRequest :[
{
field :" FilterString ",
value :" FUseOrgId.FNumber =' T00 ' and FModifyDate >=' {{MINUTE_AGO_10|datetime}}'",
type :" string ",
label :" 接管字段 ",
formModel :{
enable : false
},
tableModel :{
enable : false
},
physicalModel :{
enable : false
}
}]
}
}
```
#### 数据处理与清洗
在获取到数据后，需要对数据进行清洗和加工，以确保其符合目标系统的数据格式和业务需求。以下是几个关键步骤：
1. **字段映射与转换**：根据目标系统的数据结构，对原始数据进行字段映射。例如，将`金蝶云星空`中的`基本单位编码`映射到目标系统中的相应字段。
2. **数据过滤与校验**：根据业务规则，对数据进行过滤和校验。例如，检查是否启用了批号管理（`是否启用批号管理`字段）。
3. **异常处理与日志记录**：对于异常情况，如数据缺失或格式错误，需要进行处理并记录日志，以便后续排查问题。
#### 自动填充与接管机制
轻易云平台提供了自动填充响应和接管机制，以确保数据集成过程的连续性和稳定性。例如，当某个时间段内的数据未能成功同步时，可以通过接管机制重新发起请求，确保数据完整性。
自动填充响应配置如下：
```json
{
autoFillResponse : true ,
omissionRemedy :{
crontab :"*\/5 * * * * ",
takeOverRequest :[
{
field :" FilterString ",
value :" FUseOrgId.FNumber =' T00 ' and FModifyDate >=' {{MINUTE_AGO_10|datetime}}'",
type :" string ",
label :" 接管字段 ",
formModel :{
enable : false
},
tableModel :{
enable : false
},
physicalModel :{
enable : false
}
}]
}
}
```
通过以上配置，可以实现每5分钟检查一次未同步的数据，并重新发起请求以补全遗漏的数据。
#### 总结
通过调用金蝶云星空的`executeBillQuery`接口，我们可以高效地获取并加工所需的数据。结合轻易云平台提供的自动化工具和机制，可以显著提升数据集成过程的效率和可靠性。在实际应用中，根据具体业务需求灵活调整配置，将进一步优化集成效果。
### 数据集成生命周期中的ETL转换与写入
在数据集成生命周期的第二步中，我们需要将已经集成的源平台数据进行ETL转换，使其符合目标平台轻易云集成平台API接口所能够接收的格式，并最终写入目标平台。本文将详细探讨这一过程，重点关注API接口和数据集成的技术细节。
#### 数据请求与清洗
在进行ETL转换之前，首先需要从源平台获取原始数据，并对其进行清洗。这一步骤确保了数据的准确性和一致性，为后续的转换和写入打下坚实基础。假设我们已经完成了这一步，接下来我们将重点讨论如何将清洗后的数据转换为目标平台所需的格式。
#### 数据转换
在轻易云数据集成平台中，数据转换是指将源平台的数据结构和格式转换为目标平台所能识别和处理的形式。这一过程通常涉及到字段映射、数据类型转换以及必要的数据处理逻辑。
根据提供的元数据配置，我们需要将源平台的数据字段映射到目标平台API接口所需的字段。以下是一个简单的数据映射示例：
```json
{
"sourceData": {
"物料ID": "12345",
"基本单位": "件",
"编码": "ABC123"
},
"targetData": {
"number": "12345",
"id": "件",
"name": "ABC123"
}
}
```
在这个示例中，我们将源平台的`物料ID`映射到目标平台的`number`字段，将`基本单位`映射到`id`字段，将`编码`映射到`name`字段。
#### 写入目标平台
完成数据转换后，我们需要通过API接口将转换后的数据写入目标平台。根据元数据配置，目标API接口的信息如下：
- API: 写入空操作
- 方法: POST
- 参数:
- number: 对应物料ID
- id: 对应基本单位
- name: 对应编码
- idCheck: true (表示需要检查ID)
我们可以使用以下代码示例来实现这一过程：
```python
import requests
# 转换后的数据
data = {
"number": "12345",
"id": "件",
"name": "ABC123",
"idCheck": True
}
# API接口URL
url = 'https://api.qingyiyun.com/write'
# 发起POST请求写入数据
response = requests.post(url, json=data)
# 检查响应状态码以确认是否成功写入
if response.status_code == 200:
print("数据成功写入目标平台")
else:
print(f"写入失败，状态码：{response.status_code}")
```
在这个代码示例中，我们使用Python的requests库发起POST请求，将转换后的数据发送到指定的API接口URL。通过检查响应状态码，我们可以确认数据是否成功写入目标平台。
#### 实践中的注意事项
1. **字段校验**：确保所有必需字段都已正确映射并包含在请求中。
2. **错误处理**：对可能出现的错误情况进行处理，例如网络问题、API调用失败等。
3. **日志记录**：记录每次API调用的详细信息，包括请求参数和响应结果，以便于后续排查问题。
通过以上步骤，我们实现了从源平台获取原始数据、进行ETL转换并最终写入目标平台的全过程。在实际应用中，这一过程可能会更加复杂，需要根据具体业务需求进行定制化处理。
