轻易云平台在金蝶云星空与钉钉数据集成中的应用

  • 轻易云集成顾问-王敏

金蝶云星空数据集成到钉钉的技术案例分享

在企业信息化系统中，数据的高效流转和准确对接是提升业务运营效率的关键。本文将聚焦于一个具体的系统对接集成案例：如何将金蝶云星空中的其他业务付款单数据集成到钉钉平台，实现两大系统间的数据无缝对接。

本次集成方案名为“其他业务付款单金蝶=>钉钉”，主要目的是通过轻易云数据集成平台，将金蝶云星空中的付款单数据实时、准确地传输至钉钉，以便相关业务流程能够在钉钉上顺利进行和监控。

首先，我们需要解决从金蝶云星空获取数据的问题。通过调用金蝶云星空提供的executeBillQuery API接口，可以定时可靠地抓取所需的付款单数据。在这个过程中，必须处理好接口分页和限流问题，以确保所有数据都能被完整获取，不漏单、不重复。

其次，在将这些数据写入到钉钉之前，需要考虑两者之间的数据格式差异。轻易云平台支持自定义数据转换逻辑，使得我们可以根据特定业务需求，对获取的数据进行必要的转换和映射。这一步骤对于保证后续操作的顺利进行至关重要。

为了实现高效的数据写入，我们利用了轻易云平台提供的大量数据快速写入能力，通过调用钉钉API topapi/processinstance/create，批量将处理后的付款单数据导入到目标系统中。同时，为了确保整个过程透明可控，我们依赖于平台提供的集中监控和告警系统，实时跟踪每个任务的状态和性能，一旦出现异常情况，可以及时响应并处理。

最后，针对可能出现的数据质量问题，轻易云平台还提供了强大的数据质量监控和异常检测功能。这些功能帮助我们在第一时间发现并解决潜在问题，从而保障整个集成过程的稳定性和可靠性。

通过以上步骤，我们成功实现了金蝶云星空与钉钉之间的数据无缝对接，为企业内部各项业务流程的信息化管理提供了有力支持。 用友与WMS系统接口开发配置

金蝶与SCM系统接口开发配置

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

在轻易云数据集成平台的生命周期中，调用源系统接口是至关重要的一步。本文将详细探讨如何通过调用金蝶云星空的executeBillQuery接口来获取并加工其他业务付款单的数据。

配置元数据

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

  • api: executeBillQuery
  • method: POST
  • FormId: AP_PAYBILL
  • FieldKeys: 需查询的字段key集合，格式为字符串数组，通过逗号分隔。
  • FilterString: 过滤条件，用于筛选符合条件的数据。例如：FModifyDate>='{{LAST_SYNC_TIME|datetime}}' and FDocumentStatus='B' and FBillNo<>'' and F_ora_CheckBox='1' and F_ora_Combo4='其他业务付款单'
  • Limit: 最大行数，用于分页查询。
  • StartRow: 开始行索引，用于分页查询。

请求参数示例

在实际调用过程中，请求参数会根据具体需求进行调整。以下是一个请求参数示例：

{
  "FormId": "AP_PAYBILL",
  "FieldKeys": "FBillNo,FPAYBILLENTRY_FEntryID,FID,FDOCUMENTSTATUS,FCreatorId,FAPPROVERID,FCreateDate,FSETTLEORGID.FName,FApproveDate,FPURCHASEORGID.FNumber,FPAYTOTALAMOUNTFOR_H,FCURRENCYID.FNumber,FDATE,FModifyDate,FModifierId,FWRITTENOFFSTATUS,FBillTypeID.FNumber,FPURCHASERID.FNumber,FPURCHASERGROUPID,FPURCHASEDEPTID.FNumber,FREALPAYAMOUNTFOR_H,FACCOUNTSYSTEM,FCancellerId,FCancelStatus,FCancelDate,FCONTACTUNITTYPE,FCONTACTUNIT.FNumber,FRECTUNITTYPE,FRECTUNIT.FName",
  "FilterString": "FModifyDate>='2023-01-01' and FDocumentStatus='B' and FBillNo<>'' and F_ora_CheckBox='1' and F_ora_Combo4='其他业务付款单'",
  "Limit": "100",
  "StartRow": "0"
}

数据清洗与转换

在获取到原始数据后，需要对数据进行清洗和转换，以确保其符合目标系统（如钉钉）的要求。这一步骤包括但不限于：

  1. 字段映射与重命名：将金蝶云星空中的字段名称映射为目标系统中的字段名称。例如，将FBillNo映射为bill_number。
  2. 数据类型转换：确保所有字段的数据类型与目标系统一致。例如，将日期字符串转换为标准日期格式。
  3. 缺失值处理：对于某些必填字段，如果存在缺失值，需要进行适当处理，如填充默认值或丢弃该条记录。

分页与限流处理

由于金蝶云星空接口可能会返回大量数据，因此需要进行分页处理。通过设置Limit和StartRow参数，可以逐页获取数据。此外，还需考虑限流问题，避免因频繁请求导致接口被封禁。

{
  "FormId": "AP_PAYBILL",
  "FieldKeys": "...", // 字段列表同上
  "FilterString": "...", // 同上
  "Limit": "100",
  "StartRow": "{PAGINATION_START_ROW}"
}

每次请求后，根据返回结果更新StartRow，直到所有数据全部获取完毕。

实时监控与日志记录

为了确保整个过程的可靠性和可追溯性，需要实现实时监控与日志记录。可以通过轻易云平台提供的监控功能，实时跟踪每个API调用的状态，并记录相关日志信息，包括请求时间、响应时间、成功或失败状态等。

异常处理与错误重试机制

在实际操作中，可能会遇到各种异常情况，如网络故障、接口超时等。因此，需要设计健壮的异常处理机制，并实现错误重试功能。当某次请求失败时，可以根据预设策略进行多次重试，以提高成功率。

综上所述，通过合理配置元数据、精细化的数据清洗与转换、有效的分页与限流处理，以及完善的监控和异常处理机制，可以高效地完成从金蝶云星空到钉钉的数据集成任务。这不仅提升了数据处理效率，也保证了数据的一致性和完整性。 打通钉钉数据接口

钉钉与ERP系统接口开发配置

将金蝶云星空数据转化为钉钉API接口格式并写入

在数据集成平台的生命周期中，第二步是将已经集成的源平台数据进行ETL转换，并转化为目标平台能够接收的格式。本案例中，我们将金蝶云星空中的其他业务付款单数据转换为钉钉API接口所能接收的格式，最终写入到钉钉系统中。

1. 数据请求与清洗

首先，通过调用金蝶云星空的executeBillQuery接口获取其他业务付款单的数据。需要特别注意处理分页和限流问题，以确保所有数据能够被完整抓取，不漏单。抓取的数据可能包含冗余或不一致的部分，需要通过清洗步骤来处理，例如去除无效字段、标准化日期格式等。

{
  "field": "process_code",
  "label": "process_code",
  "type": "string",
  "describe": "process_code在审批流程编辑页面的URL网址中获取。",
  "value": "PROC-AE5EEB3F-F369-4342-A4DE-250355BDF451"
}

2. 数据转换

在清洗后的数据基础上，进行数据转换，使其符合钉钉API接口要求。以下是主要字段的转换逻辑：

  • originator_user_id：从金蝶云星空中根据FCreatorId查询发起人的用户ID。
  • dept_id：根据发起人的用户ID查询其所在部门，如果属于根部门，则传递-1。
  • form_component_values：这是一个复杂对象，其中包含多个字段，每个字段都需要根据金蝶云星空中的对应值进行映射和转换。

例如，“单据编号”字段直接映射金蝶云星空中的FBillNo，“付款类型”字段映射F_ora_Combo2，而“办理人”字段则需要通过查询来获得对应的员工编号。

{
  "field": "form_component_values",
  "label": "form_component_values",
  "type": "object",
  "children": [
    {
      "field": "单据编号",
      "label": "单据编号",
      "type": "string",
      "value": "{FBillNo}"
    },
    {
      ...
    }
  ]
}

3. 数据写入

经过上述步骤后，已经完成了从金蝶云星空到钉钉API接口格式的数据转换。接下来，通过调用钉钉的topapi/processinstance/create接口，将处理好的数据写入到钉钉系统中。

为了确保数据写入过程中的可靠性和一致性，可以利用轻易云平台提供的高吞吐量能力及异常处理机制。例如，当写入过程中出现错误时，可以通过重试机制进行修复，以避免数据丢失或重复。

{
  "api": "/topapi/processinstance/create",
  ...
}

此外，实时监控和日志记录也是非常重要的一环，通过这些手段可以及时发现并解决潜在的问题，从而保证整个集成过程的顺利进行。

小结

通过以上步骤，我们实现了将金蝶云星空中的其他业务付款单数据成功地ETL转换为钉钉API接口所能接受的格式，并顺利写入到目标平台。这一过程不仅提高了数据处理效率，还保证了数据的一致性和可靠性。 金蝶与CRM系统接口开发配置

轻易云数据集成平台金蝶集成接口配置

版权声明

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

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