金蝶云星空（企业版）

1. 概述

1.1 功能简介

支持连接金蝶云星空（企业版）数据源，用户可通过新建同步表配置，将金蝶系统数据同步至指定应用中使用。

1.2 注意事项

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

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

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

2. 获取授权信息

获取金蝶云星空数据需要先获取以下信息：

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

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. 更多配置

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

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. 新建数据连接

进入「数据连接管理」，新增「金蝶云星空（企业版）」数据连接。说明见下表：

5. 新建同步表

新建数据连接后，在「同步表管理」中新建同步表，可以将数据同步至应用中使用。。