### 吉客云与金蝶云星空系统对接集成案例分享：仓库方案-I0111
在企业业务流程中，数据的双向流动和实时同步至关重要。本技术案例将详细介绍如何利用轻易云数据集成平台，将吉客云的数据高效导入到金蝶云星空，并确保整个过程无缝衔接，避免丢单现象。
#### 1. 系统环境与接口概述
此次项目使用了吉客云获取数据的API `erp.warehouse.get` 和金蝶云星空写入数据的API `batchSave`。由于两者在数据结构和传输逻辑上存在差异，因此我们需要自定义转换规则以适应具体需求。
#### 2. 高效的数据抓取与处理机制
为了实现定时可靠地从吉客云接口抓取仓库相关的数据，我们设计了一套基于调度器（Scheduler）的机制。该机制能够按照预设时间周期触发采集任务，并处理分页和限流问题。这一过程中包含以下几个关键步骤：
1. **建立初始连接**：通过配置好的访问令牌（Access Token）及其他认证信息，安全连接到吉客云API。
2. **分页拉取**：通过合理设置每次请求的记录数量及翻页标识符，实现大批量数据分步获取。
3. **错误重试**：加入异常处理策略，对于因网络波动或服务暂时性不可达引起的失败请求，通过自动重试策略保障整体流程不中断。
#### 3. 数据转换与映射
鉴于两套系统间存在显著的数据格式差异，我们使用轻易云提供的可视化数据流设计工具，自定义了特定字段映射关系及转换逻辑。例如，将来自吉客云的一些字段进行清洗、合并后再写入至金蝶云星空所需结构中。这一步骤主要包括：
- 字段匹配与重命名
- 数据类型转换（如字符串转日期）
- 特殊字符过滤
- 空值处理等冗余字段剔除
#### 4. 批量写入与性能优化
为提高效率，我们采用批量提交方式将整理后的大量仓库信息快速写入至金蝶云星空系统。借助其高吞吐量能力，这一操作可以有效减少频繁请求对服务器带来的压力，并提高总体处理速度。此外，通过集中监控和告警系统，对各个节点状态进行实时跟踪，及时发现潜在问题并迅速恢复，从而进一步确保执行过程平稳顺畅。
本文开头部分已经明确展示了利用轻易云数据库集成平台实施跨系统对接的一般思路，在以下章节中，我们
### 调用吉客云接口erp.warehouse.get获取并加工数据
在轻易云数据集成平台中，调用源系统接口是数据处理生命周期的第一步。本文将详细探讨如何通过调用吉客云的`erp.warehouse.get`接口获取仓库数据，并对其进行初步加工。
#### 接口配置与请求参数
根据元数据配置，我们需要通过POST方法调用`erp.warehouse.get`接口。以下是具体的请求参数配置：
- **页码 (pageIndex)**: 用于分页请求，类型为字符串。
- **页大小 (pageSize)**: 每页返回的数据条数，类型为字符串，默认值为50。
- **起始开始时间 (gmtModifiedStart)**: 数据修改的起始时间，类型为字符串，使用模板变量`{{LAST_SYNC_TIME|datetime}}`。
- **结束修改时间 (gmtModifiedEnd)**: 数据修改的结束时间，类型为字符串，使用模板变量`{{CURRENT_TIME|datetime}}`。
这些参数确保了我们能够获取到最新的仓库数据，并且支持分页处理，以便在大数据量情况下进行分批次的数据拉取。
#### 请求示例
以下是一个具体的请求示例：
```json
{
"pageIndex": "1",
"pageSize": "50",
"gmtModifiedStart": "{{LAST_SYNC_TIME|datetime}}",
"gmtModifiedEnd": "{{CURRENT_TIME|datetime}}"
}
```
这个请求将会返回第一页的数据，每页包含50条记录，并且只包含在指定时间范围内被修改过的数据。
#### 数据过滤与条件设置
为了确保我们只获取到有效的仓库数据，我们需要设置过滤条件。根据元数据配置，我们需要过滤掉已经封存的仓库（isBlockup字段值为0表示未封存）。以下是条件配置：
- **condition_bk**: 备用条件，用于特殊情况。
- **condition**: 主条件，用于常规过滤。
具体条件如下：
```json
[
{
"field": "isBlockup",
"logic": "eqv2",
"value": "0"
}
]
```
这个条件确保了我们只获取未封存的仓库信息。
#### 自动填充响应与数据清洗
在轻易云平台中，我们可以启用自动填充响应功能（autoFillResponse），这意味着平台会自动解析并填充API响应中的数据。这一步骤极大地简化了后续的数据清洗和转换工作。
例如，当我们从吉客云接口获取到原始数据后，可以直接利用平台提供的工具进行初步清洗，如去除无效字段、格式化日期等操作。这些操作可以通过简单的配置实现，而无需编写复杂的代码。
#### 数据转换与写入
在完成初步的数据清洗后，我们可以将处理后的数据转换为目标系统所需的格式，并写入到相应的数据存储中。这一步骤通常包括字段映射、数据类型转换等操作。例如，将吉客云返回的仓库编码（warehouseCode）映射到目标系统中的相应字段，并确保其格式符合目标系统要求。
#### 实时监控与调试
轻易云平台提供了实时监控和调试功能，使得我们能够随时查看数据流动和处理状态。在调用吉客云接口并进行初步加工时，可以通过监控界面查看每个环节的数据状态，及时发现并解决潜在问题。
通过上述步骤，我们可以高效地调用吉客云接口获取仓库数据，并对其进行初步加工，为后续的数据集成和分析打下坚实基础。
### 使用轻易云数据集成平台进行ETL转换并写入金蝶云星空API接口的技术案例
在数据集成生命周期的第二阶段，我们将重点讨论如何将已经集成的源平台数据进行ETL转换，并通过金蝶云星空API接口写入目标平台。以下是详细的技术步骤和实现方案。
#### 1. 数据请求与清洗
在数据请求与清洗阶段，我们已经获取了源平台的数据，并进行了必要的清洗和预处理。接下来，我们将这些数据转换为金蝶云星空API接口所能接受的格式。
#### 2. 数据转换与写入
##### 元数据配置解析
根据提供的元数据配置，我们需要将源平台的数据字段映射到金蝶云星空API接口所需的字段。以下是元数据配置中的关键字段及其对应关系：
- `FName` 对应 `仓库名称`，类型为 `string`
- `FNumber` 对应 `编码`，类型为 `string`
- `FStockProperty` 固定值为 `1`，表示仓库属性
- `FCreateOrgId` 和 `FUseOrgId` 固定值为 `I0111`，使用 `ConvertObjectParser` 进行解析
- `FAllowMinusQty` 固定值为 `true`，表示允许即时库存
其他请求参数包括：
- 表单ID (`FormId`) 固定值为 `BD_STOCK`
- 执行操作 (`Operation`) 固定值为 `BatchSave`
- 提交并审核 (`IsAutoSubmitAndAudit`) 固定值为 `true`
- 验证基础资料 (`IsVerifyBaseDataField`) 固定值为 `true`
##### 数据转换过程
在实际操作中，我们需要将源平台的数据按照上述元数据配置进行转换。假设我们从源平台获取到的数据如下：
```json
{
"warehouseName": "主仓库",
"warehouseCode": "WH001"
}
```
根据元数据配置，我们需要生成如下格式的数据以便发送到金蝶云星空API接口：
```json
{
"FormId": "BD_STOCK",
"Operation": "BatchSave",
"IsAutoSubmitAndAudit": true,
"IsVerifyBaseDataField": true,
"data": [
{
"FName": "主仓库",
"FNumber": "WH001",
"FStockProperty": "1",
"FCreateOrgId": {
"FNumber": "I0111"
},
"FUseOrgId": {
"FNumber": "I0111"
},
"FAllowMinusQty": true
}
]
}
```
##### API调用
为了实现上述数据的写入操作，我们需要通过HTTP POST方法调用金蝶云星空的批量保存接口。根据元数据配置，具体的API调用信息如下：
- API路径：`batchSave`
- 请求方法：`POST`
- 是否进行ID校验：`true`
示例代码（假设使用Python）如下：
```python
import requests
import json
url = 'https://api.kingdee.com/batchSave'
headers = {'Content-Type': 'application/json'}
payload = {
'FormId': 'BD_STOCK',
'Operation': 'BatchSave',
'IsAutoSubmitAndAudit': True,
'IsVerifyBaseDataField': True,
'data': [
{
'FName': '主仓库',
'FNumber': 'WH001',
'FStockProperty': '1',
'FCreateOrgId': {'FNumber': 'I0111'},
'FUseOrgId': {'FNumber': 'I0111'},
'FAllowMinusQty': True
}
]
}
response = requests.post(url, headers=headers, data=json.dumps(payload))
if response.status_code == 200:
print('Data successfully written to Kingdee Cloud.')
else:
print('Failed to write data:', response.text)
```
通过上述代码，我们可以将经过ETL转换后的数据成功写入金蝶云星空系统。
#### 总结
本文深入探讨了如何使用轻易云数据集成平台将源平台的数据进行ETL转换，并通过金蝶云星空API接口写入目标平台。我们详细解析了元数据配置，并提供了具体的实现步骤和示例代码，以确保技术细节清晰明了。这一过程不仅提升了业务透明度和效率，也确保了不同系统间的数据无缝对接。
