案例分享：钉钉报销【现货采购】集成到金蝶付款单【炫涵】

在企业业务系统的对接过程中，数据的无缝传输和实时处理显得尤为重要。本文将聚焦于一个实际运行的系统集成案例，介绍如何通过轻易云数据集成平台实现从钉钉到金蝶云星空的数据对接。

集成场景描述

我们需要将钉钉中的报销流程数据，通过调用其API接口topapi/processinstance/get获取，然后批量写入到金蝶云星空生成相应的付款单。此过程不仅需要处理两者之间的数据格式差异，同时还要确保大规模数据的高效传输和可靠性。

数据抓取与分页限流

首先，为了确保集成过程中不漏单，我们通过定时任务可靠地抓取钉钉接口数据。在请求过程中，由于面临分页和限流问题，需要精确控制每次请求的页大小，并适当设置延迟，避免触发API限制。此外，通过日志记录机制，对每次成功与失败的抓取操作进行详细记录，以便后续排查和重试。

数据转换及映射

由于面对不同系统之间的数据差异，我们设计了一套自定义的数据映射规则，将从钉钉获取的数据字段逐一转换，以符合金蝶云星空所需格式。同时，根据业务需求，对一些必须字段进行了必要填充或计算，以保证最终写入结果的一致性和值守逻辑完整性。

批量写入与错误重试机制

在执行批量写入操作时，通过调用金蝶云星空提供的batchSave API，可以一次性插入大量记录。但为了提高安全性，在实现中加入了异常处理与错误重试机制。当某些记录因意外情况造成上传失败时，程序会捕获并重新尝试提交这些特定条目，从而提升整体成功率。

实时监控保障管理透明度

整个过程中，我们利用轻易云平台提供的实时监控功能，全程追踪每个环节的数据流动状态。一方面是为了及时发现潜在问题，另一方面也为后续优化提供了详实依据。这种全透明、可视化操作界面的优势，不仅极大提升了效率，也保障了各个业务部门对于运营状况有更全面、直观了解。

调用钉钉接口topapi/processinstance/get获取并加工数据

在数据集成的生命周期中，调用源系统接口是至关重要的一步。本文将深入探讨如何通过轻易云数据集成平台调用钉钉接口topapi/processinstance/get，并对获取的数据进行加工处理。

配置API调用

首先，我们需要配置API调用的元数据。根据提供的元数据配置，我们可以看到以下关键参数：

• api: "topapi/processinstance/get"
• method: "POST"
• number: "number"
• id: "id"
• idCheck: true
• condition: [{"field":"报销类别","logic":"eq","value":"现货采购"}]
• formatResponse: [{"old":"付款方式","new":"付款方式_new","format":"string"}]

这些参数定义了我们如何调用钉钉的API，以及如何处理返回的数据。

数据请求与清洗

在实际操作中，我们首先需要发送一个POST请求到钉钉的topapi/processinstance/get接口。这个请求会包含必要的认证信息和查询条件。在本例中，查询条件是报销类别等于“现货采购”。

{
  "process_instance_id": "your_process_instance_id",
  "userid": "your_user_id",
  "start_time": "start_time",
  "end_time": "end_time",
  "size": 10,
  "cursor": 0
}

通过这种方式，我们可以获取到符合条件的报销单据。

数据转换与写入

获取到原始数据后，需要对其进行转换和清洗，以便后续写入目标系统。在本例中，我们需要将字段“付款方式”重命名为“付款方式_new”，并确保其格式为字符串。

{
  "old": "付款方式",
  "new": "付款方式_new",
  "format": "string"
}

这一过程可以通过轻易云平台提供的可视化工具来完成，确保每一步都透明可见，便于监控和调试。

实际应用案例

假设我们从钉钉获取到以下原始数据：

{
  "process_instance_id": "123456",
  "form_component_values": [
    {
      "name": "报销类别",
      "value": "现货采购"
    },
    {
      "name": "付款方式",
      "value": 1
    }
  ]
}

根据我们的元数据配置，我们需要检查“报销类别”是否为“现货采购”，然后将“付款方式”的值转换为字符串，并重命名为“付款方式_new”。

经过处理后的数据应如下所示：

{
  "process_instance_id": "123456",
  "form_component_values": [
    {
      "name": "报销类别",
      "value": "现货采购"
    },
    {
      "name": "付款方式_new",
      "value": "1"
    }
  ]
}

小结

通过上述步骤，我们成功地调用了钉钉接口topapi/processinstance/get，并对返回的数据进行了有效的清洗和转换。这一过程展示了轻易云数据集成平台在处理异构系统间数据时的强大能力。利用平台提供的全生命周期管理和可视化操作界面，可以显著提升业务透明度和效率。

使用轻易云数据集成平台实现钉钉报销数据到金蝶付款单的ETL转换

在数据集成的过程中，ETL（Extract, Transform, Load）是关键步骤之一。本文将详细介绍如何使用轻易云数据集成平台，将钉钉报销数据转换为金蝶云星空API接口所能接收的格式，并最终写入金蝶付款单。

数据请求与清洗

在开始ETL转换之前，首先需要从源平台（如钉钉）获取原始数据，并进行必要的清洗和预处理。这一阶段确保了数据的一致性和完整性，为后续的转换和写入奠定基础。

数据转换与写入

在本案例中，我们需要将清洗后的钉钉报销数据，按照金蝶云星空API接口要求的格式进行转换，并通过API接口将数据写入金蝶付款单。以下是具体操作步骤：

1. 配置API接口元数据

   通过配置元数据，定义API接口的请求方式、字段映射和参数解析。以下是配置示例：

   {
      "api": "batchSave",
      "method": "POST",
      "idCheck": true,
      "operation": {
          "method": "batchArraySave",
          "rows": 1,
          "rowsKey": "array"
      },
      "request": [
          {"field":"FBillNo","label":"单据编号","type":"string","describe":"单据编号","value":"{{extend.business_id}}"},
          {"field":"FBillTypeID","label":"单据类型","type":"string","describe":"单据类型","parser":{"name":"ConvertObjectParser","params":"FNUMBER"},"value":"FKDLX01_SYS"},
          {"field":"FDATE","label":"业务日期","type":"string","describe":"业务日期","value":"{{extend.finish_time}}"},
          {"field":"FSETTLEORGID","label":"结算组织","type":"string","describe":"100","parser":{"name":"ConvertObjectParser","params":"FNumber"},"value":"_findCollection find Number from 723e2cb6-f80f-3823-8b4f-6e98b9713ba3 where Name={{费用归属项目}}"},
          {"field":"FPAYORGID","label":"付款组织","type":"string","describe":"100","parser":{"name":"ConvertObjectParser","params":"FNumber"},"value":"_findCollection find Number from 723e2cb6-f80f-3823-8b4f-6e98b9713ba3 where Name={{费用归属项目}}"},
          {"field":"FCURRENCYID","label":"币别","type":"string","describe":"币别","parser":{"name":"ConvertObjectParser","params":"FNumber"},"value":"PRE001"},
          {"field":"FCONTACTUNITTYPE","label":"往来单位类型","type":"string","describe":"往来单位类型","value":"BD_Supplier"},
          {"field":"FCONTACTUNIT","label":"往来单位","type":"","describe":"","value":"","parser":{"name":"","params":""}},
          {"field":"","label":"","type":"","describe":"","value":"","parser":{"name":"","params":""}},
          ...
      ],
      ...
   }

2. 字段映射与解析

   在上述配置中，通过parser字段定义了字段值的解析方式。例如，FBillTypeID字段使用了ConvertObjectParser解析器，将固定值FKDLX01_SYS转换为目标系统可识别的格式。

3. 处理数组类型字段

   对于复杂的数据结构，如数组类型字段，可以通过嵌套配置实现。例如，付款单明细（FPAYBILLENTRY）包含多个子字段，需要逐一进行映射和解析：

   {
      "field": "FPAYBILLENTRY",
      "label": "付款单明细",
      "type": "array",
      "children": [
          {"field": "FSETTLETYPEID", "label": "结算方式", "type": "", ...},
          {"field": "", ...},
          ...
      ],
      ...
   }

4. 调用API接口

   配置完成后，通过HTTP POST请求调用金蝶云星空的batchSave API接口，将转换后的数据提交到目标系统：

   POST /k3cloud/Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.BatchSave
   Content-Type: application/json
   
   {
      ...
   }

5. 处理响应结果

   接收并处理API响应结果，确保数据成功写入目标系统。如果出现错误，根据返回的信息进行调试和修正。

总结

通过以上步骤，我们实现了从钉钉报销到金蝶付款单的数据ETL转换。关键在于正确配置API接口元数据，确保每个字段都能准确映射和解析，从而保证数据无缝对接。这一过程不仅提高了业务效率，也增强了系统间的数据一致性和可靠性。