金蝶云星空API数据写入：ETL转换技术案例

  • 轻易云集成顾问-叶威宏

MySQL数据集成到金蝶云星空的技术实现：MOM-ZJDB-领料直接调拨单-ok

在企业信息化系统中，高效的数据集成是确保业务运作顺畅的重要一环。本案例将深入探讨如何利用轻易云数据集成平台，将MySQL数据库中的数据无缝对接至金蝶云星空，从而实现高效可靠的业务自动化处理。具体方案名称为“MOM-ZJDB-领料直接调拨单-ok”，其成功实施得益于多项先进技术和操作方法，在此分享关键步骤与细节。

首先，我们需要解决的是从MySQL获取数据信息并快速稳定地写入到金蝶云星空。在这个过程中，选择合适的数据抓取策略和解决分页、限流问题显得尤为重要。我们采用了定时任务来可靠地抓取MySQL接口(select)的数据，通过优化API调用效率，实现大批量数据信息的及时获取。同时，为了应对大量数据传输带来的压力，设置分页机制并结合限流策略，确保每次请求不会过载服务器，提高系统整体性能。

其次，在将数据写入金蝶云星空(batchSave API)前，需要进行必要的数据转换。这不仅包括格式上的转换，还涉及某些字段逻辑上的处理，以满足不同系统间差异化需求。基于自定义的数据转换规则，可以灵活调整各个字段的映射关系以及值域范围，确保最终写入后的数据能够准确反映实际业务需求。

为了增强整个流程管控能力，我们还部署了实时监控及告警系统，对每一步骤进行细致跟踪。例如，当出现异常时，会即时触发告警通知相关人员采取措施，并记录详细日志供后续分析。此外，通过集中监控视图，可以全面掌握所有API资产及其使用情况，有助于进一步优化资源配置，提高管理效率。

以上就是此次案例项目初步实施中的核心内容。在随后的章节中，我们将继续详细描述具体配置过程和代码实现，展示更多实用技术技巧与应用场景。 数据集成平台API接口配置

使用轻易云数据集成平台调用MySQL接口获取并加工数据

在数据集成过程中，调用源系统接口获取数据是至关重要的一步。本文将详细介绍如何使用轻易云数据集成平台，通过调用MySQL接口select方法来获取并加工数据。

元数据配置解析

元数据配置是实现数据请求与清洗的关键。以下是一个典型的元数据配置示例：

{
  "api": "select",
  "effect": "QUERY",
  "method": "POST",
  "id": "sourceid",
  "request": [
    {
      "field": "main_params",
      "label": "主参数",
      "type": "object",
      "describe": "对应其它请求字段内SQL语句的主参数，必须一一对应。",
      "value": "1",
      "children": [
        {
          "field": "limit",
          "label": "限制结果集返回的行数",
          "type": "int",
          "describe": "必要的参数！LIMIT 子句用于限制查询结果返回的行数。它指定了查询应该返回的最大行数。例如，LIMIT 10 表示查询结果只包含最多 10 行数据。这对于分页查询非常有用，可以在每次查询中返回一定数量的结果。",
          "value": "{PAGINATION_PAGE_SIZE}"
        },
        {
          "field": "offset",
          "label": "偏移量",
          "type": "int",
          "describe": "OFFSET 子句用于指定查询结果的起始位置或偏移量。它表示查询应该从结果集的哪一行开始返回数据。例如，OFFSET 20 表示查询应该从结果集的第 21 行开始返回数据。结合 LIMIT 子句使用时，OFFSET 指定了查询结果的起始行数。",
          "value": "{PAGINATION_START_ROW}"
        }
      ]
    }
  ],
  ...
}

SQL语句优化与参数绑定

在元数据配置中，主SQL语句采用了动态语法字段，例如:limit和:offset。为了确保字段与请求参数一一对应，我们需要进行参数绑定：

select
t1.iface_id as sourceid,
CONCAT(t1.instruction_doc_num, '_', t1. instruction_doc_line_num, '_', t1.iface_id) as '单据编号',
ifnull((select aft_quiet_time from ty_mes.mt_account_period where t1.transaction_date < aft_quiet_time order by account_period_id desc limit 1), t1.transaction_date) as '单据日期',
t1.erp_doc_type_id as '单据类型',
t1.transfer_biz_type as '调拨类型',
t1.transfer_direct as '调拨方向',
t1.stock_out_orgid as '调出库存组织',
t1.stock_org_id as '调入库存组织',
t1.owner_type_out_id_head as '调出货主类型',
t1.owner_type_id_head as '调入货主类型',
t1.erp_material_id as '明细物料编码',
t1.erp_from_locator_id as '明细调出仓库',
t1.erp_to_locator_id as '明细调入仓库',
t1.erp_unit_id as '明细单位',
t1.quantity as '明细调拨数量',
t1.base_unit_id as '明细基本单位',
t1.owner_type_out_id as '明细调出货主类型',
t1.owner_out_id as '明细调出货主',
t1.owner_type_id as '明细调入货主类型',
t1.owner_id as '明细调入货主',
t1.keeper_type_out_id as '明细调出保管者类型',
t1.keeper_out_id as '明细调出保管者',
t1.keeper_type_id as '明细调入保管者类型',
t1.keeper_id as '明细调入保管者',
t1.mto_no as '明细计划跟踪号',
t1.attribute1 as '明细批号'
from ty_mes.wms_picking_result_iface t1
where tenant_id = 7 and t1.return_order = 1
and t1.instruction_doc_type in ('LINEWARE_REQUISITION_DOC', 'LINEWARE_RETURN_DOC', 'REPLENISH_REQUISITION_DOC')
and `STATUS` in ('N', 'E')
limit ? offset ?

通过这种方式，我们能够提高查询语句的可读性和维护性，并确保动态语法字段与请求参数的正确对应关系。

数据请求与清洗

在实际操作中，我们通过POST方法向MySQL数据库发送请求，并使用上述配置进行数据获取和清洗。以下是一个具体操作步骤：

{
  ...
  // 请求体中的主要参数
  {
    main_params: {
      limit: 10,
      offset: 0
    },
    main_sql: "...", // 上述优化后的SQL语句
    ...
  }
}

通过这种方式，我们可以有效地从MySQL数据库中获取所需的数据，并进行初步清洗和加工，为后续的数据转换与写入做好准备。

实践案例

假设我们需要从MySQL数据库中获取领料直接调拨单的数据，并且每次只获取10条记录，从第0条开始。我们可以设置如下参数：

{
  main_params: {
    limit: 10,
    offset: 0
  },
  main_sql: "...", // 上述优化后的SQL语句
}

通过执行上述配置，我们能够成功地从MySQL数据库中获取到符合条件的数据，并为后续处理提供支持。

以上就是使用轻易云数据集成平台调用MySQL接口获取并加工数据的详细过程。通过合理配置元数据和优化SQL语句，我们可以高效地完成这一关键步骤，为整个数据处理生命周期奠定坚实基础。 如何对接金蝶云星空API接口

使用轻易云数据集成平台进行ETL转换并写入金蝶云星空API接口的技术案例

在数据集成生命周期的第二步，我们需要将已经集成的源平台数据进行ETL（Extract, Transform, Load）转换，转为目标平台金蝶云星空API接口所能够接收的格式，并最终写入目标平台。本文将详细探讨如何使用轻易云数据集成平台进行这一过程。

数据请求与清洗

首先，我们需要从源系统中提取数据，并对其进行初步清洗和转换。这一步骤通常包括数据的标准化、去重、缺失值处理等操作。假设我们已经完成了这一步骤，现在进入关键的ETL转换阶段。

数据转换与写入

轻易云数据集成平台提供了强大的元数据配置功能，可以帮助我们将清洗后的数据转换为目标系统所需的格式。以下是一个具体的元数据配置示例，用于将源系统的数据转换为金蝶云星空API接口所需的格式。

{
  "api": "batchSave",
  "effect": "EXECUTE",
  "method": "POST",
  "idCheck": true,
  "request": [
    {"field":"FBillNo","label":"单据编号","type":"string","describe":"单据编号","value":"{{单据编号}}"},
    {"field":"FBillTypeID","label":"单据类型","type":"string","describe":"单据类型","parser":{"name":"ConvertObjectParser","params":"FNumber"},"value":"{{单据类型}}"},
    {"field":"FBizType","label":"业务类型","type":"string","describe":"下拉列表","value":"NORMAL"},
    {"field":"FTransferDirect","label":"调拨方向","type":"string","describe":"下拉列表","value":"{{调拨方向}}"},
    {"field":"FTransferBizType","label":"调拨类型","type":"string","describe":"下拉列表","value":"{{调拨类型}}"},
    {"field":"FSaleOrgId","label":"销售组织","type":"string","describe":"组织","parser":{"name":"ConvertObjectParser","params":"FNumber"}},
    {"field":"FSettleOrgId","label":"结算组织","type":"string","describe":"组织","parser":{"name":"ConvertObjectParser","params":"FNumber"}},
    {"field":"FStockOutOrgId","label":"调出库存组织","type":...

上述配置中，api字段指定了调用金蝶云星空API的方法为batchSave，并通过POST请求发送。每个字段对应于目标系统中的特定字段，如FBillNo对应“单据编号”，并且使用占位符（如{{单据编号}}）来填充动态数据。

字段解析与映射

为了确保数据格式符合金蝶云星空API的要求，我们需要对某些字段进行解析和映射。例如，FBillTypeID字段使用了一个名为ConvertObjectParser的解析器，将源系统中的值转换为目标系统所需的格式：

{"field": "FBillTypeID", "label": "单据类型", "type": "string", "describe": "单据类型", "parser": {"name": "ConvertObjectParser", "params": "FNumber"}, "value": "{{单据类型}}"}

类似地，其他字段如FSaleOrgId, FSettleOrgId, FStockOutOrgId, FOwnerOutIdHead, FStockOrgId, FSETTLECURRID, 等也都进行了相应的解析和映射。

明细信息处理

在处理复杂的数据结构时，如包含多个明细项的数据，我们可以使用嵌套数组来表示。例如，在上述配置中，FBillEntry字段表示明细信息，其子字段包括物料编码、调拨数量、调出仓库、调入仓库等：

{
  "field": "FBillEntry",
  "label": "明细信息",
  "type": "array",
  ...
}

每个子字段同样使用占位符来填充动态数据，并根据需要进行解析和映射。

提交与审核

在所有字段都正确映射并填充后，我们可以通过设置其他请求参数来控制提交和审核行为：

{
  "otherRequest": [
    {"field": "FormId", "label": "业务对象表单Id", ...
    {"field": "IsAutoSubmitAndAudit", ...
    {"field": ...
}

其中，FormId指定业务对象表单ID，IsAutoSubmitAndAudit设置为true表示自动提交并审核。

实际操作示例

假设我们有以下源系统的数据：

{
  ...
}

通过上述元数据配置，我们可以将这些数据转换为如下格式，并通过调用金蝶云星空API接口实现写入：

{
  ...
}

以上就是如何利用轻易云数据集成平台实现ETL转换并写入金蝶云星空API接口的详细技术案例。在实际操作中，根据具体需求调整元数据配置，可以灵活应对各种复杂的数据集成场景。 如何开发企业微信API接口

版权声明

该文章《金蝶云星空API数据写入：ETL转换技术案例》为原创内容，版权归 广东轻亿云软件科技有限公司 所有。 未经本公司书面授权，严禁转载、引用、复制或建立镜像等行为。 若需转载或引用本文内容，请联系本公司获取授权，并在显著位置注明作者姓名、文章出处（包括原文链接）等信息。

金蝶云星空与旺店通打通
更多系统对接方案