企业微信成员删除：使用轻易云平台实现ETL转换

  • 轻易云集成顾问-何语琴

删除企业微信成员：简道云数据集成案例分享

在企业管理中，时常需要对人员信息进行更新和同步。本文将深入探讨一个具体的系统对接集成案例——如何通过轻易云数据集成平台，将简道云的数据与企业微信紧密连接，实现自动删除企业微信成员的功能。

首先，我们需要从简道云获取最新的用户数据。利用API接口 /api/v2/app/{app_id}/entry/{entry_id}/data 可以高效地抓取并读取所需的信息。但是，由于简道云接口存在分页和限流机制，为避免数据丢失及确保操作连续性，在实现过程中需特别关注这些技术细节。在后续步骤中，通过定时任务可靠地提取这些数据，不仅保证了实时性，而且极大提升了系统稳定性。

接下来是批量处理所获的数据，并调用企业微信提供的删除接口 /cgi-bin/user/delete 进行相应操作。然而，这其中不可避免会遇到一些挑战，例如两者之间的数据格式差异、及可能出现的网络异常或服务器错误等问题。为此，实现了一套智能化异常处理和错误重试机制，确保每一次请求都能达到预期效果，同时记录日志以便追踪问题源头。

以上过程只是整个方案的一部分，而核心则在于整合各环节，使其协同工作，以达到最佳效率。我们还针对特定需求进行了定制化的数据映射，对不同字段间进行准确转换，进一步提高了流程自动化水平。从而使得削减繁琐人工操作成为可能，使IT部门真正能将精力集中于更具战略性的任务上。

此次分享希望能够为您下一步实施类似项目提供参考，而详细内容将在随后章节逐一介绍。

企业微信与ERP系统接口开发配置

调用简道云接口获取并加工数据

在数据集成的生命周期中，第一步是从源系统获取数据，并对其进行初步加工。本文将详细探讨如何通过调用简道云接口/api/v2/app/{app_id}/entry/{entry_id}/data来实现这一过程。

接口概述

该接口主要用于从简道云平台获取指定应用和表单的数据。请求方法为POST，支持多种过滤和查询参数配置，以满足不同的数据获取需求。

元数据配置解析

以下是元数据配置的详细解析：

{
  "api": "/api/v2/app/{app_id}/entry/{entry_id}/data",
  "effect": "QUERY",
  "method": "POST",
  "id": "_id",
  "idCheck": true,
  "request": [
    {
      "field": "appId",
      "label": "应用ID",
      "type": "string",
      "describe": "应用ID",
      "value": "6399c24287cae90008d24e0b"
    },
    {
      "field": "entryId",
      "label": "表单ID",
      "type": "string",
      "describe": "表单ID",
      "value": "64d069f07f4b63000837515b"
    },
    {
      "field": "fields",
      "label": "需要查询的字段",
      "type": "string",
      ...
    },
    ...
  ],
  ...
}

  1. API路径：/api/v2/app/{app_id}/entry/{entry_id}/data

    • app_id 和 entry_id 分别代表应用ID和表单ID，通过这些参数可以定位到具体的数据源。

  2. 请求方法：POST

    • 使用POST方法提交请求，确保数据传输的安全性和完整性。

  3. 主键字段：_id

    • 数据记录的唯一标识符，用于后续的数据处理和匹配。

  4. 请求参数：

    • appId: 应用ID，固定值为6399c24287cae90008d24e0b
    • entryId: 表单ID，固定值为64d069f07f4b63000837515b
    • fields: 查询字段列表，可选参数，多个字段以逗号隔开。
    • limit: 每页返回数量，默认值为100。
    • filter: 过滤参数，用于精确筛选数据。

请求示例

以下是一个完整的请求示例：

{
  "appId": "6399c24287cae90008d24e0b",
  "entryId": "64d069f07f4b63000837515b",
  "fields": ["name", "_id", "_widget_1585907139131"],
  ...
}

数据过滤与加工

在实际操作中，我们通常需要对获取的数据进行过滤和加工。以下是一些常见的过滤条件配置：

  1. 逻辑关系：

    {
 ...
 {"field":"rel","label":"过滤参数逻辑","type":"string","describe":"\"rel\": \"and\", \/\/ 或者 \"or\"","value":"and"}
 ...
}
    • 设置过滤条件之间的逻辑关系，可以是and或or。

  2. 自定义字段过滤：

    {
 ...
 {"field":"cond_1","label":"自定义字段过滤","type":"object","describe":"自定义字段过滤","children":[
   {"field":"field","label":"过滤字段","type":"string","describe":"过滤字段","value":"flowState == 1"},
   {"field":"type","label":"过滤类型","type":"string","describe":"text\\number\\flowstate","value":"datetime"},
   {"field":"method","label":"过滤方法","type":"string","describe":"过滤方法；“not_empty”(不为空)，“empty”(为空)，“eq”(等于)，“in”(等于任意一个)，“range”(在x与y之间，并且包含x和y本身)，“nin”(不等于任意一个)，“ne”(不等于), “like”(文本包含)","value":"range"},
   {"field":"value","label":"过滤值","type":"string","describe":"过滤值","parser":{"name":"StringToArray","params":","},"value":"{{LAST_SYNC_TIME|datetime}}"}
 ]}
 ...
}
    • 配置自定义字段及其对应的过滤条件，如时间范围、状态等。

  3. 自动填充响应：

    {
 ...
 {"autoFillResponse":true}
 ...
}
    • 自动填充响应数据，确保返回结果的一致性和完整性。

实践案例：删除企业微信成员

假设我们需要删除企业微信中的某些成员，可以通过以下步骤实现：

  1. 获取成员列表： 调用简道云接口获取符合条件的成员列表，如状态为离职或禁用的成员。

  2. 处理响应数据： 对响应数据进行解析和处理，提取出需要删除的成员信息。

  3. 调用企业微信API删除成员： 根据提取的信息，调用企业微信提供的API接口逐一删除对应成员。

通过上述步骤，我们可以高效地完成从简道云获取数据并进行后续处理，实现企业微信成员管理的自动化操作。 用友BIP接口开发配置

使用轻易云数据集成平台进行ETL转换：删除企业微信成员

在数据集成生命周期的第二步中，我们需要将已经集成的源平台数据进行ETL转换，转为目标平台企业微信API接口所能够接收的格式，并最终写入目标平台。本文将详细介绍如何通过轻易云数据集成平台实现这一过程，特别是如何配置和使用企业微信API接口来删除企业微信成员。

API接口元数据配置

首先，我们需要了解用于删除企业微信成员的API接口元数据配置。以下是相关的元数据配置：

{
  "api": "/cgi-bin/user/delete",
  "effect": "EXECUTE",
  "method": "POST",
  "idCheck": true,
  "request": [
    {
      "field": "userid",
      "label": "成员UserID",
      "type": "string",
      "describe": "对应管理端的帐号，企业内必须唯一。长度为1~64个字节。只能由数字、字母和“_-@.”四种字符组成，且第一个字符必须是数字或字母。系统进行唯一性检查时会忽略大小写。",
      "value": "{_widget_1691380208518}"
    }
  ]
}

数据请求与清洗

在进行ETL转换之前，首先需要从源平台获取原始数据，并对其进行清洗和预处理。这一步骤确保了我们获取的数据是准确且符合要求的。

假设我们从源平台获取到了一组待删除的用户ID列表：

[
  {"userid": "user123"},
  {"userid": "user456"},
  {"userid": "user789"}
]

这些用户ID需要经过清洗，以确保它们符合企业微信API接口的要求，即每个userid必须是唯一且符合特定字符限制。

数据转换与写入

接下来，我们进入ETL生命周期的核心步骤：数据转换与写入。在这一阶段，我们将清洗后的用户ID列表转换为目标平台所需的格式，并通过企业微信API接口执行删除操作。

根据元数据配置，我们需要构建一个POST请求，其中包含要删除的userid。以下是一个示例请求体：

{
  "userid": "{_widget_1691380208518}"
}

为了实现这一点，可以使用轻易云的数据映射功能，将清洗后的用户ID映射到请求体中的userid字段。例如，对于用户user123，生成的请求体如下：

{
  "userid": "user123"
}

然后，通过轻易云的数据集成平台发起POST请求，调用企业微信API接口：

POST /cgi-bin/user/delete HTTP/1.1
Host: api.weixin.qq.com
Content-Type: application/json

{
  "userid": "user123"
}

如果请求成功，API将返回一个状态码和响应消息，表示该用户已被成功删除。

批量处理

对于批量处理多个用户ID，可以使用循环或批量处理机制，将每个用户ID逐一发送到企业微信API接口。例如，对于上面的三个用户ID，可以依次发送三个POST请求：

POST /cgi-bin/user/delete HTTP/1.1
Host: api.weixin.qq.com
Content-Type: application/json

{
  "userid": "user123"
}

POST /cgi-bin/user/delete HTTP/1.1
Host: api.weixin.qq.com
Content-Type: application/json

{
  "userid": "user456"
}

POST /cgi-bin/user/delete HTTP/1.1
Host: api.weixin.qq.com
Content-Type: application/json

{
  "userid": "user789"
}

通过这种方式，可以确保所有待删除的用户都被正确地从企业微信中移除。

实时监控与日志记录

在整个ETL过程中，通过轻易云的数据集成平台提供的实时监控和日志记录功能，可以随时查看每个步骤的执行状态和结果。这有助于及时发现并解决潜在的问题，提高整体操作效率和透明度。

综上所述，通过合理配置和使用轻易云数据集成平台，可以高效地完成从源平台到目标平台的数据ETL转换，并成功调用企业微信API接口实现成员删除操作。这一过程不仅简化了复杂的数据处理流程，还大大提升了业务操作的自动化程度和准确性。 用友与SCM系统接口开发配置

版权声明

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

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