1. 概述
1.1 应用场景
金蝶用户计划深入进行数据分析，以帮助他们更好的了解业务数据，为未来的决策提供有力支撑。
1.2 功能简介
用户需要拥有 金蝶云星空 账号，前往金蝶云星空中新增第三方系统登录授权，将获得的信息填写在产品配置界面，即可完成授权。
完成授权后，数据就获取到本产品中了，且获取的数据报告类型在不断的丰富中。
1.3 数据范围
1）8.0 版本的云星空比 7.0 版本多获取的数据表有：科目余额表、存货收发存汇总表(按日期) 、委外订单_排产明细表体、客户(包含非交易客户)_对应子账户信息、客户_对应子账户信息、收款执行、收款执行明细
2）各数据表获取的数据时间范围如下表所示：
| 数据表 | 获取的数据时间范围 |
|---|---|
| 存货收发存汇总表（按日期）数据表 | 第一次更新可以获取到第一次更新时间往前推近 1 个月数据，再次更新 可以获取上次更新到这次更新之间的数据 |
| 应收单数据表 | 第一次更新可以获取到第一次更新时间往前推近 3 个月数据，再次更新 可以获取上次更新到这次更新之间的数据 |
| 其他数据表 | 第一次更新 可以获取到第一次更新时间往前推近 6 个月数据，再次更新 可以获取上次更新到这次更新之间的数据 |
如您有更多需求，可联系技术支持反馈。
1.4 注意事项
1）若您的金蝶云星空是部署在内网环境，请将 IP：47.110.75.116、104.168.184.71、 47.245.39.51、49.65.69.136 添加到云星空的白名单中。
2）Beta 版本的数据源正处于公测阶段，如在使用中有任何问题或者需求，可联系技术支持进行反馈。Beta 版本在完成测试周期后会成为正式版，该信息将通过产品公告通知用户。
3）「金蝶云星空」为付费数据源，请管理员开通试用或者购买该数据源。
| 如何开通试用/购买数据源 |
超管或管理员，点击「企业设置>版本信息」，即可试用/购买数据源。如下图所示：
|
2. 授权流程
1）在本产品中获取金蝶云星空数据需要先获取以下信息：
2）「 ① 授权配置」所需要的信息，请在金蝶云空中新建「第三方系统登录授权」获取。分为以下三个版本，请根据自己的金蝶云星空版本跳转到对应小节中查看相关操作：
补丁版本为PT146928「8.0.396.10」以上公有云第三方授权：参见 3.2 节；
补丁版本为PT146928「8.0.396.10」以上私有云第三方授权：参见 3.3 节；
补丁版本未升级PT146928「8.0.396.10」且补丁版本为PT136657「7.3.1310.2」及以上的第三方授权：参见 3.4 节；
3）「② 请求参数配置」 中的「科目余额表」、「存货收发存汇总表」相关信息请根据 3.5、3.6 小节的操作获取；
4）「② 请求参数配置」中的自定义字段信息请根据 3.7 小节的操作获取；
5）根据第 4 节操作，在本产品中新增「金蝶云星空」数据连接，并填写获取的相关信息，即可完成授权；
6）同步金蝶云星空数据，并添加到项目中使用。
3. 获取授权信息
3.1 登录金蝶云星空
需由金蝶云星空产品管理员进行以下操作获取授权信息。
1）使用管理员账号 Administrator 在浏览器中登录金蝶云星空产品，点击「系统管理菜单」下的「第三方系统登录授权」功能。如下图所示：
2）点击「新增」按钮，进入新增「第三方系统登录授权」功能页面。如下图所示：
3）请根据自己使用的金蝶云星空版本跳转到对应的小节获取相关信息。
3.2 版本一：补丁版本为 PT146928「8.0.396.10」以上公有云第三方授权
1）点击「获取应用 ID 」按钮，输入注册的金蝶云账号及密码（金蝶云平台账号，建议使用手机号登录），注意不是当前星空产品内的用户账号。如下图所示：
2）登陆成功之后，会生成「应用 ID」、「应用密钥」，这里需要再自定义「应用名称」。
这里复制「应用密钥」，填写在后续的配置界面。
3）需要指定集成用户，「集成用户框」中选定的成员，在下方「指定用户登录」列表也需要添加该成员。如下图所示：
注：集成用户需要指定，但如果勾选了「允许全部用户登录」，则无需在「指定用户登录」列表中添加成员。
4）设置完成后，保存当前设置。点击「生成测试链接」，验证第三方授权是否正确。在弹出的信息中可以获取「应用 ID、用户名、账套 ID」，复制该信息。如下图所示：
3.3 版本二：补丁版本为PT146928「8.0.396.10」以上私有云第三方授权
1）点击「获取应用 ID 」按钮，再点击「复制网址」可以直接跳转到应用市场，请使用「金蝶云」账号授权登录应用市场。如下图所示：
2）填写对应的信息后，点击「提交」。如下图所示：
3）提交后，会生成「应用信息」，点击「复制」按钮。如下图所示：
4）回到金蝶云星空中，将复制的内容粘贴到「应用信息」栏，点击「确定」。如下图所示：
5）这里会生成「应用 ID」、「应用密钥」，这里需要再自定义「应用名称」。
这里复制「应用密钥」，填写在后续的配置界面。
6）如果需要指定集成用户，「集成用户框」中选定的成员，在下方「指定用户登录」列表也需要添加该成员。如下图所示：
注：集成用户需要指定，但如果勾选了「允许全部用户登录」，则无需在「指定用户登录」列表中添加成员。
7）设置完成后，保存当前设置。点击「生成测试链接」，验证第三方授权是否正确。在弹出的信息中可以获取「应用 ID、用户名、账套 ID」，复制该信息。如下图所示：
3.4 版本三：补丁版本未升级PT146928「8.0.396.10」且补丁版本为PT136657「7.3.1310.2」及以上
1）点击「获取应用 ID 」。如下图所示：
2）点击「复制网址」跳转到 Open网站的第三方系统登录授权页面。如下图所示：
3）在第三方系统登录授权下，点击「新增授权」。如下图所示：
4）请用户根据自身信息填写相关内容，填写完成后点击「提交」。如下图所示：
5）提交后，会生成「应用信息」，点击「复制」按钮。如下图所示：
6）回到金蝶云星空中，将应用信息粘贴在框中，点击「确认」。如下图所示：
7）会生成「应用 ID」、「应用密钥」，这里需要再自定义「应用名称」。如下图所示：
8）历史版本界面：需要集成用户。补丁版本为PT-146894 [7.7.0.202111]及后续的版本参考 9）的界面。
9）补丁版本为PT-146894 [7.7.0.202111]及后续的版本，如果需要指定集成用户，「集成用户框」中选定的成员，在下方「指定用户登录」列表也需要添加该成员。如下图所示：
注：集成用户需要指定，但如果勾选了「允许全部用户登录」，则无需在「指定用户登录」列表中添加成员。
9）设置完成后，保存当前设置。点击「生成测试链接」，验证第三方授权是否正确。在弹出的信息中可以获取「应用 ID、用户名、账套 ID」，复制该信息。如下图所示：
3.5 获取「科目余额表」中的信息
请按照以下步骤获取「币别计数」、「账簿ID」、「科目级别计数」，7.0 版本的云星空可直接跳转到 3.7 节。
1）在主控台菜单下，进入「总账>科目余额表」页面。如下图所示：
2）鼠标点击一下账簿栏，即可获取当前核算组织的「账簿 ID」。如下图所示：
3）点击「币别」，在下拉框中数一下有几种币别即可，下图的币别计数为 8 。如下图所示：
4）点击「科目级别」，在下拉框中数一下有几种科目级别，下图的「科目级别计数」为 4 。如下图所示：
3.6 获取「存货收发存汇总表（按日期）」中的信息
请根据接下来的步骤获取「核算体系编码」、「核算组织编码」、「会计政策编码」、「汇总依据」、「显示纬度」。
1）在主控台菜单下，进入「成本管理>存货核算>存货收发存汇总表（按日期）」页面。如下图所示：
2）「核算体系编码」、「核算组织编码」、「会计政策编码」可在下图标记框中获取相关信息。
3）「汇总依据」、「显示维度」信息请根据自己的需要填写。如果选择「货主」作为汇总依据，那么在本产品中填写 5（即第 5 个）。如果选择「按库存维度显示」作为「显示维度」，那么在本产品中填写 1（即第 2 个）。如下图所示：
3.7 自定义字段
1）目前云星空数据表只能获取基础字段，若客户在 ERP 中自己自定义了字段，是获取不到的，需要用户配置自定义字段信息。
注：自定义字段非必填项，如果不填写，那么表结构中不会包含该自定义字段；若信息填写错误，那么也会同步报错。
2）所有自定义字段信息获取的方式类似，下面将以获取「供应商」自定义字段为例，来说明如何获取自定义字段信息。
3）在应用菜单中搜索 webapi ，进入「Web API 」页面。如下图所示：
4）搜索「供应商」关键字，并点击「查询」，找到供应商数据表，并将操作列表切换为「保存」。如下图所示：
5）页面向下滑动，找到包含下划线「_」的字段，即自定义字段，复制字段信息，填写示例可参考下方折叠框内容。如下图所示：
| 字段信息填写示例 |
|
4. 新增「金蝶云星空」数据源
1）进入数据连接市场，新增「金蝶云星空」数据源。如下图所示：
2）在弹窗中填写相关信息，说明如下表所示：
| 配置 | 说明 | ||
|---|---|---|---|
| 名称 | 自定义数据连接的名称，方便之后识别 | ||
| 用户名/账套 ID /应用 ID |
以上信息，请根据第 3 节步骤获取。
| ||
| 应用密钥 | 各版本用户根据第 3 节步骤，在第三方系统登录授权中获取「应用密钥」。
| ||
| 服务 URL 地址 | 公有云无需配置； 私有云部署的云星空需要配置产品地址，k3cloud/结尾，例如：https://****/k3cloud | ||
| 公网IP地址 | 公有云无需配置； 如果私有云部署的云星空需要配置 DNS 解析，请在此输入相应的公网 IP 地址 | ||
| 科目余额表 | 币别计数 | ERP后台「币别」下拉框中的选项个数 | 请根据 3.5 节步骤获取 |
| 账簿 ID | |||
| 科目级别计数 | ERP后台「科目级别」下拉框中的选项个数 | ||
| 存货收发存汇总表 | 核算体系编码 | 请根据 3.6 节步骤获取 | |
| 核算组织编码 | |||
| 会计政策编码 | |||
| 汇总依据 | ERP后台「汇总依据」下拉框第几位 | ||
| 显示纬度 | ERP后台「显示维度」枚举值下拉框第几位 | ||
| 自定义字段 | 非必填项 若不填写，数据表中只获取基础字段；ERP 中自定义的字段是获取不到的。 填写示例如下图：
| 请根据 3.7 节步骤获取 | |
3）新增数据成功，在左侧会获取到数据列表。如下图所示：
注：若「数据信息」中状态仍需显示「未授权」，请跳转到本文第 8 节查看解决方案
5. 同步数据
1）完成授权后，在左侧就获取了数据列表。此时还没有数据，点击「同步数据源」将全部数据同步一次，先获取数据。如下图所示：
2）之后可以根据自己的实际需求，对单表或者多表进行同步。建议减少同步整个数据源次数，以避免不必要的等待时间。详情参见文档：同步数据
6. 数据源协作
7. 使用数据
获取到数据后，需要将数据保存在「分析展示」模块的项目中，进一步地分析。
8. 授权失败
网络环境可能造成授权失败，如果必填项都填写正确但点击确定后提示「未授权」，则可能是用户的云星空不允许公网访问。
请检查以下信息：
服务URL地址：私有云部署的云星空，第 4 节中表格的配置项都需要填写；
公网IP地址：如果私有云部署的用户网络环境没有配置DNS，可以在第 4 节中填写公网IP地址；
白名单：如果可以配置控制策略，将以下IP添加到白名单：47.110.75.116； 104.168.184.71； 47.245.39.51 ；
如果以上无法解决问题，请联系对应销售，或通过「需求反馈」入口填写工单，等待我方工作人员联系您。
