轻易云平台助力泛微OA与金蝶云快速集成：实战指南

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

泛微OA到金蝶云星空的高效数据集成：差旅费报销申请案例分析

在本文中，我们将深入探讨如何通过轻易云数据集成平台，成功实现泛微OA系统与金蝶云星空之间的数据对接。针对具体的FD001-差旅费报销申请集成方案，我们着重解决了汇率字段缺失、币别格式不统一等问题，并确保了大规模数据的高效流转和实时监控。

首先，为了获取泛微OA系统中的差旅费报销申请数据，我们使用其提供的API /api/workflow/paService/getWorkflowRequest。该接口支持定时可靠抓取，为后续处理打下坚实基础。然而，由于泛微OA的数据结构与金蝶云星空有所不同，例如汇率字段没有对应信息以及币别字段存在格式不一致的问题，需要对原始数据进行适应性的转换。

在轻易云平台上，通过可视化的数据流设计工具，我们定义了一系列自定义数据转换逻辑。这些逻辑不仅解决了上述汇率和币别字段的问题，还优化了分页抓取及限流机制，避免因大量请求而导致API性能下降。在处理过程中，平台强大的批量写入能力使得我们能够快速、高效地将已清洗和处理好的数据推送至金蝶云星空，以实现业务流程的无缝衔接。

借助集中监控和告警系统，我们可以实时跟踪整个任务状态和性能，并及时发现并修复任何异常情况。此外，对于常见错误，如网络波动或接口响应延迟，通过预设的错误重试机制进一步提升了整体稳定性。这些特性为确保泛微OA到金蝶云星空的大规模、高频次、安全性的数据传输提供了保障，同时也满足企业对于精准、透明数据信息管理日益增长的需求。

结合实际案例中的技术要点，让我们继续深入探讨本次集成方案所涉及的更多细节操作及最佳实践。 金蝶云星空API接口配置

调用泛微OA-Http接口获取并加工数据

在数据集成过程中，调用源系统接口是至关重要的一步。本文将详细探讨如何通过轻易云数据集成平台调用泛微OA-Http接口/api/workflow/paService/getWorkflowRequest，并对获取的数据进行初步加工处理。

接口调用配置

首先，我们需要配置元数据，以便正确调用泛微OA的API接口。以下是元数据配置的具体内容：

{
  "api": "/api/workflow/paService/getWorkflowRequest",
  "effect": "QUERY",
  "method": "GET",
  "number": "requestId",
  "id": "requestId",
  "name": "id",
  "idCheck": true,
  "request": [
    {
      "field": "workflowId",
      "label": "e9流程id",
      "type": "string",
      "value": "392"
    },
    {
      "field": "workflowIdList",
      "label": "workflowIdList中间方案ID",
      "type": "string",
      "value": "2356388e-8c49-35b3-bb7e-1eca1a8617d5"
    }
  ],
  "autoFillResponse": true
}

元数据解析

  1. API路径：/api/workflow/paService/getWorkflowRequest

    • 这是我们需要调用的泛微OA系统的HTTP接口路径。

  2. 请求方法：GET

    • 我们将使用HTTP GET方法来请求数据。

  3. 请求参数：

    • workflowId: e9流程ID，类型为字符串，值为"392"。
    • workflowIdList: workflowIdList中间方案ID，类型为字符串，值为"2356388e-8c49-35b3-bb7e-1eca1a8617d5"。

  4. 自动填充响应：autoFillResponse: true

    • 表示系统会自动处理并填充响应数据。

数据请求与清洗

在配置好元数据后，我们可以通过轻易云平台发起对泛微OA接口的请求。以下是一个示例代码片段，用于发起HTTP GET请求并处理响应：

import requests

# 定义API URL和参数
api_url = 'https://example.com/api/workflow/paService/getWorkflowRequest'
params = {
    'workflowId': '392',
    'workflowIdList': '2356388e-8c49-35b3-bb7e-1eca1a8617d5'
}

# 发起GET请求
response = requests.get(api_url, params=params)

# 检查响应状态码
if response.status_code == 200:
    data = response.json()
    # 对返回的数据进行初步清洗和处理
    processed_data = process_data(data)
else:
    print(f'Error: {response.status_code}')

在上面的代码中，我们使用Python的requests库发起HTTP GET请求，并传递必要的参数。如果请求成功（状态码200），则对返回的数据进行初步清洗和处理。

数据转换与写入

在获取并清洗了源系统的数据后，我们需要将其转换为目标系统所需的格式，并写入目标系统。由于本文重点在于第一步，这里简要提及转换和写入步骤：

def process_data(data):
    # 假设data是一个字典，包含多个字段
    # 清洗和转换数据，例如处理币别字段格式问题
    if 'currency' in data:
        data['currency'] = convert_currency_format(data['currency'])

    # 返回处理后的数据
    return data

def convert_currency_format(currency):
    # 示例函数，将币别字段转换为目标格式
    currency_mapping = {
        'USD': '美元',
        'CNY': '人民币'
        # 添加更多映射关系...
    }
    return currency_mapping.get(currency, currency)

以上代码示例展示了如何清洗和转换特定字段（如币别字段）的格式问题。实际应用中可能需要根据具体业务需求进行更复杂的数据处理。

通过上述步骤，我们实现了从泛微OA系统获取数据、清洗和初步加工，为后续的数据转换与写入奠定了基础。这一过程不仅确保了数据的一致性和准确性，也提升了整体业务流程的效率。 如何对接用友BIP接口

利用轻易云数据集成平台进行ETL转换并写入金蝶云星空API接口

在数据集成生命周期的第二步中，我们需要将已经集成的源平台数据进行ETL（Extract, Transform, Load）转换，转为目标平台——金蝶云星空API接口所能够接收的格式，并最终写入目标平台。以下是一个具体的技术案例，展示如何通过轻易云数据集成平台实现这一过程。

元数据配置解析

元数据配置是整个ETL过程的核心，它定义了从源系统到目标系统的数据映射和转换规则。以下是我们使用的元数据配置：

{
  "api": "batchSave",
  "effect": "EXECUTE",
  "method": "POST",
  "idCheck": true,
  "operation": {
    "rowsKey": "array",
    "rows": 1,
    "method": "batchArraySave"
  },
  "request": [
    {
      "field": "FBillTypeID",
      "label": "单据类型",
      "type": "string",
      "describe": "单据类型\n其他应付单-QTYFD01_SYS\n费用报销其他应付单-QTYFD02 SYS",
      "parser": {
        "name": "ConvertObjectParser",
        "params": "FNumber"
      },
      "value": "QTYFD01_SYS"
    },
    {
      // ...其他字段省略
    }
  ],
  // ...其他配置省略
}

数据提取与转换

在这个过程中，首先需要从源系统提取数据。假设我们从泛微系统中提取差旅费报销申请的数据，这些数据需要经过一系列转换才能符合金蝶云星空API接口的要求。

  1. 单据类型（FBillTypeID）：

    • 配置中定义了FBillTypeID字段，其值为QTYFD01_SYS，表示其他应付单。
    • 使用ConvertObjectParser进行对象转换，将其转换为金蝶系统可识别的编号格式。

  2. 业务日期（FDATE）：

    • 使用模板变量{{workflowMainTableInfo.sqrq}}直接从源系统中获取业务日期，并填充到目标字段中。

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

    • 固定值为BD_Empinfo，表示员工类型。
    • 无需额外转换，直接赋值。

  4. 币别（FCURRENCYID）：

    • 从源系统中的币别字段获取值，并通过ConvertObjectParser将其转换为金蝶系统中的编号。
    • 示例： _findCollection find FNumber from 5740d4e3-ebe8-3548-9635-f35e1fdc983b where FCODE={{workflowMainTableInfo.bb1}}

  5. 结算组织、采购组织、付款组织（FSETTLEORGID, FPURCHASEORGID, FPAYORGID）：

    • 使用相同的模板变量 {{workflowMainTableInfo.sqgs}} 并通过 ConvertObjectParser 转换后填充到相应字段中。

  6. 申请部门（FDEPARTMENTID）：

    • 从源系统获取申请部门信息并进行编号转换。
    • 示例： {{workflowMainTableInfo.sqbm_FV}}

  7. 备注（FRemarks）：

    • 直接从源系统获取备注信息并填充。
    • 示例： {{workflowMainTableInfo.bzsm}}

  8. 汇率类型（FEXCHANGETYPE）：

    • 固定值 HLTX01_SYS 表示标准汇率类型，无需额外处理。

  9. 自定义单号（F_WDW_OANO）：

    • 从源系统获取流程编号并填充。
    • 示例： {{workflowMainTableInfo.lcbh}}

  10. 明细信息（FEntity）：

    • 明细信息是一个数组，每个元素代表一条明细记录。
    • 包含费用项目编码、发票类型、不含税金额、备注等字段，每个字段都需要根据源系统的数据进行相应的转换和填充。

数据加载

完成所有字段的映射和转换后，通过调用金蝶云星空API接口将数据写入目标平台。具体实现如下：

{
  // 请求头部信息
  ...

  // 请求体
  {
    // 主表信息
    ...

    // 明细表信息
    ...

    // API操作参数
    {
      "FormId": "AP_OtherPayable",
      "Operation": "BatchSave",
      ...
    }
  }
}

通过以上步骤，我们成功地将泛微系统中的差旅费报销申请数据提取、转换并加载到金蝶云星空平台，实现了不同系统间的数据无缝对接。这不仅提高了数据处理效率，还确保了数据的一致性和准确性。 金蝶与MES系统接口开发配置

版权声明

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

数据集成平台集成生命周期
更多系统对接方案