### 09-其他入库单：从旺店通·旗舰奇门到金蝶云星空的数据集成案例
在这一技术案例中，我们将详细解析如何高效地将"旺店通·旗舰奇门"中的`其他入库单`数据通过轻易云数据集成平台对接到`金蝶云星空`。解决方案的核心是利用API接口实现数据抓取、处理与写入，从而确保业务流程的顺畅执行。
#### 确保集成旺店通·旗舰奇门数据不漏单
首先，通过调用API `wdt.wms.stockin.other.querywithdetail`定时可靠地抓取旺店通·旗舰奇门的入库数据。该接口支持分页查询，使我们能够在应对大规模数据时依旧保持稳定和高效。同时，为防止漏单情况，每次成功获取一批次的数据后，记录下本次请求的起始时间和结束时间，作为下一次请求的基础参照点。这种机制极大保证了所有新增或修改过的数据都能被及时捕捉。
#### 批量快速写入到金蝶云星空
为了将抓取到的数据高效导入至金蝶云星空，我们使用其提供的大批量写入API `batchSave`。在具体实施过程中，需要注意两个方面的重要问题：首先是处理频繁调用所导致限流问题，其次则是面对两套系统间显著差异的数据格式。在此场景中，通过轻易云强大的脚本功能，对原始JSON格式进行预处理，将其转换为符合目标系统要求的结构，并进行必要字段映射及校验。此外，还配置合理的重试机制，以应对偶发性网络故障或突发性异常，提高整体系统可用性。
#### 处理分页和限流问题
调用旺店通·旗舰奇门接口时存在分页限制，这意味着每个请求只能获取有限条数的信息。因此，在设计适配器程序时采取循环遍历方式逐页读取，并利用缓存保存已读取页码进度，以便意外终止后可续传。此外，通过设置合理延迟间隔来规避服务端限流，同时开发错峰调度策略，提高整体并发性能。
#### 数据监控与日志记录
为了实时掌握整个处理过程状态，特别是排查潜在错误干扰因素，实现精细化运维管理技巧上不可或缺的一环即为全程日志记录。从拉取源头信息，到清洗加工，再到提交目标系统，各节点步骤均需详尽记录，包括操作成功与否标志以及耗时时长等关键指标。有助于后期复盘分析优化调整，也成为有效监管保障手段之一。
这只是关于该集成项目一部分
### 调用旺店通·旗舰奇门接口wdt.wms.stockin.other.querywithdetail获取并加工数据
在数据集成生命周期的第一步，我们需要从源系统中调用API接口获取原始数据，并进行初步加工。本文将详细探讨如何通过轻易云数据集成平台调用旺店通·旗舰奇门接口`wdt.wms.stockin.other.querywithdetail`，并对返回的数据进行处理。
#### 接口配置与请求参数
该接口的主要功能是查询其他入库单的详细信息。我们使用POST方法进行请求，并配置相应的元数据。以下是具体的请求参数配置：
```json
{
"api": "wdt.wms.stockin.other.querywithdetail",
"method": "POST",
"number": "order_no",
"id": "stockin_id",
"idCheck": true,
"request": [
{
"field": "pager",
"label": "分页参数",
"type": "object",
"children": [
{
"field": "page_size",
"label": "分页大小",
"type": "string",
"value": "50",
"parent": "pager"
},
{
"field": "page_no",
"label": "页号",
"type": "string",
"value": "1",
"parent": "pager"
}
]
},
{
"field": "params",
"label": "业务参数",
"type": "object",
...
}
]
}
```
#### 分页参数
分页参数用于控制每次请求返回的数据量和页码，以便于处理大量数据时分批获取。具体字段如下：
- `page_size`: 分页大小，设置为50，表示每次请求返回50条记录。
- `page_no`: 页号，初始值为1，表示从第一页开始获取数据。
#### 业务参数
业务参数用于指定查询条件，包括时间范围、状态、仓库编号等。具体字段如下：
- `start_time` 和 `end_time`: 起始时间和结束时间，用于限定查询的时间范围。这两个字段通常使用动态变量，如`{{LAST_SYNC_TIME|datetime}}`和`{{CURRENT_TIME|datetime}}`。
- `status`: 入库单状态，这里设置为80，表示只查询已完成的入库单。
- `warehouse_no`: 仓库编号，用于指定查询哪个仓库的数据。
- `stockin_no`, `other_stockin_no`, `reason_name`: 分别为入库单号、其它入库业务单号和入库原因，用于更精确地过滤查询结果。
#### 数据请求与清洗
在完成接口配置后，我们通过轻易云平台发起API请求，获取原始数据。接下来，需要对返回的数据进行清洗和初步加工，以确保其符合后续处理的要求。
1. **数据格式转换**: 将API返回的数据格式转换为平台内部统一的数据格式，以便于后续处理。例如，将JSON格式的数据转换为表格形式。
2. **字段映射**: 根据需求，将API返回的数据字段映射到目标系统所需的字段。例如，将`order_no`映射到目标系统中的订单编号字段。
3. **数据过滤**: 根据业务逻辑，对原始数据进行过滤。例如，只保留状态为已完成（status=80）的记录。
#### 实践案例
假设我们需要获取2023年10月1日至2023年10月31日期间，某仓库（仓库编号为WH001）的所有已完成入库单，并将其导入到目标系统中。我们可以按照以下步骤进行操作：
1. **配置时间范围**:
```json
{
...
{
field: 'start_time',
value: '2023-10-01T00:00:00'
},
{
field: 'end_time',
value: '2023-10-31T23:59:59'
}
...
}
```
2. **配置仓库编号**:
```json
{
...
{
field: 'warehouse_no',
value: 'WH001'
}
...
}
```
3. **发起API请求**:
使用轻易云平台提供的工具发起POST请求，并捕获返回结果。
4. **数据清洗与转换**:
对返回的数据进行清洗和转换，将其整理成目标系统所需的格式。
通过以上步骤，我们可以高效地从旺店通·旗舰奇门系统中获取并处理其他入库单的数据，为后续的数据集成工作打下坚实基础。
### 使用轻易云数据集成平台进行ETL转换并写入金蝶云星空API接口
在数据集成过程中，ETL（Extract, Transform, Load）转换是至关重要的一步。本文将详细介绍如何使用轻易云数据集成平台，将已经集成的源平台数据进行ETL转换，并最终写入金蝶云星空API接口。
#### 配置元数据
首先，我们需要配置元数据以确保数据能够正确地从源平台转换为目标平台所需的格式。以下是我们使用的元数据配置：
```json
{
"api": "batchSave",
"method": "POST",
"idCheck": true,
"operation": {
"rowsKey": "array",
"rows": 20,
"method": "batchArraySave"
},
"request": [
{"field":"FBillNo","label":"单据编号","type":"string","describe":"单据编号","value":"{order_no}"},
{"field":"FBillTypeID","label":"单据类型","type":"string","describe":"单据类型","parser":{"name":"ConvertObjectParser","params":"FNumber"},"value":"QTRKD01_SYS"},
{"field":"FStockOrgId","label":"库存组织","type":"string","describe":"组织","parser":{"name":"ConvertObjectParser","params":"FNumber"},"value":"100"},
{"field":"FStockDirect","label":"库存方向","type":"string","describe":"下拉列表","value":"1"},
{"field":"FDate","label":"日期","type":"string","describe":"日期","value":"{{created_time|datetime}}"},
{"field":"FDEPTID","label":"部门","type":"string","describe":"基础资料","value":"BM000032","parser":{"name":"ConvertObjectParser","params":"FNumber"}},
{"field":"FOwnerTypeIdHead","label":"货主类型","type":"string","describe":"多类别基础资料列表","value":"BD_OwnerOrg"},
{"field":"FOwnerIdHead","label":"货主","type":"string","describe":"多类别基础资料","parser":{"name":"ConvertObjectParser","params":"FNumber"},"value":"100"},
{"field": "FNOTE", "label": "备注", "type": "string", "describe": "多行文本"},
{
"field": "FEntity",
"label": "明细信息",
"type": "array",
"children": [
{"field": "FInStockType", "label": "入库类型", "type": "string", "describe": "下拉列表", "parent": "FEntity"},
{"field": "FMATERIALID", "label": "物料编码", "type": "string",
"describe":
"基础资料",
"parser":
{"name":
"ConvertObjectParser",
"params":
"FNumber"
},
"value":
"{{detail_list.spec_no}}",
"parent":
"FEntity"
},
{"field":
"FSTOCKID",
"label":
"收货仓库",
"type":
"string",
"describe":
"基础资料",
"parser":
{"name":
"ConvertObjectParser",
"params":
"FNumber"
},
"value":
"{warehouse_no}",
"parent":
"FEntity"
},
{"field":
"FQty",
"label":
```
