金蝶云星空（旗舰版）

1.1 应用场景

金蝶用户计划深入进行数据分析，以帮助他们更好的了解业务数据，为未来的决策提供有力支撑。

1.2 功能简介

用户需要拥有 金蝶云星空（旗舰版） 账号，前往金蝶云星空（旗舰版）中新增第三方应用，将获得的信息填写在本产品配置界面，即可完成授权。

完成授权后，相关数据就获取到本产品中了，且获取的数据报告类型在不断的丰富中。

1.3 注意事项

1）Beta 版本的数据源正处于公测阶段，如在使用中有任何问题或者需求，可联系技术支持进行反馈。Beta 版本在完成测试周期后会成为正式版，该信息将通过产品公告通知用户。

2）「金蝶云星空（旗舰版）」为付费数据源，请管理员开通试用或者购买该数据源。

3）此数据源会调用星空旗舰版 API ，需要购买 API 使用许可，请用户自行购买星空旗舰版 OpenAPI 。详情请参见金蝶云星空官方文档：OpenAPI（开放平台）计费说明

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 中，查看是否存在必填的参数，必填的参数信息需要写在请求参数栏中。如下图所示：

配置项说明如下表所示：

1）进入数据连接市场，新增「金蝶云星空（旗舰版）」数据源。如下图所示：

2）在页面中填写相关信息，说明如下表所示：

3）左侧列表为可以选择添加的数据表，点击「查看」可以查看各表字段信息。勾选需要添加的数据表，点击「>」添加表。

若用户希望自动获取新增的表，可在选表界面开启「新增表自动勾选」。

4）添加好数据表后，点击「确认」。如下图所示：

5）在左侧就获取到了数据列表。如下图所示：

1）完成授权后，在左侧就获取了数据列表。此时还没有数据，点击「同步数据源」将全部数据同步一次，先获取数据。如下图所示：

2）之后可以根据自己的实际需求，对单表或者多表进行同步。建议减少同步整个数据源次数，以避免不必要的等待时间。详情参见文档：同步数据

数据源的创建者默认拥有数据源的管理权限，管理者可将此数据源分配给其他成员使用。

点击「权限设置」按钮，在弹窗中即可自定义配置数据源权限，详情参见文档：数据源权限设置

获取到数据后，需要将数据保存在「分析展示」模块的项目中，进一步地分析。