金蝶云星空(企业版)

1.1 应用场景

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

1.2 功能简介

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

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

1.3 数据范围

8.0 版本的金蝶云星空比 7.0 版本多获取的数据表有：科目余额表、存货收发存汇总表(按日期) 、委外订单_排产明细表体、客户(包含非交易客户)_对应子账户信息、客户_对应子账户信息、收款执行、收款执行明细

如您有更多需求，可联系技术支持反馈。

1.4 注意事项

1）此数据源不支持纯内网部署的金蝶云星空，金蝶云星空需配置可通过外网访问的域名才支持使用此数据源。

2）若在金蝶云星空中开启「是否启用白名单」按钮，请将IP： 47.110.75.116、221.228.72.3 添加到云星空的白名单中，以便数据进行双向访问。

3）支持金蝶云星空（企业版）数据源版本：7.X，8.X，9.X。

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

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

在本产品中获取金蝶云星空数据需要先获取以下信息：

1）请金蝶云星空产品管理员新建「第三方系统登录授权」获取。分为以下三个版本，请根据自己的金蝶云星空版本跳转到对应小节中查看相关操作：

• 补丁版本为 PT146928「8.0.396.10」以上公有云第三方授权：参见 2.2 节；

• 补丁版本为 PT146928「8.0.396.10」以上私有云第三方授权：参见 2.3 节；

• 补丁版本未升级 PT146928「8.0.396.10」且补丁版本为PT136657「7.3.1310.2」及以上的第三方授权：参见 2.4 节；

2）第三方授权完成后，请根据 2.5 节自测检查授权是否成功；

2.1 登录金蝶云星空

需由金蝶云星空产品管理员进行以下操作获取授权信息。

1）使用管理员账号 Administrator 在浏览器中登录金蝶云星空产品，点击「系统管理菜单」下的「第三方系统登录授权」功能。如下图所示：

2）点击「新增」按钮，进入新增「第三方系统登录授权」功能页面。如下图所示：

3）请根据自己使用的金蝶云星空版本跳转到对应的小节获取相关信息。

2.2 版本一：补丁版本为 PT146928「8.0.396.10」以上公有云第三方授权

1）点击「获取应用 ID 」按钮，输入注册的金蝶云账号及密码（金蝶云平台账号，建议使用手机号登录），注意不是当前星空产品内的用户账号。如下图所示：

2）登陆成功之后，会生成「应用 ID」、「应用密钥」，这里需要再自定义「应用名称」。

这里复制「应用密钥」，填写在后续的配置界面。

3）需要指定集成用户，「集成用户框」中选定的成员，在下方「指定用户登录」列表也需要添加该成员。如下图所示：

注：集成用户需要指定，但如果勾选了「允许全部用户登录」，则无需在「指定用户登录」列表中添加成员。

4）设置完成后，保存当前设置。点击「生成测试链接」，验证第三方授权是否正确。在弹出的信息中可以获取「应用 ID、用户名、账套 ID」，复制该信息。如下图所示：

2.3 版本二：补丁版本为PT146928「8.0.396.10」以上私有云第三方授权

1）点击「获取应用 ID 」按钮，再点击「复制网址」可以直接跳转到应用市场，请使用「金蝶云」账号授权登录应用市场。如下图所示：

2）填写对应的信息后，点击「提交」。如下图所示：

3）提交后，会生成「应用信息」，点击「复制」按钮。如下图所示：

4）回到金蝶云星空中，将复制的内容粘贴到「应用信息」栏，点击「确定」。如下图所示：

5）这里会生成「应用 ID」、「应用密钥」，这里需要再自定义「应用名称」。

这里复制「应用密钥」，填写在后续的配置界面。

6）如果需要指定集成用户，「集成用户框」中选定的成员，在下方「指定用户登录」列表也需要添加该成员。如下图所示：

注：集成用户需要指定，但如果勾选了「允许全部用户登录」，则无需在「指定用户登录」列表中添加成员。

7）设置完成后，保存当前设置。点击「生成测试链接」，验证第三方授权是否正确。在弹出的信息中可以获取「应用 ID、用户名、账套 ID」，复制该信息。如下图所示：

2.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」，复制该信息。如下图所示：

2.5 自测检查

用户在第三方授权后，请按照以下步骤检查是否授权成功。

1）先关闭「是否启用白名单」按钮，点击「生成测试链接」。如下图所示：

2）复制链接，将 localhost 替换为浏览器中的域名。

f例如，域名为：56.188.70.22.10067，修改后的链接为：http://56.188.70.22.10067/K3Cloud/html5/......

3）在浏览器中粘贴修改的链接，出现以下页面表示第三方授权成功。

成功后，请恢复白名单设置。

更多配置中，允许用户自定义表，例如增加自定义字段、修改表的请求方式等。

3.1 说明

「金蝶云星空（企业版）」数据连接可以获取两种类型的表：内置表、自定义表单。说明见下表：

若不需要自定义表，可跳转至第 4 节配置连接。

3.2 修改内置表

3.2.1 自定义字段

若客户在内指标中自定义了字段，配置数据连接后是获取不到的，需要用户手动配置自定义字段信息。

所有自定义字段信息获取的方式类似，下面将以获取「供应商」表中的自定义字段为例，来说明如何获取自定义字段信息。

注：自定义字段非必填项，如果不填写，那么表结构中不会包含该自定义字段；若信息填写错误，那么也会同步报错。

1）在应用菜单中搜索 webapi ，进入「Web API 」页面。如下图所示：

2）搜索「供应商」关键字，并点击「查询」，找到供应商数据表，并将操作列表切换为「保存」。如下图所示：

3）在应用菜单中搜索 webapi ，进入「Web API 」页面，复制自定义字段信息。如下图所示：

4）将自定义字段信息填写在配置界面。如下图所示：

3.2.2 取数开始时间

对于部分内置表，用户可以修改「取数开始时间」，手动调整全量更新的表的同步时间范围。下图所示：

3.2.3 填写额外配置项

对于部分内置表，需要用户手动填写一些配置项后，才可获取数据。

例如「科目余额表」，需填写币别计数、账簿ID、科目级别计数 信息，请在云星空 erp 中找到该表，获取相关信息。

3.3 自定义表单

授权后不会自动生成的表，需要用户通过「自定义表单」功能手动配置表的请求方式。需填写下图中的信息：

3.3.1 操作列表中有「保存」

1）在应用菜单中搜索 webapi ，进入「Web API 」页面。如下图所示：

2）搜索所需页面的名称，并点击「查询」，找到对应数据表，并将操作列表切换为「保存」。如下图所示：

3）全选内容并复制、回到本产品中，填写在「请求参数」栏。

3.3.2 操作列表中没有「保存」

1）左上角搜索所需页面的名称，并点击「查询」，找到对应数据表。若操作列表中没有「保存」，如下图所示：

2）操作列表选择「查询报表数据」，复制所有的请求参数说明，填写在第 4 节授权页的「请求参数」栏。如下图所示：

3）点击「在线测试WebAPI」。如下图所示：

4）点击「填写测试数据」，如下图所示：

5）请根据实际需求设置查询条件，将根据此条件返回测试数据。在本产品中同步的数据范围也是由这里的条件决定的。如下图所示：

6）填写完条件后，点击「返回数据」。如下图所示：

7）点击「验证接口」，复制「测试数据」栏的内容，将其填写在第 4 节授权页的「业务参数」栏。如下图所示：

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

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

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

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

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

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

注：若「数据信息」中状态仍需显示「未授权」，请跳转到本文第 8 节查看解决方案

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

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

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

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

获取到数据后，需要将数据添加至「分析空间」模块的项目中，进一步地分析。详情参见：将数据添加进项目中

8.1 授权失败

网络环境可能造成授权失败，如果必填项都填写正确但点击确定后提示「未授权」，则可能是用户的金蝶云星空不允许公网访问。

请检查以下信息：

• 服务URL地址：私有云部署的金蝶云星空，第 4 节中表格的配置项都需要填写；

• 公网IP地址：如果私有云部署的用户网络环境没有配置DNS，可以在第 4 节中填写公网IP地址；

• 白名单：如果可以配置控制策略，将以下IP添加到白名单：47.110.75.116；221.228.72.3；

如果以上无法解决问题，请联系对应销售，或通过「需求反馈」入口填写工单，等待我方工作人员联系您。

8.2 xxx 字段不存在

问题描述：

用户在同步数据时，提示： xxx 字段不存在。

解决方案：

金蝶云星空产品存在多个版本，不同版本可获取的字段有所不同，可能导致用户在定时管道任务同步数据时遇到「xxx 字段不存在」的问题。

针对此情况，可以通过「自定义表」功能添加表，用户可添加自定义表，并在配置过程中去除不支持的字段，以解决字段不存在的问题。