1. 概述
1.1 功能说明
FineDataLink 支持连接金蝶云星空（旗舰版）数据源，支持：定时管道任务读取。
1.2 使用限制
1）「金蝶云星空（旗舰版）」数据连接支持获取的表及字段信息见：平台/表/字段
2）仅当用户注册了「应用系统（云端）」功能点，且「应用系统（云端）-类型数」大于 0 时，才支持使用此数据源。详情参见文档：注册简介
3）工程所在服务器需具备访问外网权限，或者可以配置白名单：
域名白名单：dm.shukuajing.com
IP 白名单：47.110.75.116
2. 获取授权信息
2.1 基础授权信息
授权「金蝶云星空（旗舰版）」数据源需获取以下图片中的信息，请金蝶云星空产品管理员新增第三方应用获取相关信息。
1）管理员在浏览器中登录金蝶云星空（旗舰版）系统，点击进入「开放服务云>OpenAPI>第三方应用」。如下图所示：
2）点击新增应用，请自定义填写「系统编码」和「系统名称」，例如 JSY 等。如下图所示：
第 3 节新增数据源时，需填写「应用系统编码」信息，即此处的「系统编码」。
3）请开启「启用代理用户控制」，并设置代理用户。如下图所示：
第 3 节新增数据源时，需填写「应用代理的用户名」，即此处的代理用户名。
4）在认证凭证处，可以获取 accountId（即数据中心id ）和 x-acgw-identity 信息。如下图所示：
第 3 节新增数据源时，需填写此处两个信息。
5）在「访问策略」处，点击「编辑」按钮，设置并保存 AccessToken 认证密钥，并开启增强型 Token 认证开关。需注意，认证密钥设置后无法再查看，请立即记录下来。
第 3 节新增数据源时，需填写「应用认证密钥」信息，即此处的 AccessToken 认证密钥。
6）在服务授权中，点击「授权新服务」，请选择需要对接获取的 API 服务，点击「立即授权」。如下图所示：
7）设置完成后，保存。如下图所示：
2.2 更多配置
更多配置中，允许用户自定义表，例如修改部分表的请求方式。
| 内置表 | 自定义表单 | |
|---|---|---|
| 定义 | 由帆软封装的请求方式，在数据连接页面填写授权信息后，会自动获取的表，例如：采购订单详情查询 用户可以修改表的请求方式，例如，修改采购订单表的回溯周期
| 授权后不会自动生成的表，需要用户通过「自定义表单」功能手动配置表的请求方式
|
| 配置项 |
|
|
2.2.1 回溯周期
使用场景：当数据需要时间归因或修正时，回溯周期允许后续重新拉取更新后的准确数据，避免因早期数据不完整导致数据不准确。
如回溯周期=5，则每次从上次同步完成的时刻往前推 5 天开始同步。
2.2.2 账簿.编码/期间.编码
1）在应用菜单中搜索账簿，点击进入「财务会计>总账>基础设置」，获取 账簿.编码/期间.编码 信息。如下图所示：
2.2.3 自定义表单
进入 API 管理列表中，选择某一个 API ，点击「导出 zip」。压缩文件中放置着 .dts 文件。如下图所示：
进入该 API 中，查看是否存在必填的参数，必填的参数信息需要写在请求参数栏中。如下图所示：
配置项说明如下表所示：
| 配置项 | 说明 |
|---|---|
| 上传 api 文件 | 上传 zip 中的 .dts 文件 |
| 表名 | 自定义表名 |
| 请求参数 | 填写除作为游标的日期外，必须传入的参数，即必填的参数，需为 json 格式 例如： { |
3. 配置连接
3.1 前提条件
详情请参见：前提条件
3.2 具体连接步骤
1）创建数据连接步骤请参见：创建并管理数据
2）在页面中填写相关信息，如下图所示：
配置项说明见下表：
| 信息 | 说明 |
|---|---|
| 应用系统编码 | 2.1 节中的「系统编码」信息 |
| 应用认证密钥 | 2.1 节中的「AccessToken 认证密钥」信息 |
| 应用代理名称 | 2.1 节中的「代理用户」信息 |
| accountId | 2.1 节中的「accountId」信息 |
| x-acgw-identity | 2.1 节中的「x-acgw-identity」信息 |
| 第三方服务URL | 访问金蝶云星空系统的地址，例如 https://xxxx.xxxx.com/ |
| 更多配置 | 详情参见本文 2.2 节 |
4. 使用数据源
4.1 定时管道任务读取
定时管道任务的数据来源支持：金蝶云星空（旗舰版），详情参见文档：定时管道概述
上一篇：配置吉客云数据源
