金蝶云星空(企业版)

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。

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

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

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 节的操作获取；

4）根据第 4 节操作，在本产品中新增「金蝶云星空」数据连接，并填写获取的相关信息，即可完成授权；

5）同步金蝶云星空数据，并添加到项目中使用。

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 自定义表

1）使用以上信息可以获取基础数据表，如您有更多的需求，可以使用「自定义表」来实现。自定义表分为两部分，自定义表单和其他表。

• 自定义表单：若客户在 ERP 中自己自定义了字段，是获取不到的，需要用户配置自定义字段信息；

• 其他表：选择某张表，根据提示获取对应的信息并填写。

本小节仅介绍自定义表单信息，其他表请根据提示获取信息。

2）自定义表单需要填写：表名、请求参数。

• 表名：请不要和已有表名重复，若重复，数据会加入到同一张表中；

• 请求参数：请根据接下来的步骤，在金蝶系统中获取信息。

• 业务参数：将云星空（企业版）「webapi在线验证-验证接口-测试数据」的所有内容粘贴在次数。

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

注：如果搜索不到，请找金蝶系统管理员开通相关权限。

3.5.1 操作列表中有「保存」

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

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

3.5.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 字段不存在」的问题。

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