轻易云集成平台下的金蝶云数据写入与转化案例

  • 轻易云集成顾问-何语琴

系统对接集成案例分享：销售出库单-豌豆荚

在本文中，我们将深入探讨如何通过轻易云数据集成平台，将金蝶云星空系统中的销售出库单数据高效地集成至另一个金蝶云星空系统，实现业务流程的闭环和优化。此案例聚焦于一个名为“销售出库单-豌豆荚”的实际运行方案，展示了该平台在处理复杂数据集成任务时的优势和技术细节。

API接口调用与数据流设计

首先，通过调用金蝶云星空提供的数据获取API executeBillQuery，我们可以定时、可靠地抓取销售出库单相关的数据。这一步骤得益于轻易云平台强大的支持高吞吐量的数据写入能力，有效保证了大量数据能够快速被拉取并进行后续处理。在这里，我们需要特别关注接口分页及限流问题，以确保每次请求能获取到完整且正确的数据。

随后，在完成初步的原始数据抓取后，需要对这些数据进行适当的转换和清洗，使其符合目标金蝶云星空系统所需的数据格式。在这一过程中，自定义的数据转换逻辑功能显得尤为重要，它允许我们针对不同类型的字段进行精确映射，从而满足特定业务需求。同时，利用可视化的数据流设计工具，可以更直观地管理和监控整个转化过程，提升操作便捷性与准确度。

数据质量保障与异常处理机制

为了进一步加强对接过程中的稳定性和健壮性，轻易云平台提供了全面的数据质量监控和实时告警功能。当发现异常或错误时，该系统会立即触发告警，并自动启动重试机制以最大程度减少因临时故障导致的影响。这些特性对于确保集成金蝶云星空之间的大规模、高频率交易记录不漏单起到关键作用，同时也提高了整体异构系统间交互的一致性。

高效批量写入目标系统

最终，通过使用金蝶云星空 batchSave 写入API，将已清洗并经过标准化处理后的数据信息批量导入另一端的数据库中。这个过程不仅要求集成工具具备极强的并发写入性能，还需要有完善的事务控制以及日志记录能力，以应对突发情况并方便未来审计及溯源。此外，执行期间还要密切监控任务状态及性能表现，这也是集中监控与告警体系发挥作用的重要场景之一。

综上所述，此次针对“销售出库单-豌豆荚”的具体实施，为企业实现高效、可靠且透明的信息化管理奠定了 企业微信与OA系统接口开发配置

调用源系统金蝶云星空接口executeBillQuery获取并加工数据

在数据集成过程中，调用源系统接口是至关重要的一步。本文将详细探讨如何通过轻易云数据集成平台调用金蝶云星空的executeBillQuery接口来获取销售出库单数据，并进行相应的数据加工。

接口配置与请求参数

首先，我们需要配置元数据以便正确调用金蝶云星空的executeBillQuery接口。以下是关键的元数据配置：

{
  "api": "executeBillQuery",
  "method": "POST",
  "number": "FBillNo",
  "id": "FEntity_FENTRYID",
  "pagination": {
    "pageSize": 500
  },
  "idCheck": true,
  "formatResponse": [
    {
      "old": "FApproveDate",
      "new": "FApproveDate_new",
      "format": "date"
    }
  ],
  ...
}

上述配置中，api字段指定了要调用的接口名称，method字段指定了请求方法为POST。分页参数设置为每页500条记录，确保在处理大数据量时不会出现性能问题。

请求字段映射

为了确保请求参数能够正确传递给金蝶云星空，我们需要定义请求字段的映射关系。以下是部分关键字段的映射：

[
  {"field":"FBillTypeID_FNumber","label":"单据类型","type":"string","describe":"单据类型","value":"FBillTypeID.FNumber"},
  {"field":"FBillNo","label":"单据编号","type":"string","describe":"单据编号","value":"FBillNo"},
  {"field":"FDate","label":"日期","type":"string","describe":"日期","value":"FDate"},
  {"field":"FApproveDate","label":"审核时间","type":"string","describe":"日期","value":"FApproveDate"},
  ...
]

这些字段映射定义了从源系统获取的数据字段及其对应关系。例如，FBillTypeID_FNumber对应于金蝶中的FBillTypeID.FNumber。

数据过滤与分页

在实际应用中，我们可能需要对数据进行过滤和分页处理。以下是相关配置示例：

[
  {"field":"Limit","label":"最大行数","type":"string","describe":"金蝶的查询分页参数","value":"{PAGINATION_PAGE_SIZE}"},
  {"field":"StartRow","label":"开始行索引","type":"string","describe":"金蝶的查询分页参数","value":"{PAGINATION_START_ROW}"},
  {"field":"FilterString","label":"过滤条件","type":"string","describe":"示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>=","value":"'FBillNo='XSCKD8752576'or\nFBillNo='XSCKD8687079'"},
  ...
]

这里，Limit和StartRow用于控制分页，确保每次请求返回的数据量适中。而FilterString则用于设置过滤条件，例如按单据编号过滤特定记录。

数据格式化与转换

获取到的数据可能需要进行格式化处理，以便后续使用。例如，将审核时间字段格式化为新的日期格式：

[
  {
    "old": "FApproveDate",
    "new": "FApproveDate_new",
    "format": "date"
  }
]

通过这种方式，可以将原始的审核时间字段转换为新的格式，更加符合业务需求。

实际调用示例

结合上述配置，我们可以构建一个实际的API调用示例。假设我们要获取特定销售出库单的数据，可以构建如下请求：

{
  "FormId": "SAL_OUTSTOCK",
  "FieldKeys": ["FBillNo", "FDate", ...],
  "FilterString": "'FBillNo='XSCKD8752576'or\nFBillNo='XSCKD8687079'",
  ...
}

通过轻易云平台发送该请求，将会返回符合条件的销售出库单数据，并按照预先定义的格式进行处理和转换。

总结

通过轻易云数据集成平台调用金蝶云星空的executeBillQuery接口，可以高效地获取并加工销售出库单数据。本文详细介绍了元数据配置、请求字段映射、数据过滤与分页以及数据格式化与转换等关键步骤，为实现不同系统间的数据无缝对接提供了技术参考。 如何开发企业微信API接口

数据转换与写入金蝶云星空API接口的技术案例

在轻易云数据集成平台中，数据处理生命周期的第二步是将已集成的源平台数据进行ETL转换，并转为目标平台金蝶云星空API接口所能接收的格式，最终写入目标平台。本文将深入探讨如何通过配置元数据，实现销售出库单数据的转换与写入。

API接口配置

首先，我们需要配置金蝶云星空API接口。根据提供的元数据配置，目标API为batchSave，请求方法为POST。以下是关键的配置字段及其作用：

  • FormId: 业务对象表单ID，必须填写金蝶的表单ID，例如：SAL_OUTSTOCK。
  • Operation: 执行的操作，这里为Save。
  • IsAutoSubmitAndAudit: 是否自动提交并审核，这里设置为false。
  • IsVerifyBaseDataField: 是否验证基础资料有效性，这里设置为false。
  • SubSystemId: 系统模块，默认仓库模块，这里设置为21。

请求字段解析

在请求字段中，我们需要特别注意以下几个字段及其解析方式：

  1. FBillTypeID (单据类型):

    • 类型：字符串
    • 解析器：ConvertObjectParser
    • 参数：FNumber
    • 固定值：XSCKD01_SYS

  2. FDate (日期):

    • 类型：字符串
    • 固定值：2024-08-30T00:00:00

  3. FStockOrgId (发货组织):

    • 类型：字符串
    • 解析器：ConvertObjectParser
    • 参数：FNumber
    • 固定值：111

  4. FSaleOrgId (销售组织):

    • 类型：字符串
    • 解析器：ConvertObjectParser
    • 参数：FName
    • 固定值：广州市鼎骏电子科技有限公司

  5. FCustomerID (客户):

    • 类型：字符串
    • 解析器：ConvertObjectParser
    • 参数：FNumber
    • 映射关系： 
      {
"target": "63556c380bc98d4c8e11c30d",
"direction": "positive"
}

子字段配置

在子字段配置中，我们重点关注财务信息和明细信息：

  1. 财务信息 (SubHeadEntity):

    [
  {
    "field": "FSettleTypeID",
    "label": "结算方式",
    "type": "string",
    "parser": {
      "name": "ConvertObjectParser",
      "params": "FNumber"
    },
    "value": "JSFS04_SYS{FSettleTypeID_FNumber}"
  },
  {
    "field": "FReceiverAddress",
    "label": "收货人地址",
    "type": "string"
  },
  {
    "field": "FReceiverName",
    "label": "收货人",
    "type": "string"
  },
  {
    "field": "FReceiverMobile",
    "label": "收货人手机",
    "type": "string"
  }
]

  2. 明细信息 (FEntity):

    [
  {
    "field": "FMaterialID",
    "label": "物料编码",
    "type": "string",
    ...
  },
  {
    ...
  }
]

数据转换逻辑

在数据转换过程中，我们需要特别注意以下几点：

  1. 物料编码 (FMaterialID): 使用ConvertObjectParser进行解析，并根据源平台的数据映射到目标平台。

  2. 仓库 (FStockID): 根据客户名称动态选择仓库：

    case when '{{FCustomerID.FName}}' like '%京东%' then 'CK001' 
     when '{{FCustomerID.FName}}' like '%唯品会%' then 'CK002' 
     else 'CK001' end

  3. 折扣额 (FDiscount): 动态计算折扣额：

    {FTaxPrice}*{FRealQty} - {FAllAmount}

  4. 税率 (FEntryTaxRate): 根据客户名称动态选择税率：

    case when '{FCustomerID_FDJZDYSWDYZZ}' like '衡阳天量贸易有限公司' then '1' 
     else '13' end

通过以上详细的元数据配置和解析逻辑，我们可以实现从源平台到金蝶云星空API接口的数据无缝对接。这不仅提高了数据处理效率，还确保了数据的一致性和准确性。 如何开发金蝶云星空API接口

版权声明

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

金蝶云星辰与聚水潭对接
更多系统对接方案