实现钉钉与金蝶云数据集成的最佳实践

使用轻易云转换并写入钉钉采购单到金蝶云星空

2021-09-11 22:30:32
轻易云集成顾问-潘裕

钉钉数据集成到金蝶云星空的技术实现

在企业信息化建设中，系统间的数据集成和对接至关重要。本文将分享一个具体案例：如何通过轻易云数据集成平台，将钉钉中的采购付款申请单有效地同步到金蝶云星空的付款单。

为了实现这一目标，我们需要解决以下几个主要技术问题：

可靠抓取和分页处理：我们利用钉钉提供的API topapi/processinstance/get 来获取数据。由于接口限制，每次请求返回的数据条数有限，因此需要对多页数据进行处理，并确保不会漏掉任何一条记录。
高效写入大批量数据：从钉钉获取到的大量采购付款申请单，需要快速、高效地写入到金蝶云星空。这一过程依赖于金蝶云星空的BatchSave API，从而支持高吞吐量的数据整合。
自定义转换逻辑与格式差异匹配：由于两个系统间的数据结构不同，我们必须设计灵活且可配置的数据转换规则，以便精准映射每个字段并保持业务逻辑一致性。
实时监控和日志记录：为了确保每一步操作都透明可视，整个流程采用了全程监控机制与详细日志记录，大大提升了故障排除效率及任务完成率。

首先，在整个生命周期管理上，我们设立了一个定时任务，通过调用 topapi/processinstance/get 周期性抓取最新的采购付款申请单。在这一过程中，通过分页参数以及限流控制，实现稳定、持续地获取所有必需的数据。同时，为应对异常情况，还引入了错误重试机制，避免因网络波动或接口响应不及时导致的信息遗漏。

接下来是数据处理阶段。在轻易云接口资产管理功能下，自定义编排好所需的数据转换规则后，将获取到的原始JSON格式转化为符合金蝶云要求的数据结构，并使用BatchSave API进行批量存储。这不仅优化了性能，同时也极大减少人工干预，提高运作效率。

最后，对整个操作流程进行了集中式监控，一旦发生异常情况，可基于告警系统第一时间发现并采取措施。这使得我们的方案在生产环境中具备高度鲁棒性和可靠性，有力保障业务连续性。

通过以上步骤及工具应用，我们成功实现了一套既高效又稳健的跨系统自动化对接方案。未来，随着更多业务需求涌现，这一体系还能不断扩展优化，以适应更复杂多变的信息集成挑战。金蝶与CRM系统接口开发配置

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

在数据集成的生命周期中，调用源系统接口是至关重要的第一步。本文将深入探讨如何通过轻易云数据集成平台调用钉钉接口topapi/processinstance/get来获取并加工数据，以实现采购付款申请单到付款单的无缝对接。

接口调用配置

首先，我们需要配置元数据以便正确调用钉钉的API接口。以下是元数据配置的详细内容：

{
  "api": "topapi/processinstance/get",
  "effect": "QUERY",
  "method": "POST",
  "number": "name",
  "id": "id",
  "idCheck": true,
  "autoFillResponse": true,
  "condition": [
    [{"field":"付款类型","logic":"eqv2","value":"到期付款"}],
    [{"field":"付款类型","logic":"eqv2","value":"预付款"}],
    [{"field":"付款类型","logic":"eqv2","value":"现款发货"}],
    [{"field":"付款类型","logic":"eqv2","value":"货到付款"}],
    [{"field":"付款类型","logic":"eqv2","value":"超额购货付款"}],
    []
  ]
}

配置解析

API路径："api": "topapi/processinstance/get"，指定了我们要调用的钉钉API接口。
请求方法："method": "POST"，表示我们将使用POST方法进行请求。
主键字段："id": "id"和"number": "name"，分别定义了主键字段和编号字段。
ID校验："idCheck": true，启用了ID校验机制，确保每次请求的数据唯一性。
自动填充响应："autoFillResponse": true，表示系统会自动填充响应结果。
条件过滤：通过"condition"字段，我们可以定义多个条件来过滤不同类型的付款申请单。

数据请求与清洗

在实际操作中，我们需要根据上述配置发送HTTP POST请求到钉钉API，并获取相应的数据。以下是一个示例请求体：

{
  "process_instance_id_list": ["example_process_instance_id"]
}

通过这个请求，我们可以获取特定流程实例ID对应的详细信息。接下来，我们需要对返回的数据进行清洗和转换，以便后续处理。

数据转换与写入

一旦我们获取了原始数据，就需要根据业务需求进行数据转换。例如，将不同类型的付款申请单映射到金蝶系统中的相应字段。以下是一个简单的数据转换示例：

{
  "source_field_1": "destination_field_1",
  "source_field_2": {
    "type": "mapping",
    "values": {
      "到期付款": "Due Payment",
      "预付款": "Prepayment"
    }
  },
  ...
}

在这个示例中，我们将源字段映射到目标字段，并对某些字段进行了值映射（如将中文描述转换为英文描述）。

实时监控与异常处理

轻易云平台提供了实时监控功能，可以帮助我们跟踪每个数据处理环节的状态。如果在调用API或数据转换过程中出现异常，系统会及时发出警报，并记录详细日志以便排查问题。

通过以上步骤，我们实现了从钉钉采购付款申请单到金蝶付款单的数据集成。这不仅提高了业务流程的自动化程度，还确保了数据的一致性和准确性。如何对接用友BIP接口

使用轻易云数据集成平台将采购付款申请单数据转换并写入金蝶云星空API接口

在数据集成生命周期的第二步中，我们需要将已经集成的源平台数据进行ETL转换，使其符合目标平台金蝶云星空API接口的要求，并最终写入目标平台。本文将详细探讨这一过程中涉及的技术细节和实现方法。

数据转换与写入目标平台

在本案例中，我们的任务是将钉钉中的采购付款申请单数据转换为金蝶云星空能够接收的格式，并通过其API接口写入系统。我们使用轻易云数据集成平台提供的元数据配置来实现这一过程。

元数据配置解析

以下是关键字段和其配置的详细解析：

单据类型 (FBillTypeID)
- 字段: FBillTypeID
- 类型: string
- 值: FKDLX01_SYS
- 解析器: ConvertObjectParser，参数为FNumber
单据编号 (FBillNo)
- 字段: FBillNo
- 类型: string
- 值: {business_id}
结算组织 (FSETTLEORGID)
- 字段: FSETTLEORGID
- 类型: string
- 值: {{付款组织}}
- 解析器: ConvertObjectParser，参数为FNumber
采购组织 (FPURCHASEORGID)
- 字段: FPURCHASEORGID
- 类型: string
- 值: {{付款组织}}
- 解析器: ConvertObjectParser，参数为FNumber
付款组织 (FPAYORGID)
- 字段: FPAYORGID
- 类型: string
- 值: {{付款组织}}
- 解析器: ConvertObjectParser，参数为FNumber
创建人 (FCreatorId)
- 字段: FCreatorId
- 类型: string
- 值: _findCollection find FUserID from 5b6d7573-c41f-30aa-9aa1-466182356a9f where FName={{办理人}}
- 解析器: ConvertObjectParser，参数为FUserID
币别 (FCURRENCYID)
- 字段: FCURRENCYID
- 类型: string
- 值: {{币别}}
- 解析器: ConvertObjectParser，参数为FNumber
业务日期 (FDATE)
- 字段: FDATE
- 类型: string
- 值: {{申请付款日期}}
其他重要字段如采购部门、往来单位、收款单位等，也均采用类似的方法进行配置和解析。

表体明细配置 (FPAYBILLENTRY)

表体明细部分需要特别关注，因为它包含了多条记录，每条记录都有多个字段：

结算方式 (FSETTLETYPEID)
表体-应付金额 (FPAYTOTALAMOUNTFOR)
对方银行账号 (FOPPOSITEBANKACCOUNT)
付款用途 (FPURPOSEID)
对方账户名称 (FOPPOSITECCOUNTNAME)
对方开户行 (FOPPOSITEBANKNAME)

这些字段同样通过元数据配置进行定义，并且每个字段都可以使用相应的解析器进行转换。

API请求配置

在完成所有字段的配置后，我们需要设置API请求相关的信息：

API接口名称：BatchSave
请求方法：POST
表单ID：AP_PAYBILL（对应金蝶中的表单）
是否自动提交和审核：false（可根据需求调整）
是否验证基础资料有效性：false（可根据需求调整）

{
    "api": "BatchSave",
    "effect": "EXECUTE",
    "method": "POST",
    "idCheck": true,
    "request": [
        // 上述所有字段配置...
    ],
    "otherRequest": [
        {
            "field": "FormId",
            "label": "FormId",
            "type": "string",
            "describe": "必须填写金蝶的表单ID如:PUR_PurchaseOrder",
            "value": "AP_PAYBILL"
        },
        {
            "field": "Operation",
            "label": "Operation",
            "type": "string",
            "value": "BatchSave"
        },
        {
            "field": "IsAutoSubmitAndAudit",
            "label": "IsAutoSubmitAndAudit",
            "type": "bool",
            "value": false
        },
        {
            "field": "IsVerifyBaseDataField",
            "label": "IsVerifyBaseDataField",
            "type": bool,
            "",
            value":"false"
        }
    ],
    operation:{
        method:"batchArraySave",rows:"1",rowsKey:"array"
    }
}

实现步骤总结

配置源数据到目标格式的映射关系。
使用轻易云平台提供的元数据配置进行ETL转换。
调用金蝶云星空API接口，将转换后的数据写入系统。

通过上述步骤，我们能够高效地将钉钉中的采购付款申请单数据转换并写入金蝶云星空，实现不同系统间的数据无缝对接。如何对接金蝶云星空API接口

版权声明

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