利用轻易云实现钉钉到金蝶云星空的高效数据迁移

  • 轻易云集成顾问-黄宏棵

钉钉数据集成到金蝶云星空：日常报销单的高效管理

在现代企业的信息化进程中，系统间的数据集成尤为重要。本文将分享一个基于轻易云数据集成平台，实现钉钉数据与金蝶云星空对接的技术案例：从钉钉获取日常报销单并快速写入到金蝶云星空。

案例背景

我们的客户需要在日常运营中自动化地处理通过钉钉提交的报销单，然后将这些数据无缝地对接到其财务管理系统——金蝶云星空。这样不仅能提升工作效率，还能减少人为操作所带来的错误及漏单现象。

解决方案概述

该方案利用了轻易云提供的全透明可视化操作界面，通过配置元数据实现各个环节的数据同步和处理监控，确保了业务流程的高效与准确。本次集成过程中，我们主要使用了两个关键API接口：

  • 从钉钉获取报销单详情的数据API: topapi/processinstance/get。
  • 将这些数据批量写入至金蝶云星空的一般凭证模块中的API: batchSave。

以下是我们具体实施该项目的方法步骤：

  1. 定时可靠抓取
    借助轻易云平台设定任务调度，每隔一定时间调用topapi/processinstance/get接口，从而确保能够及时获取最新提交且符合条件（例如已审批）的报销单。这一过程通过分页机制有效处理大规模列表，同时针对限流问题也进行了充分考虑，以避免因频繁请求导致服务不可用。

  2. 格式转换及映射
    获取到原始数据后，我们需统一处理其格式，使之满足金蝶云星空要求。这一步骤包括字段名称、类型以及结构上的调整，由此保证两系统间的数据兼容性。另外，该过程中还支持根据企业需求进行自定义字段匹配和逻辑校验，增强灵活性。

  3. 快速批量写入 数据准备就绪后，通过调用金蝶cloud batchSave API，将整理好的报销单信息以批量方式高速、安全地传递至目标系统。在发生异常时，如网络故障或服务器响应超时，则启用错误重试机制以保障信息完整精确存储，无任何遗漏或重复记录出现。

  4. 实时监控与日志记录
    在整个流程运行期间，利用轻易云的平台特性，对每个环节进行实时监控，并详细记录日志。任何异常情况如接口返回错误，都能被立即发现并追溯，以便迅速采取措施修正问题。此外，这些日志 如何开发金蝶云星空API接口

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

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

接口概述

钉钉提供的topapi/processinstance/get接口用于获取指定流程实例的详细信息。该接口采用POST请求方式，能够返回流程实例的详细数据，包括流程状态、发起人、审批人等关键信息。

元数据配置解析

根据提供的元数据配置，以下是对各个字段的解释：

  • api: "topapi/processinstance/get" - 指定了要调用的API路径。
  • effect: "QUERY" - 表示该操作为查询类型。
  • method: "POST" - 指定了HTTP请求方法为POST。
  • number: "name" - 表示需要提取的数据字段名为"name"。
  • id: "id" - 指定了唯一标识字段为"id"。
  • idCheck: true - 表示在处理过程中需要进行ID校验。
  • autoFillResponse: true - 自动填充响应结果。

调用API获取数据

首先，通过轻易云平台配置API调用参数。以下是一个示例请求体：

{
  "process_instance_id": "example_instance_id"
}

发送POST请求到https://oapi.dingtalk.com/topapi/processinstance/get，并附带必要的认证信息（如access_token）。成功响应后，将返回如下结构的数据：

{
  "errcode": 0,
  "errmsg": "ok",
  "process_instance": {
    "title": "报销单",
    "create_time": "2023-10-01 12:00:00",
    "finish_time": "2023-10-02 12:00:00",
    ...
  }
}

数据清洗与转换

在获取到原始数据后，需要对其进行清洗和转换，以便后续写入目标系统（如金蝶）。具体步骤如下：

  1. 提取关键字段：根据业务需求，从响应中提取必要的信息。例如，提取报销单标题、创建时间和完成时间等。

    {
 "title": "报销单",
 "create_time": "2023-10-01 12:00:00",
 "finish_time": "2023-10-02 12:00:00"
}

  2. 格式转换：将日期格式转换为目标系统所需的格式。例如，将YYYY-MM-DD HH:mm:ss格式转换为YYYY/MM/DD HH:mm:ss。

  3. 数据校验：根据元数据配置中的idCheck字段，对ID进行校验，确保唯一性和正确性。

  4. 自动填充：如果配置了autoFillResponse为true，则可以自动填充一些默认值或计算值，以简化后续处理步骤。

数据写入目标系统

完成数据清洗与转换后，即可将处理后的数据写入目标系统（如金蝶）。这一步通常涉及到调用目标系统的API，并传递已处理好的数据。

{
  "supplier_name": "供应商A",
  "expense_title": "报销单",
  ...
}

通过轻易云平台，可以实现从钉钉到金蝶的数据无缝对接，大大提高了业务流程的自动化程度和效率。

总结来说，通过合理配置元数据，并利用轻易云平台强大的集成能力，可以高效地完成从钉钉获取日常报销单并加工处理，再写入金蝶系统这一完整的数据集成过程。 如何开发钉钉API接口

使用轻易云数据集成平台将钉钉报销单转换并写入金蝶云星空API接口

在数据集成的生命周期中，ETL（提取、转换、加载）是关键的一步。本文将深入探讨如何使用轻易云数据集成平台将钉钉的日常报销单数据转换为金蝶云星空API接口所能接收的格式，并最终写入目标平台。

数据请求与清洗

首先，我们从钉钉平台获取报销单数据。假设我们已经完成了数据请求与清洗阶段，接下来进入数据转换与写入阶段。

数据转换与写入

在此阶段，我们需要将清洗后的数据进行ETL处理，使其符合金蝶云星空API接口的要求。以下是详细的元数据配置及其解析：

{
  "api": "batchSave",
  "method": "POST",
  "idCheck": true,
  "operation": {
    "method": "batchArraySave",
    "rows": 1,
    "rowsKey": "array"
  },
  "request": [
    {"field":"FBillNo","label":"单据编号","type":"string","value":"{{extend.business_id}}"},
    {"field":"FDate","label":"申请日期","type":"string","value":"{{报销明细.费用发生日期}}"},
    {"field":"FBillTypeID","label":"单据类型","type":"string","value":"FYBXD001_SYS","parser":{"name":"ConvertObjectParser","params":"FNumber"}},
    {"field":"FExpenseOrgId","label":"费用承担组织","type":"string","value":"{{主体企业}}","parser":{"name":"ConvertObjectParser","params":"FNumber"},"mapping":{"target":"6577ba6af82ea526c578f93c","direction":"positive"}},
    {"field":"FExpenseDeptID","label":"费用承担部门","type":"string","value":"_findCollection find FNumber from da721f4d-6c26-3cce-913a-95995e34543f where FName={{extend.originator_dept_name}} and FFullName={{主体企业}}","parser":{"name":"ConvertObjectParser","params":"FNumber"}},
    {"field":"FOrgID","label":"申请组织","type":"string","value":"{{主体企业}}","parser":{"name":"ConvertObjectParser","params":"FNumber"},"mapping":{"target":"6577ba6af82ea526c578f93c","direction":"positive"}},
    {"field":"FProposerID","label":"申请人","type":"string","value":"_findCollection find FNumber from 16c4e534-8d99-371a-bd8f-92c5149c9b1f where FName={{归属人}}","parser":{"name":"ConvertObjectParser","params":"FSTAFFNUMBER"}},
    {"field":"FCONTACTUNITTYPE","label":"往来单位类型","type":"string","value":"BD_Supplier"},
    {"field":"FRequestDeptID","label":"申请部门","type":"","value":"","parser":{"name":"","params":""}},
    {"field":"","label":"","type":"","value":"","parser":{"name":"","params":""}}
  ],
  "otherRequest":[
    {"field":"","label":"","type":"","describe":"","value":""},
    {"field":"","label":"","type":"","describe":"","value":""},
    {"field":"","label":"","type":"","describe":"","value":""}
  ]
}

配置解析

  1. FBillNo（单据编号）：

    • 类型：字符串
    • 来源：{{extend.business_id}}
    • 描述：使用钉钉中的业务ID作为金蝶云中的单据编号。

  2. FDate（申请日期）：

    • 类型：字符串
    • 来源：{{报销明细.费用发生日期}}
    • 描述：提取报销明细中的费用发生日期作为申请日期。

  3. FBillTypeID（单据类型）：

    • 类型：字符串
    • 固定值：FYBXD001_SYS
    • 描述：设置为固定值，表示这是一个标准的报销单类型。

  4. FExpenseOrgId（费用承担组织）：

    • 类型：字符串
    • 来源：{{主体企业}}
    • 描述：提取主体企业信息，并通过ConvertObjectParser进行解析，确保其符合金蝶云的编码规则。

  5. FExpenseDeptID（费用承担部门）：

    • 类型：字符串
    • 来源：通过复杂查询 _findCollection find FNumber from da721f4d-6c26-3cce-913a-95995e34543f where FName={{extend.originator_dept_name}} and FFullName={{主体企业}}
    • 描述：根据部门名称和企业全称查询对应的部门编码，并进行解析。

  6. FOrgID（申请组织）：

    • 类型：字符串
    • 来源：{{主体企业}}
    • 描述：同样提取主体企业信息并进行编码解析。

  7. FProposerID（申请人）：

    • 类型：字符串
    • 来源：通过复杂查询 _findCollection find FNumber from 16c4e534-8d99-371a-bd8f-92c5149c9b1f where FName={{归属人}}
    • 描述：根据归属人姓名查询对应的员工编码，并进行解析。

  8. FCONTACTUNITTYPE（往来单位类型）：

    • 类型：字符串
    • 固定值：BD_Supplier
    • 描述：设置为固定值，表示往来单位类型为供应商。

  9. 其他字段配置： 包括 FRequestDeptID, FCausa, FillByBeimAmount, FBankBranchT, FBankAccountNameT, FBankAccountT, FBANKCNAPS, 等等，每个字段都需要根据具体业务需求进行相应配置和解析，以确保所有字段的数据格式和内容都符合金蝶云星空API接口的要求。

数据写入

配置完成后，通过轻易云平台提供的API调用功能，将转换后的数据发送到金蝶云星空平台。具体调用方式如下：

{
  "api": "batchSave",
  "method": "POST",
  "idCheck": true,
  "operation": {
    "method": "batchArraySave",
    "rows": 1,
    "rowsKey": "array"
  },
  ...
}

在实际操作中，我们可以通过实时监控和日志记录功能，确保每一步操作都透明可见，及时发现并解决潜在问题，从而保证数据集成过程顺利完成。 金蝶与MES系统接口开发配置

版权声明

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

小满CRM与畅捷通T+对接
更多系统对接方案