# 钉钉采集套件

来源快照：`result_data_new_260518.json`

- 来源 ID：`1235612029044989967`
- 模块：档案管理
- 目录：设置 - 集成管理 - 采集信息
- space ID：`1157340686672379917`
- 原文链接：未提供
- 产品基线：未提供

## 正文

# 一、钉钉采集套件内容简介

本套件内置了标准钉钉 API 归档采集配置相关资源，针对当前钉钉平台存量历史数据及增量新数据接入档案系统需二次开发推送的痛点，推出标准化采集解决方案。钉钉 API 采集套件支持通过可视化简易配置实现调用钉钉 API 接口快速采集数据进行归档。

 

# 二、钉钉采集套件使用说明

## 2.1钉钉采集套件迁入方式：

方式一：快速创建

您可以在档案应用设置-集成管理-采集信息处点击新建按钮，在弹窗中选择下方的钉钉采集套件快速创建：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1258600266061275140&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

方式二：手动迁入

在文书定门户中获取并下载钉钉采集基础套件包。

迁入入口：在档案应用设置-集成管理-采集信息处点击【本地迁入】按钮，将上一步中下载的压缩包文件上传到弹窗中进行迁入。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1258600364806168588&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

## 2.2 采集套件的任务维护

接下来需要在设置界面维护采集任务，请按以下步骤进行操作：

（1）在档案应用设置-集成管理-采集信息处点击采集任务信息，进入编辑界面，在此处维护相关前置参数：：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1258600463598600202&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**参数说明：**

采集开始时间（年-月-日）：是定位和拉取目标数据的依据，决定了采集任务的起始范围。单次采集任务结束后，系统记录本次采集钉钉审批流的最大时间记录，下一次采集任务开始时，从已记录的时间点后继续增量采集。

审批流id：指定该采集任务对应的钉钉审批流程唯一标识，用于限定采集范围，仅拉取该审批流下的所有相关数据

appSecret：钉钉开放平台应用的专属密钥，用于 API 调用时的身份鉴权，需填写企业在钉钉开放平台创建应用时生成的 appSecret（敏感信息，需妥善保管）

appKey：钉钉开放平台应用的唯一标识，与 appSecret 配合完成 API 调用的身份验证，是钉钉平台识别企业应用的核心凭证。需填写与 appSecret 对应同一钉钉应用的 appKey（一串唯一字符），可在钉钉开发者后台的应用详情页查看；appKey 与 appSecret 必须一一匹配，否则鉴权流程会直接失败。

分页值：控制钉钉 API 数据拉取的分页规则，避免因单次拉取数据量过大导致接口超时、调用失败或数据丢失。

 

（3）在下一步中点击【开始检测】，会触发一次执行动作，并作连通性校验

![](https://weapp.eteams.cn/papi/file/preview?fileId=1258594532190248967&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

【注】若检测失败，需前往esb查看执行日志，并找到异常的节点分析异常原因

 

（4）点击下一步进入数据映射配置

![](https://weapp.eteams.cn/papi/file/preview?fileId=1258595739174133770&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

采集任务维护完成后，系统会按标准定时任务定时执行数据采集归档。

 

## 2.3 查看日志

您可以在采集任务执行后，点击【查看日志】按钮来查看数据进入档案系统的归档接收日志情况：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1258600545169629192&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1258600588228354049&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)
