案例分享：聚水潭数据集成到金蝶云星空

在本案例中，我们将探讨如何利用轻易云数据集成平台，实现从聚水潭系统的调拨单数据高效、准确地对接到金蝶云星空的分布式调入单。该技术方案旨在解决跨系统的数据流转问题，确保关键业务数据不遗漏且实时更新。

首先，为了确保集成过程中的安全性和完整性，我们使用了聚水潭提供的API接口/open/allocate/query来定时可靠地抓取调拨单信息。在实际操作中，由于聚水潭接口有分页和请求速率限制的问题，因此我们设计了一个具备智能重试机制的调用策略。这种策略不仅能够有效应对限流，还保证了大批量数据的稳定获取。

其次，对于不同系统间的数据格式差异问题，我们通过轻易云平台自带的数据映射功能，将聚水潭返回的数据转换为符合金蝶云星空API batchSave 接口要求的数据格式。该映射过程支持高度可定制化，使得各项属性能够精确匹配。此外，通过脚本控制和可视化配置界面，大幅度降低了人工干预错误，并提高工作效率。

为了实现大量数据快速写入到金蝶云星空，我们采取了并发批量处理方式，即将抓取到的大批量调拨单按一定规则切割为多个小批次，并行调用金蝶云星空的相应接口进行写入操作。这样既提升了整体处理速度，又避免由于单个请求太大导致失败的问题。

最后，在整个集成过程中，针对可能出现的数据对接异常情况，如网络故障或 API 调用失败等，设置了一套完备的错误重试机制。一旦某一步骤发生异常，该机制会自动捕获错误信息并进行多次重试，以确保最终成功完成任务。同时还引入实时监控与日志记录模块，这样即使在问题发生后，也能快速定位原因并及时解决。

以上就是本案例开篇部分介绍内容，同时为后续详解每部分具体实施方案奠定基础。

调用聚水潭接口/open/allocate/query获取并加工数据

在数据集成的生命周期中，调用源系统接口获取数据是至关重要的一步。本文将详细探讨如何通过轻易云数据集成平台调用聚水潭的调拨单查询接口/open/allocate/query，并对获取的数据进行加工处理。

接口配置与请求参数

首先，我们需要配置调用聚水潭接口的元数据。以下是该接口的元数据配置：

{
  "api": "/open/allocate/query",
  "effect": "QUERY",
  "method": "POST",
  "number": "io_id",
  "id": "io_id",
  "name": "name",
  "idCheck": true,
  "request": [
    {"field": "modified_begin", "label": "修改起始时间", "type": "string", "value": "{{LAST_SYNC_TIME|datetime}}"},
    {"field": "modified_end", "label": "修改结束时间", "type": "string", "value": "{{CURRENT_TIME|datetime}}"},
    {"field": "page_index", "label": "第几页", "type": "string", "value":"1"},
    {"field": "page_size", "label":"每页多少条","type":"string","describe":"默认30，最大50","value":"30"},
    {"field":"type","label":"调拨类型","type":"string","value":"调拨入"}
  ],
  "autoFillResponse": true
}

该配置定义了调用/open/allocate/query接口所需的各项参数，包括起始和结束时间、分页信息以及调拨类型。具体字段说明如下：

• modified_begin 和 modified_end: 分别表示查询的起始和结束时间，使用模板变量动态填充。
• page_index: 当前页码，默认为1。
• page_size: 每页记录数，默认为30，最大值为50。
• type: 调拨类型，此处固定为“调拨入”。

数据请求与清洗

在实际操作中，我们通过POST请求方式调用该接口，并传递上述参数以获取调拨单数据。以下是一个示例请求体：

{
  "modified_begin": "{{LAST_SYNC_TIME|datetime}}",
  "modified_end": "{{CURRENT_TIME|datetime}}",
  "page_index": 1,
  "page_size": 30,
  "type": "调拨入"
}

轻易云平台会自动处理这些参数，并发出HTTP请求以获取响应数据。响应的数据通常包含多个调拨单记录，每个记录包括多个字段，如io_id（调拨单号）、name（名称）等。

数据转换与写入

获取到原始数据后，需要对其进行清洗和转换，以便后续写入目标系统。在这个过程中，可以利用轻易云平台提供的可视化工具，对数据进行过滤、映射和格式化。例如：

• 过滤无效记录：通过条件过滤器排除不符合业务规则的记录。
• 字段映射：将聚水潭的数据字段映射到目标系统所需的字段。例如，将io_id映射为金蝶系统中的对应字段。
• 格式化处理：对日期、金额等字段进行格式化，以符合目标系统的要求。

以下是一个简单的数据转换示例：

[
  {
    "_sourceFieldName_1_": "_targetFieldName_1_",
    "_sourceFieldName_2_": "_targetFieldName_2_"
    // 更多字段映射...
  }
]

实时监控与日志记录

在整个数据集成过程中，实时监控和日志记录是确保数据准确性和及时性的关键。轻易云平台提供了全面的监控功能，可以实时查看每个步骤的数据流动情况，并记录详细日志以便追踪和排查问题。

通过上述步骤，我们实现了从聚水潭系统获取调拨单数据并加工处理，为后续写入金蝶系统做好准备。这一过程不仅提高了数据处理效率，也确保了业务流程的透明性和可追溯性。

使用轻易云数据集成平台将聚水潭调拨单转换并写入金蝶云星空API接口

在数据集成过程中，ETL（Extract, Transform, Load）是一个关键步骤。本文将详细探讨如何使用轻易云数据集成平台将聚水潭的调拨单数据进行转换，并通过金蝶云星空API接口写入目标平台。

元数据配置解析

元数据配置是实现数据转换和写入的核心。以下是针对金蝶云星空API接口的具体配置：

{
  "api": "batchSave",
  "effect": "EXECUTE",
  "method": "POST",
  "idCheck": true,
  "request": [
    {
      "field": "FBillNo",
      "label": "单据编号",
      "type": "string",
      "describe": "单据编号",
      "value": "{io_id}"
    },
    {
      "field": "FStockOrgID",
      "label": "调入库存组织",
      ...
    }
  ],
  ...
}

数据字段解析与映射

1. 单据编号（FBillNo）：

   • 类型：string
   • 来源字段：{io_id}
   • 描述：该字段用于标识调拨单的唯一编号。

2. 调入库存组织（FStockOrgID）：

   • 类型：string
   • 来源字段：_function CASE '{lock_link_wh_id}' WHEN '' THEN '115' ELSE '{lock_link_wh_id}' END
   • 描述：根据条件判断设置库存组织ID，如果为空则默认值为115。

3. 日期（FDate）：

   • 类型：string
   • 来源字段：{io_date}
   • 描述：调拨单的日期。

4. 明细信息（FSTKTRSINENTRY）：

   • 类型：array
   • 描述：包含多个子字段，如物料编码、计划调拨数量等。

{
  "field": "FSTKTRSINENTRY",
  ...
  "children": [
    {
      ...
    },
    {
      "field": "FMaterialID",
      ...
    }
  ]
}

数据转换逻辑

1. 基础字段转换： 每个基础字段如FBillNo, FStockOrgID, FDate等，直接从源数据中提取并映射到目标格式。这些字段大多为简单的字符串类型，转换过程较为直接。

2. 条件判断与默认值设置： 使用 _function CASE ... END 语法，根据条件设置不同的值。例如，FStockOrgID 和 FOwnerIdHead 的值根据 lock_link_wh_id 是否为空来决定。

3. 数组类型字段处理： 对于数组类型的字段如 FSTKTRSINENTRY，需要处理每个子项。每个子项包含多个子字段，例如 FMaterialID, FSrcMaterialId, FDestStockID, FQty 等。这些子字段同样需要从源数据中提取并进行相应的转换。

API 请求构建

根据上述元数据配置和转换逻辑，最终构建出符合金蝶云星空API要求的数据格式。以下是一个简化示例：

{
  "FormId": "STK_TRANSFERIN",
  ...
  "Model": {
    ...
    "FBillNo": "{io_id}",
    ...
    "FSTKTRSINENTRY": [
      {
        ...
        "FMaterialID": "{{items.sku_id}}",
        ...
        "FDestStockID": "{wms_co_id}",
        ...
        "FQty": "{{items.qty}}"
      }
    ]
  }
}

提交与审核

在完成数据转换后，通过POST请求将构建好的JSON数据提交到金蝶云星空API接口。元数据配置中的 "IsAutoSubmitAndAudit" 字段设置为 true，表示在提交后自动审核。

{
  ...
  "IsAutoSubmitAndAudit": true,
  ...
}

实践案例

假设我们有一个聚水潭调拨单，其部分原始数据如下：

{
  ...
  "io_id": "IO12345",
  ...
  "items": [
    {
      ...
      "sku_id": "SKU001",
      ...
      "qty": 100
    }
  ]
}

经过上述ETL过程，生成的目标格式如下：

{
  ...,
  FBillNo: 'IO12345',
  ...,
  FSTKTRSINENTRY: [
    {
      FMaterialID: 'SKU001',
      ...,
      FQty: '100'
    }
  ]
}

通过这种方式，我们可以确保聚水潭调拨单的数据被正确地转换并写入到金蝶云星空系统中，从而实现跨系统的数据集成和业务流程自动化。