ETL转换：从借支单到金蝶付款申请单的实现方法

  • 轻易云集成顾问-彭萍

每刻借款单集成到金蝶云星空：技术案例分享

在企业的财务管理系统中，数据的准确性和及时性至关重要。为了进一步提升业务处理效率，我们实施了一个详尽的数据集成解决方案，将每刻平台上的借款单【借支单】自动同步到金蝶云星空中的付款申请单。这一过程通过轻易云数据集成平台得以实现，全程依托其强大且灵活的数据处理能力。

首先，每刻提供了获取借款单数据的API接口/api/openapi/form/loan，我们使用这一接口定时可靠地抓取需要转换和传输的数据。在对接过程中，不仅要确保高吞吐量的数据写入能力，还需妥善处理分页与限流问题，以保证大量数据能够快速、稳定地被处理并写入到目标系统——金蝶云星空。

为了适应两套系统之间可能存在的数据格式差异，我们设计了自定义数据转换逻辑，并利用可视化的数据流设计工具，使整个数据集成过程直观且易于管理。同时，实时监控数据流动及异常情况，从而快速响应和修正潜在的问题。

在向金蝶云星空提交经过转换后的付款申请单时，通过调用其批量保存API batchSave 实现高效的大量数据写入。为确保所有记录都能毫无遗漏地完成传输，我们部署了一整套完善的错误重试机制，对接过程中出现任何异常，都能即时发现并采取措施进行补救，保障了业务流程的一贯性和完整性。

本次案例详细阐述如何有效利用每刻与金蝶云星空之间的API资产，实现资源配置优化与高效利用，是一次成功应用现代化技术手段提升企业运营效率的重要实践。 金蝶与CRM系统接口开发配置

调用每刻接口/api/openapi/form/loan获取并加工数据的技术案例

在轻易云数据集成平台中，调用源系统接口是数据处理生命周期的第一步。本文将详细探讨如何通过配置元数据，调用每刻系统的借款单接口 /api/openapi/form/loan 获取并加工数据。

接口调用配置

首先，我们需要配置调用接口的元数据。以下是关键的元数据配置项：

  • API路径: /api/openapi/form/loan
  • 请求方法: POST
  • 唯一标识字段: formCode

这些配置确保了我们能够正确地调用每刻系统的借款单接口，并获取所需的数据。

请求参数配置

为了准确获取所需的数据，我们需要设置多个请求参数。这些参数包括但不限于：

  1. createdAtStart 和 createdAtEnd: 根据单据的创建时间进行筛选。
  2. formCodes: 单据号，可以通过 StringToArray 解析器将逗号分隔的字符串转换为数组。
  3. pageSize 和 offset: 分页参数，用于控制每次请求的数据量和偏移量。
  4. formStatus: 单据状态，默认值为 SETTLEMENT（结算中），也可以选择其他状态如 APPROVING（审批中）、COMPLETED（已完成）等。
  5. approvedAtStart 和 approvedAtEnd: 根据单据的审批通过时间进行筛选。
  6. settledAtStart 和 settledAtEnd: 根据单据的支付时间进行筛选。

这些参数确保了我们能够灵活地控制数据请求范围和数量，从而提高数据获取效率。

数据格式化与清洗

在获取到原始数据后，我们需要对其进行格式化和清洗。以下是一个具体的格式化规则示例：

{
  "old": "customObject-CF506-0.userId",
  "new": "customObject-CF506-0_userId",
  "format": "string"
}

这个规则将原始字段 customObject-CF506-0.userId 转换为新的字段名 customObject-CF506-0_userId，并将其格式化为字符串类型。这种格式化操作有助于统一数据格式，便于后续处理。

异常处理与补偿机制

在实际操作中，可能会遇到各种异常情况，如网络问题或源系统不可用。为了确保数据集成过程的稳定性，我们需要设置异常处理与补偿机制。例如，通过定时任务（crontab）定期重试未成功的数据请求：

{
  "crontab": "2 */2 * * *",
  "takeOverRequest": [
    {
      "field": "approvedAtStart",
      "label": "修改时间开始段",
      "type": "string",
      "is_required": true,
      "value": "{DAYS_AGO_2}000"
    }
  ]
}

上述配置表示每两小时执行一次补偿请求，以确保遗漏的数据能够及时被重新获取。

实际案例应用

假设我们需要从每刻系统中获取过去两天内所有状态为“结算中”的借款单，并将其导入金蝶付款申请单。我们可以按照以下步骤进行操作：

  1. 配置API路径和请求方法。
  2. 设置请求参数，包括时间范围、状态、分页等。
  3. 执行API调用，获取原始数据。
  4. 对原始数据进行格式化和清洗。
  5. 将清洗后的数据写入目标系统（金蝶）。

通过这种方式，我们可以高效地实现不同系统间的数据集成，确保业务流程的顺畅运行。

以上就是调用每刻接口 /api/openapi/form/loan 获取并加工数据的详细技术案例。希望这些内容能为您的实际操作提供有价值的参考。 打通用友BIP数据接口

轻易云数据集成平台：从借支单到金蝶付款申请单的ETL转换

在数据集成的生命周期中，ETL（提取、转换、加载）是至关重要的一环。本文将详细探讨如何使用轻易云数据集成平台将源平台的借支单数据转换为金蝶云星空API接口所能接收的付款申请单格式，并最终写入目标平台。

数据请求与清洗

首先，我们需要从源平台获取借支单数据，并进行必要的数据清洗和预处理。这一步通常包括去除无效数据、标准化字段格式等操作。假设我们已经完成了这一步，接下来进入数据转换与写入阶段。

数据转换与写入

轻易云数据集成平台提供了强大的元数据配置功能，使得我们能够灵活地定义数据转换规则。以下是一个典型的元数据配置示例：

{
  "api": "batchSave",
  "method": "POST",
  "idCheck": true,
  "operation": {
    "method": "merge",
    "field": "formCode,customObject-CF338-detailBusinessCode,paymentBaseAmount-amountStr,coverEmployeeName,customObject-CF405-startTime,submittedAt",
    "bodyName": "items",
    "header": ["formCode", "submittedAt", "paymentBaseAmount-amountStr", "fillEmployeeName", "customObject-CF506-0_userId", "customObject-CF561-text", "customObject-CF561-detailBusinessCode"],
    "body": ["formCode", "customObject-CF199-detailBusinessCode", "approvedBaseAmount-amountStr", "loanName", "customObject-CF199-text", "customObject-CF506-0_text"]
  },
  ...
}

该配置文件定义了如何将借支单的数据映射到金蝶付款申请单的字段中。以下是几个关键字段的解释：

  1. formCode：对应源平台的单据编号。
  2. submittedAt：对应申请日期，需要进行日期格式转换。
  3. paymentBaseAmount-amountStr：对应应付金额和申请付款金额。
  4. fillEmployeeName：对应往来单位，需要通过解析器将员工姓名转换为金蝶系统中的编号。

数据字段映射与解析

为了确保数据能够正确写入目标平台，我们需要对某些字段进行特殊处理。例如，往来单位类型、收款单位类型等字段需要通过解析器进行转换：

{
  "field": "FCONTACTUNIT",
  "label": "往来单位",
  ...
  "parser": {
    "name": "ConvertObjectParser",
    ...
    }
}

在这个配置中，ConvertObjectParser用于将员工姓名（fillEmployeeName）解析为金蝶系统中的编号。这种解析器可以根据具体业务需求进行定制，以确保所有基础资料都能正确匹配。

明细项处理

对于付款申请单中的明细项，我们同样需要进行详细的字段映射。例如，结算方式、付款用途、应付金额等字段：

{
  ...
  {
    "parent": "FPAYBILLSRCENTRY",
    ...
    {
      ...
      {
        ...
        }
      }
    }
  }
}

这里，我们使用了多个嵌套结构来定义明细项的映射规则。例如，结算方式根据不同条件选择不同的值，而费用项目则根据文本内容进行条件判断。

最终请求生成

在所有字段映射和解析完成后，我们生成最终的请求体，并通过API接口将其发送到金蝶云星空：

{
  ...
  {
    ...
    {
      ...
      }
    }
  },
  ...
}

此请求体包含所有必要的数据，并按照金蝶API接口要求进行了格式化。通过POST方法发送请求后，系统会自动提交并审核这些数据，从而完成整个ETL过程。

总结

通过上述步骤，我们成功地将源平台的借支单数据转换为金蝶付款申请单格式，并写入目标平台。轻易云数据集成平台提供了灵活且强大的元数据配置功能，使得这一过程变得高效且透明。在实际应用中，根据具体业务需求调整配置文件，可以实现更多复杂的数据集成任务。 打通企业微信数据接口

版权声明

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

数据集成平台运行原理
更多系统对接方案